Class Jack<C>

Class returned by the jack function and all configuration definition methods. This is what gets chained together.

Type Parameters

C extends ConfigSet = {}

Index

Constructors

constructor

new Jack<C>(options?): Jack<C>
Type Parameters
- C extends ConfigSet = {}
Parameters
- options: JackOptions = {}
Returns Jack<C>
- Defined in src/index.ts:579

Accessors

definitions

get definitions(): C
Resulting definitions, suitable to be passed to Node's util.parseArgs, but also including description and short fields, if set.

Returns C
- Defined in src/index.ts:596

jackOptions

get jackOptions(): JackOptions
options passed to the Jack constructor

Returns JackOptions
- Defined in src/index.ts:608

shorts

get shorts(): Record<string, string>
map of { <short>: <long> } strings for each short name defined

Returns Record<string, string>
- Defined in src/index.ts:601

usageFields

get usageFields(): UsageField[]
the data used to generate Jack#usage and Jack#usageMarkdown content.

Returns UsageField[]
- Defined in src/index.ts:616

Methods

[custom]

[custom](_, options): string
Custom printer for util.inspect
Parameters
- _: number
- options: InspectOptions
Returns string
- Defined in src/index.ts:1326

addFields

addFields<F>(fields): Jack<C & F>
Generic field definition method. Similar to flag/flagList/number/etc, but you must specify the type (and optionally multiple and delim) fields on each one, or Jack won't know how to define them.
Type Parameters
- F extends ConfigSet
Parameters
- fields: F
Returns Jack<C & F>
- Defined in src/index.ts:996

applyDefaults

applyDefaults(p): void
Parameters
- p: Parsed<C>
Returns void
- Defined in src/index.ts:686

description

description(text, __namedParameters?): Jack<C>
Add a long-form description to the usage output at this position.
Parameters
- text: string
- __namedParameters: {
  pre?: boolean;
  } = {}
  - Optionalpre?: boolean
Returns Jack<C>
- Defined in src/index.ts:932

flag

flag<F>(fields): Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"boolean", false, undefined>
}>
Add one or more flag fields.
Type Parameters
- F extends ConfigMetaSet<"boolean", false>
Parameters
- fields: F
Returns Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"boolean", false, undefined>
}>
- Defined in src/index.ts:976

flagList

flagList<F>(fields): Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"boolean", true, undefined>
}>
Add one or more multiple flag fields.
Type Parameters
- F extends ConfigMetaSet<"boolean", true>
Parameters
- fields: F
Returns Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"boolean", true, undefined>
}>
- Defined in src/index.ts:985

heading

heading(text, level?, __namedParameters?): Jack<C>
Add a heading to the usage output banner
Parameters
- text: string
- Optionallevel:
      | 2
      | 1
      | 3
      | 4
      | 5
      | 6
- __namedParameters: {
  pre?: boolean;
  } = {}
  - Optionalpre?: boolean
Returns Jack<C>
- Defined in src/index.ts:917

loadEnvDefaults

loadEnvDefaults(): void
Returns void
- Defined in src/index.ts:674

num

num<F>(fields): Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"number", false, undefined | readonly number[]>
}>
Add one or more number fields.
Type Parameters
- F extends ConfigMetaSet<"number", false>
Parameters
- fields: F
Returns Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"number", false, undefined | readonly number[]>
}>
- Defined in src/index.ts:940

numList

numList<F>(fields): Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"number", true, undefined | readonly number[]>
}>
Add one or more multiple number fields.
Type Parameters
- F extends ConfigMetaSet<"number", true>
Parameters
- fields: F
Returns Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"number", true, undefined | readonly number[]>
}>
- Defined in src/index.ts:949

opt

opt<F>(fields): Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"string", false, undefined | readonly string[]>
}>
Add one or more string option fields.
Type Parameters
- F extends ConfigMetaSet<"string", false>
Parameters
- fields: F
Returns Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"string", false, undefined | readonly string[]>
}>
- Defined in src/index.ts:958

optList

optList<F>(fields): Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"string", true, undefined | readonly string[]>
}>
Add one or more multiple string option fields.
Type Parameters
- F extends ConfigMetaSet<"string", true>
Parameters
- fields: F
Returns Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"string", true, undefined | readonly string[]>
}>
- Defined in src/index.ts:967

parse

parse(args?): Parsed<C>
Parse a string of arguments, and return the resulting { values, positionals } object.

If an JackOptions#envPrefix is set, then it will read default values from the environment, and write the resulting values back to the environment as well.

Environment values always take precedence over any other value, except an explicit CLI setting.
Parameters
- args: string[] = process.argv
Returns Parsed<C>
- Defined in src/index.ts:666

parseRaw

parseRaw(args): Parsed<C>
Only parse the command line arguments passed in. Does not strip off the node script.js bits, so it must be just the arguments you wish to have parsed. Does not read from or write to the environment, or set defaults.
Parameters
- args: string[]
Returns Parsed<C>
- Defined in src/index.ts:701

setConfigValues

setConfigValues(values, source?): Jack<C>
Set the default value (which will still be overridden by env or cli) as if from a parsed config file. The optional source param, if provided, will be included in error messages if a value is invalid or unknown.
Parameters
- values: Partial<OptionsResults<C>>
- source: string = ''
Returns Jack<C>
- Defined in src/index.ts:626

toJSON

toJSON(): {
[k: string]: T;
}
Return the configuration options as a plain object

Returns {
[k: string]: T;
}
- [k: string]: T
- Defined in src/index.ts:1302

usage

usage(): string
Return the usage banner for the given configuration

Returns string
- Defined in src/index.ts:1071

usageMarkdown

usageMarkdown(): string
Return the usage banner markdown for the given configuration

Returns string
- Defined in src/index.ts:1171

validate

validate(o): asserts o is OptionsResults<C>
Validate that any arbitrary object is a valid configuration values object. Useful when loading config files or other sources.
Parameters
- o: unknown
Returns asserts o is OptionsResults<C>
- Defined in src/index.ts:858

writeEnv

writeEnv(p): void
Parameters
- p: Parsed<C>
Returns void
- Defined in src/index.ts:903

Class Jack<C>

Type Parameters

Index

Constructors

Accessors

Methods

Constructors

constructor

Type Parameters

Parameters

Returns Jack<C>

Accessors

definitions

Returns C

jackOptions

Returns JackOptions

shorts

Returns Record<string, string>

usageFields

Returns UsageField[]

Methods

[custom]

Parameters

Returns string

addFields

Type Parameters

Parameters

Returns Jack<C & F>

applyDefaults

Parameters

Returns void

description

Parameters

Optionalpre?: boolean

Returns Jack<C>

flag

Type Parameters

Parameters

Returns Jack<C & F & { [longOption in string | number | symbol]: ConfigOption<"boolean", false, undefined>}>

flagList

Type Parameters

Parameters

Returns Jack<C & F & { [longOption in string | number | symbol]: ConfigOption<"boolean", true, undefined>}>

heading

Parameters

Optionalpre?: boolean

Returns Jack<C>

loadEnvDefaults

Returns void

num

Type Parameters

Parameters

Returns Jack<C & F & { [longOption in string | number | symbol]: ConfigOption<"number", false, undefined | readonly number[]>}>

numList

Type Parameters

Parameters

Returns Jack<C & F & { [longOption in string | number | symbol]: ConfigOption<"number", true, undefined | readonly number[]>}>

opt

Type Parameters

Parameters

Returns Jack<C & F & { [longOption in string | number | symbol]: ConfigOption<"string", false, undefined | readonly string[]>}>

optList

Type Parameters

Parameters

Returns Jack<C & F & { [longOption in string | number | symbol]: ConfigOption<"string", true, undefined | readonly string[]>}>

parse

Parameters

Returns Parsed<C>

parseRaw

Parameters

Returns Parsed<C>

setConfigValues

Parameters

Returns Jack<C>

toJSON

Returns { [k: string]: T; }

[k: string]: T

usage

Returns string

usageMarkdown

`Optional`pre?: boolean

Returns Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"boolean", false, undefined>
}>

Returns Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"boolean", true, undefined>
}>

`Optional`pre?: boolean

Returns Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"number", false, undefined | readonly number[]>
}>

Returns Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"number", true, undefined | readonly number[]>
}>

Returns Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"string", false, undefined | readonly string[]>
}>

Returns Jack<C & F & {
[longOption in string | number | symbol]: ConfigOption<"string", true, undefined | readonly string[]>
}>

Returns {
[k: string]: T;
}