Repository navigation
Expand file tree
/
Copy pathcliArgs.ts
More file actions
60 lines (59 loc) · 2.02 KB
/
Copy pathcliArgs.ts
File metadata and controls
60 lines (59 loc) · 2.02 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
/**
* Parse a CLI flag value early, before Commander.js processes arguments.
* Supports both space-separated (--flag value) and equals-separated (--flag=value) syntax.
*
* This function is intended for flags that must be parsed before init() runs,
* such as --settings which affects configuration loading. For normal flag parsing,
* rely on Commander.js which handles this automatically.
*
* @param flagName The flag name including dashes (e.g., '--settings')
* @param argv Optional argv array to parse (defaults to process.argv)
* @returns The value if found, undefined otherwise
*/
export function eagerParseCliFlag(
flagName: string,
argv: string[] = process.argv,
): string | undefined {
for (let i = 0; i < argv.length; i++) {
const arg = argv[i]
// Handle --flag=value syntax
if (arg?.startsWith(`${flagName}=`)) {
return arg.slice(flagName.length + 1)
}
// Handle --flag value syntax
if (arg === flagName && i + 1 < argv.length) {
return argv[i + 1]
}
}
return undefined
}
/**
* Handle the standard Unix `--` separator convention in CLI arguments.
*
* When using Commander.js with `.passThroughOptions()`, the `--` separator
* is passed through as a positional argument rather than being consumed.
* This means when a user runs:
* `cmd --opt value name -- subcmd --flag arg`
*
* Commander parses it as:
* positional1 = "name", positional2 = "--", rest = ["subcmd", "--flag", "arg"]
*
* This function corrects the parsing by extracting the actual command from
* the rest array when the positional is `--`.
*
* @param commandOrValue - The parsed positional that may be "--"
* @param args - The remaining arguments array
* @returns Object with corrected command and args
*/
export function extractArgsAfterDoubleDash(
commandOrValue: string,
args: string[] = [],
): { command: string; args: string[] } {
if (commandOrValue === '--' && args.length > 0) {
return {
command: args[0]!,
args: args.slice(1),
}
}
return { command: commandOrValue, args }
}