env-cmd/dist/parse-args.js

import * as commander from 'commander';
import { parseArgList } from './utils.js';
import { default as packageJson } from '../package.json' with { type: 'json' };
/**
* Parses the arguments passed into the cli
*/
export function parseArgs(args) {
    // Run the initial arguments through commander in order to determine
    // which value in the args array is the `command` to execute
    let program = parseArgsUsingCommander(args);
    const command = program.args[0];
    // Grab all arguments after the `command` in the args array
    const commandArgs = args.splice(args.indexOf(command) + 1);
    // Reprocess the args with the command and command arguments removed
    program = parseArgsUsingCommander(args.slice(0, args.indexOf(command)));
    // Set values for provided options
    let noOverride = false;
    // In commander `no-` negates the original value `override`
    if (program.override === false) {
        noOverride = true;
    }
    let useShell = false;
    if (program.useShell === true) {
        useShell = true;
    }
    let expandEnvs = false;
    if (program.expandEnvs === true) {
        expandEnvs = true;
    }
    let verbose = false;
    if (program.verbose === true) {
        verbose = true;
    }
    let silent = false;
    if (program.silent === true) {
        silent = true;
    }
    let rc;
    if (program.environments !== undefined
        && Array.isArray(program.environments)
        && program.environments.length !== 0) {
        rc = {
            environments: program.environments,
            filePath: program.rcFile,
        };
    }
    let envFile;
    if (program.file !== undefined) {
        envFile = {
            filePath: program.file,
            fallback: program.fallback,
        };
    }
    const options = {
        command,
        commandArgs,
        envFile,
        rc,
        options: {
            expandEnvs,
            noOverride,
            silent,
            useShell,
            verbose,
        },
    };
    if (verbose) {
        console.info(`Options: ${JSON.stringify(options, null, 0)}`);
    }
    return options;
}
export function parseArgsUsingCommander(args) {
    const program = new commander.Command();
    return program
        .version(packageJson.version, '-v, --version')
        .usage('[options] <command> [...args]')
        .option('-e, --environments [env1,env2,...]', 'The rc file environment(s) to use', parseArgList)
        .option('-f, --file [path]', 'Custom env file path (default path: ./.env)')
        .option('--fallback', 'Fallback to default env file path, if custom env file path not found')
        .option('--no-override', 'Do not override existing environment variables')
        .option('-r, --rc-file [path]', 'Custom rc file path (default path: ./.env-cmdrc(|.js|.json)')
        .option('--silent', 'Ignore any env-cmd errors and only fail on executed program failure.')
        .option('--use-shell', 'Execute the command in a new shell with the given environment')
        .option('--verbose', 'Print helpful debugging information')
        .option('-x, --expand-envs', 'Replace $var in args and command with environment variables')
        .allowUnknownOption(true)
        .parse(['_', '_', ...args]);
}