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 compileError(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()
197 if (this.result.has_member(ResultType.err.to_string())) {
202 public void dumpErrors(ResultType type)
204 if (!this.result.has_member(type.to_string())) {
207 var t = this.result.get_object_member(type.to_string());
208 t.foreach_member((obj, filename, node) => {
209 var linelist = node.dup_object();
210 linelist.foreach_member((linelistobj, linestr, nodear) => {
211 var errors= nodear.dup_array();
212 errors.foreach_element((errorar, ignore, nodestr) => {
213 print("%s: %s:%s %s", type.to_string(), filename, linestr, nodestr.get_string());
224 public void loadSourceIndexes(Gee.ArrayList<string> indexes)
226 foreach(var f in indexes) {
227 this.loadSourceIndex(f);
231 public void loadFiles(string[] fs)
233 // fixme -- prefix baseDir?
234 foreach(var f in fs) {
235 GLib.debug("add File: %s", f);
236 this.files.add(f); //?? easier way?
239 public void loadFile(string f)
241 // fixme -- prefix baseDir?
242 GLib.debug("add File: %s", f);
244 GLib.debug("FILE LEN: %d", this.files.size);
248 public string pack(string target, string targetDebug = "") throws PackerError, TokenReaderError , ScopeParserError
250 this.target = target;
251 this.targetDebug = targetDebug;
253 if (this.files.size < 1) {
254 throw new PackerError.ArgumentError("No Files loaded before pack() called");
256 if (this.target.length > 0 ) {
257 this.targetStream = File.new_for_path(this.target).replace(null, false,FileCreateFlags.NONE);
259 if (this.targetDebug.length > 0 ) {
260 this.targetDebugStream = File.new_for_path(this.targetDebug).replace(null, false,FileCreateFlags.NONE);
262 return this.packAll();
270 * load a dependancy list -f option
271 * @param {String} srcfile sourcefile to parse
275 public void loadSourceIndex(string in_srcfile)
278 var srcfile = in_srcfile;
279 if (srcfile[0] != '/') {
280 srcfile = this.baseDir + in_srcfile;
283 FileUtils.get_contents(srcfile,out str);
285 var lines = str.split("\n");
286 for(var i =0; i < lines.length;i++) {
288 var f = lines[i].strip();
290 Regex.match_simple ("^/", f) ||
291 !Regex.match_simple ("[a-zA-Z]+", f)
293 continue; // blank comment or not starting with a-z
296 if (Regex.match_simple ("\\.js$", f)) {
302 // this maps Roo.bootstrap.XXX to Roo/bootstrap/xxx.js
303 // should we prefix? =- or should this be done elsewhere?
305 var add = f.replace(".", "/") + ".js";
308 add = this.baseDir + add;
311 if (this.files.contains(add)) {
317 this.files.add( add );
323 private string packAll() throws TokenReaderError , ScopeParserError // do the packing (run from constructor)
326 //this.transOrigFile= bpath + '/../lang.en.js'; // needs better naming...
327 //File.write(this.transfile, "");
328 if (this.target.length > 0) {
329 this.targetStream.write("".data);
332 if (this.targetDebugStream != null) {
333 this.targetDebugStream.write("".data);
337 foreach(var file in this.files) {
339 print("reading %s\n",file );
341 if (!FileUtils.test (file, FileTest.EXISTS) || FileUtils.test (file, FileTest.IS_DIR)) {
342 print("SKIP (is not a file) %s\n ", file);
346 var loaded_string = false;
347 string file_contents = "";
350 if (this.targetDebugStream !=null) {
352 FileUtils.get_contents(file,out file_contents);
353 this.targetDebugStream.write(file_contents.data);
354 loaded_string = false;
356 // it's a good idea to check with 0 compression to see if the code can parse!!
359 //File.append(dout, str +"\n");
363 var minfile = this.tmpDir + "/" + file.replace("/", ".");
366 // let's see if we have a min file already?
367 // this might happen if tmpDir is set ..
370 if ( FileUtils.test (minfile, FileTest.EXISTS)) {
372 var otv = File.new_for_path(file).query_info (FileAttribute.TIME_MODIFIED, 0).get_modification_time();
373 var mtv = File.new_for_path(minfile).query_info (FileAttribute.TIME_MODIFIED, 0).get_modification_time();
376 // print("%s : compare : Cache file %s to Orignal Time %s\n", file, mtv.to_iso8601(), otv.to_iso8601());
377 if (mtv.tv_usec > otv.tv_usec) {
378 continue; // file is newer or the same time..
384 print("COMPRESSING to %s\n", minfile);
385 //var codeComp = pack(str, 10, 0, 0);
386 if (this.cleanup && FileUtils.test (minfile, FileTest.EXISTS)) {
387 FileUtils.remove(minfile);
389 if (!loaded_string) {
390 FileUtils.get_contents(file,out file_contents);
393 this.packFile(file_contents, file, minfile);
398 // at this point if we have errors, we should stop..
399 if (this.hasErrors()) {
401 GLib.Process.exit(0);
405 if (this.dumpTokens) {
407 GLib.Process.exit(0);
409 print("MERGING SOURCE\n");
411 for(var i=0; i < this.files.size; i++) {
412 var file = this.files[i];
413 var minfile = this.tmpDir + "/" + file.replace("/", ".");
416 if ( !FileUtils.test(minfile, FileTest.EXISTS)) {
417 print("skipping source %s - does not exist\n", minfile);
421 FileUtils.get_contents(minfile, out str);
422 print("using MIN FILE %s\n", minfile);
423 if (str.length > 0) {
424 if (this.targetStream != null) {
425 this.targetStream.write(("// " +
426 ( (file.length > this.baseDir.length) ? file.substring(this.baseDir.length) : file ) +
428 this.targetStream.write((str + "\n").data);
431 this.outstr += "//" +
432 ( (file.length > this.baseDir.length) ? file.substring(this.baseDir.length) : file ) + "\n";
433 this.outstr += str + "\n";
438 FileUtils.remove(minfile);
442 if (this.target.length > 0 ) {
443 print("Output file: " + this.target);
445 if (this.targetDebug.length > 0) {
446 print("Output debug file: %s\n" , this.targetDebug);
449 // OUTPUT should be handled by PackerRun (so that this can be used as a library...)
450 if (this.outstr.length > 0 ) {
452 // stdout.printf ("%s", this.outstr);
459 * Core packing routine for a file
461 * @param str - str source text..
462 * @param fn - filename (for reference?)
463 * @param minfile - min file location...
467 public string packFile (string str,string fn, string minfile) throws TokenReaderError, ScopeParserError
470 var tr = new TokenReader();
473 tr.keepComments = true;
475 tr.collapseWhite = false;
478 // we can load translation map here...
480 TokenArray toks = tr.tokenize(new TextStream(str)); // dont merge xxx + . + yyyy etc.
482 if (this.dumpTokens) {
485 //GLib.Process.exit(0);
488 this.activeFile = fn;
490 // and replace if we are generating a different language..
493 //var ts = new TokenStream(toks);
494 //print(JSON.stringify(toks, null,4 )); Seed.quit();
495 var ts = new Collapse(toks.tokens);
497 //ts.dumpAll(""); print("Done collaps"); Process.exit(1);
499 // print(JSON.stringify(ts.tokens, null,4 )); Seed.quit();
501 if (!this.skipScope) {
502 var sp = new ScopeParser(ts);
505 sp.buildSymbolTree();
506 sp.mungeSymboltree();
513 //print(sp.warnings.join("\n"));
514 //(new TokenStream(toks.tokens)).dumpAll(""); GLib.Process.exit(1);
515 // compress works on the original array - in theory the replacements have already been done by now
516 var outf = CompressWhite(new TokenStream(toks.tokens), this, this.keepWhite); // do not kill whitespace..
519 debug("RESULT: \n %s\n", outf);
521 if (outf.length > 0 && minfile.length > 0 ) {
522 FileUtils.set_contents(minfile, outf);
534 public string md5(string str)
537 return GLib.Checksum.compute_for_string(GLib.ChecksumType.MD5, str);
541 //stringHandler : function(tok) -- not used...