@karmaniverous/get-dotenv 3.0.4 → 3.0.6

package/README.md

@@ -13,7 +13,7 @@ Load environment variables with a cascade of environment-aware dotenv files. You
 
 `getdotenv` relies on the excellent [`dotenv`](https://www.npmjs.com/package/dotenv) parser and uses [`dotenv-expand`](https://www.npmjs.com/package/dotenv-expand) for recursive variable expansion.
 
-The command-line version populates `process.env` from your dotenv files (you can also specify values inline) and can then execute a shell command within that context. The executing shell is configurable. Any child `getdotenv` instances will inherit as defaults the parent shell's environment and optionally its `getdotenv` settings.
+The command-line version populates `process.env` from your dotenv files (you can also specify values inline) and can then execute a shell command within that context. Any child `getdotenv` instances will inherit as defaults the parent shell's environment and optionally its `getdotenv` settings.
 
 You can always use `getdotenv` directly on the command line, but its REAL power comes into play when you use it as the foundation of your own CLI. This lets you set defaults globally and configure pre- and post-hooks that mutate your `getdotenv` context and do useful things like grab an AWS session from your dev environment and add it to the command execution context.
 
@@ -79,31 +79,37 @@ Usage: getdotenv [options] [command]
 Base CLI. All options except delimiters follow dotenv-expand rules.
 
 Options:
-  -e, --env <string>            target environment
-  --default-env <string>        default target environment (default: "dev")
-  -p, --paths <string>          delimited list of paths to dotenv directory (default: "./")
-  --paths-delimiter <string>    regex paths delimiter (default: "\\s+")
-  -v, --vars <string>           delimited list KEY=VALUE pairs
-  --vars-delimiter <string>     regex vars delimiter (default: "\\s+")
-  --vars-assignor <string>      regex vars assignment operator (default: "=")
-  -y, --dynamic-path <string>   dynamic variables path
-  -o, --output-path <string>    consolidated output file, follows dotenv-expand rules using loaded env vars
-  -n, --exclude-env [bool]      exclude environment-specific variables (default: false)
-  -g, --exclude-global [bool]   exclude global & dynamic variables (default: false)
-  -r, --exclude-private [bool]  exclude private variables (default: false)
-  -u, --exclude-public [bool]   exclude public variables (default: false)
-  -z, --exclude-dynamic [bool]  exclude dynamic variables (default: false)
-  -l, --log [bool]              console log extracted variables (default: false)
-  -x, --suppress-dotenv         suppress dotenv loading (default: false)
-  -c, --command <string>        shell command string
-  -s, --shell <string>          execa shell option
-  --dotenv-token <string>       token indicating a dotenv file (default: ".env")
-  --private-token <string>      token indicating private variables (default: "local")
-  -h, --help                    display help for command
+  -e, --env <string>           target environment
+  --default-env <string>       default target environment (default: "dev")
+  -p, --paths <string>         delimited list of paths to dotenv directory (default: "./")
+  --paths-delimiter <string>   regex paths delimiter (default: "\\s+")
+  -v, --vars <string>          delimited list KEY=VALUE pairs
+  --vars-delimiter <string>    regex vars delimiter (default: "\\s+")
+  --vars-assignor <string>     regex vars assignment operator (default: "=")
+  -y, --dynamic-path <string>  dynamic variables path
+  -o, --output-path <string>   consolidated output file, follows dotenv-expand rules using loaded env vars
+  -n, --exclude-env            exclude environment-specific variables
+  -N, --exclude-env-off        exclude environment-specific variables OFF (default)
+  -g, --exclude-global         exclude global variables
+  -G, --exclude-global-off     exclude global variables OFF (default)
+  -r, --exclude-private        exclude private variables
+  -R, --exclude-private-off    exclude private variables OFF (default)
+  -u, --exclude-public         exclude public variables
+  -U, --exclude-public-off     exclude public variables OFF (default)
+  -z, --exclude-dynamic        exclude dynamic variables
+  -Z, --exclude-dynamic-off    exclude dynamic variables OFF (default)
+  -l, --log                    console log extracted variables
+  -L, --log-off                console log extracted variables OFF (default)
+  -x, --suppress-dotenv        suppress dotenv loading (default: false)
+  -c, --command <string>       shell command string
+  --dotenv-token <string>      token indicating a dotenv file (default: ".env")
+  --private-token <string>     token indicating private variables (default: "local")
+  -D, --debug                  debug mode
+  -h, --help                   display help for command
 
 Commands:
-  cmd                           execute shell command string (default command)
-  help [command]                display help for command
+  cmd                          execute shell command string (default command)
+  help [command]               display help for command
 ```
 
 # API Documentation
@@ -194,6 +200,7 @@ GetDotenv CLI Options type
 | Name | Type | Description |
 | --- | --- | --- |
 | [cliInvocation] | <code>string</code> | cli invocation string (used for cli help) |
+| [debug] | <code>bool</code> | debug mode |
 | [defaultEnv] | <code>string</code> | default target environment |
 | [dotenvToken] | <code>string</code> | token indicating a dotenv file |
 | [dynamicPath] | <code>string</code> | path to file exporting an object keyed to dynamic variable functions |
@@ -208,7 +215,6 @@ GetDotenv CLI Options type
 | [outputPath] | <code>string</code> | if populated, writes consolidated .env file to this path (follows [dotenv-expand rules](https://github.com/motdotla/dotenv-expand/blob/master/tests/.env)) |
 | [paths] | <code>string</code> | space-delimited list of input directory paths |
 | [privateToken] | <code>string</code> | token indicating private variables. |
-| [shell] | <code>bool</code> \| <code>string</code> | execa shell option |
 | [suppressDotenv] | <code>bool</code> | suppress dotenv loading |
 
 <a name="GetDotenvPreHookCallback"></a>

package/bin/getdotenv/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 // lib imports
 import { getCli } from '../../lib/getCli.js';

package/dist/default/lib/getCli.js

@@ -24,6 +24,7 @@ const booleanExpand = value => (0, _boolean.boolean)((0, _dotenvExpand.dotenvExp
  *
  * @typedef {Object} GetDotenvCliOptions
  * @property {string} [cliInvocation] - cli invocation string (used for cli help)
+ * @property {bool} [debug] - debug mode
  * @property {string} [defaultEnv] - default target environment
  * @property {string} [dotenvToken] - token indicating a dotenv file
  * @property {string} [dynamicPath] - path to file exporting an object keyed to dynamic variable functions
@@ -38,7 +39,6 @@ const booleanExpand = value => (0, _boolean.boolean)((0, _dotenvExpand.dotenvExp
  * @property {string} [outputPath] - if populated, writes consolidated .env file to this path (follows {@link https://github.com/motdotla/dotenv-expand/blob/master/tests/.env dotenv-expand rules})
  * @property {string} [paths] - space-delimited list of input directory paths
  * @property {string} [privateToken] - token indicating private variables.
- * @property {bool|string} [shell] - execa shell option
  * @property {bool} [suppressDotenv] - suppress dotenv loading
  */
 
@@ -99,7 +99,6 @@ const getCli = function () {
     paths,
     pathsDelimiter = '\\s+',
     privateToken,
-    shell,
     suppressDotenv,
     vars,
     varsAssignor = '=',
@@ -109,37 +108,49 @@ const getCli = function () {
     ...defaultOptions
   };
   if (Array.isArray(paths)) paths = paths.join(' ');
-  return new _commander.Command().name(cliInvocation)
-  // .usage('[options] [command] [command options] [commad args]')
-  .description('Base CLI. All options except delimiters follow dotenv-expand rules.').enablePositionalOptions().passThroughOptions().option('-e, --env <string>', 'target environment', _dotenvExpand.dotenvExpand, env).option('--default-env <string>', 'default target environment', _dotenvExpand.dotenvExpand, defaultEnv).option('-p, --paths <string>', 'delimited list of paths to dotenv directory', _dotenvExpand.dotenvExpand, paths).option('--paths-delimiter <string>', 'regex paths delimiter', pathsDelimiter).option('-v, --vars <string>', 'delimited list KEY=VALUE pairs', _dotenvExpand.dotenvExpand, vars).option('--vars-delimiter <string>', 'regex vars delimiter', varsDelimiter).option('--vars-assignor <string>', 'regex vars assignment operator', varsAssignor).option('-y, --dynamic-path <string>', 'dynamic variables path', _dotenvExpand.dotenvExpand, dynamicPath).option('-o, --output-path <string>', 'consolidated output file, follows dotenv-expand rules using loaded env vars', _dotenvExpand.dotenvExpand, outputPath).option('-n, --exclude-env [bool]', 'exclude environment-specific variables', booleanExpand, excludeEnv ?? false).option('-g, --exclude-global [bool]', 'exclude global & dynamic variables', booleanExpand, excludeGlobal ?? false).option('-r, --exclude-private [bool]', 'exclude private variables', booleanExpand, excludePrivate ?? false).option('-u, --exclude-public [bool]', 'exclude public variables', booleanExpand, excludePublic ?? false).option('-z, --exclude-dynamic [bool]', 'exclude dynamic variables', booleanExpand, excludeDynamic ?? false).option('-l, --log [bool]', 'console log extracted variables', booleanExpand, log ?? 'false').option('-x, --suppress-dotenv', 'suppress dotenv loading', booleanExpand, suppressDotenv ?? false).option('-c, --command <string>', 'shell command string', _dotenvExpand.dotenvExpand, command).option('-s, --shell <string>', 'execa shell option', _dotenvExpand.dotenvExpand, shell).option('--dotenv-token <string>', 'token indicating a dotenv file', _dotenvExpand.dotenvExpand, dotenvToken).option('--private-token <string>', 'token indicating private variables', _dotenvExpand.dotenvExpand, privateToken).addCommand(new _commander.Command().name('cmd').description('execute shell command string')
-  // .description('execute shell command string (default command)')
-  .configureHelp({
+  return new _commander.Command().name(cliInvocation).description('Base CLI. All options except delimiters follow dotenv-expand rules.').enablePositionalOptions().passThroughOptions().option('-e, --env <string>', 'target environment', _dotenvExpand.dotenvExpand, env).option('--default-env <string>', 'default target environment', _dotenvExpand.dotenvExpand, defaultEnv).option('-p, --paths <string>', 'delimited list of paths to dotenv directory', _dotenvExpand.dotenvExpand, paths).option('--paths-delimiter <string>', 'regex paths delimiter', pathsDelimiter).option('-v, --vars <string>', 'delimited list KEY=VALUE pairs', _dotenvExpand.dotenvExpand, vars).option('--vars-delimiter <string>', 'regex vars delimiter', varsDelimiter).option('--vars-assignor <string>', 'regex vars assignment operator', varsAssignor).option('-y, --dynamic-path <string>', 'dynamic variables path', _dotenvExpand.dotenvExpand, dynamicPath).option('-o, --output-path <string>', 'consolidated output file, follows dotenv-expand rules using loaded env vars', _dotenvExpand.dotenvExpand, outputPath).addOption(new _commander.Option('-n, --exclude-env', `exclude environment-specific variables${excludeEnv ? ' (default)' : ''}`).conflicts('excludeEnvOff')).addOption(new _commander.Option('-N, --exclude-env-off', `exclude environment-specific variables OFF${!excludeEnv ? ' (default)' : ''}`).conflicts('excludeEnv')).addOption(new _commander.Option('-g, --exclude-global', `exclude global variables${excludeGlobal ? ' (default)' : ''}`).conflicts('excludeGlobalOff')).addOption(new _commander.Option('-G, --exclude-global-off', `exclude global variables OFF${!excludeGlobal ? ' (default)' : ''}`).conflicts('excludeGlobal')).addOption(new _commander.Option('-r, --exclude-private', `exclude private variables${excludePrivate ? ' (default)' : ''}`).conflicts('excludePrivateOff')).addOption(new _commander.Option('-R, --exclude-private-off', `exclude private variables OFF${!excludePrivate ? ' (default)' : ''}`).conflicts('excludePrivate')).addOption(new _commander.Option('-u, --exclude-public', `exclude public variables${excludePublic ? ' (default)' : ''}`).conflicts('excludePublicOff')).addOption(new _commander.Option('-U, --exclude-public-off', `exclude public variables OFF${!excludePublic ? ' (default)' : ''}`).conflicts('excludePublic')).addOption(new _commander.Option('-z, --exclude-dynamic', `exclude dynamic variables${excludeDynamic ? ' (default)' : ''}`).conflicts('excludeDynamicOff')).addOption(new _commander.Option('-Z, --exclude-dynamic-off', `exclude dynamic variables OFF${!excludeDynamic ? ' (default)' : ''}`).conflicts('excludeDynamic')).addOption(new _commander.Option('-l, --log', `console log extracted variables${log ? ' (default)' : ''}`).conflicts('logOff')).addOption(new _commander.Option('-L, --log-off', `console log extracted variables OFF${!log ? ' (default)' : ''}`).conflicts('log')).option('-x, --suppress-dotenv', 'suppress dotenv loading', booleanExpand, suppressDotenv ?? false).option('-c, --command <string>', 'shell command string', _dotenvExpand.dotenvExpand, command).option('--dotenv-token <string>', 'token indicating a dotenv file', _dotenvExpand.dotenvExpand, dotenvToken).option('--private-token <string>', 'token indicating private variables', _dotenvExpand.dotenvExpand, privateToken).option('-D, --debug', 'debug mode').addCommand(new _commander.Command().name('cmd').description('execute shell command string (default command)').configureHelp({
     showGlobalOptions: true
   }).enablePositionalOptions().passThroughOptions().action(async (options, _ref) => {
     let {
-      args,
-      parent
+      args
     } = _ref;
-    if (args.length) await (0, _execa.execaCommand)(args.join(' '), {
+    if (args.length) await (0, _execa.execaCommand)(args.join('\\ '), {
       stdio: 'inherit',
-      shell: parent.opts().shell
+      shell: true
     });
-  })
-  // { isDefault: true }
-  ).hook('preSubcommand', async thisCommand => {
+  }), {
+    isDefault: true
+  }).hook('preSubcommand', async thisCommand => {
     var _paths;
     // Inherit options from parent command.
-    let options = {
-      ...(process.env['getdotenvOptions'] ? JSON.parse(process.env['getdotenvOptions']) : {}),
-      ...thisCommand.opts()
+    const getdotenvOptions = process.env['getdotenvOptions'] ? JSON.parse(process.env['getdotenvOptions']) : {};
+    const {
+      excludeDynamicOff,
+      excludeEnvOff,
+      excludeGlobalOff,
+      excludePrivateOff,
+      excludePublicOff,
+      logOff,
+      ...localOptions
+    } = thisCommand.opts();
+    if (excludeDynamicOff) localOptions.excludeDynamic = false;
+    if (excludeEnvOff) localOptions.excludeEnv = false;
+    if (excludeGlobalOff) localOptions.excludeGlobal = false;
+    if (excludePrivateOff) localOptions.excludePrivate = false;
+    if (excludePublicOff) localOptions.excludePublic = false;
+    if (logOff) localOptions.log = false;
+    let mergedOptions = {
+      ...getdotenvOptions,
+      ...localOptions
     };
 
     // Execute pre-hook.
-    if (preHook) options = (await preHook(options)) ?? options;
+    const options = preHook ? (await preHook(mergedOptions)) ?? mergedOptions : mergedOptions;
 
     // Get options.
     let {
       command,
+      debug,
       defaultEnv,
       env,
       paths,
@@ -153,6 +164,13 @@ const getCli = function () {
 
     // Parse vars.
     const vars = varsStr !== null && varsStr !== void 0 && varsStr.length ? (0, _lodash.default)(varsStr.split(new RegExp(varsDelimiter)).map(v => v.split(new RegExp(varsAssignor)))) : undefined;
+    if (debug) {
+      console.log('*** getdotenvOptions ***', getdotenvOptions);
+      console.log('*** localOptions ***', localOptions);
+      console.log('*** mergedOptions ***', mergedOptions);
+      console.log('*** options ***', options);
+      console.log('*** vars ***', vars);
+    }
 
     // Execute getdotenv.
     if ((_paths = paths) !== null && _paths !== void 0 && _paths.length && !suppressDotenv) {
@@ -166,14 +184,15 @@ const getCli = function () {
         vars
       });
     }
+    if (debug) console.log('*** dotenv ***', dotenv);
 
     // Execute post-hook.
     if (postHook) await postHook(options, dotenv);
 
     // Execute shell command.
-    if (command) await (0, _execa.execaCommand)(command, {
+    if (command) await (0, _execa.execaCommand)(command.replace(/ /g, '\\ '), {
       stdio: 'inherit',
-      shell
+      shell: true
     });
   });
 };

package/lib/getCli.js

@@ -1,6 +1,6 @@
 // npm imports
 import { boolean } from 'boolean';
-import { Command } from 'commander';
+import { Command, Option } from 'commander';
 import { execaCommand } from 'execa';
 import fromPairs from 'lodash.frompairs';
 import isString from 'lodash.isstring';
@@ -17,6 +17,7 @@ const booleanExpand = (value) => boolean(dotenvExpand(value));
  *
  * @typedef {Object} GetDotenvCliOptions
  * @property {string} [cliInvocation] - cli invocation string (used for cli help)
+ * @property {bool} [debug] - debug mode
  * @property {string} [defaultEnv] - default target environment
  * @property {string} [dotenvToken] - token indicating a dotenv file
  * @property {string} [dynamicPath] - path to file exporting an object keyed to dynamic variable functions
@@ -31,7 +32,6 @@ const booleanExpand = (value) => boolean(dotenvExpand(value));
  * @property {string} [outputPath] - if populated, writes consolidated .env file to this path (follows {@link https://github.com/motdotla/dotenv-expand/blob/master/tests/.env dotenv-expand rules})
  * @property {string} [paths] - space-delimited list of input directory paths
  * @property {string} [privateToken] - token indicating private variables.
- * @property {bool|string} [shell] - execa shell option
  * @property {bool} [suppressDotenv] - suppress dotenv loading
  */
 
@@ -87,7 +87,6 @@ export const getCli = ({ defaultOptions = {}, preHook, postHook } = {}) => {
     paths,
     pathsDelimiter = '\\s+',
     privateToken,
-    shell,
     suppressDotenv,
     vars,
     varsAssignor = '=',
@@ -99,196 +98,260 @@ export const getCli = ({ defaultOptions = {}, preHook, postHook } = {}) => {
 
   if (Array.isArray(paths)) paths = paths.join(' ');
 
-  return (
-    new Command()
-      .name(cliInvocation)
-      // .usage('[options] [command] [command options] [commad args]')
-      .description(
-        'Base CLI. All options except delimiters follow dotenv-expand rules.'
-      )
-      .enablePositionalOptions()
-      .passThroughOptions()
-      .option('-e, --env <string>', 'target environment', dotenvExpand, env)
-      .option(
-        '--default-env <string>',
-        'default target environment',
-        dotenvExpand,
-        defaultEnv
-      )
-      .option(
-        '-p, --paths <string>',
-        'delimited list of paths to dotenv directory',
-        dotenvExpand,
-        paths
-      )
-      .option(
-        '--paths-delimiter <string>',
-        'regex paths delimiter',
-        pathsDelimiter
-      )
-      .option(
-        '-v, --vars <string>',
-        'delimited list KEY=VALUE pairs',
-        dotenvExpand,
-        vars
-      )
-      .option(
-        '--vars-delimiter <string>',
-        'regex vars delimiter',
-        varsDelimiter
-      )
-      .option(
-        '--vars-assignor <string>',
-        'regex vars assignment operator',
-        varsAssignor
-      )
-      .option(
-        '-y, --dynamic-path <string>',
-        'dynamic variables path',
-        dotenvExpand,
-        dynamicPath
-      )
-      .option(
-        '-o, --output-path <string>',
-        'consolidated output file, follows dotenv-expand rules using loaded env vars',
-        dotenvExpand,
-        outputPath
-      )
-      .option(
-        '-n, --exclude-env [bool]',
-        'exclude environment-specific variables',
-        booleanExpand,
-        excludeEnv ?? false
-      )
-      .option(
-        '-g, --exclude-global [bool]',
-        'exclude global & dynamic variables',
-        booleanExpand,
-        excludeGlobal ?? false
-      )
-      .option(
-        '-r, --exclude-private [bool]',
-        'exclude private variables',
-        booleanExpand,
-        excludePrivate ?? false
-      )
-      .option(
-        '-u, --exclude-public [bool]',
-        'exclude public variables',
-        booleanExpand,
-        excludePublic ?? false
-      )
-      .option(
-        '-z, --exclude-dynamic [bool]',
-        'exclude dynamic variables',
-        booleanExpand,
-        excludeDynamic ?? false
-      )
-      .option(
-        '-l, --log [bool]',
-        'console log extracted variables',
-        booleanExpand,
-        log ?? 'false'
-      )
-      .option(
-        '-x, --suppress-dotenv',
-        'suppress dotenv loading',
-        booleanExpand,
-        suppressDotenv ?? false
-      )
-      .option(
-        '-c, --command <string>',
-        'shell command string',
-        dotenvExpand,
-        command
-      )
-      .option('-s, --shell <string>', 'execa shell option', dotenvExpand, shell)
-      .option(
-        '--dotenv-token <string>',
-        'token indicating a dotenv file',
-        dotenvExpand,
-        dotenvToken
-      )
-      .option(
-        '--private-token <string>',
-        'token indicating private variables',
-        dotenvExpand,
-        privateToken
-      )
-      .addCommand(
-        new Command()
-          .name('cmd')
-          .description('execute shell command string')
-          // .description('execute shell command string (default command)')
-          .configureHelp({ showGlobalOptions: true })
-          .enablePositionalOptions()
-          .passThroughOptions()
-          .action(async (options, { args, parent }) => {
-            if (args.length)
-              await execaCommand(args.join(' '), {
-                stdio: 'inherit',
-                shell: parent.opts().shell,
-              });
-          })
-        // { isDefault: true }
-      )
-      .hook('preSubcommand', async (thisCommand) => {
-        // Inherit options from parent command.
-        let options = {
-          ...(process.env['getdotenvOptions']
-            ? JSON.parse(process.env['getdotenvOptions'])
-            : {}),
-          ...thisCommand.opts(),
-        };
+  return new Command()
+    .name(cliInvocation)
+    .description(
+      'Base CLI. All options except delimiters follow dotenv-expand rules.'
+    )
+    .enablePositionalOptions()
+    .passThroughOptions()
+    .option('-e, --env <string>', 'target environment', dotenvExpand, env)
+    .option(
+      '--default-env <string>',
+      'default target environment',
+      dotenvExpand,
+      defaultEnv
+    )
+    .option(
+      '-p, --paths <string>',
+      'delimited list of paths to dotenv directory',
+      dotenvExpand,
+      paths
+    )
+    .option(
+      '--paths-delimiter <string>',
+      'regex paths delimiter',
+      pathsDelimiter
+    )
+    .option(
+      '-v, --vars <string>',
+      'delimited list KEY=VALUE pairs',
+      dotenvExpand,
+      vars
+    )
+    .option('--vars-delimiter <string>', 'regex vars delimiter', varsDelimiter)
+    .option(
+      '--vars-assignor <string>',
+      'regex vars assignment operator',
+      varsAssignor
+    )
+    .option(
+      '-y, --dynamic-path <string>',
+      'dynamic variables path',
+      dotenvExpand,
+      dynamicPath
+    )
+    .option(
+      '-o, --output-path <string>',
+      'consolidated output file, follows dotenv-expand rules using loaded env vars',
+      dotenvExpand,
+      outputPath
+    )
+    .addOption(
+      new Option(
+        '-n, --exclude-env',
+        `exclude environment-specific variables${
+          excludeEnv ? ' (default)' : ''
+        }`
+      ).conflicts('excludeEnvOff')
+    )
+    .addOption(
+      new Option(
+        '-N, --exclude-env-off',
+        `exclude environment-specific variables OFF${
+          !excludeEnv ? ' (default)' : ''
+        }`
+      ).conflicts('excludeEnv')
+    )
+    .addOption(
+      new Option(
+        '-g, --exclude-global',
+        `exclude global variables${excludeGlobal ? ' (default)' : ''}`
+      ).conflicts('excludeGlobalOff')
+    )
+    .addOption(
+      new Option(
+        '-G, --exclude-global-off',
+        `exclude global variables OFF${!excludeGlobal ? ' (default)' : ''}`
+      ).conflicts('excludeGlobal')
+    )
+    .addOption(
+      new Option(
+        '-r, --exclude-private',
+        `exclude private variables${excludePrivate ? ' (default)' : ''}`
+      ).conflicts('excludePrivateOff')
+    )
+    .addOption(
+      new Option(
+        '-R, --exclude-private-off',
+        `exclude private variables OFF${!excludePrivate ? ' (default)' : ''}`
+      ).conflicts('excludePrivate')
+    )
+    .addOption(
+      new Option(
+        '-u, --exclude-public',
+        `exclude public variables${excludePublic ? ' (default)' : ''}`
+      ).conflicts('excludePublicOff')
+    )
+    .addOption(
+      new Option(
+        '-U, --exclude-public-off',
+        `exclude public variables OFF${!excludePublic ? ' (default)' : ''}`
+      ).conflicts('excludePublic')
+    )
+    .addOption(
+      new Option(
+        '-z, --exclude-dynamic',
+        `exclude dynamic variables${excludeDynamic ? ' (default)' : ''}`
+      ).conflicts('excludeDynamicOff')
+    )
+    .addOption(
+      new Option(
+        '-Z, --exclude-dynamic-off',
+        `exclude dynamic variables OFF${!excludeDynamic ? ' (default)' : ''}`
+      ).conflicts('excludeDynamic')
+    )
+    .addOption(
+      new Option(
+        '-l, --log',
+        `console log extracted variables${log ? ' (default)' : ''}`
+      ).conflicts('logOff')
+    )
+    .addOption(
+      new Option(
+        '-L, --log-off',
+        `console log extracted variables OFF${!log ? ' (default)' : ''}`
+      ).conflicts('log')
+    )
+    .option(
+      '-x, --suppress-dotenv',
+      'suppress dotenv loading',
+      booleanExpand,
+      suppressDotenv ?? false
+    )
+    .option(
+      '-c, --command <string>',
+      'shell command string',
+      dotenvExpand,
+      command
+    )
+    .option(
+      '--dotenv-token <string>',
+      'token indicating a dotenv file',
+      dotenvExpand,
+      dotenvToken
+    )
+    .option(
+      '--private-token <string>',
+      'token indicating private variables',
+      dotenvExpand,
+      privateToken
+    )
+    .option('-D, --debug', 'debug mode')
+    .addCommand(
+      new Command()
+        .name('cmd')
+        .description('execute shell command string (default command)')
+        .configureHelp({ showGlobalOptions: true })
+        .enablePositionalOptions()
+        .passThroughOptions()
+        .action(async (options, { args }) => {
+          if (args.length)
+            await execaCommand(args.join('\\ '), {
+              stdio: 'inherit',
+              shell: true,
+            });
+        }),
+      { isDefault: true }
+    )
+    .hook('preSubcommand', async (thisCommand) => {
+      // Inherit options from parent command.
+      const getdotenvOptions = process.env['getdotenvOptions']
+        ? JSON.parse(process.env['getdotenvOptions'])
+        : {};
 
-        // Execute pre-hook.
-        if (preHook) options = (await preHook(options)) ?? options;
+      const {
+        excludeDynamicOff,
+        excludeEnvOff,
+        excludeGlobalOff,
+        excludePrivateOff,
+        excludePublicOff,
+        logOff,
+        ...localOptions
+      } = thisCommand.opts();
 
-        // Get options.
-        let {
-          command,
-          defaultEnv,
-          env,
-          paths,
-          pathsDelimiter,
-          suppressDotenv,
-          vars: varsStr,
-          varsDelimiter,
-          varsAssignor,
-          ...rest
-        } = options;
+      if (excludeDynamicOff) localOptions.excludeDynamic = false;
+      if (excludeEnvOff) localOptions.excludeEnv = false;
+      if (excludeGlobalOff) localOptions.excludeGlobal = false;
+      if (excludePrivateOff) localOptions.excludePrivate = false;
+      if (excludePublicOff) localOptions.excludePublic = false;
+      if (logOff) localOptions.log = false;
+
+      let mergedOptions = {
+        ...getdotenvOptions,
+        ...localOptions,
+      };
+
+      // Execute pre-hook.
+      const options = preHook
+        ? (await preHook(mergedOptions)) ?? mergedOptions
+        : mergedOptions;
+
+      // Get options.
+      let {
+        command,
+        debug,
+        defaultEnv,
+        env,
+        paths,
+        pathsDelimiter,
+        suppressDotenv,
+        vars: varsStr,
+        varsDelimiter,
+        varsAssignor,
+        ...rest
+      } = options;
 
-        // Parse vars.
-        const vars = varsStr?.length
-          ? fromPairs(
-              varsStr
-                .split(new RegExp(varsDelimiter))
-                .map((v) => v.split(new RegExp(varsAssignor)))
-            )
-          : undefined;
+      // Parse vars.
+      const vars = varsStr?.length
+        ? fromPairs(
+            varsStr
+              .split(new RegExp(varsDelimiter))
+              .map((v) => v.split(new RegExp(varsAssignor)))
+          )
+        : undefined;
 
-        // Execute getdotenv.
-        if (paths?.length && !suppressDotenv) {
-          if (isString(paths)) paths = paths?.split(new RegExp(pathsDelimiter));
+      if (debug) {
+        console.log('*** getdotenvOptions ***', getdotenvOptions);
+        console.log('*** localOptions ***', localOptions);
+        console.log('*** mergedOptions ***', mergedOptions);
+        console.log('*** options ***', options);
+        console.log('*** vars ***', vars);
+      }
+
+      // Execute getdotenv.
+      if (paths?.length && !suppressDotenv) {
+        if (isString(paths)) paths = paths?.split(new RegExp(pathsDelimiter));
+
+        var dotenv = await getDotenv({
+          ...rest,
+          env: env ?? defaultEnv,
+          loadProcess: true,
+          paths,
+          vars,
+        });
+      }
 
-          var dotenv = await getDotenv({
-            ...rest,
-            env: env ?? defaultEnv,
-            loadProcess: true,
-            paths,
-            vars,
-          });
-        }
+      if (debug) console.log('*** dotenv ***', dotenv);
 
-        // Execute post-hook.
-        if (postHook) await postHook(options, dotenv);
+      // Execute post-hook.
+      if (postHook) await postHook(options, dotenv);
 
-        // Execute shell command.
-        if (command)
-          await execaCommand(command, {
-            stdio: 'inherit',
-            shell,
-          });
-      })
-  );
+      // Execute shell command.
+      if (command)
+        await execaCommand(command.replace(/ /g, '\\ '), {
+          stdio: 'inherit',
+          shell: true,
+        });
+    });
 };

package/package.json

@@ -3,7 +3,7 @@
   "bin": {
     "getdotenv": "bin/getdotenv/index.js"
   },
-  "version": "3.0.4",
+  "version": "3.0.6",
   "publishConfig": {
     "access": "public"
   },