amberc-cli.js 5.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190
  1. #!/usr/bin/env node
  2. var path = require('path');
  3. var amberc = require('./amberc.js');
  4. // get parameters passed to the command line script
  5. // discard the first two parameters which are the node binary and the script name
  6. var parameters = process.argv.slice(2);
  7. // check if at least one parameter was passed to the script
  8. if (1 > parameters.length) {
  9. print_usage();
  10. process.exit();
  11. }
  12. // Get Amber root directory from the location of this script so that
  13. // we can find the st and js directories etc.
  14. var amber_dir = path.normalize(path.join(path.dirname(process.argv[1]), '..', '..'));
  15. var compiler = new amberc.Compiler(amber_dir);
  16. var configuration = handle_options(parameters);
  17. compiler.main(configuration);
  18. /**
  19. * Process given program options and update defaults values.
  20. * Followed by check_for_closure_compiler() and then collect_files().
  21. */
  22. function handle_options(optionsArray) {
  23. var programName = [];
  24. var currentItem = optionsArray.shift();
  25. var defaults = amberc.createDefaultConfiguration();
  26. while(undefined !== currentItem) {
  27. switch(currentItem) {
  28. case '-l':
  29. defaults.load.push.apply(defaults.load, optionsArray.shift().split(','));
  30. break;
  31. case '-L':
  32. defaults.jsLibraryDirs.push.apply(defaults.jsLibraryDirs, optionsArray.shift().split(','));
  33. break;
  34. case '-g':
  35. defaults.jsGlobals.push.apply(defaults.jsGlobals, optionsArray.shift().split(','));
  36. break;
  37. case '-m':
  38. defaults.main = optionsArray.shift();
  39. break;
  40. case '-M':
  41. defaults.mainfile = optionsArray.shift();
  42. break;
  43. case '-n':
  44. defaults.amd_namespace = optionsArray.shift();
  45. break;
  46. case '-D':
  47. defaults.output_dir = optionsArray.shift();
  48. break;
  49. case '-s':
  50. defaults.suffix = optionsArray.shift();
  51. defaults.suffix_used = defaults.suffix;
  52. break;
  53. case '-S':
  54. defaults.loadsuffix = optionsArray.shift();
  55. defaults.suffix_used = defaults.suffix;
  56. break;
  57. case '-v':
  58. defaults.verbose = true;
  59. break;
  60. case '-h':
  61. case '--help':
  62. case '?':
  63. print_usage();
  64. break;
  65. default:
  66. var fileSuffix = path.extname(currentItem);
  67. switch (fileSuffix) {
  68. case '.st':
  69. defaults.stFiles.push(currentItem);
  70. break;
  71. case '.js':
  72. defaults.jsFiles.push(currentItem);
  73. break;
  74. default:
  75. // Will end up being the last non js/st argument
  76. programName.push(currentItem);
  77. break;
  78. }
  79. }
  80. currentItem = optionsArray.shift();
  81. }
  82. if(1 < programName.length) {
  83. throw new Error('More than one name for ProgramName given: ' + programName);
  84. } else {
  85. defaults.program = programName[0];
  86. }
  87. return defaults;
  88. }
  89. // print available flags
  90. function print_usage() {
  91. var usage = [
  92. 'Usage: amberc [-l lib1,lib2...] [-g jsGlobal1,jsGlobla2] [-m main_class] [-M main_file]',
  93. ' [-n namespace] [-D output_dir] [-v] [-s suffix] [-S suffix] [file1 [file2 ...]] [Program]',
  94. '',
  95. ' amberc compiles Amber files - either separately or into a complete runnable',
  96. ' program. If no .st files are listed only a linking stage is performed.',
  97. ' Files listed will be handled using the following rules:',
  98. '',
  99. ' *.js',
  100. ' Files are linked (concatenated) in listed order.',
  101. ' If not found we look in $AMBER/src/',
  102. '',
  103. ' *.st',
  104. ' Files are compiled into .js files before concatenation.',
  105. ' If not found we look in $AMBER/src/',
  106. '',
  107. ' NOTE: Each .st file is currently considered to be a fileout of a single class',
  108. ' category of the same name as the file!',
  109. '',
  110. ' If no <Program> is specified each given .st file will be compiled into',
  111. ' a matching .js file. Otherwise a <Program>.js file is linked together based on',
  112. ' the given options:',
  113. '',
  114. ' -l library1,library2',
  115. ' Add listed JavaScript libraries in listed order.',
  116. ' Libraries are not separated by spaces or end with .js.',
  117. '',
  118. ' -L directory1,directory2',
  119. ' Add listed directories to the library search path.',
  120. ' The order of processing is:',
  121. ' 1. current directory',
  122. ' 2. directories specified by -L',
  123. ' 3. $AMBER',
  124. '',
  125. ' -g jsGlobal1,jsGlobal2',
  126. ' Comma separated list of JS global variable names.',
  127. ' The names are added to a list containing "window", "document" and others.',
  128. '',
  129. ' -m main_class',
  130. ' Add a call to the class method main_class>>main at the end of <Program>.',
  131. '',
  132. ' -M main_file',
  133. ' Add <main_file> at the end of <Program.js> acting as #main.',
  134. '',
  135. ' -n amd_namespace',
  136. ' Export packages with <amd_namespace> as the require.js namespace.',
  137. ' Default value is "amber_core".',
  138. '',
  139. ' -v',
  140. ' Produce a more verbose output.',
  141. '',
  142. ' -D',
  143. ' Specifies the output directory for all generated .js files.',
  144. ' The hierarchy of the input files is not maintaned.',
  145. ' If this option is omitted all generated .js files are placed next to their input files',
  146. '',
  147. ' -s suffix',
  148. ' Add <suffix> to compiled .js files. File.st is then compiled into',
  149. ' File.<suffix>.js.',
  150. '',
  151. ' -S suffix',
  152. ' Use <suffix> for all libraries accessed using -l. This makes it possible',
  153. ' to have multiple flavors of Amber and libraries in the same place.',
  154. '',
  155. '',
  156. ' Example invocations:',
  157. '',
  158. ' Just compile Kernel-Objects.st to Kernel-Objects.js:',
  159. '',
  160. ' amberc Kernel-Objects.st',
  161. '',
  162. ' Compile Hello.st to Hello.js and create complete program called Program.js.',
  163. ' Additionally add a call to the class method Hello>>main:',
  164. '',
  165. ' amberc -m Hello Hello.st Program',
  166. '',
  167. ' Compile Cat1.st and Cat2.st files into corresponding .js files.',
  168. ' Link them with myboot.js and myKernel.js',
  169. ' and merge everything into a complete program named Program.js:',
  170. '',
  171. ' amberc -M main.js myboot.js myKernel.js Cat1.st Cat2.st Program',
  172. ];
  173. usage.forEach(function (line) {
  174. console.log(line);
  175. });
  176. }