1
0

amberc.js 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455
  1. #!/usr/bin/env node
  2. // This is a "compiler" for Amber code. Run without arguments for help.
  3. var path = require('path'),
  4. util = require('util'),
  5. fs = require('fs'),
  6. exec = require('child_process').exec;
  7. function map(array, filter, callback) {
  8. var counter = array.length;
  9. var new_array = [];
  10. array.forEach(function (item, index) {
  11. filter(item, function (err, result) {
  12. if (err) { callback(err); return; }
  13. new_array[index] = result;
  14. counter--;
  15. if (counter === 0) {
  16. callback(null, new_array);
  17. }
  18. });
  19. });
  20. }
  21. console.time('Compile Time');
  22. var defaults = function() {
  23. // Get Amber root directory from the location of this script so that
  24. // we can find the st and js directories etc.
  25. var amber_dir = path.join(path.dirname(process.argv[1]), '..');
  26. amber_dir = path.normalize(amber_dir);
  27. var kernel_libraries = ['boot', 'Kernel-Objects', 'Kernel-Classes', 'Kernel-Methods', 'Kernel-Collections', 'Kernel-Exceptions', 'Kernel-Transcript', 'Kernel-Announcements'];
  28. var compiler_libs = ['parser', 'Compiler', 'Compiler-Exceptions'];//, 'Compiler-Core', 'Compiler-AST', 'Compiler-IR', 'Compiler-Inlining', 'Compiler-Semantic'];
  29. return {
  30. 'amber_dir': amber_dir,
  31. 'smalltalk': {}, // the evaluated compiler will be stored in this variable (see create_compiler)
  32. 'compiler_libraries': kernel_libraries.concat(compiler_libs),
  33. 'init': path.join(amber_dir, 'js', 'init.js'),
  34. 'main': undefined,
  35. 'mainfile': undefined,
  36. 'base': kernel_libraries,
  37. 'load': [],
  38. 'closure': false,
  39. 'closure_parts': false,
  40. 'closure_full': false,
  41. 'closure_options': '',
  42. 'closure_jar': path.resolve(path.join(process.env['HOME'], 'compiler.jar')),
  43. 'suffix': '',
  44. 'loadsuffix': '',
  45. 'suffix_used': '',
  46. 'deploy': false,
  47. 'libraries': [],
  48. 'compile': [],
  49. 'compiled_categories': [],
  50. 'compiled': [],
  51. 'program': undefined
  52. };
  53. }();
  54. if (3 > process.argv.length) {
  55. usage();
  56. } else {
  57. handle_options(process.argv.slice(2));
  58. }
  59. function handle_options(optionsArray) {
  60. var nonOptions = [];
  61. var currentItem = optionsArray.shift();
  62. while(undefined !== currentItem) {
  63. switch(currentItem) {
  64. case '-l':
  65. defaults.load.push.apply(defaults.load, optionsArray.shift().split(','));
  66. break;
  67. case '-i':
  68. defaults.init = optionsArray.shift();
  69. break;
  70. case '-m':
  71. defaults.main = optionsArray.shift();
  72. break;
  73. case '-M':
  74. defaults.mainfile = optionsArray.shift();
  75. break;
  76. case '-o':
  77. defaults.closure = true;
  78. defaults.closure_parts = true;
  79. break;
  80. case '-O':
  81. defaults.closure = true;
  82. defaults.closure_full = true;
  83. break;
  84. case '-A':
  85. defaults.closure = true;
  86. defaults.closure_options = defaults.closure_options + ' --compilation_level ADVANCED_OPTIMIZATIONS';
  87. defaults.closure_full = true;
  88. break;
  89. case '-d':
  90. defaults.deploy = true;
  91. break;
  92. case '-s':
  93. defaults.suffix = optionsArray.shift();
  94. defaults.suffix_used = defaults.suffix;
  95. break;
  96. case '-S':
  97. defaults.loadsuffix = optionsArray.shift();
  98. defaults.suffix_used = defaults.suffix;
  99. break;
  100. case '-h':
  101. case '--help':
  102. case '?':
  103. usage();
  104. break;
  105. default:
  106. nonOptions.push(currentItem);
  107. };
  108. currentItem = optionsArray.shift();
  109. }
  110. check_for_closure_compiler();
  111. collect_files(nonOptions);
  112. }
  113. // print options and exit
  114. function usage() {
  115. console.log('Usage: $0 [-l lib1,lib2...] [-i init_file] [-m main_class] [-M main_file]');
  116. console.log(' [-o] [-O|-A] [-d] [-s suffix] [-S suffix] [file1 [file2 ...]] [Program]');
  117. console.log('');
  118. console.log(' amberc compiles Amber files - either separately or into a complete runnable');
  119. console.log(' program. If no .st files are listed only a linking stage is performed.');
  120. console.log(' Files listed will be handled using the following rules:');
  121. console.log('');
  122. console.log(' *.js');
  123. console.log(' Files are linked (concatenated) in listed order.');
  124. console.log(' If not found we look in $AMBER/js/');
  125. console.log('');
  126. console.log(' *.st');
  127. console.log(' Files are compiled into .js files before concatenation.');
  128. console.log(' If not found we look in $AMBER/st/.');
  129. console.log('');
  130. console.log(' NOTE: Each file is currently considered to be a fileout of a single class');
  131. console.log(' category of the same name as the file!');
  132. console.log('');
  133. console.log(' If no Program is specified each given .st file will be compiled into');
  134. console.log(' a .js file. Otherwise a <Program>.js file is linked together based on');
  135. console.log(' the options:');
  136. console.log('');
  137. console.log(' -l library1,library2');
  138. console.log(' Additionally add listed JavaScript libraries (no spaces or .js) in listed order.');
  139. console.log('');
  140. console.log(' -i init_file');
  141. console.log(' Add library initializer <init_file> instead of default $AMBER/js/init.js ');
  142. console.log('');
  143. console.log(' -m main_class');
  144. console.log(' Add at end a call to #main in class <main_class>.');
  145. console.log('');
  146. console.log(' -M main_file');
  147. console.log(' Add at end javascript file <main_file> acting as main.');
  148. console.log('');
  149. console.log(' -o');
  150. console.log(' Optimize each .js file using the Google closure compiler.');
  151. console.log(' Using Closure compiler found at ~/compiler.jar');
  152. console.log('');
  153. console.log(' -O');
  154. console.log(' Optimize final <Program>.js using the Google closure compiler.');
  155. console.log(' Using Closure compiler found at ~/compiler.jar');
  156. console.log('');
  157. console.log(' -A Same as -O but use --compilation_level ADVANCED_OPTIMIZATIONS');
  158. console.log('');
  159. console.log(' -d');
  160. console.log(' Additionally export code for deploy - stripped from source etc.');
  161. console.log(' Uses suffix ".deploy.js" in addition to any explicit given suffic using -s.');
  162. console.log('');
  163. console.log(' -s suffix');
  164. console.log(' Add <suffix> to compiled js files so that File.st is compiled into');
  165. console.log(' File.<suffix>.js.');
  166. console.log('');
  167. console.log(' -S suffix');
  168. console.log(' Use <suffix> for all libraries accessed using -L or -l. This makes it possible');
  169. console.log(' to have multiple flavors of Amber and libraries in the same place.');
  170. console.log('');
  171. console.log('');
  172. console.log(' Example invocations:');
  173. console.log('');
  174. console.log(' Just compile Kernel-Objects.st to Kernel-Objects.js:');
  175. console.log('');
  176. console.log(' amberc Kernel-Objects.st');
  177. console.log('');
  178. console.log(' Compile Hello.st to Hello.js and create complete program called');
  179. console.log(' Program.js and adding a call to class method #main in class Hello:');
  180. console.log('');
  181. console.log(' amberc -m Hello Hello.st Program');
  182. console.log('');
  183. console.log(' Compile two .st files into corresponding .js files,');
  184. console.log(' and link with specific myboot.js, myKernel.js, myinit.js');
  185. console.log(' and main.js and create complete program called Program.js:');
  186. console.log('');
  187. console.log(' amberc -M main.js myinit.js myboot.js myKernel.js Cat1.st Cat2.st Program');
  188. process.exit();
  189. }
  190. function check_for_closure_compiler() {
  191. if (!defaults.closure) {
  192. return;
  193. }
  194. exec('which java', function(error, stdout, stderr) {
  195. // stdout contains path to java executable
  196. if (null !== error) {
  197. throw(new Error('java is not installed and is needed for -O, -A or -o (Closure compiler).'));
  198. }
  199. path.exists(defaults.closure_jar, function(exists) {
  200. if (!exists) {
  201. throw(new Error('Can not find Closure compiler at ' + defaults.closure_jar));
  202. }
  203. });
  204. });
  205. }
  206. function resolve_js(filename) {
  207. var jsFile = filename + defaults.loadsuffix + '.js';
  208. var amberJsFile = path.join(defaults.amber_dir, 'js', jsFile);
  209. console.log('Resolving: ' + jsFile);
  210. if (path.existsSync(jsFile)) {
  211. return jsFile;
  212. } else if (path.existsSync(amberJsFile)) {
  213. return amberJsFile;
  214. } else {
  215. throw(new Error('JavaScript file not found: ' + jsFile));
  216. }
  217. }
  218. // --------------------------------------------------
  219. // Collect libraries and Smalltalk files looking
  220. // both locally and in $AMBER/js and $AMBER/st
  221. // --------------------------------------------------
  222. function collect_files(filesArray) {
  223. var currentFile = filesArray.shift();
  224. while (undefined !== currentFile) {
  225. var suffix = path.extname(currentFile);
  226. var category = path.basename(currentFile, '.st');
  227. var amberFile = path.join(defaults.amber_dir, 'st', currentFile);
  228. switch (suffix) {
  229. case '.st':
  230. if (path.existsSync(currentFile)) {
  231. defaults.compile.push(currentFile);
  232. defaults.compiled_categories.push(category);
  233. defaults.compiled.push(category + defaults.suffix_used + '.js');
  234. } else if (path.existsSync(amberFile)) {
  235. defaults.compile.push(amberFile);
  236. defaults.compiled_categories.push(category);
  237. defaults.compiled.push(category + defaults.suffix_used + '.js');
  238. } else {
  239. throw(new Error('File not found: ' + currentFile));
  240. }
  241. break;
  242. case '.js':
  243. defaults.libraries.push(resolve_js(currentFile));
  244. break;
  245. default:
  246. // Will end up being the last non js/st argument
  247. defaults.program = currentFile
  248. break;
  249. };
  250. currentFile = filesArray.shift();
  251. };
  252. resolve_libraries();
  253. }
  254. function resolve_libraries() {
  255. // Resolve libraries listed in defaults.base
  256. defaults.base.forEach(function(file) {
  257. defaults.libraries.push(resolve_js(file));
  258. });
  259. // Resolve libraries listed in defaults.compiler
  260. var compilerFiles = [];
  261. defaults.compiler_libraries.forEach(function(file) {
  262. compilerFiles.push(resolve_js(file));
  263. });
  264. // Resolve libraries listed in defaults.load
  265. defaults.load.forEach(function(file) {
  266. var resolvedFile = resolve_js(file);
  267. compilerFiles.push(resolvedFile);
  268. defaults.libraries.push(resolvedFile);
  269. });
  270. // check and add init.js
  271. var initFile = defaults.init;
  272. if ('.js' !== path.extname(initFile)) {
  273. initFile = resolve_js(initFile);
  274. defaults.init = initFile;
  275. }
  276. compilerFiles.push(initFile);
  277. create_compiler(compilerFiles);
  278. }
  279. function create_compiler(compilerFilesArray) {
  280. // load all files from parameter <-> require?
  281. // create compiler in memory -> should be faster
  282. var content = '(function() {';
  283. compilerFilesArray.forEach(function(file) {
  284. console.log('Loading file: ' + file);
  285. content = content + fs.readFileSync(file);
  286. });
  287. content = content + 'return smalltalk;})();';
  288. defaults.smalltalk = eval(content);
  289. console.log('Compiler loaded');
  290. compile();
  291. };
  292. function compile() {
  293. console.log('Compiling collected .st files to .js')
  294. node_compile(defaults.compile, defaults.compiled_categories);
  295. console.log('Verifying if all .st files were compiled');
  296. map(defaults.compiled, function(file, callback) {
  297. path.exists(file, function(exists) {
  298. if (exists)
  299. callback(null, null);
  300. else
  301. throw(new Error('Compilation failed of: ' + file));
  302. });
  303. }, function(err, result) {
  304. if (undefined !== defaults.program) {
  305. compose_js_files();
  306. }
  307. optimize();
  308. });
  309. }
  310. function node_compile(smalltalkFiles, categories) {
  311. // the smalltalkFiles variable is a series of .st filenames to be imported
  312. // the categories variable holds category names to be exported as aCategoryName.js.
  313. // import .st files
  314. smalltalkFiles.forEach(function(val) {
  315. if (/\.st/.test(val)) {
  316. console.log("Importing: " + val);
  317. var code = fs.readFileSync(val, "utf8");
  318. defaults.smalltalk.Importer._new()._import_(code._stream());
  319. }
  320. });
  321. // export categories as .js
  322. categories.forEach(function(val) {
  323. console.log("Exporting " + (defaults.deploy ? "(debug + deploy)" : "(debug)") + " category "
  324. + val + " as " + val + defaults.suffix_used + ".js" + (defaults.deploy ? " and " + val + defaults.suffix_used + ".deploy.js" : ""));
  325. fs.writeFileSync(val + defaults.suffix_used + ".js", defaults.smalltalk.Exporter._new()._exportPackage_(val));
  326. if (defaults.deploy) {
  327. fs.writeFileSync(val + defaults.suffix_used + ".deploy.js", defaults.smalltalk.StrippedExporter._new()._exportPackage_(val));
  328. }
  329. });
  330. }
  331. function compose_js_files() {
  332. var program_files = [];
  333. if (undefined !== defaults.libraries) {
  334. console.log('Collecting libraries: ' + defaults.libraries);
  335. program_files.push.apply(program_files, defaults.libraries);
  336. }
  337. if (undefined !== defaults.compiled) {
  338. console.log('Collecting compiled files: ' + defaults.compiled);
  339. program_files.push.apply(program_files, defaults.compiled);
  340. }
  341. if (undefined !== defaults.init) {
  342. console.log('Adding initializer ' + defaults.init);
  343. program_files.push(defaults.init);
  344. }
  345. console.log('Writing program file: %s.js', defaults.program);
  346. var fileStream = fs.createWriteStream(defaults.program + '.js');
  347. fileStream.on('error', function(error) {
  348. console.log(error);
  349. });
  350. program_files.forEach(function(file) {
  351. console.log('Checking : ' + file);
  352. if(path.existsSync(file)) {
  353. fileStream.write(fs.readFileSync(file));
  354. } else {
  355. throw(new Error('Can not find file ' + file));
  356. }
  357. });
  358. if (undefined !== defaults.main) {
  359. console.log('Adding call to: %s>>main', defaults.main);
  360. fileStream.write('smalltalk.' + defaults.main + '._main()');
  361. }
  362. if (undefined !== defaults.mainfile && path.existsSync(defaults.mainfile)) {
  363. console.log('Adding main file: ' + defaults.mainfile);
  364. fileStream.write(fs.readFileSync(defaults.mainfile));
  365. }
  366. fileStream.end();
  367. console.log('Done.');
  368. }
  369. function optimize() {
  370. if (defaults.closure_parts) {
  371. console.log('Compiling all js files using Google closure compiler.');
  372. var allJsFiles = defaults.compiled.concat(defaults.libraries);
  373. allJsFiles.forEach(function(file) {
  374. var minifiedName = path.basename(file, '.js') + '.min.js';
  375. closure_compile(file, minifiedName);
  376. });
  377. }
  378. if (defaults.closure_full) {
  379. console.log('Compiling ' + defaults.program + '.js file using Google closure compiler.');
  380. closure_compile(defaults.program + '.js', defaults.program + '.min.js');
  381. }
  382. }
  383. function closure_compile(sourceFile, minifiedFile) {
  384. // exec is asynchronous
  385. exec(
  386. 'java -jar ' +
  387. defaults.closure_jar + ' ' +
  388. defaults.closure_options +
  389. ' --js '+ sourceFile +
  390. ' --js_output_file '+ minifiedFile,
  391. function (error, stdout, stderr) {
  392. if (error) {
  393. console.log(stderr);
  394. } else {
  395. console.log(stdout);
  396. console.log(' '+ minifiedFile + ' built.');
  397. }
  398. }
  399. );
  400. }
  401. console.timeEnd('Compile Time');