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;
105 XObject.extend(this, JSON.parse(File.read(conf)));;
107 // help ?? -- usage..
109 if (!this.src.length) {
111 name: "ArgumentError",
112 message: "No source directories specified"
115 // append full path to source directories.
117 this.src.forEach(function(v, i) {
119 _this.src[i] = _this.baseDir + '/' + v;
121 if (File.isDirectory(this.src[i])) {
123 name: "ArgumentError",
124 message: "invalid Source Directory : " + v
130 if (!this.template) {
132 name: "ArgumentError",
133 message: "No template Directory specified"
139 name: "ArgumentError",
140 message: "No directory specified"
145 // should cacheDirectory be a subdirectory of target??
147 //if (!this.cacheDirectory) {
149 // name: "ArgumentError",
150 // message: "No cacheDirectory specified"
156 * this might be nice as a standard bit of code..
159 parseArgv : function()
162 var args = Array.prototype.slice.call(Seed.argv);
164 args.shift(); // pack.js
166 for(var i =0; i < args.length;i++) {
167 if (args[i].substring(0,2) != '--') {
170 name: "ArgumentError",
171 message: "Unknown argument: " + args[i]
174 var a = args[i].substring(2);
175 if (typeof(this[args[i]]) == 'undefined') {
177 name: "ArgumentError",
178 message: "Unknown argument: " + args[i]
182 if (typeof(this[a]) == 'string') {
187 if (typeof(this[a]) == 'boolean') {
188 if (['false', 'true'].indexOf(args[i+1]) < 0) {
190 name: "ArgumentError",
191 message: "Unknown value for : " + args[i] + ' : ' + args[i+1]
194 this[a] = args[i+1] == 'true';
198 if (typeof(this[a]) == 'object') { // tecnically an array.
200 while(i < args.length)
202 if (args[i].substring(0,2) != '--'){
206 this[a].push(args[i]);
211 name: "ArgumentError",
212 message: "Do not know how to handle: " + a
224 if (i.substring(0,2) != '--') {
227 print( i + ' ARG : ' + this[i]);