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 {
61 public class Packer : Object
64 * @cfg {String} target to write files to - must be full path.
67 GLib.FileOutputStream targetStream = null;
69 * @cfg {String} debugTarget target to write files debug version to (uncompacted)- must be full path.
71 string targetDebug = "";
74 GLib.FileOutputStream targetDebugStream = null;
76 * @cfg {String} tmpDir (optional) where to put the temporary files.
77 * if you set this, then files will not be cleaned up
79 * at present we need tmpfiles - as we compile multiple files into one.
80 * we could do this in memory now, as I suspect vala will not be as bad as javascript for leakage...
83 public string tmpDir = "/tmp"; // FIXME??? in ctor?
88 * @cfg {Boolean} cleanup (optional) clean up temp files after done -
89 * Defaults to false if you set tmpDir, otherwise true.
91 public bool cleanup = false;
95 * @cfg {Boolean} keepWhite (optional) do not remove white space in output.
96 * usefull for debugging compressed files.
99 public bool keepWhite = false;
102 * @cfg {Boolean} skipScope (optional) skip Scope parsing and replacement.
103 * usefull for debugging...
106 public bool skipScope = false;
110 * @cfg {Boolean} dumpTokens (optional) read the first file and dump the tokens.
111 * usefull for debugging...
114 public bool dumpTokens = false;
116 // list of files to compile...
117 Gee.ArrayList<string> files;
120 * @cfg activeFile ??? used???
123 public string activeFile = "";
127 * @cfg baseDir -- prefix the files listed in indexfiles with this.
130 public string baseDir = "";
133 public string outstr = ""; // if no target is specified - then this will contain the result
136 * result of complication - a JSON object containing warnings / errors etc..
138 * warn-TOTAL : X (number of warnings.
139 * err-TOTAL: X (number of errors) << this indicates failure...
142 * line : [ Errors,Errors,.... ]
147 public Json.Object result; // output - what's the complication result
152 this.result = new Json.Object();
153 this.files = new Gee.ArrayList<string>();
155 new Lang_Class(); ///initilizaze lang..
159 public void loadSourceIndexes(Gee.ArrayList<string> indexes)
161 foreach(var f in indexes) {
162 this.loadSourceIndex(f);
166 public void loadFiles(string[] fs)
168 // fixme -- prefix baseDir?
169 foreach(var f in fs) {
170 GLib.debug("add File: %s", f);
171 this.files.add(f); //?? easier way?
174 public void loadFile(string f)
176 // fixme -- prefix baseDir?
177 GLib.debug("add File: %s", f);
179 GLib.debug("FILE LEN: %d", this.files.size);
183 public string pack(string target, string targetDebug = "") throws PackerError, TokenReaderError , ScopeParserError
185 this.target = target;
186 this.targetDebug = targetDebug;
188 if (this.files.size < 1) {
189 throw new PackerError.ArgumentError("No Files loaded before pack() called");
191 if (this.target.length > 0 ) {
192 this.targetStream = File.new_for_path(this.target).replace(null, false,FileCreateFlags.NONE);
194 if (this.targetDebug.length > 0 ) {
195 this.targetDebugStream = File.new_for_path(this.targetDebug).replace(null, false,FileCreateFlags.NONE);
197 return this.packAll();
205 * load a dependancy list -f option
206 * @param {String} srcfile sourcefile to parse
210 public void loadSourceIndex(string in_srcfile)
213 var srcfile = in_srcfile;
214 if (srcfile[0] != '/') {
215 srcfile = this.baseDir + in_srcfile;
218 FileUtils.get_contents(srcfile,out str);
220 var lines = str.split("\n");
221 for(var i =0; i < lines.length;i++) {
223 var f = lines[i].strip();
225 Regex.match_simple ("^/", f) ||
226 !Regex.match_simple ("[a-zA-Z]+", f)
228 continue; // blank comment or not starting with a-z
231 if (Regex.match_simple ("\\.js$", f)) {
237 // this maps Roo.bootstrap.XXX to Roo/bootstrap/xxx.js
238 // should we prefix? =- or should this be done elsewhere?
240 var add = f.replace(".", "/") + ".js";
243 add = this.baseDir + add;
246 if (this.files.contains(add)) {
252 this.files.add( add );
258 private string packAll() throws TokenReaderError , ScopeParserError // do the packing (run from constructor)
261 //this.transOrigFile= bpath + '/../lang.en.js'; // needs better naming...
262 //File.write(this.transfile, "");
263 if (this.target.length > 0) {
264 this.targetStream.write("".data);
267 if (this.targetDebugStream != null) {
268 this.targetDebugStream.write("".data);
272 foreach(var file in this.files) {
274 print("reading %s\n",file );
276 if (!FileUtils.test (file, FileTest.EXISTS) || FileUtils.test (file, FileTest.IS_DIR)) {
277 print("SKIP (is not a file) %s\n ", file);
281 var loaded_string = false;
282 string file_contents = "";
285 if (this.targetDebugStream !=null) {
287 FileUtils.get_contents(file,out file_contents);
288 this.targetDebugStream.write(file_contents.data);
289 loaded_string = false;
291 // it's a good idea to check with 0 compression to see if the code can parse!!
294 //File.append(dout, str +"\n");
298 var minfile = this.tmpDir + "/" + file.replace("/", ".");
301 // let's see if we have a min file already?
302 // this might happen if tmpDir is set ..
305 if ( FileUtils.test (minfile, FileTest.EXISTS)) {
307 var otv = File.new_for_path(file).query_info (FileAttribute.TIME_MODIFIED, 0).get_modification_time();
308 var mtv = File.new_for_path(minfile).query_info (FileAttribute.TIME_MODIFIED, 0).get_modification_time();
311 // print("%s : compare : Cache file %s to Orignal Time %s\n", file, mtv.to_iso8601(), otv.to_iso8601());
312 if (mtv.tv_usec > otv.tv_usec) {
313 continue; // file is newer or the same time..
319 print("COMPRESSING to %s\n", minfile);
320 //var codeComp = pack(str, 10, 0, 0);
321 if (this.cleanup && FileUtils.test (minfile, FileTest.EXISTS)) {
322 FileUtils.remove(minfile);
324 if (!loaded_string) {
325 FileUtils.get_contents(file,out file_contents);
328 this.packFile(file_contents, file, minfile);
333 if (this.dumpTokens) {
335 GLib.Process.exit(0);
337 print("MERGING SOURCE\n");
339 for(var i=0; i < this.files.size; i++) {
340 var file = this.files[i];
341 var minfile = this.tmpDir + "/" + file.replace("/", ".");
344 if ( !FileUtils.test(minfile, FileTest.EXISTS)) {
345 print("skipping source %s - does not exist\n", minfile);
349 FileUtils.get_contents(minfile, out str);
350 print("using MIN FILE %s\n", minfile);
351 if (str.length > 0) {
352 if (this.targetStream != null) {
353 this.targetStream.write(("// " +
354 ( (file.length > this.baseDir.length) ? file.substring(this.baseDir.length) : file ) +
356 this.targetStream.write((str + "\n").data);
359 this.outstr += "//" +
360 ( (file.length > this.baseDir.length) ? file.substring(this.baseDir.length) : file ) + "\n";
361 this.outstr += str + "\n";
366 FileUtils.remove(minfile);
370 if (this.target.length > 0 ) {
371 print("Output file: " + this.target);
373 if (this.targetDebug.length > 0) {
374 print("Output debug file: %s\n" , this.targetDebug);
377 // OUTPUT should be handled by PackerRun (so that this can be used as a library...)
378 if (this.outstr.length > 0 ) {
380 // stdout.printf ("%s", this.outstr);
387 * Core packing routine for a file
389 * @param str - str source text..
390 * @param fn - filename (for reference?)
391 * @param minfile - min file location...
395 public string packFile (string str,string fn, string minfile) throws TokenReaderError, ScopeParserError
398 var tr = new TokenReader();
401 tr.keepComments = true;
403 tr.collapseWhite = false;
406 // we can load translation map here...
408 TokenArray toks = tr.tokenize(new TextStream(str)); // dont merge xxx + . + yyyy etc.
410 if (this.dumpTokens) {
413 //GLib.Process.exit(0);
416 this.activeFile = fn;
418 // and replace if we are generating a different language..
421 //var ts = new TokenStream(toks);
422 //print(JSON.stringify(toks, null,4 )); Seed.quit();
423 var ts = new Collapse(toks.tokens);
425 //ts.dumpAll(""); print("Done collaps"); Process.exit(1);
427 // print(JSON.stringify(ts.tokens, null,4 )); Seed.quit();
429 if (!this.skipScope) {
430 var sp = new ScopeParser(ts);
433 sp.buildSymbolTree();
434 sp.mungeSymboltree();
441 //print(sp.warnings.join("\n"));
442 //(new TokenStream(toks.tokens)).dumpAll(""); GLib.Process.exit(1);
443 // compress works on the original array - in theory the replacements have already been done by now
444 var outf = CompressWhite(new TokenStream(toks.tokens), this, this.keepWhite); // do not kill whitespace..
447 debug("RESULT: \n %s\n", outf);
449 if (outf.length > 0 && minfile.length > 0 ) {
450 FileUtils.set_contents(minfile, outf);
462 public string md5(string str)
465 return GLib.Checksum.compute_for_string(GLib.ChecksumType.MD5, str);
469 //stringHandler : function(tok) -- not used...