libs/commands/exec/src/command.ts - main - githubmirror/lerna

libs/commands/exec/src/command.ts
79 строк3 KB
AI-JamesHenry
feat!: support node ^22.13.0 || ^24.0.0 || ^26.0.0, ship lerna as ESM-only (#4390)
14 июл 2026, 11:38
14 июл 2026, 11:38a148ba2
import { filterOptions } from "@lerna/core";
import type { CommandModule } from "yargs";
import { factory } from "./index";

/**
 * @see https://github.com/yargs/yargs/blob/main/docs/advanced.md#providing-a-command-module
 */
const command: CommandModule = {
  command: "exec [cmd] [args..]",
  describe: "Execute an arbitrary command in each package",
  builder(yargs) {
    yargs
      .example("$0 exec ls -- --la", "# execute `ls -la` in all packages")
      .example("$0 exec -- ls --la", "# execute `ls -la` in all packages, keeping cmd outside")
      .parserConfiguration({
        "populate--": true,
      })
      .positional("cmd", {
        describe: "The command to execute. Any command flags must be passed after --",
        type: "string",
      })
      .positional("args", {
        describe: "Positional arguments (not recognized by lerna) to send to command",
        type: "string",
      })
      .options({
        stream: {
          group: "Command Options:",
          describe: "Stream output with lines prefixed by originating package name.",
          type: "boolean",
        },
        parallel: {
          group: "Command Options:",
          describe: "Execute command with unlimited concurrency, streaming prefixed output.",
          type: "boolean",
        },
        "no-bail": {
          group: "Command Options:",
          describe: "Continue executing command despite non-zero exit in a given package.",
          type: "boolean",
        },
        bail: {
          // proxy for --no-bail
          hidden: true,
          type: "boolean",
        },
        // This option controls prefix for stream output so that it can be disabled to be friendly
        // to tools like Visual Studio Code to highlight the raw results
        "no-prefix": {
          group: "Command Options:",
          describe: "Do not prefix streaming output.",
          type: "boolean",
        },
        prefix: {
          // proxy for --no-prefix
          hidden: true,
          type: "boolean",
        },
        profile: {
          group: "Command Options:",
          describe: "Profile command executions and output performance profile to default location.",
          type: "boolean",
        },
        "profile-location": {
          group: "Command Options:",
          describe: "Output performance profile to custom location instead of default project root.",
          type: "string",
        },
      });

    return filterOptions(yargs);
  },
  async handler(argv) {
    return factory(argv);
  },
};

export default command;
export { command as "module.exports" };