coa 0.4.1 → 1.0.3

package/lib/arg.js

@@ -1,175 +1,58 @@
-// Generated by CoffeeScript 1.6.3
-var Arg, Cmd, Color, Opt;
+'use strict';
 
-Color = require('./color').Color;
-
-Cmd = require('./cmd').Cmd;
-
-Opt = require('./opt').Opt;
+const
+    CoaParam = require('./coaparam'),
+    Color = require('./color');
 
 /**
-Argument
-
-Unnamed entity. From command line arguments passed as list of unnamed values.
-@namespace
-@class Presents argument
-*/
-
-
-exports.Arg = Arg = (function() {
-  /**
-  @constructs
-  @param {COA.Cmd} cmd parent command
-  */
-
-  function Arg(_cmd) {
-    this._cmd = _cmd;
-    this._cmd._args.push(this);
-  }
-
-  /**
-  Set a canonical argument identifier to be used anywhere in text messages.
-  @param {String} _name argument name
-  @returns {COA.Arg} this instance (for chainability)
-  */
-
-
-  Arg.prototype.name = Opt.prototype.name;
-
-  /**
-  Set a long description for argument to be used anywhere in text messages.
-  @param {String} _title argument title
-  @returns {COA.Arg} this instance (for chainability)
-  */
-
-
-  Arg.prototype.title = Cmd.prototype.title;
-
-  /**
-  Makes an argument accepts multiple values.
-  Otherwise, the value will be used by the latter passed.
-  @returns {COA.Arg} this instance (for chainability)
-  */
-
-
-  Arg.prototype.arr = Opt.prototype.arr;
-
-  /**
-  Makes an argument required.
-  @returns {COA.Arg} this instance (for chainability)
-  */
-
-
-  Arg.prototype.req = Opt.prototype.req;
-
-  /**
-  Set a validation (or value) function for argument.
-  Value from command line passes through before becoming available from API.
-  Using for validation and convertion simple types to any values.
-  @param {Function} _val validating function,
-      invoked in the context of argument instance
-      and has one parameter with value from command line
-  @returns {COA.Arg} this instance (for chainability)
-  */
-
-
-  Arg.prototype.val = Opt.prototype.val;
-
-  /**
-  Set a default value for argument.
-  Default value passed through validation function as ordinary value.
-  @param {Object} _def
-  @returns {COA.Arg} this instance (for chainability)
-  */
-
-
-  Arg.prototype.def = Opt.prototype.def;
-
-  /**
-  Set custom additional completion for current argument.
-  @param {Function} completion generation function,
-      invoked in the context of argument instance.
-      Accepts parameters:
-          - {Object} opts completion options
-      It can return promise or any other value treated as result.
-  @returns {COA.Arg} this instance (for chainability)
-  */
-
-
-  Arg.prototype.comp = Cmd.prototype.comp;
-
-  /**
-  Make argument value inputting stream.
-  It's add useful validation and shortcut for STDIN.
-  @returns {COA.Arg} this instance (for chainability)
-  */
-
-
-  Arg.prototype.input = Opt.prototype.input;
-
-  /**
-  Make argument value outputing stream.
-  It's add useful validation and shortcut for STDOUT.
-  @returns {COA.Arg} this instance (for chainability)
-  */
-
-
-  Arg.prototype.output = Opt.prototype.output;
-
-  Arg.prototype._parse = function(arg, args) {
-    return this._saveVal(args, arg);
-  };
-
-  Arg.prototype._saveVal = Opt.prototype._saveVal;
-
-  Arg.prototype._checkParsed = function(opts, args) {
-    return !args.hasOwnProperty(this._name);
-  };
-
-  Arg.prototype._usage = function() {
-    var res;
-    res = [];
-    res.push(Color('lpurple', this._name.toUpperCase()), ' : ', this._title);
-    if (this._req) {
-      res.push(' ', Color('lred', '(required)'));
+ * Argument
+ *
+ * Unnamed entity. From command line arguments passed as list of unnamed values.
+ *
+ * @class Arg
+ * @extends CoaParam
+ */
+module.exports = class Arg extends CoaParam {
+    /**
+     * @constructs
+     * @param {COA.Cmd} cmd - parent command
+     */
+    constructor(cmd) {
+        super(cmd);
+
+        this._cmd._args.push(this);
     }
-    return res.join('');
-  };
-
-  Arg.prototype._requiredText = function() {
-    return 'Missing required argument:\n  ' + this._usage();
-  };
-
-  /**
-  Return rejected promise with error code.
-  Use in .val() for return with error.
-  @param {Object} reject reason
-      You can customize toString() method and exitCode property
-      of reason object.
-  @returns {Q.promise} rejected promise
-  */
 
+    _saveVal(args, val) {
+        this._val && (val = this._val(val));
 
-  Arg.prototype.reject = Cmd.prototype.reject;
+        const name = this._name;
+        this._arr
+            ? (args[name] || (args[name] = [])).push(val)
+            : (args[name] = val);
 
-  /**
-  Finish chain for current option and return parent command instance.
-  @returns {COA.Cmd} parent command
-  */
+        return val;
+    }
 
+    _parse(arg, args) {
+        return this._saveVal(args, arg);
+    }
 
-  Arg.prototype.end = Cmd.prototype.end;
+    _checkParsed(opts, args) {
+        return !args.hasOwnProperty(this._name);
+    }
 
-  /**
-  Apply function with arguments in context of arg instance.
-  @param {Function} fn
-  @param {Array} args
-  @returns {COA.Arg} this instance (for chainability)
-  */
+    _usage() {
+        const res = [];
 
+        res.push(Color('lpurple', this._name.toUpperCase()), ' : ', this._title);
 
-  Arg.prototype.apply = Cmd.prototype.apply;
+        this._req && res.push(' ', Color('lred', '(required)'));
 
-  return Arg;
+        return res.join('');
+    }
 
-})();
+    _requiredText() {
+        return `Missing required argument:\n  ${this._usage()}`;
+    }
+};