Commander.js display help when called with no commands
Asked Answered
G

3

12

I'm using commander.js to write a simple node.js program that interacts with an API. All calls require the use of subcommands. For example:

apicommand get

Is called as follows:

program
  .version('1.0.0')
  .command('get [accountId]')
  .description('retrieves account info for the specified account')
  .option('-v, --verbose', 'display extended logging information')
  .action(getAccount);

What I want to do now is display a default message when apicommand is called without any subcommands. Just like when you call git without a subcommand:

MacBook-Air:Desktop username$ git
usage: git [--version] [--help] [-C <path>] [-c name=value]
       [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]
       [-p | --paginate | --no-pager] [--no-replace-objects] [--bare]
       [--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>]
       <command> [<args>]

These are common Git commands used in various situations:

start a working area (see also: git help tutorial)
   clone      Clone a repository into a new directory
   init       Create an empty Git repository or reinitialize an existing one
...
Geoff answered 2/6, 2017 at 20:5 Comment(1)
Check process.argv, it's an array that contains the parameters.Jemy
M
16

You can do something like this by checking what arguments were received and if nothing other than node and <app>.js then display the help text.

program
  .version('1.0.0')
  .command('get [accountId]')
  .description('retrieves account info for the specified account')
  .option('-v, --verbose', 'display extended logging information')
  .action(getAccount)
  .parse(process.argv)

if (process.argv.length < 3) {
  program.help()
}
Materials answered 7/6, 2017 at 17:44 Comment(0)
G
2

What I want to do now is display a default message when apicommand is called without any subcommands. Just like when you call git without a subcommand

The help is automatically displayed from Commander 5 onwards if you call without a subcommand.

(Disclosure: I am a maintainer of Commander.)

Gaberones answered 23/12, 2021 at 6:29 Comment(1)
How de we disable that automatic Help?Aiken
M
1

When you're trying to pass a command, it stores the commands in process.argv array.

You can add a conditon like at the end of your code like -:

if(process.argv.length  <= 2)
console.log(program.help());
else 
program.parse();
Merideth answered 23/12, 2021 at 6:2 Comment(0)

© 2022 - 2024 — McMap. All rights reserved.