ClassCategoryReader.st
author Claus Gittinger <cg@exept.de>
Sat, 11 Nov 1995 15:28:26 +0100
changeset 528 a083413dfbe8
parent 451 5aab4706f2fd
child 699 12f456343eea
permissions -rw-r--r--
converted version methods from comment-only to returning-a-string
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
     1
"
5
67342904af11 *** empty log message ***
claus
parents: 3
diff changeset
     2
 COPYRIGHT (c) 1989 by Claus Gittinger
167
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
     3
	      All Rights Reserved
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
     4
a27a279701f8 Initial revision
claus
parents:
diff changeset
     5
 This software is furnished under a license and may be used
a27a279701f8 Initial revision
claus
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
a27a279701f8 Initial revision
claus
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
a27a279701f8 Initial revision
claus
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
a27a279701f8 Initial revision
claus
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
a27a279701f8 Initial revision
claus
parents:
diff changeset
    10
 hereby transferred.
a27a279701f8 Initial revision
claus
parents:
diff changeset
    11
"
a27a279701f8 Initial revision
claus
parents:
diff changeset
    12
a27a279701f8 Initial revision
claus
parents:
diff changeset
    13
Object subclass:#ClassCategoryReader
216
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
    14
       instanceVariableNames:'myClass myCategory privacy ignore primSpec'
425
claus
parents: 384
diff changeset
    15
       classVariableNames:'KeepSource'
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    16
       poolDictionaries:''
a27a279701f8 Initial revision
claus
parents:
diff changeset
    17
       category:'Kernel-Support'
a27a279701f8 Initial revision
claus
parents:
diff changeset
    18
!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    19
88
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    20
!ClassCategoryReader class methodsFor:'documentation'!
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    21
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    22
copyright
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    23
"
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    24
 COPYRIGHT (c) 1989 by Claus Gittinger
167
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
    25
	      All Rights Reserved
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    26
88
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    27
 This software is furnished under a license and may be used
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    28
 only in accordance with the terms of that license and with the
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    29
 inclusion of the above copyright notice.   This software may not
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    30
 be provided or otherwise made available to, or used by, any
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    31
 other person.  No title to or ownership of the software is
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    32
 hereby transferred.
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    33
"
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    34
!
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    35
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    36
version
528
a083413dfbe8 converted version methods from comment-only to returning-a-string
Claus Gittinger <cg@exept.de>
parents: 451
diff changeset
    37
    ^ '$Header: /cvs/stx/stx/libbasic/ClassCategoryReader.st,v 1.22 1995-11-11 14:27:31 cg Exp $'
88
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    38
!
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    39
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    40
documentation
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    41
"
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    42
    a helper class for fileIn - keeps track of class and category to filein for.
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    43
    Instances of this are created by the #methodsFor: methods in Class, to
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    44
    read the next chunk(s) from a stream.
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    45
"
81dacba7a63a *** empty log message ***
claus
parents: 68
diff changeset
    46
! !
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    47
425
claus
parents: 384
diff changeset
    48
!ClassCategoryReader class methodsFor:'initialization'!
claus
parents: 384
diff changeset
    49
claus
parents: 384
diff changeset
    50
initialize
claus
parents: 384
diff changeset
    51
    KeepSource := true
claus
parents: 384
diff changeset
    52
! !
claus
parents: 384
diff changeset
    53
claus
parents: 384
diff changeset
    54
!ClassCategoryReader class methodsFor:'defaults'!
claus
parents: 384
diff changeset
    55
claus
parents: 384
diff changeset
    56
keepSource:aBoolean
claus
parents: 384
diff changeset
    57
    KeepSource := aBoolean
claus
parents: 384
diff changeset
    58
claus
parents: 384
diff changeset
    59
    "Created: 9.9.1995 / 15:22:26 / claus"
claus
parents: 384
diff changeset
    60
!
claus
parents: 384
diff changeset
    61
claus
parents: 384
diff changeset
    62
keepSource
claus
parents: 384
diff changeset
    63
    ^ KeepSource
claus
parents: 384
diff changeset
    64
claus
parents: 384
diff changeset
    65
    "Created: 9.9.1995 / 15:22:27 / claus"
claus
parents: 384
diff changeset
    66
! !
claus
parents: 384
diff changeset
    67
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    68
!ClassCategoryReader class methodsFor:'instance creation'!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    69
a27a279701f8 Initial revision
claus
parents:
diff changeset
    70
class:aClass category:aCategory
a27a279701f8 Initial revision
claus
parents:
diff changeset
    71
    "return a new ClassCategoryReader to read methods for aClass with
a27a279701f8 Initial revision
claus
parents:
diff changeset
    72
     methodCategory aCategory"
a27a279701f8 Initial revision
claus
parents:
diff changeset
    73
a27a279701f8 Initial revision
claus
parents:
diff changeset
    74
    ^ self new class:aClass category:aCategory
167
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
    75
!
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
    76
216
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
    77
class:aClass primitiveSpec:which
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
    78
    "return a ClassCategoryReader to read a primitiveSpec chunk"
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
    79
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
    80
    ^ self new class:aClass primitiveSpec:which
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
    81
!
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
    82
167
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
    83
skippingChunks
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
    84
    "return a class categoryReader which skips chunks up to the next empty one"
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
    85
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
    86
    ^ self new ignoreMethods
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    87
! !
a27a279701f8 Initial revision
claus
parents:
diff changeset
    88
a27a279701f8 Initial revision
claus
parents:
diff changeset
    89
!ClassCategoryReader methodsFor:'private'!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    90
a27a279701f8 Initial revision
claus
parents:
diff changeset
    91
class:aClass category:aCategory
a27a279701f8 Initial revision
claus
parents:
diff changeset
    92
    "set the instance variables"
a27a279701f8 Initial revision
claus
parents:
diff changeset
    93
a27a279701f8 Initial revision
claus
parents:
diff changeset
    94
    myClass := aClass.
68
59faa75185ba *** empty log message ***
claus
parents: 12
diff changeset
    95
    myCategory := aCategory.
216
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
    96
    ignore := false
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
    97
!
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
    98
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
    99
class:aClass primitiveSpec:which
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
   100
    "set the instance variables"
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
   101
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
   102
    myClass := aClass.
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
   103
    primSpec := which.
135
077f485d7783 experimental ignored-methods
claus
parents: 92
diff changeset
   104
    ignore := false
68
59faa75185ba *** empty log message ***
claus
parents: 12
diff changeset
   105
! !
59faa75185ba *** empty log message ***
claus
parents: 12
diff changeset
   106
59faa75185ba *** empty log message ***
claus
parents: 12
diff changeset
   107
!ClassCategoryReader methodsFor:'special'!
59faa75185ba *** empty log message ***
claus
parents: 12
diff changeset
   108
59faa75185ba *** empty log message ***
claus
parents: 12
diff changeset
   109
privateProtocol
167
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   110
    privacy := #private
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   111
! 
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   112
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   113
protectedProtocol
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   114
    privacy := #protected
135
077f485d7783 experimental ignored-methods
claus
parents: 92
diff changeset
   115
! 
077f485d7783 experimental ignored-methods
claus
parents: 92
diff changeset
   116
077f485d7783 experimental ignored-methods
claus
parents: 92
diff changeset
   117
ignoreMethods 
077f485d7783 experimental ignored-methods
claus
parents: 92
diff changeset
   118
    ignore := true
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   119
! !
a27a279701f8 Initial revision
claus
parents:
diff changeset
   120
a27a279701f8 Initial revision
claus
parents:
diff changeset
   121
!ClassCategoryReader methodsFor:'fileIn'!
a27a279701f8 Initial revision
claus
parents:
diff changeset
   122
328
claus
parents: 249
diff changeset
   123
fileInFrom:aStream notifying:requestor passChunk:passChunk
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   124
    "read method-chunks from the input stream, aStream; compile them
a27a279701f8 Initial revision
claus
parents:
diff changeset
   125
     and add the methods to the class defined by the class-instance var;
12
8e03bd717355 *** empty log message ***
claus
parents: 10
diff changeset
   126
     errors and notifications are passed to requestor"
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   127
450
Claus Gittinger <cg@exept.de>
parents: 425
diff changeset
   128
    |aString done method compiler makeSourceRef sourceFile pos nm|
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   129
451
Claus Gittinger <cg@exept.de>
parents: 450
diff changeset
   130
    ignore ifFalse:[
528
a083413dfbe8 converted version methods from comment-only to returning-a-string
Claus Gittinger <cg@exept.de>
parents: 451
diff changeset
   131
	Smalltalk silentLoading ifFalse:[
451
Claus Gittinger <cg@exept.de>
parents: 450
diff changeset
   132
	    myClass isNil ifTrue:[
528
a083413dfbe8 converted version methods from comment-only to returning-a-string
Claus Gittinger <cg@exept.de>
parents: 451
diff changeset
   133
		nm := '** UndefinedClass **'
451
Claus Gittinger <cg@exept.de>
parents: 450
diff changeset
   134
	    ] ifFalse:[
528
a083413dfbe8 converted version methods from comment-only to returning-a-string
Claus Gittinger <cg@exept.de>
parents: 451
diff changeset
   135
		nm := myClass name
451
Claus Gittinger <cg@exept.de>
parents: 450
diff changeset
   136
	    ].
Claus Gittinger <cg@exept.de>
parents: 450
diff changeset
   137
	    Transcript show:'  '; show:nm; show:' -> '; showCr:myCategory.
450
Claus Gittinger <cg@exept.de>
parents: 425
diff changeset
   138
	].
328
claus
parents: 249
diff changeset
   139
528
a083413dfbe8 converted version methods from comment-only to returning-a-string
Claus Gittinger <cg@exept.de>
parents: 451
diff changeset
   140
	makeSourceRef := false.
a083413dfbe8 converted version methods from comment-only to returning-a-string
Claus Gittinger <cg@exept.de>
parents: 451
diff changeset
   141
	KeepSource == false ifTrue:[
451
Claus Gittinger <cg@exept.de>
parents: 450
diff changeset
   142
	    aStream isFileStream ifTrue:[
528
a083413dfbe8 converted version methods from comment-only to returning-a-string
Claus Gittinger <cg@exept.de>
parents: 451
diff changeset
   143
		sourceFile := aStream pathName.
a083413dfbe8 converted version methods from comment-only to returning-a-string
Claus Gittinger <cg@exept.de>
parents: 451
diff changeset
   144
		sourceFile printNL.
a083413dfbe8 converted version methods from comment-only to returning-a-string
Claus Gittinger <cg@exept.de>
parents: 451
diff changeset
   145
		makeSourceRef := true.
451
Claus Gittinger <cg@exept.de>
parents: 450
diff changeset
   146
	    ]
528
a083413dfbe8 converted version methods from comment-only to returning-a-string
Claus Gittinger <cg@exept.de>
parents: 451
diff changeset
   147
	].
425
claus
parents: 384
diff changeset
   148
    ].
claus
parents: 384
diff changeset
   149
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   150
    done := false.
a27a279701f8 Initial revision
claus
parents:
diff changeset
   151
    [done] whileFalse:[
167
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   152
	done := aStream atEnd.
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   153
	done ifFalse:[
425
claus
parents: 384
diff changeset
   154
	    makeSourceRef ifTrue:[
claus
parents: 384
diff changeset
   155
		pos := aStream position
claus
parents: 384
diff changeset
   156
	    ].
167
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   157
	    aString := aStream nextChunk.
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   158
	    done := aString isNil or:[aString isEmpty].
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   159
	    done ifFalse:[
216
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
   160
		primSpec notNil ifTrue:[
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
   161
		    myClass perform:primSpec with:aString.
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
   162
		    "
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
   163
		     ignore rest
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
   164
		    "
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
   165
		    ignore := true
a8abff749575 *** empty log message ***
claus
parents: 167
diff changeset
   166
		].
167
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   167
		ignore ifFalse:[
328
claus
parents: 249
diff changeset
   168
		    passChunk ifTrue:[
claus
parents: 249
diff changeset
   169
			requestor source:aString
claus
parents: 249
diff changeset
   170
		    ].
claus
parents: 249
diff changeset
   171
350
claus
parents: 328
diff changeset
   172
		    compiler := myClass compilerClass.
claus
parents: 328
diff changeset
   173
claus
parents: 328
diff changeset
   174
		    "/
370
claus
parents: 350
diff changeset
   175
		    "/ kludge - for now;
claus
parents: 350
diff changeset
   176
		    "/ have to make ST/X's compiler protocol be compatible to ST-80's
425
claus
parents: 384
diff changeset
   177
		    "/ for other compilers to work ... (TGEN for example)
350
claus
parents: 328
diff changeset
   178
		    "/
claus
parents: 328
diff changeset
   179
		    (compiler respondsTo:#compile:forClass:inCategory:notifying:install:skipIfSame:)
claus
parents: 328
diff changeset
   180
		    ifTrue:[
370
claus
parents: 350
diff changeset
   181
			"/ ST/X's compiler
350
claus
parents: 328
diff changeset
   182
			method :=compiler
claus
parents: 328
diff changeset
   183
				     compile:aString
claus
parents: 328
diff changeset
   184
				     forClass:myClass
claus
parents: 328
diff changeset
   185
				     inCategory:myCategory
claus
parents: 328
diff changeset
   186
				     notifying:requestor
claus
parents: 328
diff changeset
   187
				     install:true
claus
parents: 328
diff changeset
   188
				     skipIfSame:true.
claus
parents: 328
diff changeset
   189
425
claus
parents: 384
diff changeset
   190
			makeSourceRef ifTrue:[
claus
parents: 384
diff changeset
   191
			    method source = aString ifTrue:[
claus
parents: 384
diff changeset
   192
				method sourceFilename:sourceFile position:pos 
claus
parents: 384
diff changeset
   193
			    ]
claus
parents: 384
diff changeset
   194
			]
350
claus
parents: 328
diff changeset
   195
		    ] ifFalse:[
370
claus
parents: 350
diff changeset
   196
			"/ some generated (TGEN) compiler
350
claus
parents: 328
diff changeset
   197
			method := compiler new
claus
parents: 328
diff changeset
   198
				      compile:aString 
claus
parents: 328
diff changeset
   199
				      in:myClass 
claus
parents: 328
diff changeset
   200
				      notifying:requestor 
claus
parents: 328
diff changeset
   201
				      ifFail:nil
claus
parents: 328
diff changeset
   202
		    ].
328
claus
parents: 249
diff changeset
   203
167
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   204
		    privacy notNil ifTrue:[
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   205
			privacy == #private ifTrue:[
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   206
			    method setToPrivate
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   207
			] ifFalse:[
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   208
			    privacy == #protected ifTrue:[
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   209
				method setToProtected
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   210
			    ]
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   211
			]
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   212
		    ]
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   213
		]
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   214
	    ]
f93304c133e3 support private, protected and ignored code
claus
parents: 135
diff changeset
   215
	]
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   216
    ]
425
claus
parents: 384
diff changeset
   217
claus
parents: 384
diff changeset
   218
    "Modified: 9.9.1995 / 15:29:08 / claus"
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   219
!
a27a279701f8 Initial revision
claus
parents:
diff changeset
   220
a27a279701f8 Initial revision
claus
parents:
diff changeset
   221
fileInFrom:aStream
a27a279701f8 Initial revision
claus
parents:
diff changeset
   222
    "read method-chunks from the input stream, aStream; compile them
a27a279701f8 Initial revision
claus
parents:
diff changeset
   223
     and add the methods to the class defined by the class-instance var"
a27a279701f8 Initial revision
claus
parents:
diff changeset
   224
328
claus
parents: 249
diff changeset
   225
    self fileInFrom:aStream notifying:nil passChunk:false
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   226
! !