cssesc-source 0.1.0 → 1.0.1

data/vendor/node_modules/grunt/node_modules/js-yaml/node_modules/argparse/lib/argparse.js

@@ -1,14 +0,0 @@
-'use strict';
-
-module.exports.ArgumentParser = require('./argument_parser.js');
-module.exports.Namespace = require('./namespace');
-module.exports.Action = require('./action');
-module.exports.HelpFormatter = require('./help/formatter.js');
-module.exports.Const = require('./const.js');
-
-module.exports.ArgumentDefaultsHelpFormatter =
-  require('./help/added_formatters.js').ArgumentDefaultsHelpFormatter;
-module.exports.RawDescriptionHelpFormatter =
-  require('./help/added_formatters.js').RawDescriptionHelpFormatter;
-module.exports.RawTextHelpFormatter =
-  require('./help/added_formatters.js').RawTextHelpFormatter;

data/vendor/node_modules/grunt/node_modules/js-yaml/node_modules/argparse/lib/argument/error.js

@@ -1,50 +0,0 @@
-'use strict';
-
-
-var format  = require('util').format;
-
-
-var ERR_CODE = 'ARGError';
-
-/*:nodoc:*
- * argumentError(argument, message) -> TypeError
- * - argument (Object): action with broken argument
- * - message (String): error message
- *
- * Error format helper. An error from creating or using an argument
- * (optional or positional). The string value of this exception
- * is the message, augmented with information
- * about the argument that caused it.
- *
- * #####Example
- *
- *      var argumentErrorHelper = require('./argument/error');
- *      if (conflictOptionals.length > 0) {
- *        throw argumentErrorHelper(
- *          action,
- *          format('Conflicting option string(s): %s', conflictOptionals.join(', '))
- *        );
- *      }
- *
- **/
-module.exports = function (argument, message) {
-  var argumentName = null;
-  var errMessage;
-  var err;
-
-  if (argument.getName) {
-    argumentName = argument.getName();
-  } else {
-    argumentName = '' + argument;
-  }
-
-  if (!argumentName) {
-    errMessage = message;
-  } else {
-    errMessage = format('argument "%s": %s', argumentName, message);
-  }
-
-  err = new TypeError(errMessage);
-  err.code = ERR_CODE;
-  return err;
-};

data/vendor/node_modules/grunt/node_modules/js-yaml/node_modules/argparse/lib/argument/exclusive.js

@@ -1,54 +0,0 @@
-/** internal
- * class MutuallyExclusiveGroup
- *
- * Group arguments.
- * By default, ArgumentParser groups command-line arguments
- * into “positional arguments” and “optional arguments”
- * when displaying help messages. When there is a better
- * conceptual grouping of arguments than this default one,
- * appropriate groups can be created using the addArgumentGroup() method
- *
- * This class inherited from [[ArgumentContainer]]
- **/
-'use strict';
-
-var util = require('util');
-
-var ArgumentGroup = require('./group');
-
-/**
- * new MutuallyExclusiveGroup(container, options)
- * - container (object): main container
- * - options (object): options.required -> true/false
- *
- * `required` could be an argument itself, but making it a property of
- * the options argument is more consistent with the JS adaptation of the Python)
- **/
-var MutuallyExclusiveGroup = module.exports = function MutuallyExclusiveGroup(container, options) {
-  var required;
-  options = options || {};
-  required = options.required || false;
-  ArgumentGroup.call(this, container);
-  this.required = required;
-
-};
-util.inherits(MutuallyExclusiveGroup, ArgumentGroup);
-
-
-MutuallyExclusiveGroup.prototype._addAction = function (action) {
-  var msg;
-  if (action.required) {
-    msg = 'mutually exclusive arguments must be optional';
-    throw new Error(msg);
-  }
-  action = this._container._addAction(action);
-  this._groupActions.push(action);
-  return action;
-};
-
-
-MutuallyExclusiveGroup.prototype._removeAction = function (action) {
-  this._container._removeAction(action);
-  this._groupActions.remove(action);
-};
-

data/vendor/node_modules/grunt/node_modules/js-yaml/node_modules/argparse/lib/argument/group.js

@@ -1,75 +0,0 @@
-/** internal
- * class ArgumentGroup
- *
- * Group arguments.
- * By default, ArgumentParser groups command-line arguments
- * into “positional arguments” and “optional arguments”
- * when displaying help messages. When there is a better
- * conceptual grouping of arguments than this default one,
- * appropriate groups can be created using the addArgumentGroup() method
- *
- * This class inherited from [[ArgumentContainer]]
- **/
-'use strict';
-
-var util = require('util');
-
-var ActionContainer = require('../action_container');
-
-
-/**
- * new ArgumentGroup(container, options)
- * - container (object): main container
- * - options (object): hash of group options
- *
- * #### options
- * - **prefixChars**  group name prefix
- * - **argumentDefault**  default argument value
- * - **title**  group title
- * - **description** group description
- *
- **/
-var ArgumentGroup = module.exports = function ArgumentGroup(container, options) {
-
-  options = options || {};
-
-  // add any missing keyword arguments by checking the container
-  options.conflictHandler = (options.conflictHandler || container.conflictHandler);
-  options.prefixChars = (options.prefixChars || container.prefixChars);
-  options.argumentDefault = (options.argumentDefault || container.argumentDefault);
-
-  ActionContainer.call(this, options);
-
-  // group attributes
-  this.title = options.title;
-  this._groupActions = [];
-
-  // share most attributes with the container
-  this._container = container;
-  this._registries = container._registries;
-  this._actions = container._actions;
-  this._optionStringActions = container._optionStringActions;
-  this._defaults = container._defaults;
-  this._hasNegativeNumberOptionals = container._hasNegativeNumberOptionals;
-  this._mutuallyExclusiveGroups = container._mutuallyExclusiveGroups;
-};
-util.inherits(ArgumentGroup, ActionContainer);
-
-
-ArgumentGroup.prototype._addAction = function (action) {
-  // Parent add action
-  action = ActionContainer.prototype._addAction.call(this, action);
-  this._groupActions.push(action);
-  return action;
-};
-
-
-ArgumentGroup.prototype._removeAction = function (action) {
-  // Parent remove action
-  ActionContainer.prototype._removeAction.call(this, action);
-  var actionIndex = this._groupActions.indexOf(action);
-  if (actionIndex >= 0) {
-    this._groupActions.splice(actionIndex, 1);
-  }
-};
-

data/vendor/node_modules/grunt/node_modules/js-yaml/node_modules/argparse/lib/argument_parser.js

@@ -1,1165 +0,0 @@
-/**
- * class ArgumentParser
- *
- * Object for parsing command line strings into js objects.
- *
- * Inherited from [[ActionContainer]]
- **/
-'use strict';
-
-var util    = require('util');
-var format  = require('util').format;
-var Path    = require('path');
-
-var _ = require('underscore');
-_.str = require('underscore.string');
-
-// Constants
-var $$ = require('./const');
-
-var ActionContainer = require('./action_container');
-
-// Errors
-var argumentErrorHelper = require('./argument/error');
-
-var HelpFormatter = require('./help/formatter');
-
-var Namespace = require('./namespace');
-
-
-/**
- * new ArgumentParser(options)
- *
- * Create a new ArgumentParser object.
- *
- * ##### Options:
- * - `prog`  The name of the program (default: sys.argv[0])
- * - `usage`  A usage message (default: auto-generated from arguments)
- * - `description`  A description of what the program does
- * - `epilog`  Text following the argument descriptions
- * - `parents`  Parsers whose arguments should be copied into this one
- * - `formatterClass`  HelpFormatter class for printing help messages
- * - `prefixChars`  Characters that prefix optional arguments
- * - `fromfilePrefixChars` Characters that prefix files containing additional arguments
- * - `argumentDefault`  The default value for all arguments
- * - `addHelp`  Add a -h/-help option
- * - `conflictHandler`  Specifies how to handle conflicting argument names
- * - `debug`  Enable debug mode. Argument errors throw exception in
- *   debug mode and process.exit in normal. Used for development and
- *   testing (default: false)
- *
- * See also [original guide][1]
- *
- * [1]:http://docs.python.org/dev/library/argparse.html#argumentparser-objects
- **/
-var ArgumentParser = module.exports = function ArgumentParser(options) {
-  var self = this;
-  options = options || {};
-
-  options.description = (options.description || null);
-  options.argumentDefault = (options.argumentDefault || null);
-  options.prefixChars = (options.prefixChars || '-');
-  options.conflictHandler = (options.conflictHandler || 'error');
-  ActionContainer.call(this, options);
-
-  options.addHelp = (options.addHelp === undefined || !!options.addHelp);
-  options.parents = (options.parents || []);
-  // default program name
-  options.prog = (options.prog || Path.basename(process.argv[1]));
-  this.prog = options.prog;
-  this.usage = options.usage;
-  this.epilog = options.epilog;
-  this.version = options.version;
-
-  this.debug = (options.debug === true);
-
-  this.formatterClass = (options.formatterClass || HelpFormatter);
-  this.fromfilePrefixChars = options.fromfilePrefixChars || null;
-  this._positionals = this.addArgumentGroup({title: 'Positional arguments'});
-  this._optionals = this.addArgumentGroup({title: 'Optional arguments'});
-  this._subparsers = null;
-
-  // register types
-  var FUNCTION_IDENTITY = function (o) {
-    return o;
-  };
-  this.register('type', 'auto', FUNCTION_IDENTITY);
-  this.register('type', null, FUNCTION_IDENTITY);
-  this.register('type', 'int', function (x) {
-    var result = parseInt(x, 10);
-    if (isNaN(result)) {
-      throw new Error(x + ' is not a valid integer.');
-    }
-    return result;
-  });
-  this.register('type', 'float', function (x) {
-    var result = parseFloat(x);
-    if (isNaN(result)) {
-      throw new Error(x + ' is not a valid float.');
-    }
-    return result;
-  });
-  this.register('type', 'string', function (x) {
-    return '' + x;
-  });
-
-  // add help and version arguments if necessary
-  var defaultPrefix = (this.prefixChars.indexOf('-') > -1) ? '-' : this.prefixChars[0];
-  if (options.addHelp) {
-    this.addArgument(
-      [defaultPrefix + 'h', defaultPrefix + defaultPrefix + 'help'],
-      {
-        action: 'help',
-        defaultValue: $$.SUPPRESS,
-        help: 'Show this help message and exit.'
-      }
-    );
-  }
-  if (this.version !== undefined) {
-    this.addArgument(
-      [defaultPrefix + 'v', defaultPrefix + defaultPrefix + 'version'],
-      {
-        action: 'version',
-        version: this.version,
-        defaultValue: $$.SUPPRESS,
-        help: "Show program's version number and exit."
-      }
-    );
-  }
-
-  // add parent arguments and defaults
-  options.parents.forEach(function (parent) {
-    self._addContainerActions(parent);
-    if (parent._defaults !== undefined) {
-      for (var defaultKey in parent._defaults) {
-        if (parent._defaults.hasOwnProperty(defaultKey)) {
-          self._defaults[defaultKey] = parent._defaults[defaultKey];
-        }
-      }
-    }
-  });
-
-};
-util.inherits(ArgumentParser, ActionContainer);
-
-/**
- * ArgumentParser#addSubparsers(options) -> [[ActionSubparsers]]
- * - options (object): hash of options see [[ActionSubparsers.new]]
- *
- * See also [subcommands][1]
- *
- * [1]:http://docs.python.org/dev/library/argparse.html#sub-commands
- **/
-ArgumentParser.prototype.addSubparsers = function (options) {
-  if (!!this._subparsers) {
-    this.error('Cannot have multiple subparser arguments.');
-  }
-
-  options = options || {};
-  options.debug = (this.debug === true);
-  options.optionStrings = [];
-  options.parserClass = (options.parserClass || ArgumentParser);
-
-
-  if (!!options.title || !!options.description) {
-
-    this._subparsers = this.addArgumentGroup({
-      title: (options.title || 'subcommands'),
-      description: options.description
-    });
-    delete options.title;
-    delete options.description;
-
-  } else {
-    this._subparsers = this._positionals;
-  }
-
-  // prog defaults to the usage message of this parser, skipping
-  // optional arguments and with no "usage:" prefix
-  if (!options.prog) {
-    var formatter = this._getFormatter();
-    var positionals = this._getPositionalActions();
-    var groups = this._mutuallyExclusiveGroups;
-    formatter.addUsage(this.usage, positionals, groups, '');
-    options.prog = _.str.strip(formatter.formatHelp());
-  }
-
-  // create the parsers action and add it to the positionals list
-  var ParsersClass = this._popActionClass(options, 'parsers');
-  var action = new ParsersClass(options);
-  this._subparsers._addAction(action);
-
-  // return the created parsers action
-  return action;
-};
-
-ArgumentParser.prototype._addAction = function (action) {
-  if (action.isOptional()) {
-    this._optionals._addAction(action);
-  } else {
-    this._positionals._addAction(action);
-  }
-  return action;
-};
-
-ArgumentParser.prototype._getOptionalActions = function () {
-  return this._actions.filter(function (action) {
-    return action.isOptional();
-  });
-};
-
-ArgumentParser.prototype._getPositionalActions = function () {
-  return this._actions.filter(function (action) {
-    return action.isPositional();
-  });
-};
-
-
-/**
- * ArgumentParser#parseArgs(args, namespace) -> Namespace|Object
- * - args (array): input elements
- * - namespace (Namespace|Object): result object
- *
- * Parsed args and throws error if some arguments are not recognized
- *
- * See also [original guide][1]
- *
- * [1]:http://docs.python.org/dev/library/argparse.html#the-parse-args-method
- **/
-ArgumentParser.prototype.parseArgs = function (args, namespace) {
-  var argv;
-  var result = this.parseKnownArgs(args, namespace);
-
-  args = result[0];
-  argv = result[1];
-  if (argv && argv.length > 0) {
-    this.error(
-      format('Unrecognized arguments: %s.', argv.join(' '))
-    );
-  }
-  return args;
-};
-
-/**
- * ArgumentParser#parseKnownArgs(args, namespace) -> array
- * - args (array): input options
- * - namespace (Namespace|Object): result object
- *
- * Parse known arguments and return tuple of result object
- * and unknown args
- *
- * See also [original guide][1]
- *
- * [1]:http://docs.python.org/dev/library/argparse.html#partial-parsing
- **/
-ArgumentParser.prototype.parseKnownArgs = function (args, namespace) {
-  var self = this;
-
-  // args default to the system args
-  args = args || process.argv.slice(2);
-
-  // default Namespace built from parser defaults
-  namespace = namespace || new Namespace();
-
-  self._actions.forEach(function (action) {
-    if (action.dest !== $$.SUPPRESS) {
-      if (!_.has(namespace, action.dest)) {
-        if (action.defaultValue !== $$.SUPPRESS) {
-          var defaultValue = action.defaultValue;
-          if (_.isString(action.defaultValue)) {
-            defaultValue = self._getValue(action, defaultValue);
-          }
-          namespace[action.dest] = defaultValue;
-        }
-      }
-    }
-  });
-
-  _.keys(self._defaults).forEach(function (dest) {
-    namespace[dest] = self._defaults[dest];
-  });
-
-  // parse the arguments and exit if there are any errors
-  try {
-    var res = this._parseKnownArgs(args, namespace);
-
-    namespace = res[0];
-    args = res[1];
-    if (_.has(namespace, $$._UNRECOGNIZED_ARGS_ATTR)) {
-      args = _.union(args, namespace[$$._UNRECOGNIZED_ARGS_ATTR]);
-      delete namespace[$$._UNRECOGNIZED_ARGS_ATTR];
-    }
-    return [namespace, args];
-  } catch (e) {
-    this.error(e);
-  }
-};
-
-ArgumentParser.prototype._parseKnownArgs = function (argStrings, namespace) {
-  var self = this;
-
-  var extras = [];
-
-  // replace arg strings that are file references
-  if (this.fromfilePrefixChars !== null) {
-    argStrings = this._readArgsFromFiles(argStrings);
-  }
-  // map all mutually exclusive arguments to the other arguments
-  // they can't occur with
-  // Python has 'conflicts = action_conflicts.setdefault(mutex_action, [])'
-  // though I can't conceive of a way in which an action could be a member
-  // of two different mutually exclusive groups.
-
-  function actionHash(action) {
-      // some sort of hashable key for this action
-      // action itself cannot be a key in actionConflicts
-      // I think getName() (join of optionStrings) is unique enough
-      return action.getName();
-    }
-  var conflicts, key;
-  var actionConflicts = {};
-  this._mutuallyExclusiveGroups.forEach(function (mutexGroup) {
-    mutexGroup._groupActions.forEach(function (mutexAction, i, groupActions) {
-      key = actionHash(mutexAction);
-      if (!_.has(actionConflicts, key)) {
-        actionConflicts[key] = [];
-      }
-      conflicts = actionConflicts[key];
-      conflicts.push.apply(conflicts, groupActions.slice(0, i));
-      conflicts.push.apply(conflicts, groupActions.slice(i + 1));
-    });
-  });
-
-  // find all option indices, and determine the arg_string_pattern
-  // which has an 'O' if there is an option at an index,
-  // an 'A' if there is an argument, or a '-' if there is a '--'
-  var optionStringIndices = {};
-
-  var argStringPatternParts = [];
-
-  argStrings.forEach(function (argString, argStringIndex) {
-    if (argString === '--') {
-      argStringPatternParts.push('-');
-      while (argStringIndex < argStrings.length) {
-        argStringPatternParts.push('A');
-        argStringIndex++;
-      }
-    }
-    // otherwise, add the arg to the arg strings
-    // and note the index if it was an option
-    else {
-      var pattern;
-      var optionTuple = self._parseOptional(argString);
-      if (!optionTuple) {
-        pattern = 'A';
-      }
-      else {
-        optionStringIndices[argStringIndex] = optionTuple;
-        pattern = 'O';
-      }
-      argStringPatternParts.push(pattern);
-    }
-  });
-  var argStringsPattern = argStringPatternParts.join('');
-
-  var seenActions = [];
-  var seenNonDefaultActions = [];
-
-
-  function takeAction(action, argumentStrings, optionString) {
-    seenActions.push(action);
-    var argumentValues = self._getValues(action, argumentStrings);
-
-    // error if this argument is not allowed with other previously
-    // seen arguments, assuming that actions that use the default
-    // value don't really count as "present"
-    if (argumentValues !== action.defaultValue) {
-      seenNonDefaultActions.push(action);
-      if (!!actionConflicts[actionHash(action)]) {
-        actionConflicts[actionHash(action)].forEach(function (actionConflict) {
-          if (seenNonDefaultActions.indexOf(actionConflict) >= 0) {
-            throw argumentErrorHelper(
-              action,
-              format('Not allowed with argument "%s".', actionConflict.getName())
-            );
-          }
-        });
-      }
-    }
-
-    if (argumentValues !== $$.SUPPRESS) {
-      action.call(self, namespace, argumentValues, optionString);
-    }
-  }
-
-  function consumeOptional(startIndex) {
-    // get the optional identified at this index
-    var optionTuple = optionStringIndices[startIndex];
-    var action = optionTuple[0];
-    var optionString = optionTuple[1];
-    var explicitArg = optionTuple[2];
-
-    // identify additional optionals in the same arg string
-    // (e.g. -xyz is the same as -x -y -z if no args are required)
-    var actionTuples = [];
-
-    var args, argCount, start, stop;
-
-    while (true) {
-      if (!action) {
-        extras.push(argStrings[startIndex]);
-        return startIndex + 1;
-      }
-      if (!!explicitArg) {
-        argCount = self._matchArgument(action, 'A');
-
-        // if the action is a single-dash option and takes no
-        // arguments, try to parse more single-dash options out
-        // of the tail of the option string
-        var chars = self.prefixChars;
-        if (argCount === 0 && chars.indexOf(optionString[1]) < 0) {
-          actionTuples.push([action, [], optionString]);
-          optionString = optionString[0] + explicitArg[0];
-          var newExplicitArg = explicitArg.slice(1) || null;
-          var optionalsMap = self._optionStringActions;
-
-          if (_.keys(optionalsMap).indexOf(optionString) >= 0) {
-            action = optionalsMap[optionString];
-            explicitArg = newExplicitArg;
-          }
-          else {
-            var msg = 'ignored explicit argument %r';
-            throw argumentErrorHelper(action, msg);
-          }
-        }
-        // if the action expect exactly one argument, we've
-        // successfully matched the option; exit the loop
-        else if (argCount === 1) {
-          stop = startIndex + 1;
-          args = [explicitArg];
-          actionTuples.push([action, args, optionString]);
-          break;
-        }
-        // error if a double-dash option did not use the
-        // explicit argument
-        else {
-          var message = 'ignored explicit argument %r';
-          throw argumentErrorHelper(action, _.str.sprintf(message, explicitArg));
-        }
-      }
-      // if there is no explicit argument, try to match the
-      // optional's string arguments with the following strings
-      // if successful, exit the loop
-      else {
-
-        start = startIndex + 1;
-        var selectedPatterns = argStringsPattern.substr(start);
-
-        argCount = self._matchArgument(action, selectedPatterns);
-        stop = start + argCount;
-
-
-        args = argStrings.slice(start, stop);
-
-        actionTuples.push([action, args, optionString]);
-        break;
-      }
-
-    }
-
-    // add the Optional to the list and return the index at which
-    // the Optional's string args stopped
-    if (actionTuples.length < 1) {
-      throw new Error('length should be > 0');
-    }
-    for (var i = 0; i < actionTuples.length; i++) {
-      takeAction.apply(self, actionTuples[i]);
-    }
-    return stop;
-  }
-
-  // the list of Positionals left to be parsed; this is modified
-  // by consume_positionals()
-  var positionals = self._getPositionalActions();
-
-  function consumePositionals(startIndex) {
-    // match as many Positionals as possible
-    var selectedPattern = argStringsPattern.substr(startIndex);
-    var argCounts = self._matchArgumentsPartial(positionals, selectedPattern);
-
-    // slice off the appropriate arg strings for each Positional
-    // and add the Positional and its args to the list
-    _.zip(positionals, argCounts).forEach(function (item) {
-        var action = item[0];
-        var argCount = item[1];
-        if (argCount === undefined) {
-          return;
-        }
-        var args = argStrings.slice(startIndex, startIndex + argCount);
-
-        startIndex += argCount;
-        takeAction(action, args);
-      });
-
-    // slice off the Positionals that we just parsed and return the
-    // index at which the Positionals' string args stopped
-    positionals = positionals.slice(argCounts.length);
-    return startIndex;
-  }
-
-  // consume Positionals and Optionals alternately, until we have
-  // passed the last option string
-  var startIndex = 0;
-  var position;
-
-  var maxOptionStringIndex = -1;
-  if (!!optionStringIndices) {
-    for (position in optionStringIndices) {
-      maxOptionStringIndex = Math.max(maxOptionStringIndex, parseInt(position, 10));
-    }
-  }
-
-  var positionalsEndIndex, nextOptionStringIndex;
-
-  while (startIndex <= maxOptionStringIndex) {
-    // consume any Positionals preceding the next option
-    nextOptionStringIndex = null;
-    for (position in optionStringIndices) {
-      position = parseInt(position, 10);
-      if (position >= startIndex) {
-        if (nextOptionStringIndex !== null) {
-          nextOptionStringIndex = Math.min(nextOptionStringIndex, position);
-        }
-        else {
-          nextOptionStringIndex = position;
-        }
-      }
-    }
-
-    if (startIndex !== nextOptionStringIndex) {
-      positionalsEndIndex = consumePositionals(startIndex);
-      // only try to parse the next optional if we didn't consume
-      // the option string during the positionals parsing
-      if (positionalsEndIndex > startIndex) {
-        startIndex = positionalsEndIndex;
-        continue;
-      }
-      else {
-        startIndex = positionalsEndIndex;
-      }
-    }
-
-    // if we consumed all the positionals we could and we're not
-    // at the index of an option string, there were extra arguments
-    if (!optionStringIndices[startIndex]) {
-      var strings = argStrings.slice(startIndex, nextOptionStringIndex);
-      extras = extras.concat(strings);
-      startIndex = nextOptionStringIndex;
-    }
-    // consume the next optional and any arguments for it
-    startIndex = consumeOptional(startIndex);
-  }
-
-  // consume any positionals following the last Optional
-  var stopIndex = consumePositionals(startIndex);
-
-  // if we didn't consume all the argument strings, there were extras
-  extras = extras.concat(_.rest(argStrings, stopIndex));
-
-  // if we didn't use all the Positional objects, there were too few
-  // arg strings supplied.
-  if (positionals.length > 0) {
-    self.error('too few arguments');
-  }
-
-  // make sure all required actions were present
-  self._actions.forEach(function (action) {
-    if (action.required) {
-      if (_.indexOf(seenActions, action) < 0) {
-        self.error(format('Argument "%s" is required', action.getName()));
-      }
-    }
-  });
-
-  // make sure all required groups have one option present
-  var actionUsed = false;
-  self._mutuallyExclusiveGroups.forEach(function (group) {
-    if (group.required) {
-      actionUsed = _.any(group._groupActions, function (action) {
-        return _.contains(seenNonDefaultActions, action);
-      });
-
-      // if no actions were used, report the error
-      if (!actionUsed) {
-        var names = [];
-        group._groupActions.forEach(function (action) {
-          if (action.help !== $$.SUPPRESS) {
-            names.push(action.getName());
-          }
-        });
-        names = names.join(' ');
-        var msg = 'one of the arguments ' + names + ' is required';
-        self.error(msg);
-      }
-    }
-  });
-
-  // return the updated namespace and the extra arguments
-  return [namespace, extras];
-};
-
-ArgumentParser.prototype._readArgsFromFiles = function (argStrings) {
-  // expand arguments referencing files
-  var _this = this;
-  var fs = require('fs');
-  var newArgStrings = [];
-  argStrings.forEach(function (argString) {
-    if (_this.fromfilePrefixChars.indexOf(argString[0]) < 0) {
-      // for regular arguments, just add them back into the list
-      newArgStrings.push(argString);
-    } else {
-      // replace arguments referencing files with the file content
-      try {
-        var argstrs = [];
-        var filename = argString.slice(1);
-        var content = fs.readFileSync(filename, 'utf8');
-        content = content.trim().split('\n');
-        content.forEach(function (argLine) {
-          _this.convertArgLineToArgs(argLine).forEach(function (arg) {
-            argstrs.push(arg);
-          });
-          argstrs = _this._readArgsFromFiles(argstrs);
-        });
-        newArgStrings.push.apply(newArgStrings, argstrs);
-      } catch (error) {
-        return _this.error(error.message);
-      }
-    }
-  });
-  return newArgStrings;
-};
-
-ArgumentParser.prototype.convertArgLineToArgs = function (argLine) {
-  return [argLine];
-};
-
-ArgumentParser.prototype._matchArgument = function (action, regexpArgStrings) {
-
-  // match the pattern for this action to the arg strings
-  var regexpNargs = new RegExp('^' + this._getNargsPattern(action));
-  var matches = regexpArgStrings.match(regexpNargs);
-  var message;
-
-  // throw an exception if we weren't able to find a match
-  if (!matches) {
-    switch (action.nargs) {
-    case undefined:
-    case null:
-      message = 'Expected one argument.';
-      break;
-    case $$.OPTIONAL:
-      message = 'Expected at most one argument.';
-      break;
-    case $$.ONE_OR_MORE:
-      message = 'Expected at least one argument.';
-      break;
-    default:
-      message = 'Expected %s argument(s)';
-    }
-
-    throw argumentErrorHelper(
-      action,
-      format(message, action.nargs)
-    );
-  }
-  // return the number of arguments matched
-  return matches[1].length;
-};
-
-ArgumentParser.prototype._matchArgumentsPartial = function (actions, regexpArgStrings) {
-  // progressively shorten the actions list by slicing off the
-  // final actions until we find a match
-  var self = this;
-  var result = [];
-  var actionSlice, pattern, matches;
-  var i, j;
-
-  var getLength = function (string) {
-    return string.length;
-  };
-
-  for (i = actions.length; i > 0; i -= 1) {
-    pattern = '';
-    actionSlice = actions.slice(0, i);
-    for (j in actionSlice) {
-      pattern += self._getNargsPattern(actionSlice[j]);
-    }
-
-    pattern = new RegExp('^' + pattern);
-    matches = regexpArgStrings.match(pattern);
-
-    if (matches && matches.length > 0) {
-      // need only groups
-      matches = matches.splice(1);
-      result = result.concat(matches.map(getLength));
-      break;
-    }
-  }
-
-  // return the list of arg string counts
-  return result;
-};
-
-ArgumentParser.prototype._parseOptional = function (argString) {
-  var action, optionString, argExplicit, optionTuples;
-
-  // if it's an empty string, it was meant to be a positional
-  if (!argString) {
-    return null;
-  }
-
-  // if it doesn't start with a prefix, it was meant to be positional
-  if (this.prefixChars.indexOf(argString[0]) < 0) {
-    return null;
-  }
-
-  // if the option string is present in the parser, return the action
-  if (!!this._optionStringActions[argString]) {
-    return [this._optionStringActions[argString], argString, null];
-  }
-
-  // if it's just a single character, it was meant to be positional
-  if (argString.length === 1) {
-    return null;
-  }
-
-  // if the option string before the "=" is present, return the action
-  if (argString.indexOf('=') >= 0) {
-    var argStringSplit = argString.split('=');
-    optionString = argStringSplit[0];
-    argExplicit = argStringSplit[1];
-
-    if (!!this._optionStringActions[optionString]) {
-      action = this._optionStringActions[optionString];
-      return [action, optionString, argExplicit];
-    }
-  }
-
-  // search through all possible prefixes of the option string
-  // and all actions in the parser for possible interpretations
-  optionTuples = this._getOptionTuples(argString);
-
-  // if multiple actions match, the option string was ambiguous
-  if (optionTuples.length > 1) {
-    var optionStrings = optionTuples.map(function (optionTuple) {
-      return optionTuple[1];
-    });
-    this.error(format(
-          'Ambiguous option: "%s" could match %s.',
-          argString, optionStrings.join(', ')
-    ));
-  // if exactly one action matched, this segmentation is good,
-  // so return the parsed action
-  } else if (optionTuples.length === 1) {
-    return optionTuples[0];
-  }
-
-  // if it was not found as an option, but it looks like a negative
-  // number, it was meant to be positional
-  // unless there are negative-number-like options
-  if (argString.match(this._regexpNegativeNumber)) {
-    if (!_.any(this._hasNegativeNumberOptionals)) {
-      return null;
-    }
-  }
-  // if it contains a space, it was meant to be a positional
-  if (argString.search(' ') >= 0) {
-    return null;
-  }
-
-  // it was meant to be an optional but there is no such option
-  // in this parser (though it might be a valid option in a subparser)
-  return [null, argString, null];
-};
-
-ArgumentParser.prototype._getOptionTuples = function (optionString) {
-  var result = [];
-  var chars = this.prefixChars;
-  var optionPrefix;
-  var argExplicit;
-  var action;
-  var actionOptionString;
-
-  // option strings starting with two prefix characters are only split at
-  // the '='
-  if (chars.indexOf(optionString[0]) >= 0 && chars.indexOf(optionString[1]) >= 0) {
-    if (optionString.indexOf('=') >= 0) {
-      var optionStringSplit = optionString.split('=', 1);
-
-      optionPrefix = optionStringSplit[0];
-      argExplicit = optionStringSplit[1];
-    } else {
-      optionPrefix = optionString;
-      argExplicit = null;
-    }
-
-    for (actionOptionString in this._optionStringActions) {
-      if (actionOptionString.substr(0, optionPrefix.length) === optionPrefix) {
-        action = this._optionStringActions[actionOptionString];
-        result.push([action, actionOptionString, argExplicit]);
-      }
-    }
-
-  // single character options can be concatenated with their arguments
-  // but multiple character options always have to have their argument
-  // separate
-  } else if (chars.indexOf(optionString[0]) >= 0 && chars.indexOf(optionString[1]) < 0) {
-    optionPrefix = optionString;
-    argExplicit = null;
-    var optionPrefixShort = optionString.substr(0, 2);
-    var argExplicitShort = optionString.substr(2);
-
-    for (actionOptionString in this._optionStringActions) {
-      action = this._optionStringActions[actionOptionString];
-      if (actionOptionString === optionPrefixShort) {
-        result.push([action, actionOptionString, argExplicitShort]);
-      } else if (actionOptionString.substr(0, optionPrefix.length) === optionPrefix) {
-        result.push([action, actionOptionString, argExplicit]);
-      }
-    }
-
-  // shouldn't ever get here
-  } else {
-    throw new Error(format('Unexpected option string: %s.', optionString));
-  }
-  // return the collected option tuples
-  return result;
-};
-
-ArgumentParser.prototype._getNargsPattern = function (action) {
-  // in all examples below, we have to allow for '--' args
-  // which are represented as '-' in the pattern
-  var regexpNargs;
-
-  switch (action.nargs) {
-  // the default (null) is assumed to be a single argument
-  case undefined:
-  case null:
-    regexpNargs = '(-*A-*)';
-    break;
-  // allow zero or more arguments
-  case $$.OPTIONAL:
-    regexpNargs = '(-*A?-*)';
-    break;
-  // allow zero or more arguments
-  case $$.ZERO_OR_MORE:
-    regexpNargs = '(-*[A-]*)';
-    break;
-  // allow one or more arguments
-  case $$.ONE_OR_MORE:
-    regexpNargs = '(-*A[A-]*)';
-    break;
-  // allow any number of options or arguments
-  case $$.REMAINDER:
-    regexpNargs = '([-AO]*)';
-    break;
-  // allow one argument followed by any number of options or arguments
-  case $$.PARSER:
-    regexpNargs = '(-*A[-AO]*)';
-    break;
-  // all others should be integers
-  default:
-    regexpNargs = '(-*' + _.str.repeat('-*A', action.nargs) + '-*)';
-  }
-
-  // if this is an optional action, -- is not allowed
-  if (action.isOptional()) {
-    regexpNargs = regexpNargs.replace(/-\*/g, '');
-    regexpNargs = regexpNargs.replace(/-/g, '');
-  }
-
-  // return the pattern
-  return regexpNargs;
-};
-
-//
-// Value conversion methods
-//
-
-ArgumentParser.prototype._getValues = function (action, argStrings) {
-  var self = this;
-
-  // for everything but PARSER args, strip out '--'
-  if (action.nargs !== $$.PARSER && action.nargs !== $$.REMAINDER) {
-    argStrings = argStrings.filter(function (arrayElement) {
-      return arrayElement !== '--';
-    });
-  }
-
-  var value, argString;
-
-  // optional argument produces a default when not present
-  if (argStrings.length === 0 && action.nargs === $$.OPTIONAL) {
-
-    value = (action.isOptional()) ? action.constant: action.defaultValue;
-
-    if (typeof(value) === 'string') {
-      value = this._getValue(action, value);
-      this._checkValue(action, value);
-    }
-
-  // when nargs='*' on a positional, if there were no command-line
-  // args, use the default if it is anything other than None
-  } else if (argStrings.length === 0 && action.nargs === $$.ZERO_OR_MORE &&
-    action.optionStrings.length === 0) {
-
-    value = (action.defaultValue || argStrings);
-    this._checkValue(action, value);
-
-  // single argument or optional argument produces a single value
-  } else if (argStrings.length === 1 &&
-        (!action.nargs || action.nargs === $$.OPTIONAL)) {
-
-    argString = argStrings[0];
-    value = this._getValue(action, argString);
-    this._checkValue(action, value);
-
-  // REMAINDER arguments convert all values, checking none
-  } else if (action.nargs === $$.REMAINDER) {
-    value = argStrings.map(function (v) {
-      return self._getValue(action, v);
-    });
-
-  // PARSER arguments convert all values, but check only the first
-  } else if (action.nargs === $$.PARSER) {
-    value = argStrings.map(function (v) {
-      return self._getValue(action, v);
-    });
-    this._checkValue(action, value[0]);
-
-  // all other types of nargs produce a list
-  } else {
-    value = argStrings.map(function (v) {
-      return self._getValue(action, v);
-    });
-    value.forEach(function (v) {
-      self._checkValue(action, v);
-    });
-  }
-
-  // return the converted value
-  return value;
-};
-
-ArgumentParser.prototype._getValue = function (action, argString) {
-  var result;
-
-  var typeFunction = this._registryGet('type', action.type, action.type);
-  if (!_.isFunction(typeFunction)) {
-    var message = format('%s is not callable', typeFunction);
-    throw argumentErrorHelper(action, message);
-  }
-
-  // convert the value to the appropriate type
-  try {
-    result = typeFunction(argString);
-
-    // ArgumentTypeErrors indicate errors
-    // If action.type is not a registered string, it is a function
-    // Try to deduce its name for inclusion in the error message
-    // Failing that, include the error message it raised.
-  } catch (e) {
-    var name = null;
-    if (_.isString(action.type)) {
-      name = action.type;
-    } else {
-      name = action.type.name || action.type.displayName || '<function>';
-    }
-    var msg = format('Invalid %s value: %s', name, argString);
-    if (name === '<function>') {msg += '\n' + e.message; }
-    throw argumentErrorHelper(action, msg);
-  }
-  // return the converted value
-  return result;
-};
-
-ArgumentParser.prototype._checkValue = function (action, value) {
-  // converted value must be one of the choices (if specified)
-  var choices = action.choices;
-  if (!!choices) {
-    // choise for argument can by array or string
-    if ((_.isString(choices) || _.isArray(choices)) &&
-        choices.indexOf(value) !== -1) {
-      return;
-    }
-    // choise for subparsers can by only hash
-    if (_.isObject(choices) && !_.isArray(choices) && choices[value]) {
-      return;
-    }
-
-    if (_.isString(choices)) {
-      choices = choices.split('').join(', ');
-    }
-    else if (_.isArray(choices)) {
-      choices =  choices.join(', ');
-    }
-    else {
-      choices =  _.keys(choices).join(', ');
-    }
-    var message = format('Invalid choice: %s (choose from [%s])', value, choices);
-    throw argumentErrorHelper(action, message);
-  }
-};
-
-//
-// Help formatting methods
-//
-
-/**
- * ArgumentParser#formatUsage -> string
- *
- * Return usage string
- *
- * See also [original guide][1]
- *
- * [1]:http://docs.python.org/dev/library/argparse.html#printing-help
- **/
-ArgumentParser.prototype.formatUsage = function () {
-  var formatter = this._getFormatter();
-  formatter.addUsage(this.usage, this._actions, this._mutuallyExclusiveGroups);
-  return formatter.formatHelp();
-};
-
-/**
- * ArgumentParser#formatHelp -> string
- *
- * Return help
- *
- * See also [original guide][1]
- *
- * [1]:http://docs.python.org/dev/library/argparse.html#printing-help
- **/
-ArgumentParser.prototype.formatHelp = function () {
-  var formatter = this._getFormatter();
-
-  // usage
-  formatter.addUsage(this.usage, this._actions, this._mutuallyExclusiveGroups);
-
-  // description
-  formatter.addText(this.description);
-
-  // positionals, optionals and user-defined groups
-  this._actionGroups.forEach(function (actionGroup) {
-    formatter.startSection(actionGroup.title);
-    formatter.addText(actionGroup.description);
-    formatter.addArguments(actionGroup._groupActions);
-    formatter.endSection();
-  });
-
-  // epilog
-  formatter.addText(this.epilog);
-
-  // determine help from format above
-  return formatter.formatHelp();
-};
-
-ArgumentParser.prototype._getFormatter = function () {
-  var FormatterClass = this.formatterClass;
-  var formatter = new FormatterClass({prog: this.prog});
-  return formatter;
-};
-
-//
-//  Print functions
-//
-
-/**
- * ArgumentParser#printUsage() -> Void
- *
- * Print usage
- *
- * See also [original guide][1]
- *
- * [1]:http://docs.python.org/dev/library/argparse.html#printing-help
- **/
-ArgumentParser.prototype.printUsage = function () {
-  this._printMessage(this.formatUsage());
-};
-
-/**
- * ArgumentParser#printHelp() -> Void
- *
- * Print help
- *
- * See also [original guide][1]
- *
- * [1]:http://docs.python.org/dev/library/argparse.html#printing-help
- **/
-ArgumentParser.prototype.printHelp = function () {
-  this._printMessage(this.formatHelp());
-};
-
-ArgumentParser.prototype._printMessage = function (message, stream) {
-  if (!stream) {
-    stream = process.stdout;
-  }
-  if (message) {
-    stream.write('' + message);
-  }
-};
-
-//
-//  Exit functions
-//
-
-/**
- * ArgumentParser#exit(status=0, message) -> Void
- * - status (int): exit status
- * - message (string): message
- *
- * Print message in stderr/stdout and exit program
- **/
-ArgumentParser.prototype.exit = function (status, message) {
-  if (!!message) {
-    if (status === 0) {
-      this._printMessage(message);
-    }
-    else {
-      this._printMessage(message, process.stderr);
-    }
-  }
-
-  process.exit(status);
-};
-
-/**
- * ArgumentParser#error(message) -> Void
- * - err (Error|string): message
- *
- * Error method Prints a usage message incorporating the message to stderr and
- * exits. If you override this in a subclass,
- * it should not return -- it should
- * either exit or throw an exception.
- *
- **/
-ArgumentParser.prototype.error = function (err) {
-  var message;
-  if (err instanceof Error) {
-    if (this.debug === true) {
-      throw err;
-    }
-    message = err.message;
-  }
-  else {
-    message = err;
-  }
-  var msg = format('%s: error: %s', this.prog, message) + $$.EOL;
-
-  if (this.debug === true) {
-    throw new Error(msg);
-  }
-
-  this.printUsage(process.stderr);
-
-  return this.exit(2, msg);
-};