v3.0.2

Fixed

• Improve tracking of executable subcommands.

Changed

• update development dependencies

Credits:

• issue identified by Checkmarx Application Security Research Team

v3.0.1

Added

• .name and .usage to README (#1010)
• Table of Contents to README (#1010)
• TypeScript definition for executableFile in CommandOptions (#1028)

Changed

• consistently use const rather than var in README (#1026)

Fixed

• help for sub commands with custom executableFile (#1018)

v3.0.0

• Add option to specify executable file name (#999)
  • e.g. .command('clone', 'clone description', { executableFile: 'myClone' })
• Change docs for .command to contrast action handler vs git-style executable. (#938 #990)
• Breaking Change TypeScript to use overloaded function for .command. (#938 #990)
• Change to use straight quotes around strings in error messages (like 'this' instead of `this') (#915)
• Add TypeScript "reference types" for node (#974)
• Add support for hyphen as an option argument in subcommands (#697)
• Add support for a short option flag and its value to be concatenated for action handler subcommands (#599)
  • e.g. -p 80 can also be supplied as -p80
• Add executable arguments to spawn in win32, for git-style executables (#611)
  • e.g. node --harmony myCommand.js clone
• Add parent command as prefix of subcommand in help (#980)
• Add optional custom description to .version (#963)
  • e.g. program.version('0.0.1', '-v, --vers', 'output the current version')
• Add .helpOption(flags, description) routine to customise help flags and description (#963)
  • e.g. .helpOption('-e, --HELP', 'read more information')
• Fix behavior of --no-* options (#795)
  • can now define both --foo and --no-foo
  • Breaking custom event listeners: --no-foo on cli now emits option:no-foo (previously option:foo)
  • Breaking default value: defining --no-foo after defining --foo leaves the default value unchanged (previously set it to false)
  • allow boolean default value, such as from environment (#987)
• Increment inspector port for spawned subcommands (#991)
  • e.g. node --inspect myCommand.js clone

Migration Tips

The custom event for a negated option like --no-foo is option:no-foo (previously option:foo).

program
  .option('--no-foo')
  .on('option:no-foo', () => {
    console.log('removing foo');
  });

When using TypeScript, adding a command does not allow an explicit undefined for an unwanted executable description (e.g. for a command with an action handler).

program
  .command('action1', undefined, { noHelp: true }) // No longer valid
  .command('action2', { noHelp: true }) // Correct

v3.0.0-0 Prerelease

(Released as 3.0.0)

v2.20.0

• fix: resolve symbolic links completely when hunting for subcommands (#935)
• Update index.d.ts (#930)
• Update Readme.md (#924)
• Remove --save option as it isn't required anymore (#918)
• Add link to the license file (#900)
• Added example of receiving args from options (#858)
• Added missing semicolon (#882)
• Add extension to .eslintrc (#876)

v2.19.0

• Removed newline after Options and Commands headers (#864)
• Bugfix - Error output (#862)
• Fix to change default value to string (#856)

v2.18.0

• Standardize help output (#853)
• chmod 644 travis.yml (#851)
• add support for execute typescript subcommand via ts-node (#849)

v2.17.1

• Fix bug in command emit (#844)

v2.17.0

• fixed newline output after help information (#833)
• Fix to emit the action even without command (#778)
• npm update (#823)

v2.16.0

• Remove Makefile and test/run (#821)
• Make 'npm test' run on Windows (#820)
• Add badge to display install size (#807)
• chore: cache node_modules (#814)
• chore: remove Node.js 4 (EOL), add Node.js 10 (#813)
• fixed typo in readme (#812)
• Fix types (#804)
• Update eslint to resolve vulnerabilities in lodash (#799)
• updated readme with custom event listeners. (#791)
• fix tests (#794)