author | Claus Gittinger <cg@exept.de> |
Tue, 01 Dec 2009 23:11:48 +0100 | |
changeset 12578 | 6cb12eb8eb59 |
parent 12181 | 30fde7871edf |
child 12590 | 3a0b232a27fd |
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 |
|
63 |
^ self |
|
64 |
instancesDetect:[:each | each name = aString ] |
|
65 |
ifNone: [ self error: 'No language named ' , aString ]. |
|
66 |
||
67 |
" |
|
68 |
ProgrammingLanguage named: 'Smalltalk' |
|
69 |
||
70 |
ProgrammingLanguage named: 'Ruby'" |
|
71 |
||
72 |
"Created: / 15-08-2009 / 22:40:26 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
73 |
"Modified: / 16-08-2009 / 10:58:01 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
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 |
||
133 |
allDo: aBlock |
|
134 |
||
135 |
^self allSubclassesDo: |
|
136 |
[:each|aBlock value: each instance] |
|
137 |
||
138 |
"Created: / 16-08-2009 / 14:07:40 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
139 |
! ! |
|
140 |
||
141 |
!ProgrammingLanguage class methodsFor:'private'! |
|
142 |
||
143 |
instancesDetect: detectBlock ifNone: failBlock |
|
144 |
||
145 |
||
146 |
self allSubclasses |
|
147 |
do:[:cls|(detectBlock value: cls instance) ifTrue:[^cls instance]]. |
|
148 |
^failBlock value |
|
149 |
||
150 |
"Created: / 16-08-2009 / 10:57:32 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
151 |
! ! |
|
152 |
||
153 |
!ProgrammingLanguage class methodsFor:'testing'! |
|
154 |
||
155 |
isAvailable: langName |
|
156 |
||
157 |
self instancesDetect: [:lang|lang name = langName] ifNone: [^false]. |
|
158 |
^true |
|
159 |
||
160 |
" |
|
161 |
ProgrammingLanguage isAvailable: 'Smalltalk' |
|
162 |
ProgrammingLanguage isAvailable: 'Ruby' |
|
163 |
ProgrammingLanguage isAvailable: 'Haskell' |
|
164 |
" |
|
165 |
||
166 |
"Created: / 21-08-2009 / 12:56:32 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
167 |
! ! |
|
168 |
||
169 |
!ProgrammingLanguage methodsFor:'accessing'! |
|
170 |
||
171 |
name |
|
12099 | 172 |
"Answers a human-readable name of myself: |
11964 | 173 |
'Smalltalk' for SmalltalkLanguage, |
12099 | 174 |
'Ruby' for RubyLanguage |
175 |
... |
|
11964 | 176 |
" |
177 |
||
178 |
^ self subclassResponsibility |
|
179 |
||
180 |
"Created: / 15-08-2009 / 22:38:16 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
181 |
"Modified: / 16-08-2009 / 10:47:21 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
182 |
! |
|
183 |
||
184 |
sourceFileSuffix |
|
12099 | 185 |
"Answers a default suffix for source files, i.e. 'st' for Smalltalk, |
186 |
'js' for JavaScript or 'rb' for Ruby', etc." |
|
11964 | 187 |
|
188 |
^self subclassResponsibility |
|
189 |
||
190 |
"Created: / 16-08-2009 / 10:42:40 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
191 |
! ! |
|
192 |
||
193 |
!ProgrammingLanguage methodsFor:'accessing - classes'! |
|
194 |
||
195 |
compilerClass |
|
12099 | 196 |
"Answer a class suitable for compiling a source code in 'my' language" |
11964 | 197 |
|
198 |
^self subclassResponsibility |
|
199 |
||
200 |
"Created: / 21-08-2009 / 13:00:50 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
201 |
! |
|
202 |
||
12099 | 203 |
evaluatorClass |
204 |
"Answer a class suitable for evaluating a doIt in 'my' language" |
|
205 |
||
206 |
^ self compilerClass |
|
207 |
! |
|
11964 | 208 |
|
12099 | 209 |
explainerClass |
210 |
"Answers a class used by browser and debugger to |
|
211 |
show some hints about the code. It is OK to return |
|
212 |
nil, which means that there is no explainer for given |
|
213 |
language." |
|
11964 | 214 |
|
215 |
"return nil by default" |
|
216 |
^nil |
|
217 |
||
218 |
"Created: / 21-08-2009 / 08:49:13 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
219 |
! |
|
220 |
||
12099 | 221 |
formatterClass |
222 |
"Answer a class suitable for prettyPrinting (indenting) code in 'my' language. |
|
223 |
It is ok to return nil, which means that the browser will not be able to prettyprint." |
|
224 |
||
225 |
^ nil |
|
226 |
! |
|
227 |
||
11964 | 228 |
parserClass |
12099 | 229 |
"Answer a class suitable for parsing a source code in 'my' language" |
11964 | 230 |
|
231 |
^self subclassResponsibility |
|
232 |
||
233 |
"Created: / 21-08-2009 / 13:00:30 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
234 |
! |
|
235 |
||
236 |
sourceFileReaderClass |
|
12099 | 237 |
"Answers a class that can be used for reading & compiling source files" |
11964 | 238 |
|
239 |
^self subclassResponsibility |
|
240 |
||
241 |
"Created: / 16-08-2009 / 09:00:23 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
242 |
! |
|
243 |
||
244 |
sourceFileWriterClass |
|
12099 | 245 |
"Answers a class is used for source file writing (i.e. file-out)" |
11964 | 246 |
|
247 |
^self subclassResponsibility |
|
248 |
||
249 |
"Created: / 16-08-2009 / 09:40:19 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
12099 | 250 |
! |
251 |
||
252 |
syntaxHighlighterClass |
|
253 |
"Answers a class used by browser and debugger to colorze code. |
|
254 |
It is OK to return nil, which means that the code is shown as-is" |
|
255 |
||
256 |
"return nil by default" |
|
257 |
^nil |
|
11964 | 258 |
! ! |
259 |
||
260 |
!ProgrammingLanguage methodsFor:'printing & storing'! |
|
261 |
||
262 |
storeOn:aStream |
|
263 |
||
264 |
self class == ProgrammingLanguage |
|
265 |
ifTrue: |
|
266 |
[super storeOn:aStream] |
|
267 |
ifFalse: |
|
268 |
[aStream |
|
269 |
nextPutAll:'ProgrammingLanguage'; |
|
270 |
nextPutAll:' named: '; |
|
271 |
nextPutAll:self name storeString]. |
|
272 |
||
273 |
" |
|
274 |
ProgrammingLanguage instance storeString |
|
275 |
||
276 |
SmalltalkLanguage instance storeString |
|
277 |
" |
|
278 |
||
279 |
"Created: / 16-08-2009 / 10:52:28 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
280 |
! ! |
|
281 |
||
282 |
!ProgrammingLanguage methodsFor:'queries'! |
|
283 |
||
284 |
canReadSourceFile: aFilename |
|
12099 | 285 |
"Answers true iff file contains source code in 'my' language" |
11964 | 286 |
|
12099 | 287 |
"Trivial implementation here, to be overriden by subclasses" |
11964 | 288 |
|
289 |
^aFilename suffix = self sourceFileSuffix |
|
290 |
||
291 |
"Created: / 16-08-2009 / 10:10:33 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
292 |
! ! |
|
293 |
||
294 |
!ProgrammingLanguage methodsFor:'testing'! |
|
295 |
||
12151
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
296 |
isRuby |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
297 |
"true iff this is the ruby language" |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
298 |
|
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
299 |
^ false |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
300 |
! |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
301 |
|
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
302 |
isSTXJavaScript |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
303 |
"true iff this is the ST/X-javascript language" |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
304 |
|
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
305 |
^ false |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
306 |
! |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
307 |
|
11964 | 308 |
isSmalltalk |
12106 | 309 |
"true iff this is the smalltalk language" |
11964 | 310 |
|
12106 | 311 |
^ false |
11964 | 312 |
|
313 |
"Created: / 16-08-2009 / 09:01:27 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
314 |
! ! |
|
315 |
||
316 |
!ProgrammingLanguage methodsFor:'utilities - file in/file out'! |
|
317 |
||
318 |
fileIn: aFilename |
|
319 |
||
320 |
^self sourceFileReaderClass fileIn: aFilename |
|
321 |
||
322 |
"Created: / 16-08-2009 / 13:28:17 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
323 |
! |
|
324 |
||
325 |
fileInStream: aStream |
|
326 |
||
327 |
^self sourceFileReaderClass fileInStream: aStream |
|
328 |
||
329 |
"Created: / 16-08-2009 / 11:05:46 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
330 |
! ! |
|
331 |
||
332 |
!ProgrammingLanguage methodsFor:'utilities - source code'! |
|
333 |
||
12151
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
334 |
methodTemplate |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
335 |
"return a method definition template string (or nil)" |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
336 |
|
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
337 |
^ nil |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
338 |
! |
6f4f339cfa56
more stuff via programmingLanguage
Claus Gittinger <cg@exept.de>
parents:
12106
diff
changeset
|
339 |
|
12106 | 340 |
writeComment:aStringOrStringCollection on:aStream |
12099 | 341 |
"Utility method - writes a comment to a stream, |
342 |
using proper syntax" |
|
11964 | 343 |
|
12099 | 344 |
^ self sourceFileWriterClass new |
345 |
fileOutComment: aStringOrStringCollection |
|
11964 | 346 |
on: aStream |
347 |
||
348 |
"Created: / 21-08-2009 / 09:35:07 / Jan Vrany <vranyj1@fel.cvut.cz>" |
|
349 |
! ! |
|
350 |
||
351 |
!ProgrammingLanguage class methodsFor:'documentation'! |
|
352 |
||
353 |
version |
|
12181
30fde7871edf
update #version_SVN with § as keyword expansion character
fm
parents:
12151
diff
changeset
|
354 |
^ '$Header: /cvs/stx/stx/libbasic/ProgrammingLanguage.st,v 1.9 2009-10-08 12:00:30 fm Exp $' |
12048 | 355 |
! |
356 |
||
357 |
version_CVS |
|
12181
30fde7871edf
update #version_SVN with § as keyword expansion character
fm
parents:
12151
diff
changeset
|
358 |
^ '$Header: /cvs/stx/stx/libbasic/ProgrammingLanguage.st,v 1.9 2009-10-08 12:00:30 fm Exp $' |
12048 | 359 |
! |
360 |
||
361 |
version_SVN |
|
12181
30fde7871edf
update #version_SVN with § as keyword expansion character
fm
parents:
12151
diff
changeset
|
362 |
^'§Id: ProgrammingLanguage.st 10468 2009-08-22 08:34:50Z vranyj1 §' |
11964 | 363 |
! ! |
364 |
||
365 |
ProgrammingLanguage initialize! |