82
yargs.version();
83
return yargs;
85
>
}
86
>
87
>
// Used to expose private methods to other module-level classes,
88
>
// such as the command parser and usage printer.
89
>
const kCopyDoubleDash = Symbol('copyDoubleDash');
90
>
const kCreateLogger = Symbol('copyDoubleDash');
91
>
const kDeleteFromParserHintObject = Symbol('deleteFromParserHintObject');
92
>
const kEmitWarning = Symbol('emitWarning');
93
>
const kFreeze = Symbol('freeze');
94
>
const kGetDollarZero = Symbol('getDollarZero');
95
>
const kGetParserConfiguration = Symbol('getParserConfiguration');
96
>
const kGetUsageConfiguration = Symbol('getUsageConfiguration');
97
>
const kGuessLocale = Symbol('guessLocale');
98
>
const kGuessVersion = Symbol('guessVersion');
99
>
const kParsePositionalNumbers = Symbol('parsePositionalNumbers');
100
>
const kPkgUp = Symbol('pkgUp');
101
>
const kPopulateParserHintArray = Symbol('populateParserHintArray');
102
>
const kPopulateParserHintSingleValueDictionary = Symbol(
103
>
'populateParserHintSingleValueDictionary'
104
>
);
105
>
const kPopulateParserHintArrayDictionary = Symbol(
106
>
'populateParserHintArrayDictionary'
107
>
);
108
>
const kPopulateParserHintDictionary = Symbol('populateParserHintDictionary');
109
>
const kSanitizeKey = Symbol('sanitizeKey');
110
>
const kSetKey = Symbol('setKey');
111
>
const kUnfreeze = Symbol('unfreeze');
112
>
const kValidateAsync = Symbol('validateAsync');
113
>
const kGetCommandInstance = Symbol('getCommandInstance');
114
>
const kGetContext = Symbol('getContext');
115
>
const kGetHasOutput = Symbol('getHasOutput');
116
>
const kGetLoggerInstance = Symbol('getLoggerInstance');
117
>
const kGetParseContext = Symbol('getParseContext');
118
>
const kGetUsageInstance = Symbol('getUsageInstance');
119
>
const kGetValidationInstance = Symbol('getValidationInstance');
120
>
const kHasParseCallback = Symbol('hasParseCallback');
121
>
const kIsGlobalContext = Symbol('isGlobalContext');
122
>
const kPostProcess = Symbol('postProcess');
123
>
const kRebase = Symbol('rebase');
124
>
const kReset = Symbol('reset');
125
>
const kRunYargsParserAndExecuteCommands = Symbol(
126
>
'runYargsParserAndExecuteCommands'
127
>
);
128
>
const kRunValidation = Symbol('runValidation');
129
>
const kSetHasOutput = Symbol('setHasOutput');
130
>
const kTrackManuallySetKeys = Symbol('kTrackManuallySetKeys');
131
>
const DEFAULT_LOCALE = 'en_US';
132
>
133
>
export interface YargsInternalMethods {
134
>
getCommandInstance(): CommandInstance;
135
>
getContext(): Context;
136
>
getHasOutput(): boolean;
137
>
getLoggerInstance(): LoggerInstance;
138
>
getParseContext(): object;
139
>
getParserConfiguration(): Configuration;
140
>
getUsageConfiguration(): UsageConfiguration;
141
>
getUsageInstance(): UsageInstance;
142
>
getValidationInstance(): ValidationInstance;
143
>
hasParseCallback(): boolean;
144
>
isGlobalContext(): boolean;
145
>
postProcess<T extends Arguments | Promise<Arguments>>(
146
>
argv: Arguments | Promise<Arguments>,
147
>
populateDoubleDash: boolean,
148
>
calledFromCommand: boolean,
149
>
runGlobalMiddleware: boolean
150
>
): any;
151
>
reset(aliases?: Aliases): YargsInstance;
152
>
runValidation(
153
>
aliases: Dictionary<string[]>,
154
>
positionalMap: Dictionary<string[]>,
155
>
parseErrors: Error | null,
156
>
isDefaultCommand?: boolean
157
>
): (argv: Arguments) => void;
158
>
runYargsParserAndExecuteCommands(
159
>
args: string | string[] | null,
160
>
shortCircuit?: boolean | null,
161
>
calledFromCommand?: boolean,
162
>
commandIndex?: number,
163
>
helpOnly?: boolean
164
>
): Arguments | Promise<Arguments>;
165
>
setHasOutput(): void;
166
>
}
167
>
168
>
export class YargsInstance {
169
>
$0: string;
170
>
argv?: Arguments;
171
>
customScriptName = false;
172
>
parsed: DetailedArguments | false = false;
173
>
174
>
#command: CommandInstance;
175
>
#cwd: string;
176
>
// use context object to keep track of resets, subcommand execution, etc.,
177
>
// submodules should modify and check the state of context as necessary:
178
>
#context: Context = {commands: [], fullCommands: []};
179
>
#completion: CompletionInstance | null = null;
180
>
#completionCommand: string | null = null;
181
>
#defaultShowHiddenOpt = 'show-hidden';
182
>
#exitError: YError | string | nil = null;
183
>
#detectLocale = true;
184
>
#emittedWarnings: Dictionary<boolean> = {};
185
>
#exitProcess = true;
186
>
#frozens: FrozenYargsInstance[] = [];
187
>
#globalMiddleware: GlobalMiddleware;
188
>
#groups: Dictionary<string[]> = {};
189
>
#hasOutput = false;
190
>
#helpOpt: string | null = null;
191
>
#isGlobalContext = true;
192
>
#logger: LoggerInstance;
193
>
#output = '';
194
>
#options: Options;
195
>
#parentRequire?: RequireType;
196
>
#parserConfig: Configuration = {};
197
>
#parseFn: ParseCallback | null = null;
198
>
#parseContext: object | null = null;
199
>
#pkgs: Dictionary<{[key: string]: string | {[key: string]: string}}> = {};
200
>
#preservedGroups: Dictionary<string[]> = {};
201
>
#processArgs: string | string[];
202
>
#recommendCommands = false;
203
>
#shim: PlatformShim;
204
>
#strict = false;
205
>
#strictCommands = false;
206
>
#strictOptions = false;
207
>
#usage: UsageInstance;
208
>
#usageConfig: UsageConfiguration = {};
209
>
#versionOpt: string | null = null;
210
>
#validation: ValidationInstance;
211
>
212
>
constructor(
213
processArgs: string | string[] = [],
214
cwd: string,