1
0

Kernel-Classes.st 19 KB

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