Lots of updates

.gitignore

@@ -1,4 +1,6 @@
 ._*
 .DS_Store
 npm-debug.log
-node_modules
+node_modules
+lib-cov
+coverage.html

.npmignore

@@ -3,3 +3,9 @@
 node_modules
 *.sublime-project
 *.sublime-workspace
+docs
+tests
+lib-cov
+coverage.html
+forge
+forge-tools

README.md

@@ -1,22 +1,54 @@
 ## Overview
 
-[Titanium](https://github.com/appcelerator/titanium) is a [Command Line Tool (CLI)](http://en.wikipedia.org/wiki/Command-line_interface)
-for managing and deploying Titanium Mobile applications and modules. It's open-source and easy to use. [We've](https://github.com/appcelerator)
-designed Titanium to be suitable for command line beginners, but still be powerful and extensible enough for production usage.
+[Titanium CLI](https://github.com/appcelerator/titanium) is a
+[Command Line Tool](http://en.wikipedia.org/wiki/Command-line_interface)
+for creating and building Titanium Mobile applications and modules. It's
+open-source and easy to use. [We've](https://github.com/appcelerator)
+designed Titanium to be suitable for command line beginners, but still be
+powerful and extensible enough for production usage.
 
-## Installation
+## Prerequisites
 
-    [sudo] npm install titanium -g
+The Titanium CLI requires [Node.js 0.8.x](http://nodejs.org/dist/). You can
+download Node.js 0.10.x, but only Titanium SDK 3.1.0 and later will work.
 
-After npm download and installs the Titanium CLI, then you need to download the latest unstable Titanium Mobile SDK:
+## Installation
 
-    titanium sdk install --branch 3_0_X --default
+    [sudo] npm install -g titanium
 
 ## Bleeding Edge
 
-You can download the latest and greatest *unstable* code by running the following:
+You can download the latest and greatest *unstable* Titanium CLI code by
+running the following:
+
+    [sudo] npm install -g git://github.com/appcelerator/titanium.git
+
+## Obtaining a Titanium SDK
+
+You will need to download a Titanium SDK 3.0 or newer:
+
+    # stable release (recommended)
+    titanium sdk install --default
+
+There are times when the latest stable release has an issue or lacks a feature
+in which case you may want to try an unstable Titanium SDK build. These builds
+are not recommended for production use, but should work for development.
+
+    # unstable next release
+    titanium sdk install --branch 3_1_X --default
+
+    # bleeding edge
+    titanium sdk install --branch master --default
+
+## Setting up the Titanium CLI
 
-    [sudo] npm install git://github.com/appcelerator/titanium.git -g
+Before you begin using the Titanium CLI, you should configure it by running the
+"setup" command:
+
+    titanium setup
+
+It will prompt you with a number of questions such as your e-mail address (for
+logging into the Appcelerator Network), the location of your Android SDK, and so on.
 
 ## Usage
 
@@ -125,40 +157,111 @@ Download and install the latest version for the specified branch if not already
 
     titanium sdk update --branch master
 
-### status
+### setup
 
-Checks authentication, SDK, and project status.
+Reconfigures the Titanium CLI by asking you a series of questions.
 
-**Implementation not complete**
+    titanium setup
+
+### status
+
+Indicates whether you are logged in or not.
 
     titanium status
 
-    titanium status --dir /path/to/project
+    titanium status --output json
 
 ### version
 
 Displays the current version of the CLI and exits.
 
-    titanium version
+    titanium -v
+
     titanium --version
 
-## Looking for the old CLI?
+### info
 
-Don't worry, it's still around. You can install it by running:
+Displays information about your development environment including Xcode installs,
+iOS SDKs, Android SDKs, and so on.
 
-    sudo npm install –g titanium@0.0.26
+    titanium info
 
-## Contributing
+    titanium info -o json
 
-Titanium is an open source project.  Titanium wouldn't be where it is now without contributions by the community. Please consider forking this repo to improve, enhance or fix issues. If you feel like the community will benefit from your fork, please open a pull request. 
+## Hacking the Titanium CLI
 
-To protect the interests of the Titanium contributors, Appcelerator, customers and end users we require contributors to sign a Contributors License Agreement (CLA) before we pull the changes into the main repository. Our CLA is simple and straightforward - it requires that the contributions you make to any Appcelerator open source project are properly licensed and that you have the legal authority to make those changes. This helps us significantly reduce future legal risk for everyone involved. It is easy, helps everyone, takes only a few minutes, and only needs to be completed once. 
+In order to begin hacking on the Titanium CLI, you need to download and install
+[git](http://git-scm.com/).
+
+If you have already installed a previous version of the Titanium CLI, it's
+recommended you uninstall the old one first:
+
+    [sudo] npm uninstall -g titanium
+
+The Titanium CLI is essentially pure JavaScript, so there is no build process.
+You just need to pull the code and resolve the dependendencies.
+
+    git clone git@github.com:appcelerator/titanium.git
+    cd titanium
+    npm install
+    sudo npm link
+
+### Running Unit Tests
+
+To run the unit tests, simply run:
+
+    node forge test
+
+### Running Code Coverage
+
+To generate the code coverage, you first must install
+[node-jscoverage](https://github.com/visionmedia/node-jscoverage). The easist
+way to do this is run:
+
+    git clone git@github.com:visionmedia/node-jscoverage.git
+    cd node-jscoverage
+    ./configure
+    make
+    sudo make install
+
+Then run:
+
+	node forge test-cov
+
+It will generate a file called _coverage.html_ in the Titanium CLI directory.
+
+## Looking for the really old CLI?
+
+Don't worry, it's still around. You can install it by running:
+
+    [sudo] npm install –g titanium@0.0.26
+
+## Contributing
 
-[You can digitally sign the CLA](http://bit.ly/app_cla) online. Please indicate your email address in your first pull request so that we can make sure that will locate your CLA.  Once you've submitted it, you no longer need to send one for subsequent submissions.
+Titanium is an open source project. Titanium wouldn't be where it is now without
+contributions by the community. Please consider forking this repo to improve,
+enhance or fix issues. If you feel like the community will benefit from your
+fork, please open a pull request.
+
+To protect the interests of the Titanium contributors, Appcelerator, customers
+and end users we require contributors to sign a Contributors License Agreement
+(CLA) before we pull the changes into the main repository. Our CLA is simple and
+straightforward - it requires that the contributions you make to any
+Appcelerator open source project are properly licensed and that you have the
+legal authority to make those changes. This helps us significantly reduce future
+legal risk for everyone involved. It is easy, helps everyone, takes only a few
+minutes, and only needs to be completed once.
+
+[You can digitally sign the CLA](http://bit.ly/app_cla) online. Please indicate
+your e-mail address in your first pull request so that we can make sure that
+will locate your CLA. Once you've submitted it, you no longer need to send one
+for subsequent submissions.
 
 ## License
 
-This project is open source and provided under the Apache Public License (version 2). Please make sure you see the `LICENSE` file
-included in this distribution for more details on the license.  Also, please take notice of the privacy notice at the end of the file.
+This project is open source and provided under the Apache Public License
+(version 2). Please make sure you see the `LICENSE` file included in this
+distribution for more details on the license.  Also, please take notice of the
+privacy notice at the end of the file.
 
 #### (C) Copyright 2012-2013, [Appcelerator](http://www.appcelerator.com/) Inc. All Rights Reserved.

forge

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+/**
+ * forge - make-like tool
+ *
+ * @copyright
+ * Copyright (c) 2009-2013 by Appcelerator, Inc. All Rights Reserved.
+ *
+ * @license
+ * Licensed under the terms of the Apache Public License
+ * Please see the LICENSE included with this distribution for details.
+ */
+
+var toolsDir = './forge-tools',
+	spawn = require('child_process').spawn,
+	fs = require('fs'),
+	path = require('path'),
+	colors = require('colors');
+
+global.which = function which(program, fn) {
+	if (process.platform == 'win32') {
+		fn(); // no 'which' on windows
+	} else {
+		spawn('which', [ program ]).on('exit', fn);
+	}
+};
+
+global.rootDir = __dirname;
+
+var tools = {};
+fs.readdirSync(toolsDir = path.resolve(toolsDir)).forEach(function (name) {
+	var m, file = path.join(toolsDir, name);
+	if (fs.statSync(file).isDirectory()) {
+		if (fs.existsSync(m = path.join(file, 'index.js'))) {
+			tools[name] = m;
+		}
+	} else if (m = name.match(/^(?!\.|_)(.+)\.js$/)) {
+		tools[m[1]] = file;
+	}
+});
+
+function help(err) {
+	console.log('Forge'.cyan.bold + ' - Copyright (c) 2012-' + (new Date).getFullYear() + ', Appcelerator, Inc.  All Rights Reserved.\n');
+	console.log('Usage: ' + 'forge <tool> [options]'.cyan + '\n');
+	err && console.error(err.red + '\n');
+	console.error('Available tools:');
+	Object.keys(tools).sort().forEach(function (t) {
+		console.log('   ' + t.cyan);
+	});
+	console.log();
+	process.exit(err ? 1 : 0);
+}
+
+var args = process.argv.slice(2),
+	tool = args.shift();
+
+if (tool && !tools[tool]) {
+	help('ERROR: Invalid tool "' + tool + '"');
+} else if (!tool) {
+	help();
+}
+
+require(tools[tool]).apply(null, args);

forge-tools/test-cov/index.js

@@ -0,0 +1,84 @@
+/**
+ * Generates lib-cov files, then runs all unit tests and an html-based
+ * coverage report.
+ *
+ * @copyright
+ * Copyright (c) 2009-2013 by Appcelerator, Inc. All Rights Reserved.
+ *
+ * @license
+ * Licensed under the terms of the Apache Public License
+ * Please see the LICENSE included with this distribution for details.
+ */
+
+module.exports = function () {
+	var spawn = require('child_process').spawn,
+		fs = require('fs'),
+		path = require('path'),
+		colors = require('colors'),
+		wrench = require('wrench'),
+		args = Array.prototype.slice.call(arguments);
+
+	console.log('Code Coverage Tool'.cyan.bold + ' - Copyright (c) 2012-' + (new Date).getFullYear() + ', Appcelerator, Inc.  All Rights Reserved.\n');
+
+	which('jscoverage', function (code) {
+		if (code) {
+			console.error('ERROR: Unable to find "jscoverage".\n\n'.red
+				+ 'You can download it by visiting "https://github.com/visionmedia/node-jscoverage" or by running:\n\n'
+				+ '   git clone https://github.com/visionmedia/node-jscoverage.git\n'
+				+ '   cd node-jscoverage\n'
+				+ '   configure\n'
+				+ '   make\n'
+				+ '   sudo make install\n');
+			process.exit(1);
+		} else {
+			var startTime = Date.now();
+			console.log('Generating lib-cov...');
+
+			wrench.rmdirSyncRecursive(path.join(rootDir, 'lib-cov'), true);
+			var child = spawn('jscoverage', ['lib', 'lib-cov'], { cwd: rootDir }),
+				err = '';
+
+			child.stderr.on('data', function (data) {
+				err += data.toString();
+			});
+
+			child.on('close', function (code) {
+				if (code) {
+					console.error('\nERROR: jscoverage failed (' + code + ')\n'.red);
+					err && console.error(err.trim() + '\n');
+				} else {
+					console.log('lib-cov generation completed successfully in ' + (Date.now() - startTime) + ' ms\n');
+
+					startTime = Date.now();
+					console.log('Generating coverage.html...');
+
+					var coverageFile = path.join(rootDir, 'coverage.html');
+					fs.existsSync(coverageFile) && fs.unlinkSync(coverageFile);
+
+					process.env.APPC_COV = path.join(__dirname, 'templates');
+
+					var test = spawn(process.execPath, [ path.join(rootDir, 'tests', 'run.js') ].concat(args), {
+							env: process.env,
+							cwd: rootDir
+						}),
+						output = '';
+
+					test.stdout.on('data', function (data) {
+						output += data.toString();
+					});
+
+					test.stderr.pipe(process.stderr);
+
+					test.on('exit', function (code) {
+						if (!code) {
+							fs.writeFileSync(coverageFile, output);
+							console.log('coverage.html generated successfully in ' + (Date.now() - startTime) + ' ms\n');
+						} else {
+							console.error(output);
+						}
+					});
+				}
+			});
+		}
+	});
+};