author | Jan Vrany <jan.vrany@fit.cvut.cz> |
Wed, 23 Oct 2013 12:49:35 +0200 | |
changeset 215 | b6e13772ac08 |
parent 163 | b8a6ee98534a |
child 218 | 82447e847e2d |
permissions | -rw-r--r-- |
69 | 1 |
"{ Package: 'stx:goodies/builder/reports' }" |
2 |
||
3 |
"{ NameSpace: Builder }" |
|
4 |
||
5 |
Object subclass:#Report |
|
149
3f9e255e7d47
class: Builder::ReportRunner
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
142
diff
changeset
|
6 |
instanceVariableNames:'name packages format' |
69 | 7 |
classVariableNames:'Verbose OutputDir' |
8 |
poolDictionaries:'' |
|
9 |
category:'Builder-Reports' |
|
10 |
! |
|
11 |
||
12 |
||
13 |
!Report class methodsFor:'initialization'! |
|
14 |
||
15 |
initialize |
|
16 |
||
17 |
Verbose := false. |
|
18 |
OutputDir := Filename currentDirectory. |
|
19 |
||
20 |
"Created: / 14-03-2011 / 19:42:03 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
21 |
! ! |
|
22 |
||
23 |
!Report class methodsFor:'instance creation'! |
|
24 |
||
25 |
new |
|
26 |
"return an initialized instance" |
|
27 |
||
28 |
^ self basicNew initialize. |
|
29 |
! ! |
|
30 |
||
31 |
!Report class methodsFor:'accessing'! |
|
32 |
||
76 | 33 |
available |
34 |
"Return all available reports ready to run. |
|
35 |
Unfinished/Experimental reports are not returned" |
|
36 |
||
37 |
^{ |
|
38 |
Builder::TestReport . |
|
39 |
Builder::LintReport . |
|
40 |
} |
|
41 |
||
42 |
"Created: / 13-01-2012 / 12:01:26 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
43 |
! |
|
44 |
||
69 | 45 |
outputDir |
46 |
||
47 |
^OutputDir ? '.' |
|
48 |
||
49 |
" |
|
50 |
Report outputDir: '/tmp/reports' |
|
51 |
" |
|
52 |
||
53 |
"Created: / 07-10-2011 / 09:12:23 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
54 |
! |
|
55 |
||
56 |
outputDir: aStringOrFilename |
|
57 |
||
58 |
OutputDir := aStringOrFilename asFilename. |
|
59 |
||
60 |
" |
|
61 |
Report outputDir: '/tmp/reports' |
|
62 |
" |
|
63 |
||
64 |
"Created: / 14-03-2011 / 19:40:25 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
65 |
! ! |
|
66 |
||
67 |
!Report class methodsFor:'private'! |
|
68 |
||
69 |
convert: aString |
|
70 |
^ (aString asString |
|
71 |
copyReplaceAll: (String with: Character cr with: Character lf) with: (String with: Character lf)) |
|
72 |
copyReplaceAll: (String with: Character cr) with: (String with: Character lf) |
|
73 |
! |
|
74 |
||
75 |
encode: aString |
|
76 |
||
77 |
| in out c | |
|
78 |
||
79 |
(aString includesAny: #($< $> $& $")) ifFalse:[^aString]. |
|
80 |
in := aString readStream. |
|
81 |
out := String new writeStream. |
|
82 |
[in atEnd ] whileFalse:[ |
|
83 |
c := in next. |
|
84 |
c == $< ifTrue:[out nextPutAll:'<'] ifFalse:[ |
|
85 |
c == $> ifTrue:[out nextPutAll:'>'] ifFalse:[ |
|
86 |
c == $& ifTrue:[out nextPutAll:'&'] ifFalse:[ |
|
87 |
c == $" ifTrue:[out nextPutAll:'"'] ifFalse:[ |
|
88 |
out nextPut: c]]]]]. |
|
89 |
^out contents. |
|
90 |
||
91 |
" |
|
92 |
HDReport basicNew encode: 'abx' |
|
93 |
HDReport basicNew encode: '' |
|
94 |
HDReport basicNew encode: 'sss <clint>()' |
|
95 |
" |
|
96 |
||
97 |
"Modified: / 11-03-2011 / 17:12:17 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
98 |
! |
|
99 |
||
100 |
encodeFilename: aString |
|
101 |
||
102 |
^(aString copyReplaceAll: $: with:$_) copyReplaceAll: $/ with:$_ |
|
103 |
||
104 |
"Created: / 14-03-2011 / 14:14:43 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
105 |
"Modified: / 14-03-2011 / 23:45:40 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
106 |
! ! |
|
107 |
||
108 |
!Report class methodsFor:'running'! |
|
109 |
||
110 |
runClasses: aCollectionOfClasses |
|
111 |
||
112 |
^self runClasses: aCollectionOfClasses named: 'Some classes' |
|
113 |
||
114 |
"Created: / 04-08-2011 / 12:25:15 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
115 |
! |
|
116 |
||
117 |
runClasses: aCollectionOfClasses named: aString |
|
118 |
||
119 |
^self new runClasses: aCollectionOfClasses named: aString |
|
120 |
||
121 |
"Modified: / 04-08-2011 / 12:23:26 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
122 |
! |
|
123 |
||
124 |
runPackage: aString |
|
125 |
||
126 |
"Run a report for given package (package id)" |
|
127 |
||
128 |
^self runPackages: (Array with: aString) |
|
129 |
||
130 |
"Modified (comment): / 04-08-2011 / 12:24:59 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
131 |
! |
|
132 |
||
133 |
runPackages: packages |
|
134 |
||
135 |
"Run a report for given list of packages |
|
136 |
(package IDs)" |
|
137 |
||
138 |
^self new runPackages: packages |
|
139 |
||
140 |
"Modified (comment): / 04-08-2011 / 12:24:28 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
141 |
! |
|
142 |
||
143 |
verbose |
|
144 |
||
145 |
^ Verbose |
|
146 |
||
147 |
"Created: / 21-07-2011 / 11:48:13 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
148 |
! |
|
149 |
||
150 |
verbose: aBoolean |
|
151 |
||
152 |
Verbose := aBoolean. |
|
153 |
||
154 |
"Created: / 21-07-2011 / 11:48:02 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
155 |
! ! |
|
156 |
||
157 |
!Report methodsFor:'accessing'! |
|
158 |
||
159 |
format |
|
160 |
^ format |
|
161 |
! |
|
162 |
||
163 |
format: aFormatOrString |
|
164 |
||
165 |
aFormatOrString isString ifTrue:[ |
|
166 |
format := ReportFormat named: aFormatOrString |
|
167 |
] ifFalse:[ |
|
168 |
format := aFormatOrString |
|
169 |
] |
|
170 |
||
171 |
"Created: / 04-08-2011 / 11:55:46 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
172 |
! |
|
173 |
||
174 |
name |
|
175 |
||
176 |
^name isNil ifTrue:[ |
|
177 |
self defaultName |
|
178 |
] ifFalse:[ |
|
179 |
name |
|
180 |
] |
|
181 |
||
182 |
"Modified: / 07-11-2011 / 09:47:56 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
183 |
! |
|
184 |
||
185 |
name:aString |
|
186 |
name := aString. |
|
187 |
! |
|
188 |
||
189 |
outputDirectory |
|
190 |
||
191 |
^self class outputDir asFilename |
|
192 |
||
193 |
"Created: / 07-10-2011 / 09:12:49 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
194 |
! ! |
|
195 |
||
196 |
!Report methodsFor:'accessing-command line options'! |
|
197 |
||
198 |
cmdlineOptionFormat |
|
199 |
||
200 |
^CmdLineOption new |
|
201 |
short: $F; |
|
163
b8a6ee98534a
Initial version of code coverage report.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
149
diff
changeset
|
202 |
long: 'format'; |
69 | 203 |
description: 'Report format to use'; |
204 |
action:[:option | self format: option ] |
|
205 |
||
206 |
"Created: / 06-11-2011 / 21:49:12 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
163
b8a6ee98534a
Initial version of code coverage report.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
149
diff
changeset
|
207 |
"Modified: / 25-06-2013 / 16:02:49 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
69 | 208 |
! |
209 |
||
210 |
cmdlineOptionPackage |
|
211 |
||
212 |
^CmdLineOption new |
|
213 |
short: $p; |
|
163
b8a6ee98534a
Initial version of code coverage report.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
149
diff
changeset
|
214 |
long: 'package'; |
69 | 215 |
description: 'Package in which to run the report'; |
81
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
216 |
action:[:option | |
149
3f9e255e7d47
class: Builder::ReportRunner
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
142
diff
changeset
|
217 |
packages isNil ifTrue:[ packages := Set new ]. |
3f9e255e7d47
class: Builder::ReportRunner
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
142
diff
changeset
|
218 |
packages add: option. |
81
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
219 |
] |
69 | 220 |
|
221 |
"Created: / 06-11-2011 / 21:49:49 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
163
b8a6ee98534a
Initial version of code coverage report.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
149
diff
changeset
|
222 |
"Modified: / 25-06-2013 / 16:02:55 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
69 | 223 |
! ! |
224 |
||
225 |
!Report methodsFor:'accessing-defaults'! |
|
226 |
||
227 |
defaultFileSuffix |
|
228 |
||
229 |
"Return a default filename suffix. Note that format suffix will be |
|
230 |
appended too if not file is explicitely specified" |
|
231 |
||
232 |
^self subclassResponsibility |
|
233 |
||
234 |
"Created: / 04-08-2011 / 12:47:05 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
235 |
! |
|
236 |
||
237 |
defaultFormat |
|
238 |
"raise an error: must be redefined in concrete subclass(es)" |
|
239 |
||
240 |
^ self subclassResponsibility |
|
241 |
! |
|
242 |
||
243 |
defaultName |
|
244 |
||
245 |
^self class name |
|
246 |
||
247 |
"Created: / 07-11-2011 / 09:47:21 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
248 |
! ! |
|
249 |
||
250 |
!Report methodsFor:'initialization'! |
|
251 |
||
252 |
setupForClasses: classes |
|
253 |
"raise an error: must be redefined in concrete subclass(es)" |
|
254 |
||
255 |
^ self subclassResponsibility |
|
256 |
||
257 |
"Created: / 04-08-2011 / 14:34:31 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
258 |
! |
|
259 |
||
163
b8a6ee98534a
Initial version of code coverage report.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
149
diff
changeset
|
260 |
setupForPackages:pkgs |
69 | 261 |
"raise an error: must be redefined in concrete subclass(es)" |
262 |
||
263 |
^ self subclassResponsibility |
|
264 |
! ! |
|
265 |
||
266 |
!Report methodsFor:'private'! |
|
267 |
||
268 |
convert:arg |
|
269 |
^ self class convert:arg |
|
270 |
! |
|
271 |
||
272 |
encode:arg |
|
273 |
^ self class encode:arg |
|
274 |
! |
|
275 |
||
276 |
encodeFilename:arg |
|
277 |
^ self class encodeFilename:arg |
|
81
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
278 |
! |
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
279 |
|
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
280 |
loadPackageIfNotAlready: pkg |
142 | 281 |
"Loads a package, if it is not loaded already. |
282 |
Raises an error if package cannot be loaded" |
|
81
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
283 |
|
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
284 |
| def | |
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
285 |
def := ProjectDefinition definitionClassForPackage:pkg. |
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
286 |
def isNil ifTrue:[ |
142 | 287 |
(Smalltalk loadPackage:pkg) ifFalse:[ |
81
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
288 |
self error:'Cannot load package: ', pkg. |
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
289 |
]. |
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
290 |
def := ProjectDefinition definitionClassForPackage:pkg. |
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
291 |
]. |
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
292 |
def isNil ifTrue:[ |
142 | 293 |
self error:'Package loaded but project definition not found: ', pkg. |
81
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
294 |
]. |
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
295 |
|
a433f1944dca
Loads the package if not already loaded.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
76
diff
changeset
|
296 |
"Created: / 13-01-2012 / 12:56:48 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
69 | 297 |
! ! |
298 |
||
299 |
!Report methodsFor:'running'! |
|
300 |
||
301 |
run |
|
302 |
||
303 |
self setUp. |
|
304 |
format writeHeader. |
|
305 |
[ self runReport ] ensure:[ |
|
306 |
format writeFooter. |
|
307 |
self tearDown. |
|
308 |
] |
|
309 |
||
310 |
"Modified: / 04-08-2011 / 12:42:32 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
311 |
! |
|
312 |
||
313 |
runClasses:classes named:aString |
|
314 |
name := aString. |
|
315 |
self setupForClasses:classes. |
|
316 |
self run |
|
317 |
||
318 |
"Modified: / 04-08-2011 / 14:34:41 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
319 |
! |
|
320 |
||
321 |
runPackage: package |
|
322 |
||
323 |
^self runPackages: (Array with: package) |
|
324 |
||
325 |
"Created: / 04-08-2011 / 12:53:58 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
326 |
! |
|
327 |
||
163
b8a6ee98534a
Initial version of code coverage report.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
149
diff
changeset
|
328 |
runPackages:pkgs |
b8a6ee98534a
Initial version of code coverage report.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
149
diff
changeset
|
329 |
pkgs size == 1 |
b8a6ee98534a
Initial version of code coverage report.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
149
diff
changeset
|
330 |
ifTrue:[ name := pkgs anyOne. ] |
b8a6ee98534a
Initial version of code coverage report.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
149
diff
changeset
|
331 |
ifFalse:[ name := ('%1 packages' bindWith:pkgs size). ]. |
b8a6ee98534a
Initial version of code coverage report.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
149
diff
changeset
|
332 |
packages := pkgs. |
69 | 333 |
^ self run |
334 |
||
335 |
" |
|
336 |
HDTestReport runPackage:'stx:goodies/monticello' |
|
337 |
HDTestReport runPackage:'stx:libjava'" |
|
163
b8a6ee98534a
Initial version of code coverage report.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
149
diff
changeset
|
338 |
|
69 | 339 |
"Created: / 04-08-2011 / 12:35:32 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
163
b8a6ee98534a
Initial version of code coverage report.
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
149
diff
changeset
|
340 |
"Modified: / 25-06-2013 / 01:03:51 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
69 | 341 |
! |
342 |
||
343 |
runReport |
|
344 |
"Actually run the report. What to do (what classes/packages to check) |
|
345 |
must be stored instance variables" |
|
346 |
||
347 |
^ self subclassResponsibility |
|
348 |
||
349 |
"Created: / 04-08-2011 / 12:39:43 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
350 |
! |
|
351 |
||
352 |
setUp |
|
353 |
||
354 |
| stream | |
|
149
3f9e255e7d47
class: Builder::ReportRunner
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
142
diff
changeset
|
355 |
|
3f9e255e7d47
class: Builder::ReportRunner
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
142
diff
changeset
|
356 |
packages notNil ifTrue:[ |
3f9e255e7d47
class: Builder::ReportRunner
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
142
diff
changeset
|
357 |
packages do:[:pkg| self loadPackageIfNotAlready: pkg]. |
3f9e255e7d47
class: Builder::ReportRunner
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
142
diff
changeset
|
358 |
self setupForPackages: packages. |
3f9e255e7d47
class: Builder::ReportRunner
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
142
diff
changeset
|
359 |
packages := nil. |
3f9e255e7d47
class: Builder::ReportRunner
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
142
diff
changeset
|
360 |
]. |
69 | 361 |
format isNil ifTrue:[format := self defaultFormat]. |
362 |
stream := (OutputDir / (self encodeFilename: ('%1-%2.%3' bindWith: self name with: self defaultFileSuffix with: format defaultFileSuffix))) writeStream. |
|
363 |
format report: self stream: stream |
|
364 |
||
365 |
"Created: / 04-08-2011 / 12:43:32 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
149
3f9e255e7d47
class: Builder::ReportRunner
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
142
diff
changeset
|
366 |
"Modified: / 15-05-2013 / 19:03:06 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
69 | 367 |
! |
368 |
||
369 |
tearDown |
|
370 |
||
371 |
format streamFlush; streamClose. |
|
372 |
||
373 |
"Created: / 04-08-2011 / 12:43:40 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
374 |
! ! |
|
375 |
||
376 |
!Report class methodsFor:'documentation'! |
|
377 |
||
378 |
version |
|
379 |
^ '$Header$' |
|
380 |
! |
|
381 |
||
382 |
version_CVS |
|
383 |
^ '$Header$' |
|
384 |
! |
|
385 |
||
386 |
version_SVN |
|
149
3f9e255e7d47
class: Builder::ReportRunner
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
142
diff
changeset
|
387 |
^ '$Id$' |
69 | 388 |
! ! |
389 |
||
142 | 390 |
|
69 | 391 |
Report initialize! |