Added alias feature

examples/deploy

@@ -24,6 +24,7 @@ program
 
 program
   .command('exec <cmd>')
+  .alias('ex')
   .description('execute the given remote cmd')
   .option("-e, --exec_mode <mode>", "Which exec mode to use")
   .action(function(cmd, options){

index.js

@@ -211,7 +211,7 @@ Command.prototype.parseExpectedArgs = function(args){
 
 Command.prototype.action = function(fn){
   var self = this;
-  this.parent.on(this._name, function(args, unknown){
+  var listener = function(args, unknown){
     // Parse any so-far unknown options
     args = args || [];
     unknown = unknown || [];
@@ -247,7 +247,9 @@ Command.prototype.action = function(fn){
     }
 
     fn.apply(this, args);
-  });
+  };
+  this.parent.on(this._name, listener);
+  if (this._alias) this.parent.on(this._alias, listener);
   return this;
 };
 
@@ -673,6 +675,20 @@ Command.prototype.description = function(str){
   return this;
 };
 
+/**
+ * Set an alias for the command
+ *
+ * @param {String} alias
+ * @return {String|Command}
+ * @api public
+ */
+
+Command.prototype.alias = function(alias){
+  if (0 == arguments.length) return this._alias;
+  this._alias = alias;
+  return this;
+};
+
 /**
  * Set / get the command usage `str`.
  *
@@ -751,13 +767,17 @@ Command.prototype.commandHelp = function(){
           : '[' + arg.name + ']';
       }).join(' ');
 
-      return pad(cmd._name
+      return cmd._name
+        + (cmd._alias
+          ? '|' + cmd._alias
+          : '')
         + (cmd.options.length
           ? ' [options]'
-          : '') + ' ' + args, 22)
+          : '') + ' ' + args
         + (cmd.description()
-          ? ' ' + cmd.description()
-          : '');
+          ? '\n   ' + cmd.description()
+          : '')
+        + '\n';
     }).join('\n').replace(/^/gm, '    ')
     , ''
   ].join('\n');
@@ -773,7 +793,11 @@ Command.prototype.commandHelp = function(){
 Command.prototype.helpInformation = function(){
   return [
       ''
-    , '  Usage: ' + this._name + ' ' + this.usage()
+    , '  Usage: ' + this._name
+        + (this._alias
+          ? '|' + this._alias
+          : '')
+        + ' ' + this.usage()
     , '' + this.commandHelp()
     , '  Options:'
     , ''

test/test.options.commands.js

@@ -29,6 +29,7 @@ program
 
 program
   .command('exec <cmd>')
+  .alias('ex')
   .description('execute the given remote cmd')
   .option("-e, --exec_mode <mode>", "Which exec mode to use")
   .option("-t, --target [target]", "Target to use")
@@ -85,6 +86,12 @@ program.commands[1].exec_mode.should.equal("mode2");
 program.commands[1].target.should.equal("target1");
 cmdValue.should.equal("exec3");
 
+program.parse(['node', 'test', '--config', 'conf7', 'ex', '-e', 'mode3', 'exec4']);
+program.config.should.equal("conf7");
+program.commands[1].exec_mode.should.equal("mode3");
+program.commands[1].should.not.have.property.target;
+cmdValue.should.equal("exec4");
+
 // Make sure we still catch errors with required values for options
 var exceptionOccurred = false;
 var oldProcessExit = process.exit;