inray 0.0.3 → 0.0.5

package/dist/cli/src/lib/argument.js

@@ -0,0 +1,143 @@
+/**
+ * Original library: commander.js (v15.0.0)
+ * - Copyright (c) 2011 TJ Holowaychuk
+ * - Copyright (c) John Gee and "commander.js" authors
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import { InvalidArgumentError } from "./error.js";
+export class Argument {
+    description;
+    required;
+    variadic;
+    defaultValue;
+    defaultValueDescription;
+    parseArg;
+    argChoices;
+    _name;
+    /**
+     * Initialize a new command argument with the given name and description.
+     * The default is that the argument is required, and you can explicitly
+     * indicate this with <> around the name. Put [] around the name for an optional argument.
+     *
+     * @param {string} name
+     * @param {string} [description]
+     */
+    constructor(name, description) {
+        this.description = description || '';
+        this.variadic = false;
+        this.parseArg = undefined;
+        this.defaultValue = undefined;
+        this.defaultValueDescription = undefined;
+        this.argChoices = undefined;
+        switch (name[0]) {
+            case '<': // e.g. <required>
+                this.required = true;
+                this._name = name.slice(1, -1);
+                break;
+            case '[': // e.g. [optional]
+                this.required = false;
+                this._name = name.slice(1, -1);
+                break;
+            default:
+                this.required = true;
+                this._name = name;
+                break;
+        }
+        if (this._name.endsWith('...')) {
+            this.variadic = true;
+            this._name = this._name.slice(0, -3);
+        }
+    }
+    /**
+     * Return argument name.
+     *
+     * @return {string}
+     */
+    name() {
+        return this._name;
+    }
+    /**
+     * @package
+     */
+    _collectValue(value, previous) {
+        if (previous === this.defaultValue || !Array.isArray(previous)) {
+            return [value];
+        }
+        previous.push(value);
+        return previous;
+    }
+    /**
+     * Set the default value, and optionally supply the description to be displayed in the help.
+     *
+     * @param {*} value
+     * @param {string} [description]
+     * @return {Argument}
+     */
+    default(value, description) {
+        this.defaultValue = value;
+        this.defaultValueDescription = description;
+        return this;
+    }
+    /**
+     * Set the custom handler for processing CLI command arguments into argument values.
+     *
+     * @param {Function} [fn]
+     * @return {Argument}
+     */
+    argParser(fn) {
+        this.parseArg = fn;
+        return this;
+    }
+    /**
+     * Only allow argument value to be one of choices.
+     *
+     * @param {string[]} values
+     * @return {Argument}
+     */
+    choices(values) {
+        this.argChoices = values.slice();
+        this.parseArg = (arg, previous) => {
+            if (!this.argChoices?.includes(arg)) {
+                throw new InvalidArgumentError(`Allowed choices are ${this.argChoices?.join(', ')}.`);
+            }
+            if (this.variadic) {
+                return this._collectValue(arg, previous);
+            }
+            return arg;
+        };
+        return this;
+    }
+    /**
+     * Make argument required.
+     *
+     * @returns {Argument}
+     */
+    argRequired() {
+        this.required = true;
+        return this;
+    }
+    /**
+     * Make argument optional.
+     *
+     * @returns {Argument}
+     */
+    argOptional() {
+        this.required = false;
+        return this;
+    }
+}
+/**
+ * Takes an argument and returns its human readable equivalent for help usage.
+ *
+ * @param {Argument} arg
+ * @return {string}
+ * @private
+ */
+export function humanReadableArgName(arg) {
+    const nameOutput = arg.name() + (arg.variadic === true ? '...' : '');
+    return arg.required ? '<' + nameOutput + '>' : '[' + nameOutput + ']';
+}
+//# sourceMappingURL=argument.js.map

package/dist/cli/src/lib/argument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argument.js","sourceRoot":"","sources":["../../../../src/cli/src/lib/argument.ts"],"names":[],"mappings":"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"}