Rush StackShopBlogEvents
Skip to main content

Home > @rushstack/ts-command-line > IBaseCommandLineDefinition

IBaseCommandLineDefinition interface

For use with CommandLineParser, this interface represents a generic command-line parameter

Signature:

export interface IBaseCommandLineDefinition 

Properties

Property

Modifiers

Type

Description

allowNonStandardEnvironmentVariableNames?

boolean

(Optional) Allows for the use of environment variable names that do not conform to the standard described by the Shell and Utilities volume of IEEE Std 1003.1-2001. This disables the validation that is performed on the provided IBaseCommandLineDefinition.environmentVariable value by default.

description

string

Documentation for the parameter that will be shown when invoking the tool with "--help"

environmentVariable?

string

(Optional) The name of an environment variable that the parameter value will be read from, if it was omitted from the command-line. An error will be reported if the environment value cannot be parsed.

parameterGroup?

string | typeof SCOPING_PARAMETER_GROUP

(Optional) An optional parameter group name, shown when invoking the tool with "--help"

parameterLongName

string

The long name of the flag including double dashes, e.g. "--do-something"

parameterScope?

string

(Optional) An optional parameter scope name, used to add a scope-prefixed parameter synonym, e.g. "--scope:do-something". Scopes provide additional flexibility for parameters in conflict resolution since when a scope is specified, parameters that have conflicting long names will be defined using only the scope-prefixed name.

parameterShortName?

string

(Optional) An optional short name for the flag including the dash, e.g. "-d"

required?

boolean

(Optional) If true, then an error occurs if the parameter was not included on the command-line.

undocumentedSynonyms?

string[]

(Optional) Specifies additional names for this parameter that are accepted but not displayed in the command line help.