default

gunshi cli entry point.

This entry point exports the bellow APIs and types:

• cli: The main CLI function to run the command, included global options and usage renderer built-in plugins.
• define: A function to define a command.
• defineWithTypes: A function to define a command with specific type parameters.
• lazy: A function to lazily load a command.
• lazyWithTypes: A function to lazily load a command with specific type parameters.
• plugin: A function to create a plugin.
• createCommandContext: A function to create a command context, mainly for testing purposes.
• args-tokens utilities, parseArgs and resolveArgs for parsing command line arguments.
• Some basic type definitions, such as CommandContext, Plugin, PluginContext, etc.

Example

import { cli } from 'gunshi'

Variables

Variable	Description
ANONYMOUS_COMMAND_NAME

Functions

Function	Description
cli	Run the command.
parseArgs	Parse command line arguments.
plugin	Define a plugin with extension compatibility and typed dependency extensions
resolveArgs	Resolve command line arguments.

Classes

Class	Description
DefaultTranslation	Default implementation of TranslationAdapter.

Interfaces

Interface	Description
Args	An object that contains argument schema.
ArgSchema	An argument schema definition for command-line argument parsing.
ArgToken	Argument token.
CliOptions	CLI options of cli function.
Command	Command interface.
CommandContext	Command context.
CommandContextExtension	Command context extension
CommandEnvironment	Command environment.
GunshiParams	Gunshi unified parameter type.
PluginContext	Gunshi plugin context interface.
PluginDependency	Plugin dependency definition
PluginOptions	Plugin definition options
PluginWithExtension	Plugin return type with extension, which includes the plugin ID, name, dependencies, and extension.
PluginWithoutExtension	Plugin return type without extension, which includes the plugin ID, name, and dependencies, but no extension.
RenderingOptions	Rendering control options
SubCommandable	Sub-command entry type for use in subCommands.

References

CommandContextParams

Re-exports CommandContextParams

---

createCommandContext

Re-exports createCommandContext

---

define

Re-exports define

---

defineWithTypes

Re-exports defineWithTypes

---

lazy

Re-exports lazy

---

lazyWithTypes

Re-exports lazyWithTypes

Type Aliases

Type Alias	Description
ArgValues	An object that contains the values of the arguments.
Awaitable	Awaitable type.
Commandable	Define a command type.
CommandCallMode	Command call mode.
CommandContextCore	Readonly command context available to a command context extension factory.
CommandDecorator	Command decorator.
CommandExamplesFetcher	Command examples fetcher.
CommandLoader	Command loader.
CommandRunner	Command runner.
DefaultGunshiParams	Default Gunshi parameters.
ExtendContext	Extend command context type. This type is used to extend the command context with additional properties at CommandContext.extensions.
GunshiParamsConstraint	Generic constraint for command-related types.
LazyCommand	Lazy command interface.
OnPluginExtension	Plugin extension callback, which is called when the plugin is extended with extension option.
Plugin	Gunshi plugin, which is a function that receives a PluginContext.
PluginExtension	Plugin extension
PluginFunction	Plugin function type
Prettify	Prettify a type by flattening its structure.
RendererDecorator	Renderer decorator type.
ValidationErrorsDecorator	Validation errors renderer decorator type. A function that wraps a validation errors renderer to add or modify its behavior.