1 //<script type="text/javascript">
3 * Options management...
5 XObject = imports.XObject.XObject;
6 File = imports.File.File;
11 "--help" : 'Show help', // was h
12 "help": false, // was h;se
15 // configurable settings.. -
16 "usage" : "Usage seed jsdocbuild.js OPTIONS \n",
19 // options get defined like this..
20 "--src" : "source directory (either absolute - starts with "/" or relative " +
21 "- without, in which case it's added to baseDir",
22 "--baseDir" : 'Base Directory (root directory of code)',
23 "--target" : 'Target Directory (where html files go)',
24 "--cacheDirectory": 'Cached Files Directory',
25 "--conf" : 'Read From a Configuration file', // was c. - configuration file.. - parsed with JSON.parse
26 "--template" : 'Template Directory', // was t.
27 // "recurse": false, // was r. - not supported..
28 "--ext" : 'Extension of code files to read (normally js)', // was x.
29 "--publishExt" : 'Extension of html files to write (normally html)',
30 //"private": '', // was p
31 //"allfunctions": '', // was a
32 //"encoding": '', // was e.
33 //"nocode": '', // was n
34 //"out": '', // was o.
35 //"suppress": '', // was s ??? used?
36 "--outputSource" : 'Output the Source code to symbols/src/* (boolean)',
37 //"testmode": '', // was t
39 "--verbose" : 'Show verbose messages', // was v
40 //"disablecache": '', // was C -- not needed? - see if cacheDirectory was set..
41 //"define" : [], // was D.
42 //"handler" : [], // was H -- not supported..
45 // and now the defaults.. (which type can be infered from..)
47 "baseDir" : '', // base directory -
48 "target" : '', // was d. ?? source directory (needed to put temporary files..)
49 "cacheDirectory" : '',
50 "conf" : '', // was c. - configuration file.. - parsed with JSON.parse
51 "template": '', // was t.
52 // "recurse": false, // was r. - not supported..
53 "ext": 'js', // was x.
54 "publishExt" : 'html',
55 "private": '', // was p
56 "allfunctions": '', // was a
57 "encoding": '', // was e.
58 "nocode": '', // was n
60 "suppress": '', // was s ??? used?
61 "outputSource" : true,
62 "testmode": '', // was t
64 "verbose": '', // was v
65 "disablecache": '', // was C
66 "define" : [], // was D.
67 "handler" : [], // was H -- not supported..
69 warn : function(str) {
70 print("Warn: " +str );
72 inform : function(str) {
73 print("Inform: " +str );
75 close : function() { },
76 flush : function() { },
89 // the reset of this is specific to JSDOC - and can not be moved to a generic handler..
92 this.LOG.verbose = this.verbose;
94 if (!this.baseDir) { // should we set this to cwd?
96 name: "ArgumentError",
97 message: "No baseDir specified"
101 // this is most likely to come from the command line..
103 var conf = this.conf[0] == '/' ? this.conf : this.baseDir + '/' + this.conf;
104 XObject.extend(this, JSON.parse(File.read(conf)));;
106 // help ?? -- usage..
108 if (!this.src.length) {
110 name: "ArgumentError",
111 message: "No source directories specified"
114 // append full path to source directories.
116 this.src.forEach(function(v, i) {
118 this.src[i] = _this.baseDir + '/' + v;
120 if (File.isDirectory(this.src[i])) {
122 name: "ArgumentError",
123 message: "invalid Source Directory : " + v
129 if (!this.template) {
131 name: "ArgumentError",
132 message: "No template Directory specified"
138 name: "ArgumentError",
139 message: "No directory specified"
144 // should cacheDirectory be a subdirectory of target??
146 //if (!this.cacheDirectory) {
148 // name: "ArgumentError",
149 // message: "No cacheDirectory specified"
155 * this might be nice as a standard bit of code..
158 parseArgv : function()
161 var args = Array.prototype.slice.call(Seed.argv);
163 args.shift(); // pack.js
165 for(var i =0; i < args.length;i++) {
166 if (args[i].substring(0,2) != '--') {
169 name: "ArgumentError",
170 message: "Unknown argument: " + args[i]
173 var a = arg[i].substring(2);
174 if (typeof(argTypes[arg[i]]) == 'undefined') {
176 name: "ArgumentError",
177 message: "Unknown argument: " + args[i]
181 if (typeof(this[a]) == 'string') {
186 if (typeof(this[a]) == 'boolean') {
187 if (['false', 'true'].indexOf(args[i+1]) < 0) {
189 name: "ArgumentError",
190 message: "Unknown value for : " + args[i] + ' : ' + args[i+1]
193 this[a] = args[i+1] == 'true';
197 if (typeof(this[a]) == 'object') { // tecnically an array.
199 while(i < args.length)
201 if (args[i].substring(0,2) != '--'){
205 this[a].push(args[i]);
210 name: "ArgumentError",
211 message: "Do not know how to handle: " + a
223 if (i.substring(0,2) != '--') {
226 print( i + ' ARG : ' + this[i]);