author | Claus Gittinger <cg@exept.de> |
Sun, 30 Jan 2011 10:06:33 +0100 | |
changeset 13256 | 9c32fe18a2ae |
parent 13250 | 3cad632753a7 |
child 13425 | 352177aa4eb1 |
permissions | -rw-r--r-- |
11964 | 1 |
"{ Package: 'stx:libbasic' }" |
2 |
||
3 |
Object subclass:#ProgrammingLanguage |
|
4 |
instanceVariableNames:'' |
|
5 |
classVariableNames:'LanguageQuerySignal' |
|
6 |
poolDictionaries:'' |
|
7 |
category:'Kernel-Languages' |
|
8 |
! |
|
9 |
||
10 |
ProgrammingLanguage class instanceVariableNames:'Instance' |
|
11 |
||
12 |
" |
|
13 |
No other class instance variables are inherited by this class. |
|
14 |
" |
|
15 |
! |
|
16 |
||
12101 | 17 |
!ProgrammingLanguage class methodsFor:'documentation'! |
18 |
||
19 |
documentation |
|
20 |
" |
|
21 |
provide info about which tools are to be used for code in |
|
22 |
a programming language |
|
23 |
" |
|
24 |
! ! |
|
11964 | 25 |
|
26 |
!ProgrammingLanguage class methodsFor:'initialization'! |
|
27 |
||
28 |
initialize |
|
29 |
||
30 |
LanguageQuerySignal := |
|
31 |
QuerySignal new |
|
32 |
nameClass:self message:#languageQuerySignal; |
|
33 |
notifierString:'asking for current language'; |
|
34 |
handlerBlock:[:ex | ex proceedWith:SmalltalkLanguage instance]. |
|
35 |
||
36 |
"Created: / 12-08-2009 / 14:56:11 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
37 |
"Modified: / 16-08-2009 / 10:36:11 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
38 |
! ! |
|
39 |
||
40 |
!ProgrammingLanguage class methodsFor:'instance creation'! |
|
41 |
||
42 |
forFile: aFilename |
|
12099 | 43 |
"Answers a language for given source file. If none is found, |
11964 | 44 |
SmalltalkLanguage is returned (to provide backward compatibility)" |
45 |
||
46 |
^ self instancesDetect: [:each | each canReadSourceFile: aFilename ] |
|
47 |
ifNone: [ SmalltalkLanguage instance ] |
|
48 |
||
49 |
"Created: / 16-08-2009 / 10:08:44 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
50 |
! |
|
51 |
||
52 |
forStream: aStream |
|
12099 | 53 |
"Answers a language for given source stream. If none is found, |
11964 | 54 |
SmalltalkLanguage is returned (to provide backward compatibility)" |
55 |
||
56 |
aStream isFileStream ifFalse: [ ^ SmalltalkLanguage instance ]. |
|
57 |
^ self forFile: aStream fileName |
|
58 |
||
59 |
"Created: / 16-08-2009 / 10:56:26 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
60 |
! |
|
61 |
||
62 |
named: aString |
|
12990 | 63 |
^ self named:aString ifNone:[ self error: 'No language named ' , aString ]. |
11964 | 64 |
|
65 |
" |
|
12989 | 66 |
ProgrammingLanguage named: 'Smalltalk' |
67 |
ProgrammingLanguage named: 'JavaScript' |
|
68 |
ProgrammingLanguage named: 'Ruby' |
|
69 |
" |
|
11964 | 70 |
|
71 |
"Created: / 15-08-2009 / 22:40:26 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
72 |
"Modified: / 16-08-2009 / 10:58:01 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
12990 | 73 |
"Modified: / 04-08-2010 / 12:06:38 / cg" |
11964 | 74 |
! |
75 |
||
76 |
named: aString ifNone: aBlock |
|
77 |
^ self |
|
78 |
instancesDetect:[:each | each name = aString ] |
|
79 |
ifNone: aBlock |
|
80 |
||
81 |
"Created: / 21-08-2009 / 13:07:10 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
82 |
! ! |
|
83 |
||
84 |
!ProgrammingLanguage class methodsFor:'Signal constants'! |
|
85 |
||
86 |
languageQuerySignal |
|
87 |
||
88 |
^LanguageQuerySignal |
|
89 |
||
90 |
"Created: / 12-08-2009 / 14:57:07 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
91 |
! ! |
|
92 |
||
93 |
!ProgrammingLanguage class methodsFor:'accessing'! |
|
94 |
||
95 |
all |
|
96 |
" |
|
97 |
Anwers a collection of all available languages |
|
98 |
" |
|
99 |
||
100 |
^self allSubclasses collect:[:each|each instance] |
|
101 |
||
102 |
||
103 |
" |
|
12099 | 104 |
ProgrammingLanguage all |
11964 | 105 |
" |
106 |
||
107 |
"Created: / 16-08-2009 / 13:43:41 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
108 |
! |
|
109 |
||
110 |
current |
|
111 |
||
112 |
" |
|
12099 | 113 |
ProgrammingLanguage current |
11964 | 114 |
" |
115 |
||
116 |
||
117 |
^LanguageQuerySignal query |
|
118 |
||
119 |
"Created: / 12-08-2009 / 15:02:59 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
120 |
! |
|
121 |
||
122 |
instance |
|
12099 | 123 |
"return this languages singleton" |
11964 | 124 |
|
125 |
Instance ifNil:[Instance := self new]. |
|
126 |
^Instance |
|
127 |
||
128 |
"Created: / 16-08-2009 / 10:36:37 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
129 |
! ! |
|
130 |
||
131 |
!ProgrammingLanguage class methodsFor:'enumerating'! |
|
132 |
||
12590 | 133 |
allDetect:aBlock ifNone:exceptionValue |
134 |
self allDo:[:each | (aBlock value:each) ifTrue:[^ each]]. |
|
135 |
^ exceptionValue value |
|
136 |
! |
|
11964 | 137 |
|
12590 | 138 |
allDo: aBlock |
139 |
^ self allSubclassesDo: [:each | aBlock value: each instance] |
|
11964 | 140 |
|
141 |
"Created: / 16-08-2009 / 14:07:40 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
142 |
! ! |
|
143 |
||
144 |
!ProgrammingLanguage class methodsFor:'private'! |
|
145 |
||
146 |
instancesDetect: detectBlock ifNone: failBlock |
|
147 |
||
148 |
||
149 |
self allSubclasses |
|
150 |
do:[:cls|(detectBlock value: cls instance) ifTrue:[^cls instance]]. |
|
151 |
^failBlock value |
|
152 |
||
153 |
"Created: / 16-08-2009 / 10:57:32 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
154 |
! ! |
|
155 |
||
156 |
!ProgrammingLanguage class methodsFor:'testing'! |
|
157 |
||
158 |
isAvailable: langName |
|
159 |
||
160 |
self instancesDetect: [:lang|lang name = langName] ifNone: [^false]. |
|
161 |
^true |
|
162 |
||
163 |
" |
|
164 |
ProgrammingLanguage isAvailable: 'Smalltalk' |
|
165 |
ProgrammingLanguage isAvailable: 'Ruby' |
|
166 |
ProgrammingLanguage isAvailable: 'Haskell' |
|
167 |
" |
|
168 |
||
169 |
"Created: / 21-08-2009 / 12:56:32 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
170 |
! ! |
|
171 |
||
172 |
!ProgrammingLanguage methodsFor:'accessing'! |
|
173 |
||
174 |
name |
|
12099 | 175 |
"Answers a human-readable name of myself: |
11964 | 176 |
'Smalltalk' for SmalltalkLanguage, |
12099 | 177 |
'Ruby' for RubyLanguage |
178 |
... |
|
11964 | 179 |
" |
180 |
||
181 |
^ self subclassResponsibility |
|
182 |
||
183 |
"Created: / 15-08-2009 / 22:38:16 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
184 |
"Modified: / 16-08-2009 / 10:47:21 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
185 |
! |
|
186 |
||
187 |
sourceFileSuffix |
|
12099 | 188 |
"Answers a default suffix for source files, i.e. 'st' for Smalltalk, |
189 |
'js' for JavaScript or 'rb' for Ruby', etc." |
|
11964 | 190 |
|
191 |
^self subclassResponsibility |
|
192 |
||
193 |
"Created: / 16-08-2009 / 10:42:40 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
194 |
! ! |
|
195 |
||
196 |
!ProgrammingLanguage methodsFor:'accessing - classes'! |
|
197 |
||
13250 | 198 |
codeGeneratorClass |
199 |
"Answer a class suitable for generating code (such as getters, setters, etc.) |
|
200 |
It is ok to return nil, which means that no code can be generated automagically" |
|
201 |
||
202 |
^ nil |
|
203 |
! |
|
204 |
||
11964 | 205 |
compilerClass |
12099 | 206 |
"Answer a class suitable for compiling a source code in 'my' language" |
11964 | 207 |
|
208 |
^self subclassResponsibility |
|
209 |
||
210 |
"Created: / 21-08-2009 / 13:00:50 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
211 |
! |
|
212 |
||
12099 | 213 |
evaluatorClass |
214 |
"Answer a class suitable for evaluating a doIt in 'my' language" |
|
215 |
||
216 |
^ self compilerClass |
|
217 |
! |
|
11964 | 218 |
|
12099 | 219 |
explainerClass |
220 |
"Answers a class used by browser and debugger to |
|
221 |
show some hints about the code. It is OK to return |
|
222 |
nil, which means that there is no explainer for given |
|
223 |
language." |
|
11964 | 224 |
|
225 |
"return nil by default" |
|
226 |
^nil |
|
227 |
||
228 |
"Created: / 21-08-2009 / 08:49:13 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
229 |
! |
|
230 |
||
12099 | 231 |
formatterClass |
232 |
"Answer a class suitable for prettyPrinting (indenting) code in 'my' language. |
|
233 |
It is ok to return nil, which means that the browser will not be able to prettyprint." |
|
234 |
||
235 |
^ nil |
|
236 |
! |
|
237 |
||
13256 | 238 |
metaClass |
239 |
"will be used for new classes (in the class wizard); |
|
240 |
a fallback here" |
|
241 |
||
242 |
^ Metaclass |
|
243 |
||
244 |
"Created: / 30-01-2011 / 10:05:03 / cg" |
|
245 |
! |
|
246 |
||
11964 | 247 |
parserClass |
12099 | 248 |
"Answer a class suitable for parsing a source code in 'my' language" |
11964 | 249 |
|
250 |
^self subclassResponsibility |
|
251 |
||
252 |
"Created: / 21-08-2009 / 13:00:30 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
253 |
! |
|
254 |
||
255 |
sourceFileReaderClass |
|
12099 | 256 |
"Answers a class that can be used for reading & compiling source files" |
11964 | 257 |
|
258 |
^self subclassResponsibility |
|
259 |
||
260 |
"Created: / 16-08-2009 / 09:00:23 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
261 |
! |
|
262 |
||
263 |
sourceFileWriterClass |
|
12099 | 264 |
"Answers a class is used for source file writing (i.e. file-out)" |
11964 | 265 |
|
266 |
^self subclassResponsibility |
|
267 |
||
268 |
"Created: / 16-08-2009 / 09:40:19 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
12099 | 269 |
! |
270 |
||
271 |
syntaxHighlighterClass |
|
272 |
"Answers a class used by browser and debugger to colorze code. |
|
273 |
It is OK to return nil, which means that the code is shown as-is" |
|
274 |
||
275 |
"return nil by default" |
|
276 |
^nil |
|
11964 | 277 |
! ! |
278 |
||
279 |
!ProgrammingLanguage methodsFor:'printing & storing'! |
|
280 |
||
281 |
storeOn:aStream |
|
282 |
||
283 |
self class == ProgrammingLanguage |
|
284 |
ifTrue: |
|
285 |
[super storeOn:aStream] |
|
286 |
ifFalse: |
|
287 |
[aStream |
|
288 |
nextPutAll:'ProgrammingLanguage'; |
|
289 |
nextPutAll:' named: '; |
|
290 |
nextPutAll:self name storeString]. |
|
291 |
||
292 |
" |
|
293 |
ProgrammingLanguage instance storeString |
|
294 |
||
295 |
SmalltalkLanguage instance storeString |
|
296 |
" |
|
297 |
||
298 |
"Created: / 16-08-2009 / 10:52:28 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
299 |
! ! |
|
300 |
||
301 |
!ProgrammingLanguage methodsFor:'queries'! |
|
302 |
||
303 |
canReadSourceFile: aFilename |
|
12099 | 304 |
"Answers true iff file contains source code in 'my' language" |
11964 | 305 |
|
12099 | 306 |
"Trivial implementation here, to be overriden by subclasses" |
11964 | 307 |
|
308 |
^aFilename suffix = self sourceFileSuffix |
|
309 |
||
310 |
"Created: / 16-08-2009 / 10:10:33 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
311 |
! ! |
|
312 |
||
313 |
!ProgrammingLanguage methodsFor:'testing'! |
|
314 |
||
12151
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
315 |
isRuby |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
316 |
"true iff this is the ruby language" |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
317 |
|
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
318 |
^ false |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
319 |
! |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
320 |
|
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
321 |
isSTXJavaScript |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
322 |
"true iff this is the ST/X-javascript language" |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
323 |
|
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
324 |
^ false |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
325 |
! |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
326 |
|
11964 | 327 |
isSmalltalk |
12106 | 328 |
"true iff this is the smalltalk language" |
11964 | 329 |
|
12106 | 330 |
^ false |
11964 | 331 |
|
332 |
"Created: / 16-08-2009 / 09:01:27 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
333 |
! ! |
|
334 |
||
335 |
!ProgrammingLanguage methodsFor:'utilities - file in/file out'! |
|
336 |
||
337 |
fileIn: aFilename |
|
338 |
||
339 |
^self sourceFileReaderClass fileIn: aFilename |
|
340 |
||
341 |
"Created: / 16-08-2009 / 13:28:17 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
342 |
! |
|
343 |
||
344 |
fileInStream: aStream |
|
345 |
||
346 |
^self sourceFileReaderClass fileInStream: aStream |
|
347 |
||
348 |
"Created: / 16-08-2009 / 11:05:46 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
349 |
! ! |
|
350 |
||
351 |
!ProgrammingLanguage methodsFor:'utilities - source code'! |
|
352 |
||
12151
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
353 |
methodTemplate |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
354 |
"return a method definition template string (or nil)" |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
355 |
|
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
356 |
^ nil |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
357 |
! |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
358 |
|
12106 | 359 |
writeComment:aStringOrStringCollection on:aStream |
12099 | 360 |
"Utility method - writes a comment to a stream, |
361 |
using proper syntax" |
|
11964 | 362 |
|
12099 | 363 |
^ self sourceFileWriterClass new |
364 |
fileOutComment: aStringOrStringCollection |
|
11964 | 365 |
on: aStream |
366 |
||
367 |
"Created: / 21-08-2009 / 09:35:07 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
368 |
! ! |
|
369 |
||
370 |
!ProgrammingLanguage class methodsFor:'documentation'! |
|
371 |
||
372 |
version |
|
13256 | 373 |
^ '$Header: /cvs/stx/stx/libbasic/ProgrammingLanguage.st,v 1.14 2011-01-30 09:06:33 cg Exp $' |
12048 | 374 |
! |
375 |
||
376 |
version_CVS |
|
13256 | 377 |
^ '$Header: /cvs/stx/stx/libbasic/ProgrammingLanguage.st,v 1.14 2011-01-30 09:06:33 cg Exp $' |
12048 | 378 |
! |
379 |
||
380 |
version_SVN |
|
12181
30fde7871edf
update #version_SVN with § as keyword expansion character
fm
parents:
12151
diff
changeset
|
381 |
^'§Id: ProgrammingLanguage.st 10468 2009-08-22 08:34:50Z vranyj1 §' |
11964 | 382 |
! ! |
383 |
||
384 |
ProgrammingLanguage initialize! |