PR - Command Bundle

.gitignore

@@ -6,3 +6,6 @@ node_modules
 # Logs & System
 *.log
 *.pid
+
+# IDE
+.idea

.travis.yml

@@ -6,3 +6,10 @@ script:
     - npm run it
 after_success:
     - test $TRAVIS_BRANCH = "master" && npm run coveralls
+notifications:
+  webhooks:
+    urls:
+      - https://webhooks.gitter.im/e/19547337979e0c84f48d
+    on_success: change  # options: [always|never|change] default: always
+    on_failure: always  # options: [always|never|change] default: always
+    on_start: never     # options: [always|never|change] default: always

README.md

@@ -3,6 +3,7 @@
 
 [![Build Status](https://travis-ci.org/nahuelio/squarebox.svg?branch=master)](https://travis-ci.org/nahuelio/squarebox)
 [![Coverage Status](https://coveralls.io/repos/github/nahuelio/squarebox/badge.svg)](https://coveralls.io/github/nahuelio/squarebox)
+[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/sqbox/General?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 [![Version](https://img.shields.io/badge/Version-1.0.0-blue.svg?style=flat)]()
 [![Version](https://img.shields.io/badge/License-MIT-blue.svg?style=flat)](http://www.opensource.org/licenses/mit-license.php)
 [![GitHub stars](https://img.shields.io/github/stars/nahuelio/squarebox.svg?style=social&label=Stars)]()
@@ -15,42 +16,48 @@ Experimental ES6/CommonJS/AMD Module Bundler
 
 ```npm install [-g] squarebox```
 
-#### Usage
+### Usage
 
-CLI Commands
+```sqbox [command] [options]```
 
-```
-global option: -c (sqbox.js|.sqboxrc|URL) | Default: ./.sqboxrc
-contextual help - sqbox [command] help
+#### Commands
 
-* sqbox help - global help (list of commands and general usage)
-* sbox bundle --options
-* sbox clean
-* sbox visualize
-```
+* **help** - Global Help
+* **bundle help** - Contextual help for command ```bundle```
+* **bundle** - Bundles your project
+	* Options
+		* [-c, --config] (sqbox.js, .sqboxrc, or a remote url) | Default: [currentDirectory]/.sqboxrc
+		* TODO Overrides...
+* **clean** - Clean destination folder
+	* Options
+		* ...TODO
+* **graph** - Generates a graphical report of your current bundling strategy
+	* Options
+		* ...TODO
 
-Programmatic API
+#### Programmatic API
 
 ```
 const sqbox = require('squarebox');
+// Or ES6: import sqbox from 'squarebox';
 sqbox.clean([opts])
 	.bundle([config])
-	.visualize([opts]);
+	.graph([opts]);
 ```
 
 #### Official Documentation
 
 ```
-TODO
+TODO: Official Website / APIDocs
 ```
 
-#### Configuration
+#### Contribute
 
 ```
 TODO
 ```
 
-#### Contribute
+#### License
 
 ```
 TODO

lib/bin/commands.json

@@ -17,7 +17,8 @@
 		"override": { "default": false },
 		"config": { "default": ".sqboxrc" },
 		"url": {},
-		"target": { "default": "./dist" }
+		"target": { "default": "./dist" },
+		"logLevel": { "alias": "lv", "default": "output" }
 	}
 }, {
 	"name": "bundle",
@@ -28,10 +29,12 @@
 		"override": { "default": false },
 		"config": { "default": ".sqboxrc" },
 		"url": { "alias": "u" },
+		"basePath": { "alias": "b", "default": "./" },
 		"scan": { "alias": "s", "default": "." },
 		"exclude": { "alias": "x" },
 		"extensions": { "alias": "e", "default": ".js,.jsx,.es6,.es" },
 		"alias": { "alias": "a", "default": {} },
+		"external": { "alias": "l", "default": "" },
  		"target": { "alias": "t", "default": "dist>umd:./dist" },
 		"logLevel": { "alias": "lv", "default": "output" }
 	}
@@ -44,6 +47,7 @@
 		"override": { "default": false },
 		"config": { "default": ".sqboxrc" },
 		"url": {},
-		"target": { "default": "./dist" }
+		"target": { "default": "./dist" },
+		"logLevel": { "alias": "lv", "default": "output" }
 	}
 }]

lib/bin/sqbox.es6

@@ -1,10 +1,12 @@
 /**
 *	@module bin
 *	@author Patricio Ferreira <3dimentionar@gmail.com>
+*	@Notes Think about the API require('sqbox').clean({}).bundle({}).graph({});
 **/
 import 'util/mixins';
 import extend from 'extend';
 import Collection from 'util/adt/collection';
+import StackAsync from 'util/adt/stack-async';
 import Factory from 'util/factory/factory';
 import Command from 'command';
 import CommandsList from './commands.json';
@@ -23,21 +25,22 @@ class SquareBox extends Command {
 	/**
 	*	Constructor
 	*	@public
-	*	@param {Object} [args = {}] - Constructor arguments
+	*	@param {Symbol} _enforcer - private enforcer symbol
+	*	@param {Object} [...args] - Constructor arguments
 	*	@return {bin.SquareBox}
 	**/
-	constructor(...args) {
+	constructor(_enforcer, ...args) {
 		super(...args);
-		return SquareBox.isPrivate(this.attachEvents());
+		return SquareBox.isPrivate(_enforcer, this.attachEvents());
 	}
 
 	/**
-	*	Attaches Events
+	*	Attach Events
 	*	@public
 	*	@return {bin.SquareBox}
 	**/
 	attachEvents() {
-		this.once(SquareBox.events.done, this.after);
+		this.stack.on(StackAsync.events.push, _.bind(this.onCommand, this));
 		return this;
 	}
 
@@ -48,7 +51,6 @@ class SquareBox extends Command {
 	*	@return {bin.SquareBox}
 	**/
 	before() {
-		super.before();
 		this.commander.read();
 		return this;
 	}
@@ -61,44 +63,57 @@ class SquareBox extends Command {
 	**/
 	run() {
 		this.before();
-		this.configuration.parse().then(_.bind(this.onConfiguration, this));
+		this.configuration.parse()
+			.then(_.bind(this.push, this, this, this.options.path))
+			.catch(_.bind(this.after, this));
 		return this;
 	}
 
 	/**
-	*	Configuration Loaded and Parsed Handler
+	*	Subcommand push Handler
 	*	@public
-	*	@param {visitors.Configuration} configuration - configuration visitor reference
+	*	@param {util.adt.StackAsync} stack - stack reference
+	*	@param {Command} command - command offered
 	*	@return {bin.SquareBox}
 	**/
-	onConfiguration() {
-		const { path } = this.options;
-		//console.log(_.pick(this, Command.options));
-		// TODO: Factory.get(path, this.params()).run();
-		return this;
+	onCommand(stack, command) {
+		let dependents = command.getDependsOn();
+		return (dependents.length > 0) ? _.reduce(dependents, this.push, this, this) : this.after();
 	}
 
 	/**
-	*	Constructor Validation
+	*	After Run
 	*	@public
-	*	@throws {Error} Private violation
-	*	@param {Symbol} pte - constructor enforcer
+	*	@override
+	*	@param {Error} [err] - error reference
 	*	@return {bin.SquareBox}
 	**/
-	isPrivate(pte) {
-		if(!_.isEqual(pte, enforcer)) throw new Error('Private Violation');
+	after(err, results) {
+		if(_.defined(err)) logger(err.message).fatal();
+		if(this.stack.isEmpty()) return this.complete(results);
+		this.stack.pop().then(_.bind(this.after, this, null)).catch(_.bind(this.after, this));
 		return this;
 	}
 
 	/**
-	*	Register Command Factories
+	*	SquareBox Complete Handler
 	*	@public
-	*	@override
+	*	@param {Array} results - all Results
 	*	@return {bin.SquareBox}
 	**/
-	register() {
-		super.register();
-		Factory.registerAll(this.constructor.commands);
+	complete(results) {
+		return super.after();
+	}
+
+	/**
+	*	Constructor Validation
+	*	@public
+	*	@throws {Error} Private violation
+	*	@param {Symbol} pte - constructor enforcer
+	*	@return {bin.SquareBox}
+	**/
+	isPrivate(pte) {
+		if(!_.isEqual(pte, enforcer)) throw new Error('Private Violation');
 		return this;
 	}
 
@@ -110,24 +125,25 @@ class SquareBox extends Command {
 	static commands = Collection.new(CommandsList);
 
 	/**
-	*	SquareBox visitors
+	*	Command Visitors
 	*	@static
 	*	@override
-	*	@type {Array}
+	*	@type {util.adt.Collection}
 	**/
-	static visitors = [
+	static visitors = Collection.new(Command.visitors.toJSON().concat([
 		'visitors/commander',
 		'visitors/configuration'
-	].concat(Command.visitors);
+	]));
 
 	/**
 	*	Static enforcer validation
 	*	@static
+	*	@param {Symbol} _enforcer - private enforcer symbol
 	*	@param {bin.SquareBox} instance - squarebox instance reference
 	*	@return {bin.SquareBox}
 	**/
-	static isPrivate(instance) {
-		return instance.isPrivate(enforcer);
+	static isPrivate(_enforcer, instance) {
+		return instance.isPrivate(_enforcer);
 	}
 
 	/**
@@ -144,7 +160,7 @@ class SquareBox extends Command {
 	*	@return {bin.SquareBox}
 	**/
 	static run(cwd = process.cwd()) {
-		return this.new({ cwd }).run();
+		return this.new(enforcer, { cwd }).run();
 	}
 
 }