git.roojs.org Git - roojspacker/blob - src/jsdoc/PackerRun.vala

   1
   2 /**
   3   the application
   4   -- in theory this code  can be used as a library... but this is the standard command line version...
   5
   6
   7   valac  --vapidir=/usr/share/vala/vapi
   8      --vapidir=/usr/share/vala/vapi
   9     --vapidir=/usr/share/vala-0.30/vapi
  10         --thread  -g
  11       JSDOC/Lang.vala JSDOC/TextStream.vala JSDOC/TokenReader.vala JSDOC/Token.vala JSDOC/TokenStream.vala JSDOC/Packer.vala
  12       JSDOC/Collapse.vala JSDOC/ScopeParser.vala JSDOC/Scope.vala JSDOC/Identifier.vala JSDOC/CompressWhite.vala
  13        JSDOC/PackerRun.vala --pkg glib-2.0 --pkg gee-1.0 --pkg gio-2.0 --pkg posix -o /tmp/jspack --target-glib=2.32  -X -lm
  14
  15
  16 */
  17
  18 namespace JSDOC
  19 {
  20         // --------------- <<<<<<< <MAIN HERE....
  21
  22 #if HAVE_OLD_GLIB
  23         class PackerRun : Object
  24 #else
  25         class PackerRun : Application
  26 #endif
  27         {
  28                 public static string opt_target = null;
  29                 public static string opt_debug_target = null;
  30 //              public static string opt_tmpdir = null;
  31                 private static string opt_basedir = null;
  32
  33                 /**
  34                 * @cfg baseDir -- prefix the files listed in indexfiles with this.
  35                 */
  36
  37                 public static string opt_real_basedir = null; // USE this one it's calcuated based on current path..
  38
  39                 public static string opt_doc_target = null;
  40                 public static string opt_doc_template_dir = null;
  41                 public static bool opt_doc_include_private = false;
  42
  43                 [CCode (array_length = false, array_null_terminated = true)]
  44                 private static string[]? opt_files = null;
  45                 [CCode (array_length = false, array_null_terminated = true)]
  46                 private static string[]? opt_files_from = null;
  47
  48
  49                 public static bool opt_debug = false;
  50
  51                  /**
  52                  * @cfg {Boolean} opt_skip_scope (optional) skip Scope parsing and replacement.
  53                  *    usefull for debugging...
  54                  */
  55                 public static bool opt_skip_scope = false;
  56
  57                 /**
  58                  * @cfg {Boolean} opt_keep_whitespace (optional) do not remove white space in output.
  59                  *    usefull for debugging compressed files.
  60                  */
  61
  62                 public static bool opt_keep_whitespace = false;
  63
  64                         /**
  65                  * @cfg {Boolean} opt_dump_tokens (optional) read the first file and dump the tokens.
  66                  *    usefull for debugging...
  67                  */
  68
  69                 public static bool opt_dump_tokens = false;
  70
  71
  72                 /**
  73                  * @cfg {Boolean} opt_clean_cache  (optional) clean up temp files after done -
  74                  *    Defaults to false if you set tmpDir, otherwise true.
  75                  */
  76
  77                 public static bool opt_clean_cache = true;
  78
  79                 // not actually an option yet..
  80
  81                 public static string opt_doc_ext = "html";
  82
  83                 const OptionEntry[] options = {
  84
  85                         { "jsfile", 'f', 0, OptionArg.FILENAME_ARRAY, ref opt_files ,"add a file to compile", null },
  86                         { "target", 't', 0, OptionArg.STRING, ref opt_target, "Target File to write (eg. roojs.js)", null },
  87                         { "debug-target", 'T', 0, OptionArg.STRING, ref opt_debug_target, "Target File to write debug code (eg. roojs-debug.js)", null },
  88                         //{ "tmpdir", 'm', 0, OptionArg.STRING, ref opt_tmpdir, "Temporary Directory to use (defaults to /tmp)", null },
  89                         { "basedir", 'b', 0, OptionArg.STRING, ref opt_basedir, "Base directory (where the files listed in index files are located.)", null },
  90
  91                         { "index-files", 'i', 0, OptionArg.FILENAME_ARRAY, ref opt_files_from ,"files that contain listing of files to compile", null },
  92                         { "keep-whitespace", 'w', 0, OptionArg.NONE, ref opt_keep_whitespace, "Keep whitespace", null },
  93                         { "skip-scope", 's', 0, OptionArg.NONE, ref opt_skip_scope, "Skip scope parsing and variable replacement", null },
  94                         { "debug", 0, 0, OptionArg.NONE, ref opt_debug, "Show debug messages", null },
  95                         { "dump-tokens", 'k', 0, OptionArg.NONE, ref opt_dump_tokens, "Dump the tokens from a file", null },
  96                         { "clean-cache", 'c', 0, OptionArg.NONE, ref opt_clean_cache, "Clean up the cache after running (slower)", null },
  97
  98                         // fixme -- keepwhite.. cleanup
  99
 100                         // documentation options
 101                         // usage: roojspacker --basedir roojs1 \
 102                         //       --doc-target roojs1/docs \
 103                         //       --index-files roojs1/buildSDK/dependancy_core.txt  \
 104                         //       --index-files roojs1/buildSDK/dependancy_ui.txt  \
 105                         //       --index-files roojs1/buildSDK/dependancy_bootstrap.txt  \
 106                         //       --doc-template-dir\
 107
 108
 109                         { "doc-target", 'd', 0, OptionArg.STRING, ref opt_doc_target, "Documentation Directory target", null },
 110                         { "doc-template-dir", 'p', 0, OptionArg.STRING, ref opt_doc_template_dir, "Documentation Directory target", null },
 111                         { "doc-private", 'p', 0, OptionArg.NONE, ref opt_doc_include_private, "Document Private functions", null },
 112
 113
 114
 115                         { null }
 116                 };
 117                 public static int main(string[] args)
 118                 {
 119                         //foreach(var a in args) {
 120                         //      debug("ARG: %s\n", a);
 121                         //}
 122
 123                         var opt_context = new OptionContext ("JSDOC Packer");
 124
 125                                 try {
 126                                         opt_context.set_help_enabled (true);
 127                                         opt_context.add_main_entries (options, null);
 128                                         if (!opt_context.parse ( ref args)) {
 129                                                 print("options parse error");
 130                                                 GLib.Process.exit(Posix.EXIT_FAILURE);
 131                                         }
 132
 133
 134
 135
 136                                 } catch (OptionError e) {
 137                                         stdout.printf ("error: %s\n", e.message);
 138                                         stdout.printf ("Run '%s --help' to see a full list of available command line options.\n %s",
 139                                                                  args[0], opt_context.get_help(true,null));
 140                                         GLib.Process.exit(Posix.EXIT_FAILURE);
 141
 142                                 }
 143
 144                         new PackerRun(args);
 145                         return 0;
 146                 }
 147
 148
 149
 150                 public PackerRun (string[] args)
 151                 {
 152 #if !HAVE_OLD_GLIB
 153                         Object(
 154                             application_id: "org.roojs.jsdoc.packerrun",
 155                                 flags: ApplicationFlags.HANDLES_COMMAND_LINE
 156                         );
 157 #endif
 158
 159
 160                         // what's required...
 161                         if (opt_debug) {
 162                                 GLib.Log.set_handler(null,
 163                                         GLib.LogLevelFlags.LEVEL_DEBUG | GLib.LogLevelFlags.LEVEL_WARNING,
 164                                         (dom, lvl, msg) => {
 165                                         print("%s: %s\n", dom, msg);
 166                                 });
 167                         }
 168
 169
 170
 171
 172
 173
 174                         // set the base directory...
 175                         var curdir = Environment.get_current_dir() + Path.DIR_SEPARATOR_S;
 176                         if (opt_basedir == null) {
 177
 178                                 opt_real_basedir = curdir;
 179                         } else if (opt_basedir[0] == '/') {
 180                                 opt_real_basedir  = opt_basedir;
 181                         } else {
 182                                 opt_real_basedir  = curdir + opt_basedir;
 183                         }
 184                         // suffix a slash..
 185                         if (opt_real_basedir [opt_real_basedir .length-1].to_string() != Path.DIR_SEPARATOR_S) {
 186                                 opt_real_basedir  += Path.DIR_SEPARATOR_S;
 187                         }
 188
 189                         GLib.debug("real_base_dir  = '%s' : opt_basedir ='%s'\n", opt_real_basedir , opt_basedir);
 190
 191
 192                         if (opt_files == null && opt_files_from == null) {
 193                                 GLib.error("You must list some files with -f or -i to compile - see --help for more details");
 194                                 GLib.Process.exit(1);
 195                         }
 196
 197
 198                                 // now run the Packer...
 199                         var p = new Packer(                     );
 200
 201
 202                         if (opt_files != null) {
 203
 204                                 foreach (var  f in opt_files) {
 205                                         GLib.debug("Adding File %s", f);
 206                                         p.loadFile(f);
 207                                 }
 208                         }
 209                         if (opt_files_from != null) {
 210
 211                                 foreach (var  f in opt_files_from) {
 212                                         GLib.debug("Adding File %s", f);
 213                                         p.loadSourceIndex(f);
 214                                 }
 215                         }
 216
 217                         var run_pack = false;
 218                         if (opt_target != null || opt_debug_target != null || opt_dump_tokens) {
 219
 220                                 p.pack( opt_target == null ? "" : opt_target ,
 221                                                 opt_debug_target == null ? "" :  opt_debug_target );
 222
 223                         if (p.outstr.length > 0 ) {
 224                                         stdout.printf ("%s", p.outstr);
 225                                 }
 226                 }
 227                 if (opt_doc_target != null) {
 228                         //var d = new DocBuilder(p);
 229                 }
 230
 231
 232
 233
 234                 }
 235
 236         }
 237
 238 }