Kernel-Classes.st 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892
  1. Smalltalk createPackage: 'Kernel-Classes'!
  2. Object subclass: #Behavior
  3. instanceVariableNames: ''
  4. package: 'Kernel-Classes'!
  5. !Behavior commentStamp!
  6. I am the superclass of all class objects.
  7. I define the protocol for creating instances of a class with `#basicNew` and `#new` (see `boot.js` for class constructors details).
  8. My instances know about the subclass/superclass relationships between classes, contain the description that instances are created from,
  9. and hold the method dictionary that's associated with each class.
  10. I also provides methods for compiling methods, examining the method dictionary, and iterating over the class hierarchy.!
  11. !Behavior methodsFor: 'accessing'!
  12. >> aString
  13. ^ self methodAt: aString
  14. !
  15. allInstanceVariableNames
  16. | result |
  17. result := self instanceVariableNames copy.
  18. self superclass ifNotNil: [
  19. result addAll: self superclass allInstanceVariableNames ].
  20. ^ result
  21. !
  22. allSelectors
  23. ^ self allSuperclasses
  24. inject: self selectors
  25. into: [ :acc :each | acc addAll: each selectors; yourself ]
  26. !
  27. allSubclasses
  28. "Answer an collection of the receiver's and the receiver's descendent's subclasses. "
  29. | subclasses index |
  30. subclasses := self subclasses.
  31. index := 1.
  32. [ index > subclasses size ]
  33. whileFalse: [ subclasses addAll: (subclasses at: index) subclasses.
  34. index := index + 1 ].
  35. ^ subclasses
  36. !
  37. allSuperclasses
  38. self superclass ifNil: [ ^ #() ].
  39. ^ (OrderedCollection with: self superclass)
  40. addAll: self superclass allSuperclasses;
  41. yourself
  42. !
  43. comment
  44. ^ (self basicAt: 'comment') ifNil: [ '' ]
  45. !
  46. comment: aString
  47. self basicAt: 'comment' put: aString.
  48. SystemAnnouncer current
  49. announce: (ClassCommentChanged new
  50. theClass: self;
  51. yourself)
  52. !
  53. commentStamp
  54. ^ ClassCommentReader new
  55. class: self;
  56. yourself
  57. !
  58. commentStamp: aStamp prior: prior
  59. ^ self commentStamp
  60. !
  61. definition
  62. ^ ''
  63. !
  64. instanceVariableNames
  65. <return self.iVarNames>
  66. !
  67. javascriptConstructor
  68. "Answer the JS constructor used to instantiate. See boot.js"
  69. <return self.fn>
  70. !
  71. javascriptConstructor: aJavaScriptFunction
  72. "Set the JS constructor used to instantiate.
  73. See the JS counter-part in boot.js `$core.setClassConstructor'"
  74. <$core.setClassConstructor(self, aJavaScriptFunction);>
  75. !
  76. lookupSelector: selector
  77. "Look up the given selector in my methodDictionary.
  78. Return the corresponding method if found.
  79. Otherwise chase the superclass chain and try again.
  80. Return nil if no method is found."
  81. | lookupClass |
  82. lookupClass := self.
  83. [ lookupClass = nil ] whileFalse: [
  84. (lookupClass includesSelector: selector)
  85. ifTrue: [ ^ lookupClass methodAt: selector ].
  86. lookupClass := lookupClass superclass ].
  87. ^ nil
  88. !
  89. methodAt: aString
  90. ^ self methodDictionary at: aString
  91. !
  92. methodDictionary
  93. <var dict = $globals.HashedCollection._new();
  94. var methods = self.methods;
  95. Object.keys(methods).forEach(function(i) {
  96. if(methods[i].selector) {
  97. dict._at_put_(methods[i].selector, methods[i]);
  98. }
  99. });
  100. return dict>
  101. !
  102. methodTemplate
  103. ^ String streamContents: [ :stream |
  104. stream
  105. nextPutAll: 'messageSelectorAndArgumentNames';
  106. nextPutAll: String lf, String tab;
  107. nextPutAll: '"comment stating purpose of message"';
  108. nextPutAll: String lf, String lf, String tab;
  109. nextPutAll: '| temporary variable names |';
  110. nextPutAll: String lf, String tab;
  111. nextPutAll: 'statements' ]
  112. !
  113. methods
  114. ^ self methodDictionary values
  115. !
  116. methodsFor: aString
  117. ^ ClassCategoryReader new
  118. class: self category: aString;
  119. yourself
  120. !
  121. methodsFor: aString stamp: aStamp
  122. "Added for file-in compatibility, ignores stamp."
  123. ^ self methodsFor: aString
  124. !
  125. methodsInProtocol: aString
  126. ^ self methods select: [ :each | each protocol = aString ]
  127. !
  128. name
  129. <return self.className || nil>
  130. !
  131. organization
  132. ^ self basicAt: 'organization'
  133. !
  134. ownMethods
  135. "Answer the methods of the receiver that are not package extensions"
  136. ^ (self ownProtocols
  137. inject: OrderedCollection new
  138. into: [ :acc :each | acc, (self methodsInProtocol: each) ])
  139. sorted: [ :a :b | a selector <= b selector ]
  140. !
  141. ownProtocols
  142. "Answer the protocols of the receiver that are not package extensions"
  143. ^ self protocols reject: [ :each |
  144. each match: '^\*' ]
  145. !
  146. protocols
  147. ^ self organization elements sorted
  148. !
  149. prototype
  150. <return self.fn.prototype>
  151. !
  152. removeProtocolIfEmpty: aString
  153. self methods
  154. detect: [ :each | each protocol = aString ]
  155. ifNone: [ self organization removeElement: aString ]
  156. !
  157. selectors
  158. ^ self methodDictionary keys
  159. !
  160. subclasses
  161. self subclassResponsibility
  162. !
  163. superclass
  164. <return self.superclass || nil>
  165. !
  166. theMetaClass
  167. ^ self class
  168. !
  169. theNonMetaClass
  170. ^ self
  171. !
  172. withAllSubclasses
  173. ^ (Array with: self) addAll: self allSubclasses; yourself
  174. ! !
  175. !Behavior methodsFor: 'compiling'!
  176. addCompiledMethod: aMethod
  177. | oldMethod announcement |
  178. oldMethod := self methodDictionary
  179. at: aMethod selector
  180. ifAbsent: [ nil ].
  181. (self protocols includes: aMethod protocol)
  182. ifFalse: [ self organization addElement: aMethod protocol ].
  183. self basicAddCompiledMethod: aMethod.
  184. oldMethod ifNotNil: [
  185. self removeProtocolIfEmpty: oldMethod protocol ].
  186. announcement := oldMethod
  187. ifNil: [
  188. MethodAdded new
  189. method: aMethod;
  190. yourself ]
  191. ifNotNil: [
  192. MethodModified new
  193. oldMethod: oldMethod;
  194. method: aMethod;
  195. yourself ].
  196. SystemAnnouncer current
  197. announce: announcement
  198. !
  199. compile: aString
  200. ^ self compile: aString protocol: ''
  201. !
  202. compile: aString protocol: anotherString
  203. ^ Compiler new
  204. install: aString
  205. forClass: self
  206. protocol: anotherString
  207. !
  208. recompile
  209. ^ Compiler new recompile: self
  210. !
  211. removeCompiledMethod: aMethod
  212. self basicRemoveCompiledMethod: aMethod.
  213. self removeProtocolIfEmpty: aMethod protocol.
  214. SystemAnnouncer current
  215. announce: (MethodRemoved new
  216. method: aMethod;
  217. yourself)
  218. ! !
  219. !Behavior methodsFor: 'enumerating'!
  220. allSubclassesDo: aBlock
  221. "Evaluate the argument, aBlock, for each of the receiver's subclasses."
  222. self allSubclasses do: [ :each |
  223. aBlock value: each ]
  224. !
  225. protocolsDo: aBlock
  226. "Execute aBlock for each method protocol with
  227. its collection of methods in the sort order of protocol name."
  228. | methodsByProtocol |
  229. methodsByProtocol := HashedCollection new.
  230. self methodDictionary valuesDo: [ :m |
  231. (methodsByProtocol at: m protocol ifAbsentPut: [ Array new ])
  232. add: m ].
  233. self protocols do: [ :protocol |
  234. aBlock value: protocol value: (methodsByProtocol at: protocol) ]
  235. ! !
  236. !Behavior methodsFor: 'instance creation'!
  237. basicNew
  238. <return new self.fn()>
  239. !
  240. new
  241. ^ self basicNew initialize
  242. ! !
  243. !Behavior methodsFor: 'private'!
  244. basicAddCompiledMethod: aMethod
  245. <$core.addMethod(aMethod, self)>
  246. !
  247. basicRemoveCompiledMethod: aMethod
  248. <$core.removeMethod(aMethod,self)>
  249. ! !
  250. !Behavior methodsFor: 'testing'!
  251. canUnderstand: aSelector
  252. ^ (self includesSelector: aSelector asString) or: [
  253. self superclass notNil and: [ self superclass canUnderstand: aSelector ]]
  254. !
  255. includesBehavior: aClass
  256. ^ self == aClass or: [
  257. self inheritsFrom: aClass ]
  258. !
  259. includesSelector: aString
  260. ^ self methodDictionary includesKey: aString
  261. !
  262. inheritsFrom: aClass
  263. self superclass ifNil: [ ^ false ].
  264. ^ aClass == self superclass or: [
  265. self superclass inheritsFrom: aClass ]
  266. !
  267. isBehavior
  268. ^ true
  269. ! !
  270. Behavior subclass: #Class
  271. instanceVariableNames: ''
  272. package: 'Kernel-Classes'!
  273. !Class commentStamp!
  274. I am __the__ class object.
  275. My instances are the classes of the system.
  276. Class creation is done throught a `ClassBuilder` instance.!
  277. !Class methodsFor: 'accessing'!
  278. category
  279. ^ self package ifNil: [ 'Unclassified' ] ifNotNil: [ self package name ]
  280. !
  281. definition
  282. ^ String streamContents: [ :stream |
  283. stream
  284. nextPutAll: self superclass asString;
  285. nextPutAll: ' subclass: #';
  286. nextPutAll: self name;
  287. nextPutAll: String lf, String tab;
  288. nextPutAll: 'instanceVariableNames: '''.
  289. self instanceVariableNames
  290. do: [ :each | stream nextPutAll: each ]
  291. separatedBy: [ stream nextPutAll: ' ' ].
  292. stream
  293. nextPutAll: '''', String lf, String tab;
  294. nextPutAll: 'package: ''';
  295. nextPutAll: self category;
  296. nextPutAll: '''' ]
  297. !
  298. heliosClass
  299. "Should be an Helios extension. Unfortunately, since helios can browse remote
  300. environments, we can't extend base classes"
  301. ^ 'class'
  302. !
  303. package
  304. ^ self basicAt: 'pkg'
  305. !
  306. package: aPackage
  307. | oldPackage |
  308. self package = aPackage ifTrue: [ ^ self ].
  309. oldPackage := self package.
  310. self basicAt: 'pkg' put: aPackage.
  311. oldPackage organization removeElement: self.
  312. aPackage organization addElement: self.
  313. SystemAnnouncer current announce: (ClassMoved new
  314. theClass: self;
  315. oldPackage: oldPackage;
  316. yourself)
  317. !
  318. rename: aString
  319. ClassBuilder new renameClass: self to: aString
  320. !
  321. subclasses
  322. <return self.subclasses._copy()>
  323. ! !
  324. !Class methodsFor: 'browsing'!
  325. browse
  326. Finder findClass: self
  327. ! !
  328. !Class methodsFor: 'class creation'!
  329. subclass: aString instanceVariableNames: anotherString
  330. "Kept for file-in compatibility."
  331. ^ self subclass: aString instanceVariableNames: anotherString package: nil
  332. !
  333. subclass: aString instanceVariableNames: aString2 category: aString3
  334. "Kept for file-in compatibility."
  335. ^ self subclass: aString instanceVariableNames: aString2 package: aString3
  336. !
  337. subclass: aString instanceVariableNames: aString2 classVariableNames: classVars poolDictionaries: pools category: aString3
  338. "Kept for file-in compatibility. ignores class variables and pools."
  339. ^ self subclass: aString instanceVariableNames: aString2 package: aString3
  340. !
  341. subclass: aString instanceVariableNames: aString2 package: aString3
  342. ^ ClassBuilder new
  343. superclass: self subclass: aString asString instanceVariableNames: aString2 package: aString3
  344. ! !
  345. !Class methodsFor: 'converting'!
  346. asJavascript
  347. ^ '$globals.', self name
  348. ! !
  349. !Class methodsFor: 'printing'!
  350. printOn: aStream
  351. aStream nextPutAll: self name
  352. ! !
  353. !Class methodsFor: 'testing'!
  354. isClass
  355. ^ true
  356. ! !
  357. Behavior subclass: #Metaclass
  358. instanceVariableNames: ''
  359. package: 'Kernel-Classes'!
  360. !Metaclass commentStamp!
  361. I am the root of the class hierarchy.
  362. My instances are metaclasses, one for each real class, and have a single instance, which they hold onto: the class that they are the metaclass of.!
  363. !Metaclass methodsFor: 'accessing'!
  364. definition
  365. ^ String streamContents: [ :stream |
  366. stream
  367. nextPutAll: self asString;
  368. nextPutAll: ' instanceVariableNames: '''.
  369. self instanceVariableNames
  370. do: [ :each | stream nextPutAll: each ]
  371. separatedBy: [ stream nextPutAll: ' ' ].
  372. stream nextPutAll: '''' ]
  373. !
  374. instanceClass
  375. <return self.instanceClass>
  376. !
  377. instanceVariableNames: aCollection
  378. ClassBuilder new
  379. class: self instanceVariableNames: aCollection
  380. !
  381. package
  382. ^ self instanceClass package
  383. !
  384. subclasses
  385. ^ (self instanceClass subclasses
  386. select: [ :each | each isMetaclass not ])
  387. collect: [ :each | each theMetaClass ]
  388. !
  389. theMetaClass
  390. ^ self
  391. !
  392. theNonMetaClass
  393. ^ self instanceClass
  394. ! !
  395. !Metaclass methodsFor: 'converting'!
  396. asJavascript
  397. ^ '$globals.', self instanceClass name, '.klass'
  398. ! !
  399. !Metaclass methodsFor: 'printing'!
  400. printOn: aStream
  401. aStream
  402. nextPutAll: self instanceClass name;
  403. nextPutAll: ' class'
  404. ! !
  405. !Metaclass methodsFor: 'testing'!
  406. isMetaclass
  407. ^ true
  408. ! !
  409. Object subclass: #ClassBuilder
  410. instanceVariableNames: ''
  411. package: 'Kernel-Classes'!
  412. !ClassBuilder commentStamp!
  413. I am responsible for compiling new classes or modifying existing classes in the system.
  414. Rather than using me directly to compile a class, use `Class >> subclass:instanceVariableNames:package:`.!
  415. !ClassBuilder methodsFor: 'accessing'!
  416. instanceVariableNamesFor: aString
  417. ^ (aString tokenize: ' ') reject: [ :each | each isEmpty ]
  418. ! !
  419. !ClassBuilder methodsFor: 'class definition'!
  420. addSubclassOf: aClass named: className instanceVariableNames: aCollection package: packageName
  421. | theClass thePackage |
  422. theClass := Smalltalk globals at: className.
  423. thePackage := Package named: packageName.
  424. theClass ifNotNil: [
  425. theClass package: thePackage.
  426. theClass superclass == aClass ifFalse: [
  427. ^ self
  428. migrateClassNamed: className
  429. superclass: aClass
  430. instanceVariableNames: aCollection
  431. package: packageName ] ].
  432. ^ self
  433. basicAddSubclassOf: aClass
  434. named: className
  435. instanceVariableNames: aCollection
  436. package: packageName
  437. !
  438. class: aClass instanceVariableNames: ivarNames
  439. self basicClass: aClass instanceVariableNames: ivarNames.
  440. self setupClass: aClass.
  441. SystemAnnouncer current
  442. announce: (ClassDefinitionChanged new
  443. theClass: aClass;
  444. yourself)
  445. !
  446. superclass: aClass subclass: className
  447. ^ self superclass: aClass subclass: className instanceVariableNames: '' package: nil
  448. !
  449. superclass: aClass subclass: className instanceVariableNames: ivarNames package: packageName
  450. | newClass |
  451. newClass := self addSubclassOf: aClass
  452. named: className instanceVariableNames: (self instanceVariableNamesFor: ivarNames)
  453. package: (packageName ifNil: [ 'unclassified' ]).
  454. self setupClass: newClass.
  455. SystemAnnouncer current
  456. announce: (ClassAdded new
  457. theClass: newClass;
  458. yourself).
  459. ^ newClass
  460. ! !
  461. !ClassBuilder methodsFor: 'class migration'!
  462. migrateClass: aClass superclass: anotherClass
  463. ^ self
  464. migrateClassNamed: aClass name
  465. superclass: anotherClass
  466. instanceVariableNames: aClass instanceVariableNames
  467. package: aClass package name
  468. !
  469. migrateClassNamed: className superclass: aClass instanceVariableNames: aCollection package: packageName
  470. | oldClass newClass tmp |
  471. tmp := 'new*', className.
  472. oldClass := Smalltalk globals at: className.
  473. newClass := self
  474. addSubclassOf: aClass
  475. named: tmp
  476. instanceVariableNames: aCollection
  477. package: packageName.
  478. self basicSwapClassNames: oldClass with: newClass.
  479. [ self copyClass: oldClass to: newClass ]
  480. on: Error
  481. do: [ :exception |
  482. self
  483. basicSwapClassNames: oldClass with: newClass;
  484. basicRemoveClass: newClass.
  485. exception signal ].
  486. self
  487. rawRenameClass: oldClass to: tmp;
  488. rawRenameClass: newClass to: className.
  489. oldClass subclasses
  490. do: [ :each | self migrateClass: each superclass: newClass ].
  491. self basicRemoveClass: oldClass.
  492. SystemAnnouncer current announce: (ClassMigrated new
  493. theClass: newClass;
  494. oldClass: oldClass;
  495. yourself).
  496. ^ newClass
  497. !
  498. renameClass: aClass to: className
  499. self basicRenameClass: aClass to: className.
  500. "Recompile the class to fix potential issues with super sends"
  501. aClass recompile.
  502. SystemAnnouncer current
  503. announce: (ClassRenamed new
  504. theClass: aClass;
  505. yourself)
  506. ! !
  507. !ClassBuilder methodsFor: 'copying'!
  508. copyClass: aClass named: className
  509. | newClass |
  510. newClass := self
  511. addSubclassOf: aClass superclass
  512. named: className
  513. instanceVariableNames: aClass instanceVariableNames
  514. package: aClass package name.
  515. self copyClass: aClass to: newClass.
  516. SystemAnnouncer current
  517. announce: (ClassAdded new
  518. theClass: newClass;
  519. yourself).
  520. ^ newClass
  521. !
  522. copyClass: aClass to: anotherClass
  523. anotherClass comment: aClass comment.
  524. aClass methodDictionary valuesDo: [ :each |
  525. Compiler new install: each source forClass: anotherClass protocol: each protocol ].
  526. self basicClass: anotherClass class instanceVariables: aClass class instanceVariableNames.
  527. aClass class methodDictionary valuesDo: [ :each |
  528. Compiler new install: each source forClass: anotherClass class protocol: each protocol ].
  529. self setupClass: anotherClass
  530. ! !
  531. !ClassBuilder methodsFor: 'method definition'!
  532. installMethod: aCompiledMethod forClass: aBehavior protocol: aString
  533. aCompiledMethod protocol: aString.
  534. aBehavior addCompiledMethod: aCompiledMethod.
  535. self setupClass: aBehavior.
  536. ^ aCompiledMethod
  537. ! !
  538. !ClassBuilder methodsFor: 'private'!
  539. basicAddSubclassOf: aClass named: aString instanceVariableNames: aCollection package: packageName
  540. <
  541. $core.addClass(aString, aClass, aCollection, packageName);
  542. return $globals[aString]
  543. >
  544. !
  545. basicClass: aClass instanceVariableNames: aString
  546. self basicClass: aClass instanceVariables: (self instanceVariableNamesFor: aString)
  547. !
  548. basicClass: aClass instanceVariables: aCollection
  549. aClass isMetaclass ifFalse: [ self error: aClass name, ' is not a metaclass' ].
  550. aClass basicAt: 'iVarNames' put: aCollection
  551. !
  552. basicRemoveClass: aClass
  553. <$core.removeClass(aClass)>
  554. !
  555. basicRenameClass: aClass to: aString
  556. <
  557. $globals[aString] = aClass;
  558. delete $globals[aClass.className];
  559. aClass.className = aString;
  560. >
  561. !
  562. basicSwapClassNames: aClass with: anotherClass
  563. <
  564. var tmp = aClass.className;
  565. aClass.className = anotherClass.className;
  566. anotherClass.className = tmp;
  567. >
  568. !
  569. rawRenameClass: aClass to: aString
  570. <
  571. $globals[aString] = aClass;
  572. >
  573. ! !
  574. !ClassBuilder methodsFor: 'public'!
  575. setupClass: aClass
  576. <$core.init(aClass);>
  577. ! !
  578. Object subclass: #ClassCategoryReader
  579. instanceVariableNames: 'class category'
  580. package: 'Kernel-Classes'!
  581. !ClassCategoryReader commentStamp!
  582. I provide a mechanism for retrieving class descriptions stored on a file in the Smalltalk chunk format.!
  583. !ClassCategoryReader methodsFor: 'accessing'!
  584. class: aClass category: aString
  585. class := aClass.
  586. category := aString
  587. ! !
  588. !ClassCategoryReader methodsFor: 'fileIn'!
  589. scanFrom: aChunkParser
  590. | chunk |
  591. [ chunk := aChunkParser nextChunk.
  592. chunk isEmpty ] whileFalse: [
  593. self compileMethod: chunk ].
  594. ClassBuilder new setupClass: class
  595. ! !
  596. !ClassCategoryReader methodsFor: 'initialization'!
  597. initialize
  598. super initialize.
  599. ! !
  600. !ClassCategoryReader methodsFor: 'private'!
  601. compileMethod: aString
  602. Compiler new install: aString forClass: class protocol: category
  603. ! !
  604. Object subclass: #ClassCommentReader
  605. instanceVariableNames: 'class'
  606. package: 'Kernel-Classes'!
  607. !ClassCommentReader commentStamp!
  608. I provide a mechanism for retrieving class comments stored on a file.
  609. See also `ClassCategoryReader`.!
  610. !ClassCommentReader methodsFor: 'accessing'!
  611. class: aClass
  612. class := aClass
  613. ! !
  614. !ClassCommentReader methodsFor: 'fileIn'!
  615. scanFrom: aChunkParser
  616. | chunk |
  617. chunk := aChunkParser nextChunk.
  618. chunk isEmpty ifFalse: [
  619. self setComment: chunk ].
  620. ! !
  621. !ClassCommentReader methodsFor: 'initialization'!
  622. initialize
  623. super initialize.
  624. ! !
  625. !ClassCommentReader methodsFor: 'private'!
  626. setComment: aString
  627. class comment: aString
  628. ! !
  629. Object subclass: #ClassSorterNode
  630. instanceVariableNames: 'theClass level nodes'
  631. package: 'Kernel-Classes'!
  632. !ClassSorterNode commentStamp!
  633. I provide an algorithm for sorting classes alphabetically.
  634. See [Issue #143](https://github.com/amber-smalltalk/amber/issues/143) on GitHub.!
  635. !ClassSorterNode methodsFor: 'accessing'!
  636. getNodesFrom: aCollection
  637. | children others |
  638. children := #().
  639. others := #().
  640. aCollection do: [ :each |
  641. (each superclass = self theClass)
  642. ifTrue: [ children add: each ]
  643. ifFalse: [ others add: each ]].
  644. nodes:= children collect: [ :each |
  645. ClassSorterNode on: each classes: others level: self level + 1 ]
  646. !
  647. level
  648. ^ level
  649. !
  650. level: anInteger
  651. level := anInteger
  652. !
  653. nodes
  654. ^ nodes
  655. !
  656. theClass
  657. ^ theClass
  658. !
  659. theClass: aClass
  660. theClass := aClass
  661. ! !
  662. !ClassSorterNode methodsFor: 'visiting'!
  663. traverseClassesWith: aCollection
  664. "sort classes alphabetically Issue #143"
  665. aCollection add: self theClass.
  666. (self nodes sorted: [ :a :b | a theClass name <= b theClass name ]) do: [ :aNode |
  667. aNode traverseClassesWith: aCollection ].
  668. ! !
  669. !ClassSorterNode class methodsFor: 'instance creation'!
  670. on: aClass classes: aCollection level: anInteger
  671. ^ self new
  672. theClass: aClass;
  673. level: anInteger;
  674. getNodesFrom: aCollection;
  675. yourself
  676. ! !