@villedemontreal/caporal 3.1.7

package/dist/src/autocomplete/__tests__/autocomplete.spec.js

@@ -0,0 +1,119 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const __1 = require("..");
+const prog_autocomplete_1 = require("../__fixtures__/prog-autocomplete");
+const filter_1 = __importDefault(require("lodash/filter"));
+const vitest_1 = require("vitest");
+/**
+ * Helper to cimulate auto comp env
+ * @param cl Command line
+ * @param opts
+ * @param env
+ */
+function makeFakeEnv(cl, opts = {}, env = process.env) {
+    let cursorPos = cl.indexOf("|");
+    if (cursorPos === -1) {
+        cursorPos = cl.length;
+    }
+    cl = cl.replace("|", "");
+    const argv = (0, filter_1.default)(cl.split(" "));
+    env.COMP_CWORD = String(argv.length);
+    env.COMP_LINE = cl;
+    env.COMP_POINT = cursorPos === -1 ? "0" : String(cursorPos);
+    env = { ...env, ...opts };
+    return { env, argv: [process.execPath, __filename, "completion", "--", ...argv] };
+}
+(0, vitest_1.describe)("autocomplete", () => {
+    (0, vitest_1.describe)("complete()", () => {
+        (0, vitest_1.it)("should auto-complete command name if possible", async () => {
+            const argv = "ord|";
+            await (0, vitest_1.expect)((0, __1.complete)(prog_autocomplete_1.program, makeFakeEnv(argv))).resolves.toEqual([
+                {
+                    name: "order",
+                    description: vitest_1.expect.any(String),
+                },
+            ]);
+            await (0, vitest_1.expect)((0, __1.complete)(prog_autocomplete_1.program, makeFakeEnv("c|"))).resolves.toEqual([
+                {
+                    name: "cancel",
+                    description: vitest_1.expect.any(String),
+                },
+            ]);
+        });
+        (0, vitest_1.it)("should not auto-complete command name if none are available", async () => {
+            await (0, vitest_1.expect)((0, __1.complete)(prog_autocomplete_1.program, makeFakeEnv("wrong|"))).resolves.toEqual([]);
+            await (0, vitest_1.expect)((0, __1.complete)(prog_autocomplete_1.program, makeFakeEnv("cancel|"))).resolves.not.toContain(vitest_1.expect.objectContaining({
+                name: "cancel",
+            }));
+        });
+        (0, vitest_1.it)("should auto-complete arguments values from choices", async () => {
+            const argv = "order |";
+            await (0, vitest_1.expect)((0, __1.complete)(prog_autocomplete_1.program, makeFakeEnv(argv))).resolves.toEqual([
+                {
+                    name: "margherita",
+                    description: vitest_1.expect.any(String),
+                },
+                {
+                    name: "caprese",
+                    description: vitest_1.expect.any(String),
+                },
+                {
+                    name: "quattro fromaggi",
+                    description: vitest_1.expect.any(String),
+                },
+                {
+                    name: "--extra-ingredients",
+                    description: vitest_1.expect.any(String),
+                },
+            ]);
+        });
+        (0, vitest_1.it)("should auto-complete arguments values from complete()", async () => {
+            const argv = "cancel |";
+            await (0, vitest_1.expect)((0, __1.complete)(prog_autocomplete_1.program, makeFakeEnv(argv))).resolves.toEqual([
+                {
+                    name: "1234",
+                    description: vitest_1.expect.any(String),
+                },
+                {
+                    name: "5678",
+                    description: vitest_1.expect.any(String),
+                },
+                {
+                    name: "--cash-out",
+                    description: vitest_1.expect.any(String),
+                },
+            ]);
+        });
+        (0, vitest_1.it)("should auto-complete partial options values from complete()", async () => {
+            const argv = "cancel --ca|";
+            await (0, vitest_1.expect)((0, __1.complete)(prog_autocomplete_1.program, makeFakeEnv(argv))).resolves.toEqual([
+                {
+                    name: "--cash-out",
+                    description: vitest_1.expect.any(String),
+                },
+            ]);
+        });
+        (0, vitest_1.it)("should auto-complete partial long options", async () => {
+            const argv = "order --ex";
+            await (0, vitest_1.expect)((0, __1.complete)(prog_autocomplete_1.program, makeFakeEnv(argv))).resolves.toEqual([
+                {
+                    name: "--extra-ingredients",
+                    description: vitest_1.expect.any(String),
+                },
+            ]);
+        });
+        (0, vitest_1.it)("should auto-complete a single dash", async () => {
+            const argv = "order -";
+            await (0, vitest_1.expect)((0, __1.complete)(prog_autocomplete_1.program, makeFakeEnv(argv))).resolves.toEqual([
+                {
+                    name: "--extra-ingredients",
+                    description: vitest_1.expect.any(String),
+                },
+            ]);
+        });
+    });
+});
+//# sourceMappingURL=autocomplete.spec.js.map

package/dist/src/autocomplete/__tests__/autocomplete.spec.js.map

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

package/dist/src/autocomplete/index.d.ts

@@ -0,0 +1,20 @@
+import { Program } from "../program";
+import { Argument, Option } from "../types";
+import { Completer, CompletionItem } from "./types";
+/**
+ * Register a completion handler
+ *
+ * @param {Argument|Option} arg_or_opt argument or option to complete
+ * @param {Function} completer
+ */
+export declare function registerCompletion(argOrOpt: Argument | Option, completer: Completer): void;
+export declare function installCompletion(program: Program): Promise<void>;
+export declare function uninstallCompletion(program: Program): Promise<void>;
+/**
+ * Called by tabtab
+ */
+export declare function complete(program: Program, { env, argv }?: {
+    env: NodeJS.ProcessEnv;
+    argv: string[];
+}): Promise<CompletionItem[] | false>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/autocomplete/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/autocomplete/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAO3C,OAAO,EAAe,SAAS,EAAE,cAAc,EAAqB,MAAM,SAAS,CAAA;AAInF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAC3B,SAAS,EAAE,SAAS,GACnB,IAAI,CAEN;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvE;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,OAAO,EAChB,EAAE,GAAG,EAAE,IAAI,EAAE;;;CAA2C,GACvD,OAAO,CAAC,cAAc,EAAE,GAAG,KAAK,CAAC,CAkBnC"}

package/dist/src/autocomplete/index.js

@@ -0,0 +1,172 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCompletion = registerCompletion;
+exports.installCompletion = installCompletion;
+exports.uninstallCompletion = uninstallCompletion;
+exports.complete = complete;
+/**
+ * @packageDocumentation
+ * @module caporal/autocomplete
+ */
+const tabtab_1 = __importDefault(require("tabtab"));
+const parser_1 = require("../parser");
+const validate_1 = require("../argument/validate");
+const option_1 = require("../option");
+const find_1 = require("../command/find");
+const filter_1 = __importDefault(require("lodash/filter"));
+const flatMap_1 = __importDefault(require("lodash/flatMap"));
+const completions = new Map();
+/**
+ * Register a completion handler
+ *
+ * @param {Argument|Option} arg_or_opt argument or option to complete
+ * @param {Function} completer
+ */
+function registerCompletion(argOrOpt, completer) {
+    completions.set(argOrOpt, completer);
+}
+async function installCompletion(program) {
+    return tabtab_1.default.install({
+        name: program.getBin(),
+        completer: program.getBin(),
+    });
+}
+async function uninstallCompletion(program) {
+    return tabtab_1.default.uninstall({
+        name: program.getBin(),
+    });
+}
+/**
+ * Called by tabtab
+ */
+async function complete(program, { env, argv } = { env: process.env, argv: process.argv }) {
+    const compEnv = tabtab_1.default.parseEnv(env);
+    if (!compEnv.complete) {
+        return false;
+    }
+    const ctx = await getContext(program, compEnv, argv);
+    const compPromises = [
+        getCompCommands(ctx),
+        getCompArgValues(ctx),
+        getCompOptNames(ctx),
+        getCompOptValues(ctx),
+    ];
+    const comps = (0, flatMap_1.default)(await Promise.all(compPromises));
+    tabtab_1.default.log(comps);
+    return comps;
+}
+async function getContext(program, compEnv, argv) {
+    const { lastPartial } = compEnv;
+    argv = argv.slice(4);
+    const currentCmd = await (0, find_1.findCommand)(program, argv);
+    const parserResult = (0, parser_1.parseArgv)(currentCmd?.getParserConfig(), argv);
+    const lastPartIsOpt = lastPartial.startsWith("-");
+    const lastPartIsKnownOpt = Boolean(lastPartIsOpt && currentCmd && getLastPartIsKnownOpt(currentCmd, lastPartial));
+    const currentOpt = currentCmd
+        ? currentCmd.options.find((o) => o.allNames.includes(lastPartial))
+        : undefined;
+    const ctx = {
+        program,
+        currentCmd,
+        compEnv,
+        parserResult,
+        lastPartIsOpt,
+        lastPartIsKnownOpt,
+        currentOpt,
+    };
+    return ctx;
+}
+async function getCompCommands(ctx) {
+    const { compEnv: { line }, program, currentCmd, } = ctx;
+    const commandMatch = (cmd, str) => {
+        return cmd.name.startsWith(str) || cmd.getAliases().some((a) => a.startsWith(str));
+    };
+    let commands = await program.getAllCommands();
+    commands = (0, filter_1.default)(commands, (cmd) => commandMatch(cmd, line) && cmd !== currentCmd);
+    return commands.map((cmd) => ({
+        name: cmd.name,
+        description: cmd.description,
+    }));
+}
+async function getCompOptNames(ctx) {
+    const { compEnv: { lastPartial }, currentCmd, } = ctx;
+    if (!currentCmd) {
+        return [];
+    }
+    const matchOptionName = (o) => {
+        return Boolean((o.shortNotation != lastPartial && o.shortNotation?.startsWith(lastPartial)) ||
+            (o.longNotation != lastPartial && o.longNotation?.startsWith(lastPartial)));
+    };
+    return (0, filter_1.default)(currentCmd.options, matchOptionName).map((opt) => ({
+        name: opt.notation,
+        description: opt.description,
+    }));
+}
+async function getCompOptValues(ctx) {
+    const { currentOpt } = ctx;
+    if (!currentOpt) {
+        return [];
+    }
+    // Choices
+    if (currentOpt.choices.length) {
+        return currentOpt.choices.map((choice) => ({
+            name: choice.toString(),
+            description: "Value for option " + currentOpt.synopsis,
+        }));
+    }
+    // Promise completion
+    const completer = completions.get(currentOpt);
+    if (completer) {
+        return hanldleCompleter(ctx, completer, currentOpt);
+    }
+    return [];
+}
+async function getCompArgValues(ctx) {
+    const { compEnv: { lastPartial }, parserResult: { args }, currentCmd, lastPartIsOpt, } = ctx;
+    if (!currentCmd || lastPartIsOpt) {
+        return [];
+    }
+    const formatedArgs = currentCmd.isProgramCommand()
+        ? args
+        : (0, validate_1.removeCommandFromArgs)(currentCmd, args);
+    const argsCount = formatedArgs.length;
+    const arg = currentCmd.args[argsCount];
+    if (!arg) {
+        return [];
+    }
+    // Choices
+    if (arg.choices.length) {
+        return arg.choices
+            .map((choice) => ({
+            name: choice.toString(),
+            description: "Value for argument " + arg.synopsis,
+        }))
+            .filter((choice) => !lastPartial || choice.name.toString().startsWith(lastPartial));
+    }
+    // Promise completion
+    const completion = completions.get(arg);
+    if (completion) {
+        return hanldleCompleter(ctx, completion, arg);
+    }
+    return [];
+}
+async function hanldleCompleter(ctx, completer, argOrOpt) {
+    const type = (0, option_1.isOptionObject)(argOrOpt) ? "option" : "argument";
+    const res = await completer(ctx);
+    return res.map((item) => {
+        if (typeof item === "object") {
+            return item;
+        }
+        return {
+            name: "" + item,
+            description: `Value for ${type} ${argOrOpt.synopsis}`,
+        };
+    });
+}
+function getLastPartIsKnownOpt(cmd, lastPartial) {
+    return cmd.options.some((o) => o.allNames.includes(lastPartial));
+}
+//# sourceMappingURL=index.js.map

package/dist/src/autocomplete/index.js.map

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

package/dist/src/autocomplete/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @packageDocumentation
+ * @module caporal/types
+ */
+import type { Argument, Option, Promisable, ParserResult } from "../types";
+import type tabtab from "tabtab";
+import type { Command } from "../command";
+import type { Program } from "../program";
+export interface CompletionItem {
+    name: string;
+    description: string;
+}
+export interface Completer {
+    (ctx: CompletionContext): Promisable<(string | CompletionItem)[]>;
+}
+export interface CompletionContext {
+    program: Program;
+    currentCmd?: Command;
+    compEnv: tabtab.TabtabEnv;
+    parserResult: ParserResult;
+    lastPartIsOpt: boolean;
+    lastPartIsKnownOpt: boolean;
+    currentOpt?: Option;
+}
+export type Completions = Map<Argument | Option, Completer>;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/autocomplete/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/autocomplete/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC1E,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,iBAAiB,GAAG,UAAU,CAAC,CAAC,MAAM,GAAG,cAAc,CAAC,EAAE,CAAC,CAAA;CAClE;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,EAAE,MAAM,CAAC,SAAS,CAAA;IACzB,YAAY,EAAE,YAAY,CAAA;IAC1B,aAAa,EAAE,OAAO,CAAA;IACtB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,GAAG,MAAM,EAAE,SAAS,CAAC,CAAA"}

package/dist/src/autocomplete/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/autocomplete/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/autocomplete/types.ts"],"names":[],"mappings":""}

package/dist/src/command/__fixtures__/example-cmd.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @packageDocumentation
+ * @ignore
+ */
+import type { Command } from "..";
+import type { CreateCommandParameters } from "../../types";
+export default function ({ createCommand }: CreateCommandParameters): Command;
+//# sourceMappingURL=example-cmd.d.ts.map

package/dist/src/command/__fixtures__/example-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-cmd.d.ts","sourceRoot":"","sources":["../../../../src/command/__fixtures__/example-cmd.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAA;AACjC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAE1D,MAAM,CAAC,OAAO,WAAW,EAAE,aAAa,EAAE,EAAE,uBAAuB,GAAG,OAAO,CAK5E"}

package/dist/src/command/__fixtures__/example-cmd.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+function default_1({ createCommand }) {
+    return createCommand("My command").action(({ logger }) => {
+        logger.info("Output of my command");
+        return "hey";
+    });
+}
+//# sourceMappingURL=example-cmd.js.map

package/dist/src/command/__fixtures__/example-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-cmd.js","sourceRoot":"","sources":["../../../../src/command/__fixtures__/example-cmd.ts"],"names":[],"mappings":";;AAQA,4BAKC;AALD,mBAAyB,EAAE,aAAa,EAA2B;IACjE,OAAO,aAAa,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;QACvD,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;QACnC,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/src/command/__tests__/command.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command.spec.d.ts.map

package/dist/src/command/__tests__/command.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.spec.d.ts","sourceRoot":"","sources":["../../../../src/command/__tests__/command.spec.ts"],"names":[],"mappings":""}