Kernel-Classes.st 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887
  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 `smalltalk.setClassConstructor'"
  74. <smalltalk.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 compatibility, right now 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. <smalltalk.addMethod(aMethod, self)>
  246. !
  247. basicRemoveCompiledMethod: aMethod
  248. <smalltalk.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. package
  299. ^ self basicAt: 'pkg'
  300. !
  301. package: aPackage
  302. | oldPackage |
  303. self package = aPackage ifTrue: [ ^ self ].
  304. oldPackage := self package.
  305. self basicAt: 'pkg' put: aPackage.
  306. oldPackage organization removeElement: self.
  307. aPackage organization addElement: self.
  308. SystemAnnouncer current announce: (ClassMoved new
  309. theClass: self;
  310. oldPackage: oldPackage;
  311. yourself)
  312. !
  313. rename: aString
  314. ClassBuilder new renameClass: self to: aString
  315. !
  316. subclasses
  317. <return self.subclasses._copy()>
  318. ! !
  319. !Class methodsFor: 'browsing'!
  320. browse
  321. Finder findClass: self
  322. ! !
  323. !Class methodsFor: 'class creation'!
  324. subclass: aString instanceVariableNames: anotherString
  325. "Kept for compatibility."
  326. ^ self subclass: aString instanceVariableNames: anotherString package: nil
  327. !
  328. subclass: aString instanceVariableNames: aString2 category: aString3
  329. "Kept for compatibility."
  330. self deprecatedAPI.
  331. ^ self subclass: aString instanceVariableNames: aString2 package: aString3
  332. !
  333. subclass: aString instanceVariableNames: aString2 classVariableNames: classVars poolDictionaries: pools category: aString3
  334. "Just ignore class variables and pools. Added for compatibility."
  335. ^ self subclass: aString instanceVariableNames: aString2 package: aString3
  336. !
  337. subclass: aString instanceVariableNames: aString2 package: aString3
  338. ^ ClassBuilder new
  339. superclass: self subclass: aString asString instanceVariableNames: aString2 package: aString3
  340. ! !
  341. !Class methodsFor: 'converting'!
  342. asJavascript
  343. ^ 'globals.', self name
  344. ! !
  345. !Class methodsFor: 'printing'!
  346. printOn: aStream
  347. aStream nextPutAll: self name
  348. ! !
  349. !Class methodsFor: 'testing'!
  350. isClass
  351. ^ true
  352. ! !
  353. Behavior subclass: #Metaclass
  354. instanceVariableNames: ''
  355. package: 'Kernel-Classes'!
  356. !Metaclass commentStamp!
  357. I am the root of the class hierarchy.
  358. 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.!
  359. !Metaclass methodsFor: 'accessing'!
  360. definition
  361. ^ String streamContents: [ :stream |
  362. stream
  363. nextPutAll: self asString;
  364. nextPutAll: ' instanceVariableNames: '''.
  365. self instanceVariableNames
  366. do: [ :each | stream nextPutAll: each ]
  367. separatedBy: [ stream nextPutAll: ' ' ].
  368. stream nextPutAll: '''' ]
  369. !
  370. instanceClass
  371. <return self.instanceClass>
  372. !
  373. instanceVariableNames: aCollection
  374. ClassBuilder new
  375. class: self instanceVariableNames: aCollection
  376. !
  377. package
  378. ^ self instanceClass package
  379. !
  380. subclasses
  381. ^ (self instanceClass subclasses
  382. select: [ :each | each isMetaclass not ])
  383. collect: [ :each | each theMetaClass ]
  384. !
  385. theMetaClass
  386. ^ self
  387. !
  388. theNonMetaClass
  389. ^ self instanceClass
  390. ! !
  391. !Metaclass methodsFor: 'converting'!
  392. asJavascript
  393. ^ 'globals.', self instanceClass name, '.klass'
  394. ! !
  395. !Metaclass methodsFor: 'printing'!
  396. printOn: aStream
  397. aStream
  398. nextPutAll: self instanceClass name;
  399. nextPutAll: ' class'
  400. ! !
  401. !Metaclass methodsFor: 'testing'!
  402. isMetaclass
  403. ^ true
  404. ! !
  405. Object subclass: #ClassBuilder
  406. instanceVariableNames: ''
  407. package: 'Kernel-Classes'!
  408. !ClassBuilder commentStamp!
  409. I am responsible for compiling new classes or modifying existing classes in the system.
  410. Rather than using me directly to compile a class, use `Class >> subclass:instanceVariableNames:package:`.!
  411. !ClassBuilder methodsFor: 'accessing'!
  412. instanceVariableNamesFor: aString
  413. ^ (aString tokenize: ' ') reject: [ :each | each isEmpty ]
  414. ! !
  415. !ClassBuilder methodsFor: 'class definition'!
  416. addSubclassOf: aClass named: className instanceVariableNames: aCollection package: packageName
  417. | theClass thePackage |
  418. theClass := Smalltalk globals at: className.
  419. thePackage := Package named: packageName.
  420. theClass ifNotNil: [
  421. theClass package: thePackage.
  422. theClass superclass == aClass ifFalse: [
  423. ^ self
  424. migrateClassNamed: className
  425. superclass: aClass
  426. instanceVariableNames: aCollection
  427. package: packageName ] ].
  428. ^ self
  429. basicAddSubclassOf: aClass
  430. named: className
  431. instanceVariableNames: aCollection
  432. package: packageName
  433. !
  434. class: aClass instanceVariableNames: ivarNames
  435. self basicClass: aClass instanceVariableNames: ivarNames.
  436. self setupClass: aClass.
  437. SystemAnnouncer current
  438. announce: (ClassDefinitionChanged new
  439. theClass: aClass;
  440. yourself)
  441. !
  442. superclass: aClass subclass: className
  443. ^ self superclass: aClass subclass: className instanceVariableNames: '' package: nil
  444. !
  445. superclass: aClass subclass: className instanceVariableNames: ivarNames package: packageName
  446. | newClass |
  447. newClass := self addSubclassOf: aClass
  448. named: className instanceVariableNames: (self instanceVariableNamesFor: ivarNames)
  449. package: (packageName ifNil: [ 'unclassified' ]).
  450. self setupClass: newClass.
  451. SystemAnnouncer current
  452. announce: (ClassAdded new
  453. theClass: newClass;
  454. yourself).
  455. ^ newClass
  456. ! !
  457. !ClassBuilder methodsFor: 'class migration'!
  458. migrateClass: aClass superclass: anotherClass
  459. ^ self
  460. migrateClassNamed: aClass name
  461. superclass: anotherClass
  462. instanceVariableNames: aClass instanceVariableNames
  463. package: aClass package name
  464. !
  465. migrateClassNamed: className superclass: aClass instanceVariableNames: aCollection package: packageName
  466. | oldClass newClass tmp |
  467. tmp := 'new*', className.
  468. oldClass := Smalltalk globals at: className.
  469. newClass := self
  470. addSubclassOf: aClass
  471. named: tmp
  472. instanceVariableNames: aCollection
  473. package: packageName.
  474. self basicSwapClassNames: oldClass with: newClass.
  475. [ self copyClass: oldClass to: newClass ]
  476. on: Error
  477. do: [ :exception |
  478. self
  479. basicSwapClassNames: oldClass with: newClass;
  480. basicRemoveClass: newClass.
  481. exception signal ].
  482. self
  483. rawRenameClass: oldClass to: tmp;
  484. rawRenameClass: newClass to: className.
  485. oldClass subclasses
  486. do: [ :each | self migrateClass: each superclass: newClass ]
  487. displayingProgress: 'Recompiling ', newClass name, '...'.
  488. self basicRemoveClass: oldClass.
  489. SystemAnnouncer current announce: (ClassMigrated new
  490. theClass: newClass;
  491. oldClass: oldClass;
  492. yourself).
  493. ^ newClass
  494. !
  495. renameClass: aClass to: className
  496. self basicRenameClass: aClass to: className.
  497. "Recompile the class to fix potential issues with super sends"
  498. aClass recompile.
  499. SystemAnnouncer current
  500. announce: (ClassRenamed new
  501. theClass: aClass;
  502. yourself)
  503. ! !
  504. !ClassBuilder methodsFor: 'copying'!
  505. copyClass: aClass named: className
  506. | newClass |
  507. newClass := self
  508. addSubclassOf: aClass superclass
  509. named: className
  510. instanceVariableNames: aClass instanceVariableNames
  511. package: aClass package name.
  512. self copyClass: aClass to: newClass.
  513. SystemAnnouncer current
  514. announce: (ClassAdded new
  515. theClass: newClass;
  516. yourself).
  517. ^ newClass
  518. !
  519. copyClass: aClass to: anotherClass
  520. anotherClass comment: aClass comment.
  521. aClass methodDictionary valuesDo: [ :each |
  522. Compiler new install: each source forClass: anotherClass protocol: each protocol ].
  523. self basicClass: anotherClass class instanceVariables: aClass class instanceVariableNames.
  524. aClass class methodDictionary valuesDo: [ :each |
  525. Compiler new install: each source forClass: anotherClass class protocol: each protocol ].
  526. self setupClass: anotherClass
  527. ! !
  528. !ClassBuilder methodsFor: 'method definition'!
  529. installMethod: aCompiledMethod forClass: aBehavior protocol: aString
  530. aCompiledMethod protocol: aString.
  531. aBehavior addCompiledMethod: aCompiledMethod.
  532. self setupClass: aBehavior.
  533. ^ aCompiledMethod
  534. ! !
  535. !ClassBuilder methodsFor: 'private'!
  536. basicAddSubclassOf: aClass named: aString instanceVariableNames: aCollection package: packageName
  537. <
  538. smalltalk.addClass(aString, aClass, aCollection, packageName);
  539. return globals[aString]
  540. >
  541. !
  542. basicClass: aClass instanceVariableNames: aString
  543. self basicClass: aClass instanceVariables: (self instanceVariableNamesFor: aString)
  544. !
  545. basicClass: aClass instanceVariables: aCollection
  546. aClass isMetaclass ifFalse: [ self error: aClass name, ' is not a metaclass' ].
  547. aClass basicAt: 'iVarNames' put: aCollection
  548. !
  549. basicRemoveClass: aClass
  550. <smalltalk.removeClass(aClass)>
  551. !
  552. basicRenameClass: aClass to: aString
  553. <
  554. globals[aString] = aClass;
  555. delete globals[aClass.className];
  556. aClass.className = aString;
  557. >
  558. !
  559. basicSwapClassNames: aClass with: anotherClass
  560. <
  561. var tmp = aClass.className;
  562. aClass.className = anotherClass.className;
  563. anotherClass.className = tmp;
  564. >
  565. !
  566. rawRenameClass: aClass to: aString
  567. <
  568. globals[aString] = aClass;
  569. >
  570. ! !
  571. !ClassBuilder methodsFor: 'public'!
  572. setupClass: aClass
  573. <smalltalk.init(aClass);>
  574. ! !
  575. Object subclass: #ClassCategoryReader
  576. instanceVariableNames: 'class category'
  577. package: 'Kernel-Classes'!
  578. !ClassCategoryReader commentStamp!
  579. I provide a mechanism for retrieving class descriptions stored on a file in the Smalltalk chunk format.!
  580. !ClassCategoryReader methodsFor: 'accessing'!
  581. class: aClass category: aString
  582. class := aClass.
  583. category := aString
  584. ! !
  585. !ClassCategoryReader methodsFor: 'fileIn'!
  586. scanFrom: aChunkParser
  587. | chunk |
  588. [ chunk := aChunkParser nextChunk.
  589. chunk isEmpty ] whileFalse: [
  590. self compileMethod: chunk ].
  591. ClassBuilder new setupClass: class
  592. ! !
  593. !ClassCategoryReader methodsFor: 'initialization'!
  594. initialize
  595. super initialize.
  596. ! !
  597. !ClassCategoryReader methodsFor: 'private'!
  598. compileMethod: aString
  599. Compiler new install: aString forClass: class protocol: category
  600. ! !
  601. Object subclass: #ClassCommentReader
  602. instanceVariableNames: 'class'
  603. package: 'Kernel-Classes'!
  604. !ClassCommentReader commentStamp!
  605. I provide a mechanism for retrieving class comments stored on a file.
  606. See also `ClassCategoryReader`.!
  607. !ClassCommentReader methodsFor: 'accessing'!
  608. class: aClass
  609. class := aClass
  610. ! !
  611. !ClassCommentReader methodsFor: 'fileIn'!
  612. scanFrom: aChunkParser
  613. | chunk |
  614. chunk := aChunkParser nextChunk.
  615. chunk isEmpty ifFalse: [
  616. self setComment: chunk ].
  617. ! !
  618. !ClassCommentReader methodsFor: 'initialization'!
  619. initialize
  620. super initialize.
  621. ! !
  622. !ClassCommentReader methodsFor: 'private'!
  623. setComment: aString
  624. class comment: aString
  625. ! !
  626. Object subclass: #ClassSorterNode
  627. instanceVariableNames: 'theClass level nodes'
  628. package: 'Kernel-Classes'!
  629. !ClassSorterNode commentStamp!
  630. I provide an algorithm for sorting classes alphabetically.
  631. See [Issue #143](https://github.com/amber-smalltalk/amber/issues/143) on GitHub.!
  632. !ClassSorterNode methodsFor: 'accessing'!
  633. getNodesFrom: aCollection
  634. | children others |
  635. children := #().
  636. others := #().
  637. aCollection do: [ :each |
  638. (each superclass = self theClass)
  639. ifTrue: [ children add: each ]
  640. ifFalse: [ others add: each ]].
  641. nodes:= children collect: [ :each |
  642. ClassSorterNode on: each classes: others level: self level + 1 ]
  643. !
  644. level
  645. ^ level
  646. !
  647. level: anInteger
  648. level := anInteger
  649. !
  650. nodes
  651. ^ nodes
  652. !
  653. theClass
  654. ^ theClass
  655. !
  656. theClass: aClass
  657. theClass := aClass
  658. ! !
  659. !ClassSorterNode methodsFor: 'visiting'!
  660. traverseClassesWith: aCollection
  661. "sort classes alphabetically Issue #143"
  662. aCollection add: self theClass.
  663. (self nodes sorted: [ :a :b | a theClass name <= b theClass name ]) do: [ :aNode |
  664. aNode traverseClassesWith: aCollection ].
  665. ! !
  666. !ClassSorterNode class methodsFor: 'instance creation'!
  667. on: aClass classes: aCollection level: anInteger
  668. ^ self new
  669. theClass: aClass;
  670. level: anInteger;
  671. getNodesFrom: aCollection;
  672. yourself
  673. ! !