gunshi / default / cli

Function: cli()

Run the command.

Param

Command line arguments

Param

A entry command, an inline command runner, or a lazily-loaded command

Param

A CLI options

Call Signature

function cli<A, G>(
   args, 
   entry, 
options?): Promise<undefined | string>;

Run the command.

Type Parameters

Type Parameter	Default type
A extends Args	Args
G extends GunshiParams<{ args: Args; extensions: { }; }>	object

Parameters

Parameter	Type	Description
args	string[]	Command line arguments
entry	| Command<G> | CommandRunner<G> | LazyCommand<G>	A entry command, an inline command runner, or a lazily-loaded command
options?	CliOptions<G>	A CLI options

Returns

Promise<undefined | string>

A rendered usage or undefined. if you will use CliOptions.usageSilent option, it will return rendered usage string.

Call Signature

function cli<E, G>(
   args, 
   entry, 
options?): Promise<undefined | string>;

Run the command.

Type Parameters

Type Parameter	Default type
E extends ExtendContext	ExtendContext
G extends GunshiParams<{ args: Args; extensions: { }; }>	object

Parameters

Parameter	Type	Description
args	string[]	Command line arguments
entry	| Command<G> | CommandRunner<G> | LazyCommand<G>	A entry command, an inline command runner, or a lazily-loaded command
options?	CliOptions<G>	A CLI options

Returns

Promise<undefined | string>

A rendered usage or undefined. if you will use CliOptions.usageSilent option, it will return rendered usage string.

Call Signature

function cli<G>(
   args, 
   entry, 
options?): Promise<undefined | string>;

Run the command.

Type Parameters

Type Parameter	Default type
G extends GunshiParams<{ args: Args; extensions: { }; }>	DefaultGunshiParams

Parameters

Parameter	Type	Description
args	string[]	Command line arguments
entry	| Command<G> | CommandRunner<G> | LazyCommand<G>	A entry command, an inline command runner, or a lazily-loaded command
options?	CliOptions<G>	A CLI options

Returns

Promise<undefined | string>

A rendered usage or undefined. if you will use CliOptions.usageSilent option, it will return rendered usage string.