parse-my-command 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Fardjad Davari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+# Parse My Command
+
+Parse `argv` with **Commander.js** without executing the command
+
+<div class="paragraph">
+
+<span class="image"><a href="https://www.npmjs.com/package/parse-my-command" class="image"><img src="https://img.shields.io/npm/v/parse-my-command" alt="NPM Version" /></a></span> <span class="image"><a href="https://www.npmjs.com/package/parse-my-command" class="image"><img src="https://img.shields.io/npm/dm/parse-my-command" alt="Monthly Downloads" /></a></span> <span class="image"><a href="https://github.com/fardjad/node-parse-my-command/actions" class="image"><img src="https://img.shields.io/github/actions/workflow/status/fardjad/node-parse-my-command/test-and-release.yml?branch=main" alt="test-and-release Workflow Status" /></a></span>
+
+</div>
+
+<hr />
+
+[Commander.js](https://github.com/tj/commander.js) doesn't support parsing
+`argv` without executing the command. This package provides a workaround for that.
+
+## Installation
+
+```bash
+npm install --save parse-my-command
+```
+
+## Usage
+
+```js
+import { Command } from "commander";
+import { partialParse } from "parse-my-command";
+
+const rootCommand = new Command("root")
+  .requiredOption("-a, --option-a <value>", "option a")
+  .action(() => {
+    throw new Error("This should never get called");
+  });
+
+const childCommand = rootCommand
+  .command("child")
+  .requiredOption("-b, --option-b <value>", "option b")
+  .requiredOption("-c, --option-c <value>", "option c")
+  .action(() => {
+    throw new Error("This should never get called");
+  });
+
+const argv = ["node", "index.mjs", "-a", "value1", "child", "-b", "value2"];
+
+const { matchedCommand, providedOptions, missingOptions } = partialParse(
+  rootCommand,
+  argv,
+);
+
+console.log(matchedCommand.name()); // child
+console.log(providedOptions.get(childCommand)); // { optionB: 'value2' }
+console.log(missingOptions.get(childCommand)); // Set(1) { 'optionC' }
+```
+
+More examples can be found in the [examples](/examples/) directory.

package/dist/index.cjs

@@ -0,0 +1,95 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  findMissingOptions: () => findMissingOptions,
+  partialParse: () => partialParse
+});
+module.exports = __toCommonJS(src_exports);
+var import_camelcase = __toESM(require("camelcase"), 1);
+var import_commander = require("commander");
+var findMissingOptions = (command, providedOptionsByCommand) => {
+  const missingOptionsByCommand = /* @__PURE__ */ new Map();
+  let currentCommand = command;
+  while (currentCommand) {
+    const missingOptions = /* @__PURE__ */ new Set();
+    const providedOptions = providedOptionsByCommand.get(currentCommand);
+    for (const option of currentCommand.options) {
+      const key = (0, import_camelcase.default)(option.long ?? option.short);
+      if (providedOptions?.[key]) {
+        continue;
+      }
+      missingOptions.add(key);
+    }
+    missingOptionsByCommand.set(currentCommand, missingOptions);
+    currentCommand = currentCommand.parent;
+  }
+  return missingOptionsByCommand;
+};
+var partialParse = (command, argv, options) => {
+  const providedOptions = /* @__PURE__ */ new Map();
+  const commandsMap = /* @__PURE__ */ new Map();
+  let matchedCommand;
+  const createParserCommand = (parserCommand2, command2) => {
+    commandsMap.set(parserCommand2, command2);
+    for (const option of command2.options) {
+      parserCommand2.option(option.flags, option.description);
+    }
+    parserCommand2.hook("preSubcommand", (thisCommand, actionCommand) => {
+      providedOptions.set(commandsMap.get(parserCommand2), thisCommand.opts());
+      providedOptions.set(commandsMap.get(actionCommand), thisCommand.opts());
+    });
+    parserCommand2.action(() => {
+      providedOptions.set(
+        commandsMap.get(parserCommand2),
+        parserCommand2.opts()
+      );
+      matchedCommand = command2;
+    });
+    for (const subcommand of command2.commands) {
+      const parserSubcommand = parserCommand2.command(subcommand.name()).exitOverride();
+      createParserCommand(parserSubcommand, subcommand);
+    }
+    return parserCommand2;
+  };
+  const parserCommand = createParserCommand(
+    new import_commander.Command().exitOverride(),
+    command
+  );
+  parserCommand.parse(argv, options);
+  const missingOptions = matchedCommand ? findMissingOptions(matchedCommand, providedOptions) : /* @__PURE__ */ new Map();
+  return { matchedCommand, missingOptions, providedOptions };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  findMissingOptions,
+  partialParse
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vc3JjL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyJpbXBvcnQgY2FtZWxDYXNlIGZyb20gXCJjYW1lbGNhc2VcIjtcbmltcG9ydCB7IHR5cGUgT3B0aW9uVmFsdWVzLCBDb21tYW5kLCB0eXBlIFBhcnNlT3B0aW9ucyB9IGZyb20gXCJjb21tYW5kZXJcIjtcblxuZXhwb3J0IGNvbnN0IGZpbmRNaXNzaW5nT3B0aW9ucyA9IChcbiAgY29tbWFuZDogQ29tbWFuZCxcbiAgcHJvdmlkZWRPcHRpb25zQnlDb21tYW5kOiBNYXA8Q29tbWFuZCwgT3B0aW9uVmFsdWVzPixcbikgPT4ge1xuICBjb25zdCBtaXNzaW5nT3B0aW9uc0J5Q29tbWFuZCA9IG5ldyBNYXA8Q29tbWFuZCwgU2V0PHN0cmluZz4+KCk7XG5cbiAgLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9iYW4tdHlwZXNcbiAgbGV0IGN1cnJlbnRDb21tYW5kOiBDb21tYW5kIHwgdW5kZWZpbmVkIHwgbnVsbCA9IGNvbW1hbmQ7XG5cbiAgd2hpbGUgKGN1cnJlbnRDb21tYW5kKSB7XG4gICAgY29uc3QgbWlzc2luZ09wdGlvbnMgPSBuZXcgU2V0PHN0cmluZz4oKTtcbiAgICBjb25zdCBwcm92aWRlZE9wdGlvbnMgPSBwcm92aWRlZE9wdGlvbnNCeUNvbW1hbmQuZ2V0KGN1cnJlbnRDb21tYW5kKTtcbiAgICBmb3IgKGNvbnN0IG9wdGlvbiBvZiBjdXJyZW50Q29tbWFuZC5vcHRpb25zKSB7XG4gICAgICBjb25zdCBrZXkgPSBjYW1lbENhc2UoKG9wdGlvbi5sb25nID8/IG9wdGlvbi5zaG9ydCkhKTtcbiAgICAgIGlmIChwcm92aWRlZE9wdGlvbnM/LltrZXldKSB7XG4gICAgICAgIGNvbnRpbnVlO1xuICAgICAgfVxuXG4gICAgICBtaXNzaW5nT3B0aW9ucy5hZGQoa2V5KTtcbiAgICB9XG5cbiAgICBtaXNzaW5nT3B0aW9uc0J5Q29tbWFuZC5zZXQoY3VycmVudENvbW1hbmQsIG1pc3NpbmdPcHRpb25zKTtcbiAgICBjdXJyZW50Q29tbWFuZCA9IGN1cnJlbnRDb21tYW5kLnBhcmVudDtcbiAgfVxuXG4gIHJldHVybiBtaXNzaW5nT3B0aW9uc0J5Q29tbWFuZDtcbn07XG5cbmV4cG9ydCB0eXBlIFBhcnRpYWxQYXJzZVJlc3VsdCA9IHtcbiAgLyoqXG4gICAqIFRoZSBjb21tYW5kIHdob3NlIGFjdGlvbiB3aWxsIGJlIGV4ZWN1dGVkXG4gICAqL1xuICBtYXRjaGVkQ29tbWFuZDogQ29tbWFuZCB8IHVuZGVmaW5lZDtcbiAgLyoqXG4gICAqIEEgbWFwIG9mIGNvbW1hbmRzIHRvIGEgc2V0IG9mIG1pc3Npbmcgb3B0aW9ucyBmb3IgdGhhdCBjb21tYW5kXG4gICAqL1xuICBtaXNzaW5nT3B0aW9uczogTWFwPENvbW1hbmQsIFNldDxzdHJpbmc+PjtcbiAgLyoqXG4gICAqIEEgbWFwIG9mIGNvbW1hbmRzIHRvIHRoZSBvcHRpb25zIHByb3ZpZGVkIGZvciB0aGF0IGNvbW1hbmRcbiAgICovXG4gIHByb3ZpZGVkT3B0aW9uczogTWFwPENvbW1hbmQsIE9wdGlvblZhbHVlcz47XG59O1xuXG4vKipcbiAqIFBhcnRpYWxseSBwYXJzZSBhcmd2IGZvciBhIGNvbW1hbmQgd2l0aG91dCBleGVjdXRpbmcgdGhlIGFjdGlvbi4gQHNlZSB7QGxpbmsgQ29tbWFuZC5wYXJzZX1cbiAqXG4gKiBAcmV0dXJucyBBbiBvYmplY3QgY29udGFpbmluZyB0aGUgbWF0Y2hlZCBjb21tYW5kLCB0aGUgcHJvdmlkZWQgb3B0aW9ucywgYW5kIHRoZSBtaXNzaW5nIG9wdGlvbnMuXG4gKi9cbmV4cG9ydCBjb25zdCBwYXJ0aWFsUGFyc2UgPSAoXG4gIGNvbW1hbmQ6IENvbW1hbmQsXG4gIGFyZ3Y6IHJlYWRvbmx5IHN0cmluZ1tdLFxuICBvcHRpb25zPzogUGFyc2VPcHRpb25zLFxuKTogUGFydGlhbFBhcnNlUmVzdWx0ID0+IHtcbiAgY29uc3QgcHJvdmlkZWRPcHRpb25zID0gbmV3IE1hcDxDb21tYW5kLCBPcHRpb25WYWx1ZXM+KCk7XG4gIGNvbnN0IGNvbW1hbmRzTWFwID0gbmV3IE1hcDxDb21tYW5kLCBDb21tYW5kPigpO1xuICBsZXQgbWF0Y2hlZENvbW1hbmQ6IENvbW1hbmQgfCB1bmRlZmluZWQ7XG5cbiAgY29uc3QgY3JlYXRlUGFyc2VyQ29tbWFuZCA9IChwYXJzZXJDb21tYW5kOiBDb21tYW5kLCBjb21tYW5kOiBDb21tYW5kKSA9PiB7XG4gICAgY29tbWFuZHNNYXAuc2V0KHBhcnNlckNvbW1hbmQsIGNvbW1hbmQpO1xuXG4gICAgZm9yIChjb25zdCBvcHRpb24gb2YgY29tbWFuZC5vcHRpb25zKSB7XG4gICAgICBwYXJzZXJDb21tYW5kLm9wdGlvbihvcHRpb24uZmxhZ3MsIG9wdGlvbi5kZXNjcmlwdGlvbik7XG4gICAgfVxuXG4gICAgcGFyc2VyQ29tbWFuZC5ob29rKFwicHJlU3ViY29tbWFuZFwiLCAodGhpc0NvbW1hbmQsIGFjdGlvbkNvbW1hbmQpID0+IHtcbiAgICAgIHByb3ZpZGVkT3B0aW9ucy5zZXQoY29tbWFuZHNNYXAuZ2V0KHBhcnNlckNvbW1hbmQpISwgdGhpc0NvbW1hbmQub3B0cygpKTtcbiAgICAgIHByb3ZpZGVkT3B0aW9ucy5zZXQoY29tbWFuZHNNYXAuZ2V0KGFjdGlvbkNvbW1hbmQpISwgdGhpc0NvbW1hbmQub3B0cygpKTtcbiAgICB9KTtcblxuICAgIHBhcnNlckNvbW1hbmQuYWN0aW9uKCgpID0+IHtcbiAgICAgIHByb3ZpZGVkT3B0aW9ucy5zZXQoXG4gICAgICAgIGNvbW1hbmRzTWFwLmdldChwYXJzZXJDb21tYW5kKSEsXG4gICAgICAgIHBhcnNlckNvbW1hbmQub3B0cygpLFxuICAgICAgKTtcbiAgICAgIG1hdGNoZWRDb21tYW5kID0gY29tbWFuZDtcbiAgICB9KTtcblxuICAgIGZvciAoY29uc3Qgc3ViY29tbWFuZCBvZiBjb21tYW5kLmNvbW1hbmRzIGFzIENvbW1hbmRbXSkge1xuICAgICAgY29uc3QgcGFyc2VyU3ViY29tbWFuZCA9IHBhcnNlckNvbW1hbmRcbiAgICAgICAgLmNvbW1hbmQoc3ViY29tbWFuZC5uYW1lKCkpXG4gICAgICAgIC5leGl0T3ZlcnJpZGUoKTtcbiAgICAgIGNyZWF0ZVBhcnNlckNvbW1hbmQocGFyc2VyU3ViY29tbWFuZCwgc3ViY29tbWFuZCk7XG4gICAgfVxuXG4gICAgcmV0dXJuIHBhcnNlckNvbW1hbmQ7XG4gIH07XG5cbiAgY29uc3QgcGFyc2VyQ29tbWFuZCA9IGNyZWF0ZVBhcnNlckNvbW1hbmQoXG4gICAgbmV3IENvbW1hbmQoKS5leGl0T3ZlcnJpZGUoKSxcbiAgICBjb21tYW5kLFxuICApO1xuICBwYXJzZXJDb21tYW5kLnBhcnNlKGFyZ3YsIG9wdGlvbnMpO1xuXG4gIGNvbnN0IG1pc3NpbmdPcHRpb25zID0gbWF0Y2hlZENvbW1hbmRcbiAgICA/IGZpbmRNaXNzaW5nT3B0aW9ucyhtYXRjaGVkQ29tbWFuZCwgcHJvdmlkZWRPcHRpb25zKVxuICAgIDogbmV3IE1hcDxDb21tYW5kLCBTZXQ8c3RyaW5nPj4oKTtcblxuICByZXR1cm4geyBtYXRjaGVkQ29tbWFuZCwgbWlzc2luZ09wdGlvbnMsIHByb3ZpZGVkT3B0aW9ucyB9O1xufTtcbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsdUJBQXNCO0FBQ3RCLHVCQUE4RDtBQUV2RCxJQUFNLHFCQUFxQixDQUNoQyxTQUNBLDZCQUNHO0FBQ0gsUUFBTSwwQkFBMEIsb0JBQUksSUFBMEI7QUFHOUQsTUFBSSxpQkFBNkM7QUFFakQsU0FBTyxnQkFBZ0I7QUFDckIsVUFBTSxpQkFBaUIsb0JBQUksSUFBWTtBQUN2QyxVQUFNLGtCQUFrQix5QkFBeUIsSUFBSSxjQUFjO0FBQ25FLGVBQVcsVUFBVSxlQUFlLFNBQVM7QUFDM0MsWUFBTSxVQUFNLGlCQUFBQSxTQUFXLE9BQU8sUUFBUSxPQUFPLEtBQU87QUFDcEQsVUFBSSxrQkFBa0IsR0FBRyxHQUFHO0FBQzFCO0FBQUEsTUFDRjtBQUVBLHFCQUFlLElBQUksR0FBRztBQUFBLElBQ3hCO0FBRUEsNEJBQXdCLElBQUksZ0JBQWdCLGNBQWM7QUFDMUQscUJBQWlCLGVBQWU7QUFBQSxFQUNsQztBQUVBLFNBQU87QUFDVDtBQXNCTyxJQUFNLGVBQWUsQ0FDMUIsU0FDQSxNQUNBLFlBQ3VCO0FBQ3ZCLFFBQU0sa0JBQWtCLG9CQUFJLElBQTJCO0FBQ3ZELFFBQU0sY0FBYyxvQkFBSSxJQUFzQjtBQUM5QyxNQUFJO0FBRUosUUFBTSxzQkFBc0IsQ0FBQ0MsZ0JBQXdCQyxhQUFxQjtBQUN4RSxnQkFBWSxJQUFJRCxnQkFBZUMsUUFBTztBQUV0QyxlQUFXLFVBQVVBLFNBQVEsU0FBUztBQUNwQyxNQUFBRCxlQUFjLE9BQU8sT0FBTyxPQUFPLE9BQU8sV0FBVztBQUFBLElBQ3ZEO0FBRUEsSUFBQUEsZUFBYyxLQUFLLGlCQUFpQixDQUFDLGFBQWEsa0JBQWtCO0FBQ2xFLHNCQUFnQixJQUFJLFlBQVksSUFBSUEsY0FBYSxHQUFJLFlBQVksS0FBSyxDQUFDO0FBQ3ZFLHNCQUFnQixJQUFJLFlBQVksSUFBSSxhQUFhLEdBQUksWUFBWSxLQUFLLENBQUM7QUFBQSxJQUN6RSxDQUFDO0FBRUQsSUFBQUEsZUFBYyxPQUFPLE1BQU07QUFDekIsc0JBQWdCO0FBQUEsUUFDZCxZQUFZLElBQUlBLGNBQWE7QUFBQSxRQUM3QkEsZUFBYyxLQUFLO0FBQUEsTUFDckI7QUFDQSx1QkFBaUJDO0FBQUEsSUFDbkIsQ0FBQztBQUVELGVBQVcsY0FBY0EsU0FBUSxVQUF1QjtBQUN0RCxZQUFNLG1CQUFtQkQsZUFDdEIsUUFBUSxXQUFXLEtBQUssQ0FBQyxFQUN6QixhQUFhO0FBQ2hCLDBCQUFvQixrQkFBa0IsVUFBVTtBQUFBLElBQ2xEO0FBRUEsV0FBT0E7QUFBQSxFQUNUO0FBRUEsUUFBTSxnQkFBZ0I7QUFBQSxJQUNwQixJQUFJLHlCQUFRLEVBQUUsYUFBYTtBQUFBLElBQzNCO0FBQUEsRUFDRjtBQUNBLGdCQUFjLE1BQU0sTUFBTSxPQUFPO0FBRWpDLFFBQU0saUJBQWlCLGlCQUNuQixtQkFBbUIsZ0JBQWdCLGVBQWUsSUFDbEQsb0JBQUksSUFBMEI7QUFFbEMsU0FBTyxFQUFFLGdCQUFnQixnQkFBZ0IsZ0JBQWdCO0FBQzNEOyIsCiAgIm5hbWVzIjogWyJjYW1lbENhc2UiLCAicGFyc2VyQ29tbWFuZCIsICJjb21tYW5kIl0KfQo=

package/dist/index.d.cts

@@ -0,0 +1,25 @@
+import { Command, OptionValues, ParseOptions } from 'commander';
+
+declare const findMissingOptions: (command: Command, providedOptionsByCommand: Map<Command, OptionValues>) => Map<Command, Set<string>>;
+type PartialParseResult = {
+    /**
+     * The command whose action will be executed
+     */
+    matchedCommand: Command | undefined;
+    /**
+     * A map of commands to a set of missing options for that command
+     */
+    missingOptions: Map<Command, Set<string>>;
+    /**
+     * A map of commands to the options provided for that command
+     */
+    providedOptions: Map<Command, OptionValues>;
+};
+/**
+ * Partially parse argv for a command without executing the action. @see {@link Command.parse}
+ *
+ * @returns An object containing the matched command, the provided options, and the missing options.
+ */
+declare const partialParse: (command: Command, argv: readonly string[], options?: ParseOptions) => PartialParseResult;
+
+export { PartialParseResult, findMissingOptions, partialParse };

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { Command, OptionValues, ParseOptions } from 'commander';
+
+declare const findMissingOptions: (command: Command, providedOptionsByCommand: Map<Command, OptionValues>) => Map<Command, Set<string>>;
+type PartialParseResult = {
+    /**
+     * The command whose action will be executed
+     */
+    matchedCommand: Command | undefined;
+    /**
+     * A map of commands to a set of missing options for that command
+     */
+    missingOptions: Map<Command, Set<string>>;
+    /**
+     * A map of commands to the options provided for that command
+     */
+    providedOptions: Map<Command, OptionValues>;
+};
+/**
+ * Partially parse argv for a command without executing the action. @see {@link Command.parse}
+ *
+ * @returns An object containing the matched command, the provided options, and the missing options.
+ */
+declare const partialParse: (command: Command, argv: readonly string[], options?: ParseOptions) => PartialParseResult;
+
+export { PartialParseResult, findMissingOptions, partialParse };

package/dist/index.js

@@ -0,0 +1,60 @@
+// src/index.ts
+import camelCase from "camelcase";
+import { Command } from "commander";
+var findMissingOptions = (command, providedOptionsByCommand) => {
+  const missingOptionsByCommand = /* @__PURE__ */ new Map();
+  let currentCommand = command;
+  while (currentCommand) {
+    const missingOptions = /* @__PURE__ */ new Set();
+    const providedOptions = providedOptionsByCommand.get(currentCommand);
+    for (const option of currentCommand.options) {
+      const key = camelCase(option.long ?? option.short);
+      if (providedOptions?.[key]) {
+        continue;
+      }
+      missingOptions.add(key);
+    }
+    missingOptionsByCommand.set(currentCommand, missingOptions);
+    currentCommand = currentCommand.parent;
+  }
+  return missingOptionsByCommand;
+};
+var partialParse = (command, argv, options) => {
+  const providedOptions = /* @__PURE__ */ new Map();
+  const commandsMap = /* @__PURE__ */ new Map();
+  let matchedCommand;
+  const createParserCommand = (parserCommand2, command2) => {
+    commandsMap.set(parserCommand2, command2);
+    for (const option of command2.options) {
+      parserCommand2.option(option.flags, option.description);
+    }
+    parserCommand2.hook("preSubcommand", (thisCommand, actionCommand) => {
+      providedOptions.set(commandsMap.get(parserCommand2), thisCommand.opts());
+      providedOptions.set(commandsMap.get(actionCommand), thisCommand.opts());
+    });
+    parserCommand2.action(() => {
+      providedOptions.set(
+        commandsMap.get(parserCommand2),
+        parserCommand2.opts()
+      );
+      matchedCommand = command2;
+    });
+    for (const subcommand of command2.commands) {
+      const parserSubcommand = parserCommand2.command(subcommand.name()).exitOverride();
+      createParserCommand(parserSubcommand, subcommand);
+    }
+    return parserCommand2;
+  };
+  const parserCommand = createParserCommand(
+    new Command().exitOverride(),
+    command
+  );
+  parserCommand.parse(argv, options);
+  const missingOptions = matchedCommand ? findMissingOptions(matchedCommand, providedOptions) : /* @__PURE__ */ new Map();
+  return { matchedCommand, missingOptions, providedOptions };
+};
+export {
+  findMissingOptions,
+  partialParse
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vc3JjL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyJpbXBvcnQgY2FtZWxDYXNlIGZyb20gXCJjYW1lbGNhc2VcIjtcbmltcG9ydCB7IHR5cGUgT3B0aW9uVmFsdWVzLCBDb21tYW5kLCB0eXBlIFBhcnNlT3B0aW9ucyB9IGZyb20gXCJjb21tYW5kZXJcIjtcblxuZXhwb3J0IGNvbnN0IGZpbmRNaXNzaW5nT3B0aW9ucyA9IChcbiAgY29tbWFuZDogQ29tbWFuZCxcbiAgcHJvdmlkZWRPcHRpb25zQnlDb21tYW5kOiBNYXA8Q29tbWFuZCwgT3B0aW9uVmFsdWVzPixcbikgPT4ge1xuICBjb25zdCBtaXNzaW5nT3B0aW9uc0J5Q29tbWFuZCA9IG5ldyBNYXA8Q29tbWFuZCwgU2V0PHN0cmluZz4+KCk7XG5cbiAgLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9iYW4tdHlwZXNcbiAgbGV0IGN1cnJlbnRDb21tYW5kOiBDb21tYW5kIHwgdW5kZWZpbmVkIHwgbnVsbCA9IGNvbW1hbmQ7XG5cbiAgd2hpbGUgKGN1cnJlbnRDb21tYW5kKSB7XG4gICAgY29uc3QgbWlzc2luZ09wdGlvbnMgPSBuZXcgU2V0PHN0cmluZz4oKTtcbiAgICBjb25zdCBwcm92aWRlZE9wdGlvbnMgPSBwcm92aWRlZE9wdGlvbnNCeUNvbW1hbmQuZ2V0KGN1cnJlbnRDb21tYW5kKTtcbiAgICBmb3IgKGNvbnN0IG9wdGlvbiBvZiBjdXJyZW50Q29tbWFuZC5vcHRpb25zKSB7XG4gICAgICBjb25zdCBrZXkgPSBjYW1lbENhc2UoKG9wdGlvbi5sb25nID8/IG9wdGlvbi5zaG9ydCkhKTtcbiAgICAgIGlmIChwcm92aWRlZE9wdGlvbnM/LltrZXldKSB7XG4gICAgICAgIGNvbnRpbnVlO1xuICAgICAgfVxuXG4gICAgICBtaXNzaW5nT3B0aW9ucy5hZGQoa2V5KTtcbiAgICB9XG5cbiAgICBtaXNzaW5nT3B0aW9uc0J5Q29tbWFuZC5zZXQoY3VycmVudENvbW1hbmQsIG1pc3NpbmdPcHRpb25zKTtcbiAgICBjdXJyZW50Q29tbWFuZCA9IGN1cnJlbnRDb21tYW5kLnBhcmVudDtcbiAgfVxuXG4gIHJldHVybiBtaXNzaW5nT3B0aW9uc0J5Q29tbWFuZDtcbn07XG5cbmV4cG9ydCB0eXBlIFBhcnRpYWxQYXJzZVJlc3VsdCA9IHtcbiAgLyoqXG4gICAqIFRoZSBjb21tYW5kIHdob3NlIGFjdGlvbiB3aWxsIGJlIGV4ZWN1dGVkXG4gICAqL1xuICBtYXRjaGVkQ29tbWFuZDogQ29tbWFuZCB8IHVuZGVmaW5lZDtcbiAgLyoqXG4gICAqIEEgbWFwIG9mIGNvbW1hbmRzIHRvIGEgc2V0IG9mIG1pc3Npbmcgb3B0aW9ucyBmb3IgdGhhdCBjb21tYW5kXG4gICAqL1xuICBtaXNzaW5nT3B0aW9uczogTWFwPENvbW1hbmQsIFNldDxzdHJpbmc+PjtcbiAgLyoqXG4gICAqIEEgbWFwIG9mIGNvbW1hbmRzIHRvIHRoZSBvcHRpb25zIHByb3ZpZGVkIGZvciB0aGF0IGNvbW1hbmRcbiAgICovXG4gIHByb3ZpZGVkT3B0aW9uczogTWFwPENvbW1hbmQsIE9wdGlvblZhbHVlcz47XG59O1xuXG4vKipcbiAqIFBhcnRpYWxseSBwYXJzZSBhcmd2IGZvciBhIGNvbW1hbmQgd2l0aG91dCBleGVjdXRpbmcgdGhlIGFjdGlvbi4gQHNlZSB7QGxpbmsgQ29tbWFuZC5wYXJzZX1cbiAqXG4gKiBAcmV0dXJucyBBbiBvYmplY3QgY29udGFpbmluZyB0aGUgbWF0Y2hlZCBjb21tYW5kLCB0aGUgcHJvdmlkZWQgb3B0aW9ucywgYW5kIHRoZSBtaXNzaW5nIG9wdGlvbnMuXG4gKi9cbmV4cG9ydCBjb25zdCBwYXJ0aWFsUGFyc2UgPSAoXG4gIGNvbW1hbmQ6IENvbW1hbmQsXG4gIGFyZ3Y6IHJlYWRvbmx5IHN0cmluZ1tdLFxuICBvcHRpb25zPzogUGFyc2VPcHRpb25zLFxuKTogUGFydGlhbFBhcnNlUmVzdWx0ID0+IHtcbiAgY29uc3QgcHJvdmlkZWRPcHRpb25zID0gbmV3IE1hcDxDb21tYW5kLCBPcHRpb25WYWx1ZXM+KCk7XG4gIGNvbnN0IGNvbW1hbmRzTWFwID0gbmV3IE1hcDxDb21tYW5kLCBDb21tYW5kPigpO1xuICBsZXQgbWF0Y2hlZENvbW1hbmQ6IENvbW1hbmQgfCB1bmRlZmluZWQ7XG5cbiAgY29uc3QgY3JlYXRlUGFyc2VyQ29tbWFuZCA9IChwYXJzZXJDb21tYW5kOiBDb21tYW5kLCBjb21tYW5kOiBDb21tYW5kKSA9PiB7XG4gICAgY29tbWFuZHNNYXAuc2V0KHBhcnNlckNvbW1hbmQsIGNvbW1hbmQpO1xuXG4gICAgZm9yIChjb25zdCBvcHRpb24gb2YgY29tbWFuZC5vcHRpb25zKSB7XG4gICAgICBwYXJzZXJDb21tYW5kLm9wdGlvbihvcHRpb24uZmxhZ3MsIG9wdGlvbi5kZXNjcmlwdGlvbik7XG4gICAgfVxuXG4gICAgcGFyc2VyQ29tbWFuZC5ob29rKFwicHJlU3ViY29tbWFuZFwiLCAodGhpc0NvbW1hbmQsIGFjdGlvbkNvbW1hbmQpID0+IHtcbiAgICAgIHByb3ZpZGVkT3B0aW9ucy5zZXQoY29tbWFuZHNNYXAuZ2V0KHBhcnNlckNvbW1hbmQpISwgdGhpc0NvbW1hbmQub3B0cygpKTtcbiAgICAgIHByb3ZpZGVkT3B0aW9ucy5zZXQoY29tbWFuZHNNYXAuZ2V0KGFjdGlvbkNvbW1hbmQpISwgdGhpc0NvbW1hbmQub3B0cygpKTtcbiAgICB9KTtcblxuICAgIHBhcnNlckNvbW1hbmQuYWN0aW9uKCgpID0+IHtcbiAgICAgIHByb3ZpZGVkT3B0aW9ucy5zZXQoXG4gICAgICAgIGNvbW1hbmRzTWFwLmdldChwYXJzZXJDb21tYW5kKSEsXG4gICAgICAgIHBhcnNlckNvbW1hbmQub3B0cygpLFxuICAgICAgKTtcbiAgICAgIG1hdGNoZWRDb21tYW5kID0gY29tbWFuZDtcbiAgICB9KTtcblxuICAgIGZvciAoY29uc3Qgc3ViY29tbWFuZCBvZiBjb21tYW5kLmNvbW1hbmRzIGFzIENvbW1hbmRbXSkge1xuICAgICAgY29uc3QgcGFyc2VyU3ViY29tbWFuZCA9IHBhcnNlckNvbW1hbmRcbiAgICAgICAgLmNvbW1hbmQoc3ViY29tbWFuZC5uYW1lKCkpXG4gICAgICAgIC5leGl0T3ZlcnJpZGUoKTtcbiAgICAgIGNyZWF0ZVBhcnNlckNvbW1hbmQocGFyc2VyU3ViY29tbWFuZCwgc3ViY29tbWFuZCk7XG4gICAgfVxuXG4gICAgcmV0dXJuIHBhcnNlckNvbW1hbmQ7XG4gIH07XG5cbiAgY29uc3QgcGFyc2VyQ29tbWFuZCA9IGNyZWF0ZVBhcnNlckNvbW1hbmQoXG4gICAgbmV3IENvbW1hbmQoKS5leGl0T3ZlcnJpZGUoKSxcbiAgICBjb21tYW5kLFxuICApO1xuICBwYXJzZXJDb21tYW5kLnBhcnNlKGFyZ3YsIG9wdGlvbnMpO1xuXG4gIGNvbnN0IG1pc3NpbmdPcHRpb25zID0gbWF0Y2hlZENvbW1hbmRcbiAgICA/IGZpbmRNaXNzaW5nT3B0aW9ucyhtYXRjaGVkQ29tbWFuZCwgcHJvdmlkZWRPcHRpb25zKVxuICAgIDogbmV3IE1hcDxDb21tYW5kLCBTZXQ8c3RyaW5nPj4oKTtcblxuICByZXR1cm4geyBtYXRjaGVkQ29tbWFuZCwgbWlzc2luZ09wdGlvbnMsIHByb3ZpZGVkT3B0aW9ucyB9O1xufTtcbiJdLAogICJtYXBwaW5ncyI6ICI7QUFBQSxPQUFPLGVBQWU7QUFDdEIsU0FBNEIsZUFBa0M7QUFFdkQsSUFBTSxxQkFBcUIsQ0FDaEMsU0FDQSw2QkFDRztBQUNILFFBQU0sMEJBQTBCLG9CQUFJLElBQTBCO0FBRzlELE1BQUksaUJBQTZDO0FBRWpELFNBQU8sZ0JBQWdCO0FBQ3JCLFVBQU0saUJBQWlCLG9CQUFJLElBQVk7QUFDdkMsVUFBTSxrQkFBa0IseUJBQXlCLElBQUksY0FBYztBQUNuRSxlQUFXLFVBQVUsZUFBZSxTQUFTO0FBQzNDLFlBQU0sTUFBTSxVQUFXLE9BQU8sUUFBUSxPQUFPLEtBQU87QUFDcEQsVUFBSSxrQkFBa0IsR0FBRyxHQUFHO0FBQzFCO0FBQUEsTUFDRjtBQUVBLHFCQUFlLElBQUksR0FBRztBQUFBLElBQ3hCO0FBRUEsNEJBQXdCLElBQUksZ0JBQWdCLGNBQWM7QUFDMUQscUJBQWlCLGVBQWU7QUFBQSxFQUNsQztBQUVBLFNBQU87QUFDVDtBQXNCTyxJQUFNLGVBQWUsQ0FDMUIsU0FDQSxNQUNBLFlBQ3VCO0FBQ3ZCLFFBQU0sa0JBQWtCLG9CQUFJLElBQTJCO0FBQ3ZELFFBQU0sY0FBYyxvQkFBSSxJQUFzQjtBQUM5QyxNQUFJO0FBRUosUUFBTSxzQkFBc0IsQ0FBQ0EsZ0JBQXdCQyxhQUFxQjtBQUN4RSxnQkFBWSxJQUFJRCxnQkFBZUMsUUFBTztBQUV0QyxlQUFXLFVBQVVBLFNBQVEsU0FBUztBQUNwQyxNQUFBRCxlQUFjLE9BQU8sT0FBTyxPQUFPLE9BQU8sV0FBVztBQUFBLElBQ3ZEO0FBRUEsSUFBQUEsZUFBYyxLQUFLLGlCQUFpQixDQUFDLGFBQWEsa0JBQWtCO0FBQ2xFLHNCQUFnQixJQUFJLFlBQVksSUFBSUEsY0FBYSxHQUFJLFlBQVksS0FBSyxDQUFDO0FBQ3ZFLHNCQUFnQixJQUFJLFlBQVksSUFBSSxhQUFhLEdBQUksWUFBWSxLQUFLLENBQUM7QUFBQSxJQUN6RSxDQUFDO0FBRUQsSUFBQUEsZUFBYyxPQUFPLE1BQU07QUFDekIsc0JBQWdCO0FBQUEsUUFDZCxZQUFZLElBQUlBLGNBQWE7QUFBQSxRQUM3QkEsZUFBYyxLQUFLO0FBQUEsTUFDckI7QUFDQSx1QkFBaUJDO0FBQUEsSUFDbkIsQ0FBQztBQUVELGVBQVcsY0FBY0EsU0FBUSxVQUF1QjtBQUN0RCxZQUFNLG1CQUFtQkQsZUFDdEIsUUFBUSxXQUFXLEtBQUssQ0FBQyxFQUN6QixhQUFhO0FBQ2hCLDBCQUFvQixrQkFBa0IsVUFBVTtBQUFBLElBQ2xEO0FBRUEsV0FBT0E7QUFBQSxFQUNUO0FBRUEsUUFBTSxnQkFBZ0I7QUFBQSxJQUNwQixJQUFJLFFBQVEsRUFBRSxhQUFhO0FBQUEsSUFDM0I7QUFBQSxFQUNGO0FBQ0EsZ0JBQWMsTUFBTSxNQUFNLE9BQU87QUFFakMsUUFBTSxpQkFBaUIsaUJBQ25CLG1CQUFtQixnQkFBZ0IsZUFBZSxJQUNsRCxvQkFBSSxJQUEwQjtBQUVsQyxTQUFPLEVBQUUsZ0JBQWdCLGdCQUFnQixnQkFBZ0I7QUFDM0Q7IiwKICAibmFtZXMiOiBbInBhcnNlckNvbW1hbmQiLCAiY29tbWFuZCJdCn0K

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "parse-my-command",
+  "version": "0.1.0",
+  "description": "Parse argv with Commander.js without executing the command",
+  "keywords": [],
+  "homepage": "https://github.com/fardjad/node-parse-my-command",
+  "bugs": {
+    "url": "https://github.com/fardjad/node-parse-my-command/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/fardjad/node-parse-my-command.git"
+  },
+  "license": "MIT",
+  "author": "Fardjad Davari <public@fardjad.com>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "require": {
+        "default": "./dist/index.cjs",
+        "types": "./dist/index.d.cts"
+      },
+      "import": {
+        "default": "./dist/index.js",
+        "types": "./dist/index.d.ts"
+      }
+    }
+  },
+  "main": "dist/index.cjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/index.cjs",
+    "dist/index.d.cts",
+    "dist/index.d.ts",
+    "dist/index.js"
+  ],
+  "scripts": {
+    "fix": "prettier --write . && eslint --ext .js --ext .cjs --ext .mjs --ext .ts --ext .cts --ext .mts --ext .d.ts --fix .",
+    "lint": "prettier --check . && eslint --ext .js --ext .cjs --ext .mjs --ext .ts --ext .cts --ext .mts --ext .d.ts .",
+    "prepare": "tsup ./src/index.ts --format esm,cjs --dts --clean --sourcemap inline --silent",
+    "pretest": "tsc",
+    "test": "glob -c \"tsx --test --test-reporter spec\" \"src/**/*.test.ts\"",
+    "posttest": "npm run lint",
+    "test:coverage": "c8 npm run test"
+  },
+  "c8": {
+    "reporter": [
+      "lcov"
+    ]
+  },
+  "dependencies": {
+    "camelcase": "^8.0.0",
+    "commander": "^11.0.0"
+  },
+  "devDependencies": {
+    "@trivago/prettier-plugin-sort-imports": "^4.2.0",
+    "@types/node": "^20.5.8",
+    "@typescript-eslint/eslint-plugin": "^6.5.0",
+    "@typescript-eslint/parser": "^6.5.0",
+    "c8": "^8.0.1",
+    "eslint": "^8.48.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-config-xo": "^0.43.1",
+    "eslint-config-xo-typescript": "^1.0.1",
+    "eslint-plugin-unicorn": "^48.0.1",
+    "glob": "^10.3.4",
+    "npm-check-updates": "^16.13.2",
+    "prettier": "^3.0.3",
+    "prettier-plugin-packagejson": "^2.4.5",
+    "tsup": "^7.2.0",
+    "tsx": "^3.12.8",
+    "typescript": "^5.2.2"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}