1 /**

     2 	@constructor

     3 	@param [opt] Used to override the commandline options. Useful for testing.

     4 	@version $Id: JsDoc.js 831 2010-03-09 14:24:56Z micmath $

     5 */

     6 JSDOC.JsDoc = function(/**object*/ opt) {

     7 	if (opt) {

     8 		JSDOC.opt = opt;

     9 	}

    10 	

    11 	if (JSDOC.opt.h) {

    12 		JSDOC.usage();

    13 		quit();

    14 	}

    15 	

    16 	// defend against options that are not sane 

    17 	if (JSDOC.opt._.length == 0) {

    18 		LOG.warn("No source files to work on. Nothing to do.");

    19 		quit();

    20 	}

    21 	if (JSDOC.opt.t === true || JSDOC.opt.d === true) {

    22 		JSDOC.usage();

    23 	}

    24 	

    25 	if (typeof JSDOC.opt.d == "string") {

    26 		if (!JSDOC.opt.d.charAt(JSDOC.opt.d.length-1).match(/[\\\/]/)) {

    27 			JSDOC.opt.d = JSDOC.opt.d+"/";

    28 		}

    29 		LOG.inform("Output directory set to '"+JSDOC.opt.d+"'.");

    30 		IO.mkPath(JSDOC.opt.d);

    31 	}

    32 	if (JSDOC.opt.e) IO.setEncoding(JSDOC.opt.e);

    33 	

    34 	// the -r option: scan source directories recursively

    35 	if (typeof JSDOC.opt.r == "boolean") JSDOC.opt.r = 10;

    36 	else if (!isNaN(parseInt(JSDOC.opt.r))) JSDOC.opt.r = parseInt(JSDOC.opt.r);

    37 	else JSDOC.opt.r = 1;

    38 	

    39 	// the -D option: define user variables

    40 	var D = {};

    41 	if (JSDOC.opt.D) {

    42 		for (var i = 0; i < JSDOC.opt.D.length; i++) {

    43 			var param = JSDOC.opt.D[i];

    44 			// remove first and last character if both == "

    45 			if ( 

    46 				param.length > 1

    47 				&& param.charAt(0) == '"'

    48 				&& param.charAt(param.length-1) == '"'

    49 			) {

    50 				param = param.substr(1, param.length-2);

    51 			}

    52 			var defineParts = param.split(":");

    53 			if (defineParts && defineParts.length > 1) {

    54 				for ( var dpIdx = 2; dpIdx < defineParts.length; dpIdx++ ) {

    55 					defineParts[1] += ':' + defineParts[dpIdx];

    56 				}

    57 				D[defineParts[0]] = defineParts[1];

    58 			}

    59 		}

    60 	}

    61 	JSDOC.opt.D = D;

    62 	// combine any conf file D options with the commandline D options

    63 	if (defined(JSDOC.conf)) for (var c in JSDOC.conf.D) {

    64  		if (!defined(JSDOC.opt.D[c])) {

    65  			JSDOC.opt.D[c] = JSDOC.conf.D[c];

    66  		}

    67  	}

    68 	

    69 	// Give plugins a chance to initialize

    70 	if (defined(JSDOC.PluginManager)) {

    71 		JSDOC.PluginManager.run("onInit", JSDOC.opt);

    72 	}

    73 

    74 	JSDOC.opt.srcFiles = JSDOC.JsDoc._getSrcFiles();

    75 	JSDOC.JsDoc._parseSrcFiles();

    76 	JSDOC.JsDoc.symbolSet = JSDOC.Parser.symbols;

    77 }

    78 

    79 /**

    80 	Retrieve source file list.

    81 	@returns {String[]} The pathnames of the files to be parsed.

    82  */

    83 JSDOC.JsDoc._getSrcFiles = function() {

    84 	JSDOC.JsDoc.srcFiles = [];

    85 	

    86 	var ext = ["js"];

    87 	if (JSDOC.opt.x) {

    88 		ext = JSDOC.opt.x.split(",").map(function($) {return $.toLowerCase()});

    89 	}

    90 	

    91 	for (var i = 0; i < JSDOC.opt._.length; i++) {

    92 		JSDOC.JsDoc.srcFiles = JSDOC.JsDoc.srcFiles.concat(

    93 			IO.ls(JSDOC.opt._[i], JSDOC.opt.r).filter(

    94 				function($) {

    95 					var thisExt = $.split(".").pop().toLowerCase();

    96 					

    97 					if (JSDOC.opt.E) {

    98 						for(var n = 0; n < JSDOC.opt.E.length; n++) {

    99 							if ($.match(new RegExp(JSDOC.opt.E[n]))) {

   100 								LOG.inform("Excluding " + $);

   101 								return false; // if the file matches the regex then it's excluded.

   102 							}

   103 						}

   104 					}

   105 					

   106 					return (ext.indexOf(thisExt) > -1); // we're only interested in files with certain extensions

   107 				}

   108 			)

   109 		);

   110 	}

   111 	

   112 	return JSDOC.JsDoc.srcFiles;

   113 }

   114 

   115 JSDOC.JsDoc._parseSrcFiles = function() {

   116 	JSDOC.Parser.init();

   117 	for (var i = 0, l = JSDOC.JsDoc.srcFiles.length; i < l; i++) {

   118 		var srcFile = JSDOC.JsDoc.srcFiles[i];

   119 		

   120 		if (JSDOC.opt.v) LOG.inform("Parsing file: " + srcFile);

   121 		

   122 		try {

   123 			var src = IO.readFile(srcFile);

   124 		}

   125 		catch(e) {

   126 			LOG.warn("Can't read source file '"+srcFile+"': "+e.message);

   127 		}

   128 

   129 		var tr = new JSDOC.TokenReader();

   130 		var ts = new JSDOC.TokenStream(tr.tokenize(new JSDOC.TextStream(src)));

   131 

   132 		JSDOC.Parser.parse(ts, srcFile);

   133 

   134 	}

   135 	JSDOC.Parser.finish();

   136 

   137 	if (JSDOC.PluginManager) {

   138 		JSDOC.PluginManager.run("onFinishedParsing", JSDOC.Parser.symbols);

   139 	}

   140 }