14 var x = new JSON.Packer(target, debugTarget);
16 x.files = an array of files
17 x.srcfiles = array of files (that list other files...) << not supported?
18 x.target = "output.pathname.js"
19 x.debugTarget = "output.pathname.debug.js"
23 x.pack(); // writes files etc..
27 * Notes for improving compacting:
28 * if you add a jsdoc comment
35 * directly before an eval statement, it will compress all the code around the eval,
36 * and not rename the variables 'avarname'
38 * Dont try running this on a merged uncompressed large file - it's used to be horrifically slow. not sure about now..
39 * Best to use lot's of small classes, and use it to merge, as it will cache the compaction
43 * Notes for translation
44 * - translation relies on you using double quotes for strings if they need translating
45 * - single quoted strings are ignored.
47 * Generation of indexFiles
48 * - translateIndex = the indexfile
57 public errordomain PackerError {
62 public class Packer : Object
65 * @cfg {String} target to write files to - must be full path.
68 GLib.FileOutputStream targetStream = null;
70 * @cfg {String} debugTarget target to write files debug version to (uncompacted)- must be full path.
72 string targetDebug = "";
75 GLib.FileOutputStream targetDebugStream = null;
77 * @cfg {String} tmpDir (optional) where to put the temporary files.
78 * if you set this, then files will not be cleaned up
80 * at present we need tmpfiles - as we compile multiple files into one.
81 * we could do this in memory now, as I suspect vala will not be as bad as javascript for leakage...
84 public string tmpDir = "/tmp"; // FIXME??? in ctor?
89 * @cfg {Boolean} cleanup (optional) clean up temp files after done -
90 * Defaults to false if you set tmpDir, otherwise true.
92 public bool cleanup = false;
96 * @cfg {Boolean} keepWhite (optional) do not remove white space in output.
97 * usefull for debugging compressed files.
100 public bool keepWhite = false;
103 * @cfg {Boolean} skipScope (optional) skip Scope parsing and replacement.
104 * usefull for debugging...
107 public bool skipScope = false;
111 * @cfg {Boolean} dumpTokens (optional) read the first file and dump the tokens.
112 * usefull for debugging...
115 public bool dumpTokens = false;
117 // list of files to compile...
118 Gee.ArrayList<string> files;
121 * @cfg activeFile ??? used???
124 public string activeFile = "";
128 * @cfg baseDir -- prefix the files listed in indexfiles with this.
131 public string baseDir = "";
134 public string outstr = ""; // if no target is specified - then this will contain the result
141 this.result = new Json.Object();
142 this.files = new Gee.ArrayList<string>();
144 new Lang_Class(); ///initilizaze lang..
149 // this could be another class really..
151 public enum ResultType { err , warn }
153 * result of complication - a JSON object containing warnings / errors etc..
155 * warn-TOTAL : X (number of warnings.
156 * err-TOTAL: X (number of errors) << this indicates failure...
159 * line : [ Errors,Errors,.... ]
166 public Json.Object result; // output - what's the complication result
168 public void logError(ResultType type, string filename, int line, string message) {
170 if (!this.result.has_member(type.to_string()+"-TOTAL")) {
171 this.result.set_int_member(type.to_string()+"-TOTAL", 1);
173 this.result.set_int_member(type.to_string()+"-TOTAL",
174 this.result.get_int_member(type.to_string()+"-TOTAL") +1
179 if (!this.result.has_member(type.to_string())) {
180 this.result.set_object_member(type.to_string(), new Json.Object());
182 var t = this.result.get_object_member(type.to_string());
183 if (!t.has_member(filename)) {
184 t.set_object_member(filename, new Json.Object());
186 var tt = t.get_object_member(filename);
187 if (!tt.has_member(line.to_string())) {
188 tt.set_array_member(line.to_string(), new Json.Array());
190 var tl = tt.get_array_member(line.to_string());
191 tl.add_string_element(message);
195 public bool hasErrors(string fn)
197 if (!this.result.has_member(ResultType.err.to_string())) {
204 var t = this.result.get_object_member(ResultType.err.to_string());
206 if (t.has_member(fn)) {
211 public void dumpErrors(ResultType type)
213 if (!this.result.has_member(type.to_string())) {
216 var t = this.result.get_object_member(type.to_string());
217 t.foreach_member((obj, filename, node) => {
218 var linelist = node.dup_object();
219 linelist.foreach_member((linelistobj, linestr, nodear) => {
220 var errors= nodear.dup_array();
221 errors.foreach_element((errorar, ignore, nodestr) => {
222 print("%s: %s:%s %s", type.to_string(), filename, linestr, nodestr.get_string());
233 public void loadSourceIndexes(Gee.ArrayList<string> indexes)
235 foreach(var f in indexes) {
236 this.loadSourceIndex(f);
240 public void loadFiles(string[] fs)
242 // fixme -- prefix baseDir?
243 foreach(var f in fs) {
244 GLib.debug("add File: %s", f);
245 this.files.add(f); //?? easier way?
248 public void loadFile(string f)
250 // fixme -- prefix baseDir?
251 GLib.debug("add File: %s", f);
253 GLib.debug("FILE LEN: %d", this.files.size);
257 public string pack(string target, string targetDebug = "") throws PackerError
259 this.target = target;
260 this.targetDebug = targetDebug;
262 if (this.files.size < 1) {
263 throw new PackerError.ArgumentError("No Files loaded before pack() called");
265 if (this.target.length > 0 ) {
266 this.targetStream = File.new_for_path(this.target).replace(null, false,FileCreateFlags.NONE);
268 if (this.targetDebug.length > 0 ) {
269 this.targetDebugStream = File.new_for_path(this.targetDebug).replace(null, false,FileCreateFlags.NONE);
271 return this.packAll();
279 * load a dependancy list -f option
280 * @param {String} srcfile sourcefile to parse
284 public void loadSourceIndex(string in_srcfile)
287 var srcfile = in_srcfile;
288 if (srcfile[0] != '/') {
289 srcfile = this.baseDir + in_srcfile;
292 FileUtils.get_contents(srcfile,out str);
294 var lines = str.split("\n");
295 for(var i =0; i < lines.length;i++) {
297 var f = lines[i].strip();
299 Regex.match_simple ("^/", f) ||
300 !Regex.match_simple ("[a-zA-Z]+", f)
302 continue; // blank comment or not starting with a-z
305 if (Regex.match_simple ("\\.js$", f)) {
311 // this maps Roo.bootstrap.XXX to Roo/bootstrap/xxx.js
312 // should we prefix? =- or should this be done elsewhere?
314 var add = f.replace(".", "/") + ".js";
317 add = this.baseDir + add;
320 if (this.files.contains(add)) {
326 this.files.add( add );
332 private string packAll() // do the packing (run from constructor)
335 //this.transOrigFile= bpath + '/../lang.en.js'; // needs better naming...
336 //File.write(this.transfile, "");
337 if (this.target.length > 0) {
338 this.targetStream.write("".data);
341 if (this.targetDebugStream != null) {
342 this.targetDebugStream.write("".data);
346 foreach(var file in this.files) {
348 print("reading %s\n",file );
350 if (!FileUtils.test (file, FileTest.EXISTS) || FileUtils.test (file, FileTest.IS_DIR)) {
351 print("SKIP (is not a file) %s\n ", file);
355 var loaded_string = false;
356 string file_contents = "";
359 if (this.targetDebugStream !=null) {
361 FileUtils.get_contents(file,out file_contents);
362 this.targetDebugStream.write(file_contents.data);
363 loaded_string = false;
365 // it's a good idea to check with 0 compression to see if the code can parse!!
368 //File.append(dout, str +"\n");
372 var minfile = this.tmpDir + "/" + file.replace("/", ".");
375 // let's see if we have a min file already?
376 // this might happen if tmpDir is set ..
379 if ( FileUtils.test (minfile, FileTest.EXISTS)) {
381 var otv = File.new_for_path(file).query_info (FileAttribute.TIME_MODIFIED, 0).get_modification_time();
382 var mtv = File.new_for_path(minfile).query_info (FileAttribute.TIME_MODIFIED, 0).get_modification_time();
385 // print("%s : compare : Cache file %s to Orignal Time %s\n", file, mtv.to_iso8601(), otv.to_iso8601());
386 if (mtv.tv_usec > otv.tv_usec) {
387 continue; // file is newer or the same time..
393 print("COMPRESSING to %s\n", minfile);
394 //var codeComp = pack(str, 10, 0, 0);
395 if (this.cleanup && FileUtils.test (minfile, FileTest.EXISTS)) {
396 FileUtils.remove(minfile);
398 if (!loaded_string) {
399 FileUtils.get_contents(file,out file_contents);
402 this.packFile(file_contents, file, minfile);
407 // at this point if we have errors, we should stop..
409 this.dumpErrors(ResultType.err);
410 this.dumpErrors(ResultType.warn);
412 if (this.dumpTokens || this.hasErrors()) {
414 GLib.Process.exit(0);
416 print("MERGING SOURCE\n");
418 for(var i=0; i < this.files.size; i++) {
419 var file = this.files[i];
420 var minfile = this.tmpDir + "/" + file.replace("/", ".");
423 if ( !FileUtils.test(minfile, FileTest.EXISTS)) {
424 print("skipping source %s - does not exist\n", minfile);
428 FileUtils.get_contents(minfile, out str);
429 print("using MIN FILE %s\n", minfile);
430 if (str.length > 0) {
431 if (this.targetStream != null) {
432 this.targetStream.write(("// " +
433 ( (file.length > this.baseDir.length) ? file.substring(this.baseDir.length) : file ) +
435 this.targetStream.write((str + "\n").data);
438 this.outstr += "//" +
439 ( (file.length > this.baseDir.length) ? file.substring(this.baseDir.length) : file ) + "\n";
440 this.outstr += str + "\n";
445 FileUtils.remove(minfile);
452 if (this.target.length > 0 ) {
453 print("Output file: " + this.target);
455 if (this.targetDebug.length > 0) {
456 print("Output debug file: %s\n" , this.targetDebug);
461 // OUTPUT should be handled by PackerRun (so that this can be used as a library...)
462 if (this.outstr.length > 0 ) {
464 // stdout.printf ("%s", this.outstr);
471 * Core packing routine for a file
473 * @param str - str source text..
474 * @param fn - filename (for reference?)
475 * @param minfile - min file location...
479 public string packFile (string str,string fn, string minfile)
482 var tr = new TokenReader(this);
485 tr.keepComments = true;
487 tr.collapseWhite = false;
490 // we can load translation map here...
492 TokenArray toks = tr.tokenize(new TextStream(str)); // dont merge xxx + . + yyyy etc.
494 if (this.dumpTokens) {
497 //GLib.Process.exit(0);
500 this.activeFile = fn;
502 // and replace if we are generating a different language..
505 //var ts = new TokenStream(toks);
506 //print(JSON.stringify(toks, null,4 )); Seed.quit();
507 var ts = new Collapse(toks.tokens);
509 //ts.dumpAll(""); print("Done collaps"); Process.exit(1);
511 // print(JSON.stringify(ts.tokens, null,4 )); Seed.quit();
513 if (!this.skipScope) {
514 var sp = new ScopeParser(ts, this, fn);
517 sp.buildSymbolTree();
518 sp.mungeSymboltree();
525 //print(sp.warnings.join("\n"));
526 //(new TokenStream(toks.tokens)).dumpAll(""); GLib.Process.exit(1);
527 // compress works on the original array - in theory the replacements have already been done by now
528 var outf = CompressWhite(new TokenStream(toks.tokens), this, this.keepWhite); // do not kill whitespace..
531 debug("RESULT: \n %s\n", outf);
535 if (outf.length > 0 && minfile.length > 0 && !this.hasErrors(fn)) {
536 FileUtils.set_contents(minfile, outf);
548 public string md5(string str)
551 return GLib.Checksum.compute_for_string(GLib.ChecksumType.MD5, str);
555 //stringHandler : function(tok) -- not used...