Method parse

lib/jsdoc/opts/argparser.js:225–303

* Get the options. * @param {Array. } args An array, like ['-x', 'hello'] * @param {Object} [defaults={}] An optional collection of default values. * @returns {Object} The keys will be the longNames, or the shortName if no longName is defined for * that option. The values

(args, defaults)

     * that option. The values will be the values provided, or `true` if the option accepts no value.
     */
    parse(args, defaults) {
        let arg;
        let next;
        let option;
        const result = ( defaults && _.defaults({}, defaults) ) || {};
        let shortName;
        let longName;
        let name;
        let value;

        result._ = [];
        for (let i = 0, l = args.length; i < l; i++) {
            arg = String(args[i]);
            next = (i < l - 1) ? String(args[i + 1]) : null;
            shortName = null;
            value = null;

            // like -t
            if (arg.charAt(0) === '-') {
                // like --template
                if (arg.charAt(1) === '-') {
                    name = longName = arg.slice(2);
                    option = this._getOptionByLongName(longName);
                }
                else {
                    name = shortName = arg.slice(1);
                    option = this._getOptionByShortName(shortName);
                }

                if (option === null) {
                    throw new Error( util.format('Unknown command-line option "%s".', name) );
                }

                if (option.hasValue) {
                    value = next;
                    i++;

                    if (value === null || value.charAt(0) === '-') {
                        throw new Error( util.format('The command-line option "%s" requires a value.', name) );
                    }
                }
                else {
                    value = true;
                }

                // skip ignored options now that we've consumed the option text
                if (option.ignore) {
                    continue;
                }

                if (option.longName && shortName) {
                    name = option.longName;
                }

                if (typeof option.coercer === 'function') {
                    value = option.coercer(value);
                }