flags 0.2.0 → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +9 -0
- package/README.md +88 -89
- package/dist/flags.cjs +20 -1
- package/dist/flags.cjs.map +1 -1
- package/dist/flags.d.cts +3 -1
- package/dist/flags.d.ts +3 -1
- package/dist/flags.js +20 -1
- package/dist/flags.js.map +1 -1
- package/package.json +3 -3
package/LICENSE
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
The MIT License (MIT)
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2011 Daniel Pupius
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
|
6
|
+
|
|
7
|
+
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
|
8
|
+
|
|
9
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,123 +1,122 @@
|
|
|
1
1
|
# Node-Flags
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
A flexible and easy-to-use command-line flag parsing library for Node.js applications.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
Fork the latest source from github, or else use your favorite package manager:
|
|
8
|
-
|
|
9
|
-
pnpm install flags
|
|
10
|
-
|
|
11
|
-
## Example
|
|
12
|
-
|
|
13
|
-
import * as flags from 'flags';
|
|
14
|
-
|
|
15
|
-
flags.defineString('name', 'Billy Noone', 'Your name');
|
|
16
|
-
flags.defineInteger('age', 21, 'Your age in whole years');
|
|
17
|
-
flags.defineNumber('height', 1.80, 'Your height in meters');
|
|
18
|
-
flags.defineStringList('pets', []);
|
|
19
|
-
flags.defineMultiString('hobby', []);
|
|
5
|
+
[](https://badge.fury.io/js/flags)
|
|
6
|
+
[](https://opensource.org/licenses/MIT)
|
|
20
7
|
|
|
21
|
-
|
|
8
|
+
## Features
|
|
22
9
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
info.push('Height : ' + flags.get('height') + '"');
|
|
29
|
-
info.push('Pets : ' + flags.get('pets').join(', '));
|
|
30
|
-
info.push('Hobbies : \n ' + flags.get('hobby').join('\n '));
|
|
31
|
-
|
|
32
|
-
console.log(info.join('\n'));
|
|
33
|
-
|
|
34
|
-
Then on the command line:
|
|
35
|
-
|
|
36
|
-
node example.js --name='Your Name' --age 43 --height=1.234 --pets=fred,bob --hobby biking --hobby=snowboarding
|
|
37
|
-
|
|
38
|
-
## Passing Flags
|
|
10
|
+
- Define flags across multiple files
|
|
11
|
+
- Support for various data types (string, boolean, integer, number, string list, multi-string)
|
|
12
|
+
- Easy-to-use API for defining and accessing flags
|
|
13
|
+
- Customizable flag validation
|
|
14
|
+
- Built-in help text generation
|
|
39
15
|
|
|
40
|
-
|
|
41
|
-
- Values can be separated from the name with either an equal sign or a space: e.g. `--flagname=flagvalue` or `--flagname flagvalue`
|
|
42
|
-
- Complex string flags should be quoted: e.g. `--flag="some flag with spaces"`
|
|
43
|
-
- Additional non-flag arguments can be passed by adding `--` before the subsequent args. The remaining args will be returned from `flags.parse()` as an array, e.g. `--one --two -- other stuff here`
|
|
16
|
+
## Installation
|
|
44
17
|
|
|
45
|
-
|
|
18
|
+
Install using your favorite package manager:
|
|
46
19
|
|
|
47
|
-
|
|
20
|
+
```bash
|
|
21
|
+
npm install flags
|
|
22
|
+
# or
|
|
23
|
+
yarn add flags
|
|
24
|
+
# or
|
|
25
|
+
pnpm add flags
|
|
26
|
+
```
|
|
48
27
|
|
|
49
|
-
|
|
28
|
+
## Usage
|
|
50
29
|
|
|
51
|
-
|
|
30
|
+
Here's a quick example of how to use Node-Flags:
|
|
52
31
|
|
|
53
|
-
|
|
32
|
+
```javascript
|
|
33
|
+
import * as flags from "flags";
|
|
54
34
|
|
|
55
|
-
|
|
35
|
+
// Define flags
|
|
36
|
+
flags.defineString("name", "Anonymous", "Your name");
|
|
37
|
+
flags.defineInteger("age", 21, "Your age in years");
|
|
38
|
+
flags.defineNumber("height", 1.8, "Your height in meters");
|
|
39
|
+
flags.defineStringList("pets", [], "List of your pets");
|
|
40
|
+
flags.defineMultiString("hobby", [], "Your hobbies");
|
|
56
41
|
|
|
57
|
-
|
|
42
|
+
// Parse command-line arguments
|
|
43
|
+
flags.parse();
|
|
58
44
|
|
|
59
|
-
|
|
45
|
+
// Access flag values
|
|
46
|
+
const info = [
|
|
47
|
+
`Name: ${flags.get("name")}`,
|
|
48
|
+
`Age: ${flags.get("age")}`,
|
|
49
|
+
`Height: ${flags.get("height")}m`,
|
|
50
|
+
`Pets: ${flags.get("pets").join(", ")}`,
|
|
51
|
+
`Hobbies:\n ${flags.get("hobby").join("\n ")}`,
|
|
52
|
+
];
|
|
60
53
|
|
|
61
|
-
|
|
54
|
+
console.log(info.join("\n"));
|
|
55
|
+
```
|
|
62
56
|
|
|
63
|
-
|
|
57
|
+
Run your script with flags:
|
|
64
58
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
59
|
+
```bash
|
|
60
|
+
node example.js --name="John Doe" --age=30 --height=1.75 --pets=dog,cat --hobby=reading --hobby=gaming
|
|
61
|
+
```
|
|
68
62
|
|
|
69
|
-
|
|
63
|
+
## Defining Flags
|
|
70
64
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
`
|
|
74
|
-
`
|
|
65
|
+
Node-Flags provides several methods to define flags:
|
|
66
|
+
|
|
67
|
+
- `defineString(name, defaultValue, description)`
|
|
68
|
+
- `defineBoolean(name, defaultValue, description)`
|
|
69
|
+
- `defineInteger(name, defaultValue, description)`
|
|
70
|
+
- `defineNumber(name, defaultValue, description)`
|
|
71
|
+
- `defineStringList(name, defaultValue, description)`
|
|
72
|
+
- `defineMultiString(name, defaultValue, description)`
|
|
73
|
+
|
|
74
|
+
Each method returns a `Flag` object that allows further configuration:
|
|
75
|
+
|
|
76
|
+
```javascript
|
|
77
|
+
flags
|
|
78
|
+
.defineString("api-key")
|
|
79
|
+
.setDefault("your-default-key")
|
|
80
|
+
.setDescription("API key for authentication")
|
|
81
|
+
.setValidator((value) => {
|
|
82
|
+
if (value.length < 10) {
|
|
83
|
+
throw new Error("API key must be at least 10 characters long");
|
|
84
|
+
}
|
|
85
|
+
})
|
|
86
|
+
.setSecret(true);
|
|
87
|
+
```
|
|
75
88
|
|
|
76
|
-
|
|
89
|
+
## Passing Flags
|
|
77
90
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
if (inp.substr(0, 1) != 'e') {
|
|
83
|
-
throw Error('Flag must start with an "e"');
|
|
84
|
-
}
|
|
85
|
-
});
|
|
91
|
+
- Use double dashes for flag names: `--flagname`
|
|
92
|
+
- Separate values with an equal sign or space: `--flagname=value` or `--flagname value`
|
|
93
|
+
- Quote complex string values: `--message="Hello, World!"`
|
|
94
|
+
- Use `--` to separate flags from additional arguments: `--flag1 value1 -- arg1 arg2`
|
|
86
95
|
|
|
87
96
|
## Querying Flag Values
|
|
88
97
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
The flag object also contains the following properties you may be interested in:
|
|
98
|
+
Access flag values using `flags.get(flagName)` or `flags.FLAGS.flagName.get()`.
|
|
92
99
|
|
|
93
|
-
|
|
94
|
-
flag.defaultValue
|
|
95
|
-
flag.currentValue
|
|
96
|
-
flag.isSet
|
|
100
|
+
Flag objects also provide properties like `name`, `defaultValue`, `currentValue`, and `isSet`.
|
|
97
101
|
|
|
98
|
-
##
|
|
102
|
+
## Help Text
|
|
99
103
|
|
|
100
|
-
|
|
104
|
+
Node-Flags automatically generates help text. Access it by running your script with the `--help` flag.
|
|
101
105
|
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
If you want to change flags between test cases, you may call:
|
|
105
|
-
|
|
106
|
-
flags.reset();
|
|
107
|
-
|
|
108
|
-
## TODOs
|
|
109
|
-
|
|
110
|
-
- Support --flagsfile
|
|
111
|
-
- Support multi space separated flags, e.g. --files file1 file2 file3
|
|
106
|
+
## Testing
|
|
112
107
|
|
|
113
|
-
|
|
108
|
+
For testing, you can pass predefined arguments to `flags.parse()`:
|
|
114
109
|
|
|
115
|
-
|
|
110
|
+
```javascript
|
|
111
|
+
flags.parse(["--flag1", "--noflag2", "--flag3=value"]);
|
|
112
|
+
```
|
|
116
113
|
|
|
117
|
-
|
|
114
|
+
Reset flags between test cases:
|
|
118
115
|
|
|
119
|
-
|
|
116
|
+
```javascript
|
|
117
|
+
flags.reset();
|
|
118
|
+
```
|
|
120
119
|
|
|
121
|
-
|
|
120
|
+
## License
|
|
122
121
|
|
|
123
|
-
|
|
122
|
+
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
|
package/dist/flags.cjs
CHANGED
|
@@ -133,11 +133,19 @@ function parse(args = process.argv.slice(2), ignoreUnrecognized) {
|
|
|
133
133
|
help();
|
|
134
134
|
process.exit(0);
|
|
135
135
|
}
|
|
136
|
+
Object.keys(FLAGS).forEach((key) => {
|
|
137
|
+
if (FLAGS[key].isRequired && !FLAGS[key].isSet) {
|
|
138
|
+
throwFlagParseError(args, -1, 'Missing required flag "--' + key + '"');
|
|
139
|
+
}
|
|
140
|
+
});
|
|
136
141
|
return [];
|
|
137
142
|
}
|
|
138
143
|
var parseCalled = false;
|
|
139
144
|
function throwFlagParseError(args, i, msg) {
|
|
140
|
-
|
|
145
|
+
let errorMsg = "FLAG PARSING ERROR: " + msg;
|
|
146
|
+
if (i > -1) {
|
|
147
|
+
errorMsg += "\n " + args.join(" ") + "\n " + new Array(args.slice(0, i).join(" ").length + 2).join(" ") + new Array(args[i].length + 1).join("^");
|
|
148
|
+
}
|
|
141
149
|
if (exitOnError) {
|
|
142
150
|
console.error(errorMsg);
|
|
143
151
|
process.exit(1);
|
|
@@ -190,25 +198,36 @@ var Flag = class {
|
|
|
190
198
|
__publicField(this, "validator");
|
|
191
199
|
__publicField(this, "isSecret");
|
|
192
200
|
__publicField(this, "isSet");
|
|
201
|
+
__publicField(this, "isRequired");
|
|
193
202
|
this.name = name;
|
|
194
203
|
this.defaultValue = defaultValue;
|
|
195
204
|
this.description = description;
|
|
196
205
|
this.currentValue = null;
|
|
197
206
|
this.isSecret = false;
|
|
198
207
|
this.isSet = false;
|
|
208
|
+
this.isRequired = false;
|
|
199
209
|
}
|
|
210
|
+
/** Set a default value. */
|
|
200
211
|
setDefault(defaultValue) {
|
|
201
212
|
this.defaultValue = defaultValue;
|
|
202
213
|
return this;
|
|
203
214
|
}
|
|
215
|
+
/** Set whether this flag is required. */
|
|
216
|
+
setRequired(isRequired) {
|
|
217
|
+
this.isRequired = isRequired;
|
|
218
|
+
return this;
|
|
219
|
+
}
|
|
220
|
+
/** Set a description for use in the help message. */
|
|
204
221
|
setDescription(description) {
|
|
205
222
|
this.description = description;
|
|
206
223
|
return this;
|
|
207
224
|
}
|
|
225
|
+
/** Set a custom validator. */
|
|
208
226
|
setValidator(validator) {
|
|
209
227
|
this.validator = validator;
|
|
210
228
|
return this;
|
|
211
229
|
}
|
|
230
|
+
/** Hide this flag from the help message. */
|
|
212
231
|
setSecret(isSecret) {
|
|
213
232
|
this.isSecret = isSecret;
|
|
214
233
|
return this;
|
package/dist/flags.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/flags.ts"],"sourcesContent":["// Define interfaces for our flag types\ninterface IFlag<T> {\n name: string;\n defaultValue: T;\n description?: string;\n currentValue: T | null;\n validator?: (input: T | null) => boolean;\n isSecret: boolean;\n isSet: boolean;\n setDefault(defaultValue: T): this;\n setDescription(description: string): this;\n setValidator(validator: (input: T | null) => boolean): this;\n setSecret(isSecret: boolean): this;\n set(input: T): void;\n get(): T | null;\n parseInput(inp: string): T | null;\n toHelpString(): string;\n}\n\n// Define the global flags object\ndeclare global {\n var GLOBAL_FLAGS: { [key: string]: IFlag<any> };\n}\n\nif (typeof global.GLOBAL_FLAGS === \"undefined\") {\n global.GLOBAL_FLAGS = {};\n}\n\nconst FLAGS: { [key: string]: IFlag<any> } = global.GLOBAL_FLAGS;\n\n/**\n * An object containing a map of flag objects. If different modules are\n * importing different versions of the library we want them to use the same\n * FLAGS object. This does mean that the flags library needs to be backwards\n * compatible.\n */\nexport { FLAGS };\n\nlet exitOnError = true;\n\nlet usageInfo =\n \"Usage: node \" + (process.argv[1] || \"\").split(\"/\").pop() + \" [options]\";\n\n/**\n * If true, then the process will be nicely exit on a parse error. If false,\n * an Error will be thrown. Set to false in tests.\n */\nexport function setExitOnError(value: boolean) {\n exitOnError = value;\n}\n\n/**\n * Allows an app to add extra usage information that will be shown in the help\n * message, above the flags.\n */\nexport function setUsageInfo(value: string) {\n usageInfo = value;\n}\n\n/**\n * Defines a string flag. e.g. --servername=bob\n */\nexport function defineString(\n name: string,\n defaultValue?: string,\n description?: string\n): IFlag<string> {\n return addFlag(name, new StringFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a boolean flag. e.g. --turnonlights\n */\nexport function defineBoolean(\n name: string,\n defaultValue?: boolean,\n description?: string\n): IFlag<boolean> {\n return addFlag(name, new BooleanFlag(name, defaultValue, description));\n}\n\n/**\n * Defines an integer flag. e.g. --age=12\n */\nexport function defineInteger(\n name: string,\n defaultValue?: number,\n description?: string\n): IFlag<number> {\n return addFlag(name, new IntegerFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a number flag. e.g. --number=1.345\n */\nexport function defineNumber(\n name: string,\n defaultValue?: number,\n description?: string\n): IFlag<number> {\n return addFlag(name, new NumberFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a string list flag. e.g. --anmial=frog,bat,chicken\n */\nexport function defineStringList(\n name: string,\n defaultValue?: string[],\n description?: string\n): IFlag<string[]> {\n return addFlag(name, new StringListFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a multi string flag. e.g. --allowedip=127.0.0.1 --allowedip=127.0.0.2\n */\nexport function defineMultiString(\n name: string,\n defaultValue?: string[],\n description?: string\n): IFlag<string[]> {\n return addFlag(name, new MultiStringFlag(name, defaultValue, description));\n}\n\n/**\n * Dumps the help text to the console.\n */\nexport function help(): void {\n if (usageInfo) {\n console.log(usageInfo + \"\\n\");\n }\n console.log(\"Options:\");\n for (const flag in FLAGS) {\n if (!FLAGS[flag].isSecret) {\n console.log(FLAGS[flag].toHelpString());\n }\n }\n}\n\n/**\n * Resets the flag values.\n */\nexport function reset(): void {\n parseCalled = false;\n Object.keys(FLAGS).forEach((key) => delete FLAGS[key]);\n registerInternalFlags();\n}\n\n/**\n * Gets the current value of the given flag.\n */\nexport function get(name: string): unknown {\n if (!FLAGS[name]) throw Error('Unknown flag \"' + name + '\"');\n return FLAGS[name].get();\n}\n\n/**\n * Gets whether or not the flag was set.\n */\nexport function isSet(name: string): boolean {\n if (!FLAGS[name]) throw Error('Unknown flag \"' + name + '\"');\n return FLAGS[name].isSet;\n}\n\n/**\n * Parses process.argv for flags. Idempotent if called multiple times.\n */\nexport function parse(\n args: string[] = process.argv.slice(2),\n ignoreUnrecognized?: boolean\n): string[] {\n if (parseCalled) return [];\n\n for (let i = 0; i < args.length; i++) {\n const arg = args[i];\n\n if (arg == \"--\") {\n return args.slice(i + 1);\n } else if (arg.startsWith(\"--\")) {\n let flag = arg.slice(2);\n let value: string | null = null;\n if (flag.indexOf(\"=\") > -1) {\n const parts = flag.split(\"=\");\n flag = parts[0];\n value = parts.slice(1).join(\"=\");\n }\n\n if (value == null && args[i + 1] && !args[i + 1].startsWith(\"--\")) {\n args[i] = args[i] + \" \" + args[i + 1];\n value = args[i + 1];\n args.splice(i + 1, 1);\n }\n\n if (!FLAGS[flag] && value == null && flag.startsWith(\"no\")) {\n flag = flag.slice(2);\n value = \"0\";\n }\n\n if (FLAGS[flag]) {\n try {\n FLAGS[flag].set(value);\n } catch (e) {\n throwFlagParseError(args, i, (e as Error).message);\n }\n } else if (!ignoreUnrecognized) {\n throwFlagParseError(args, i, 'Unrecognized flag name \"' + arg + '\"');\n }\n } else {\n throwFlagParseError(args, i, 'Invalid argument \"' + arg + '\"');\n }\n }\n\n parseCalled = true;\n\n if (FLAGS.help.get()) {\n help();\n process.exit(0);\n }\n\n return [];\n}\n\n// Private helpers\nlet parseCalled = false;\n\nfunction throwFlagParseError(args: string[], i: number, msg: string): void {\n const errorMsg =\n \"FLAG PARSING ERROR: \" +\n msg +\n \"\\n \" +\n args.join(\" \") +\n \"\\n \" +\n new Array(args.slice(0, i).join(\" \").length + 2).join(\" \") +\n new Array(args[i].length + 1).join(\"^\");\n\n if (exitOnError) {\n console.error(errorMsg);\n process.exit(1);\n } else {\n throw Error(errorMsg);\n }\n}\n\nfunction addFlag<T>(name: string, flag: IFlag<T>): IFlag<T> {\n if (parseCalled) throw Error(\"Can not register new flags after parse()\");\n if (FLAGS[name]) throw Error('Flag already defined: \"' + name + '\"');\n FLAGS[name] = flag;\n return flag;\n}\n\nfunction wrapText(text: string, maxLen: number): string {\n const lines = text.split(\"\\n\");\n const out: string[] = [];\n lines.forEach((line) => {\n const maxLenx = maxLen + (out.length == 0 ? 4 : 0);\n if (line.length < maxLenx) {\n out.push(line);\n } else {\n const current = wrapLine(line, \" \", maxLenx, out);\n if (current != \"\") {\n out.push(current);\n }\n }\n });\n return out.join(\"\\n \");\n}\n\nfunction wrapLine(\n line: string,\n delimiter: string,\n maxLen: number,\n out: string[]\n): string {\n const parts = line.split(delimiter);\n let current = \"\";\n parts.forEach((part) => {\n const next = current + part + delimiter;\n if (next.length > maxLen) {\n out.push(current);\n current = part + delimiter;\n } else {\n current = next;\n }\n });\n return current;\n}\n\nclass Flag<T> implements IFlag<T> {\n name: string;\n defaultValue: T;\n description?: string;\n currentValue: T | null;\n validator?: (input: T | null) => boolean;\n isSecret: boolean;\n isSet: boolean;\n\n constructor(name: string, defaultValue: T, description?: string) {\n this.name = name;\n this.defaultValue = defaultValue;\n this.description = description;\n this.currentValue = null;\n this.isSecret = false;\n this.isSet = false;\n }\n\n setDefault(defaultValue: T): this {\n this.defaultValue = defaultValue;\n return this;\n }\n\n setDescription(description: string): this {\n this.description = description;\n return this;\n }\n\n setValidator(validator: (input: T | null) => boolean): this {\n this.validator = validator;\n return this;\n }\n\n setSecret(isSecret: boolean): this {\n this.isSecret = isSecret;\n return this;\n }\n\n set(input: T | string): void {\n if (this.isSet) {\n throw Error(\"Flag already set\");\n }\n if (typeof input === \"string\") {\n this.currentValue = this.parseInput(input);\n } else if (input === null) {\n this.currentValue = this.parseInput(null);\n } else {\n this.currentValue = input;\n }\n if (this.validator) this.validator(this.currentValue);\n this.isSet = true;\n }\n\n get(): T | null {\n return this.isSet ? this.currentValue : this.defaultValue;\n }\n\n parseInput(_inp: string | null): T | null {\n throw Error(\"Not implemented\");\n }\n\n toHelpString(): string {\n return (\n wrapText(\" --\" + this.name + \": \" + this.description, 70) +\n \"\\n\" +\n \" (default: \" +\n JSON.stringify(this.defaultValue) +\n \")\"\n );\n }\n}\n\nclass BooleanFlag extends Flag<boolean> implements IFlag<boolean> {\n constructor(name: string, defaultValue?: boolean, description?: string) {\n super(name, defaultValue ?? false, description);\n }\n\n parseInput(inp: string | null): boolean {\n if (inp === null) {\n // Empty flag value means true for a boolean flag.\n return true;\n }\n inp = inp.toLowerCase();\n if (inp === \"1\" || inp === \"true\" || inp == \"t\") {\n return true;\n } else if (inp === \"0\" || inp === \"false\" || inp == \"f\") {\n return false;\n } else {\n throw Error('Invalid Boolean flag \"' + inp + '\"');\n }\n }\n\n get(): boolean {\n return !!super.get();\n }\n\n toHelpString(): string {\n return (\n wrapText(\" --[no]\" + this.name + \": \" + this.description, 70) +\n \"\\n\" +\n \" (default: \" +\n JSON.stringify(this.defaultValue) +\n \")\"\n );\n }\n}\n\nclass IntegerFlag extends Flag<number> implements IFlag<number> {\n constructor(name: string, defaultValue?: number, description?: string) {\n super(name, defaultValue ?? 0, description);\n }\n\n parseInput(inp: string): number {\n if (isNaN(Number(inp)) || parseInt(inp, 10) !== Number(inp)) {\n throw Error('Invalid Integer flag \"' + inp + '\"');\n }\n return Number(inp);\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (an integer)\";\n }\n}\n\nclass NumberFlag extends Flag<number> implements IFlag<number> {\n constructor(name: string, defaultValue?: number, description?: string) {\n super(name, defaultValue ?? 0, description);\n }\n\n parseInput(inp: string | null): number {\n if (isNaN(Number(inp))) {\n throw Error('Invalid Number flag \"' + inp + '\"');\n }\n return Number(inp);\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (a number)\";\n }\n}\n\nclass StringFlag extends Flag<string> implements IFlag<string> {\n constructor(name: string, defaultValue?: string, description?: string) {\n super(name, defaultValue ?? \"\", description);\n }\n\n parseInput(inp: string | null): string {\n if (inp === null) {\n throw Error('Invalid String flag \"' + inp + '\"');\n }\n return inp;\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (a string)\";\n }\n}\n\nclass StringListFlag extends Flag<string[]> implements IFlag<string[]> {\n constructor(name: string, defaultValue?: string[], description?: string) {\n super(name, defaultValue ?? [], description);\n }\n\n parseInput(inp: string | null): string[] {\n if (inp === null) return [];\n else return inp.split(\",\");\n }\n}\n\nclass MultiStringFlag extends Flag<string[]> implements IFlag<string[]> {\n constructor(name: string, defaultValue?: string[], description?: string) {\n super(name, defaultValue ?? [], description);\n }\n\n set(input: string[]): void {\n if (this.validator) this.validator(input);\n if (!this.currentValue) this.currentValue = [];\n this.currentValue.push(...input);\n this.isSet = true;\n }\n}\n\n// Internal flags\nfunction registerInternalFlags(): void {\n defineBoolean(\"help\").setDescription(\"Shows this help text.\").setSecret(true);\n // TODO: --flagsfile\n}\n\nregisterInternalFlags();\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../src/flags.ts"],"sourcesContent":["// Define interfaces for our flag types\ninterface IFlag<T> {\n name: string;\n defaultValue: T;\n description?: string;\n currentValue: T | null;\n validator?: (input: T | null) => boolean;\n isSecret: boolean;\n isSet: boolean;\n isRequired: boolean;\n setDefault(defaultValue: T): this;\n setRequired(required: boolean): this;\n setDescription(description: string): this;\n setValidator(validator: (input: T | null) => boolean): this;\n setSecret(isSecret: boolean): this;\n set(input: T): void;\n get(): T | null;\n parseInput(inp: string): T | null;\n toHelpString(): string;\n}\n\n// Define the global flags object\ndeclare global {\n var GLOBAL_FLAGS: { [key: string]: IFlag<any> };\n}\n\nif (typeof global.GLOBAL_FLAGS === \"undefined\") {\n global.GLOBAL_FLAGS = {};\n}\n\nconst FLAGS: { [key: string]: IFlag<any> } = global.GLOBAL_FLAGS;\n\n/**\n * An object containing a map of flag objects. If different modules are\n * importing different versions of the library we want them to use the same\n * FLAGS object. This does mean that the flags library needs to be backwards\n * compatible.\n */\nexport { FLAGS };\n\nlet exitOnError = true;\n\nlet usageInfo =\n \"Usage: node \" + (process.argv[1] || \"\").split(\"/\").pop() + \" [options]\";\n\n/**\n * If true, then the process will be nicely exit on a parse error. If false,\n * an Error will be thrown. Set to false in tests.\n */\nexport function setExitOnError(value: boolean) {\n exitOnError = value;\n}\n\n/**\n * Allows an app to add extra usage information that will be shown in the help\n * message, above the flags.\n */\nexport function setUsageInfo(value: string) {\n usageInfo = value;\n}\n\n/**\n * Defines a string flag. e.g. --servername=bob\n */\nexport function defineString(\n name: string,\n defaultValue?: string,\n description?: string\n): IFlag<string> {\n return addFlag(name, new StringFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a boolean flag. e.g. --turnonlights\n */\nexport function defineBoolean(\n name: string,\n defaultValue?: boolean,\n description?: string\n): IFlag<boolean> {\n return addFlag(name, new BooleanFlag(name, defaultValue, description));\n}\n\n/**\n * Defines an integer flag. e.g. --age=12\n */\nexport function defineInteger(\n name: string,\n defaultValue?: number,\n description?: string\n): IFlag<number> {\n return addFlag(name, new IntegerFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a number flag. e.g. --number=1.345\n */\nexport function defineNumber(\n name: string,\n defaultValue?: number,\n description?: string\n): IFlag<number> {\n return addFlag(name, new NumberFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a string list flag. e.g. --animal=frog,bat,chicken\n */\nexport function defineStringList(\n name: string,\n defaultValue?: string[],\n description?: string\n): IFlag<string[]> {\n return addFlag(name, new StringListFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a multi string flag. e.g. --allowedip=127.0.0.1 --allowedip=127.0.0.2\n */\nexport function defineMultiString(\n name: string,\n defaultValue?: string[],\n description?: string\n): IFlag<string[]> {\n return addFlag(name, new MultiStringFlag(name, defaultValue, description));\n}\n\n/**\n * Dumps the help text to the console.\n */\nexport function help(): void {\n if (usageInfo) {\n console.log(usageInfo + \"\\n\");\n }\n console.log(\"Options:\");\n for (const flag in FLAGS) {\n if (!FLAGS[flag].isSecret) {\n console.log(FLAGS[flag].toHelpString());\n }\n }\n}\n\n/**\n * Resets the flag values.\n */\nexport function reset(): void {\n parseCalled = false;\n Object.keys(FLAGS).forEach((key) => delete FLAGS[key]);\n registerInternalFlags();\n}\n\n/**\n * Gets the current value of the given flag.\n */\nexport function get(name: string): unknown {\n if (!FLAGS[name]) throw Error('Unknown flag \"' + name + '\"');\n return FLAGS[name].get();\n}\n\n/**\n * Gets whether or not the flag was set.\n */\nexport function isSet(name: string): boolean {\n if (!FLAGS[name]) throw Error('Unknown flag \"' + name + '\"');\n return FLAGS[name].isSet;\n}\n\n/**\n * Parses process.argv for flags. Idempotent if called multiple times.\n */\nexport function parse(\n args: string[] = process.argv.slice(2),\n ignoreUnrecognized?: boolean\n): string[] {\n if (parseCalled) return [];\n\n for (let i = 0; i < args.length; i++) {\n const arg = args[i];\n\n if (arg == \"--\") {\n return args.slice(i + 1);\n } else if (arg.startsWith(\"--\")) {\n let flag = arg.slice(2);\n let value: string | null = null;\n if (flag.indexOf(\"=\") > -1) {\n const parts = flag.split(\"=\");\n flag = parts[0];\n value = parts.slice(1).join(\"=\");\n }\n\n if (value == null && args[i + 1] && !args[i + 1].startsWith(\"--\")) {\n args[i] = args[i] + \" \" + args[i + 1];\n value = args[i + 1];\n args.splice(i + 1, 1);\n }\n\n if (!FLAGS[flag] && value == null && flag.startsWith(\"no\")) {\n flag = flag.slice(2);\n value = \"0\";\n }\n\n if (FLAGS[flag]) {\n try {\n FLAGS[flag].set(value);\n } catch (e) {\n throwFlagParseError(args, i, (e as Error).message);\n }\n } else if (!ignoreUnrecognized) {\n throwFlagParseError(args, i, 'Unrecognized flag name \"' + arg + '\"');\n }\n } else {\n throwFlagParseError(args, i, 'Invalid argument \"' + arg + '\"');\n }\n }\n\n parseCalled = true;\n\n if (FLAGS.help.get()) {\n help();\n process.exit(0);\n }\n\n Object.keys(FLAGS).forEach((key) => {\n if (FLAGS[key].isRequired && !FLAGS[key].isSet) {\n throwFlagParseError(args, -1, 'Missing required flag \"--' + key + '\"');\n }\n });\n\n return [];\n}\n\n// Private helpers\nlet parseCalled = false;\n\nfunction throwFlagParseError(args: string[], i: number, msg: string): void {\n let errorMsg = \"FLAG PARSING ERROR: \" + msg;\n if (i > -1) {\n errorMsg +=\n \"\\n \" +\n args.join(\" \") +\n \"\\n \" +\n new Array(args.slice(0, i).join(\" \").length + 2).join(\" \") +\n new Array(args[i].length + 1).join(\"^\");\n }\n\n if (exitOnError) {\n console.error(errorMsg);\n process.exit(1);\n } else {\n throw Error(errorMsg);\n }\n}\n\nfunction addFlag<T>(name: string, flag: IFlag<T>): IFlag<T> {\n if (parseCalled) throw Error(\"Can not register new flags after parse()\");\n if (FLAGS[name]) throw Error('Flag already defined: \"' + name + '\"');\n FLAGS[name] = flag;\n return flag;\n}\n\nfunction wrapText(text: string, maxLen: number): string {\n const lines = text.split(\"\\n\");\n const out: string[] = [];\n lines.forEach((line) => {\n const maxLenx = maxLen + (out.length == 0 ? 4 : 0);\n if (line.length < maxLenx) {\n out.push(line);\n } else {\n const current = wrapLine(line, \" \", maxLenx, out);\n if (current != \"\") {\n out.push(current);\n }\n }\n });\n return out.join(\"\\n \");\n}\n\nfunction wrapLine(\n line: string,\n delimiter: string,\n maxLen: number,\n out: string[]\n): string {\n const parts = line.split(delimiter);\n let current = \"\";\n parts.forEach((part) => {\n const next = current + part + delimiter;\n if (next.length > maxLen) {\n out.push(current);\n current = part + delimiter;\n } else {\n current = next;\n }\n });\n return current;\n}\n\nclass Flag<T> implements IFlag<T> {\n name: string;\n defaultValue: T;\n description?: string;\n currentValue: T | null;\n validator?: (input: T | null) => boolean;\n isSecret: boolean;\n isSet: boolean;\n isRequired: boolean;\n\n constructor(name: string, defaultValue: T, description?: string) {\n this.name = name;\n this.defaultValue = defaultValue;\n this.description = description;\n this.currentValue = null;\n this.isSecret = false;\n this.isSet = false;\n this.isRequired = false;\n }\n\n /** Set a default value. */\n setDefault(defaultValue: T): this {\n this.defaultValue = defaultValue;\n return this;\n }\n\n /** Set whether this flag is required. */\n setRequired(isRequired: boolean): this {\n this.isRequired = isRequired;\n return this;\n }\n\n /** Set a description for use in the help message. */\n setDescription(description: string): this {\n this.description = description;\n return this;\n }\n\n /** Set a custom validator. */\n setValidator(validator: (input: T | null) => boolean): this {\n this.validator = validator;\n return this;\n }\n\n /** Hide this flag from the help message. */\n setSecret(isSecret: boolean): this {\n this.isSecret = isSecret;\n return this;\n }\n\n set(input: T | string): void {\n if (this.isSet) {\n throw Error(\"Flag already set\");\n }\n if (typeof input === \"string\") {\n this.currentValue = this.parseInput(input);\n } else if (input === null) {\n this.currentValue = this.parseInput(null);\n } else {\n this.currentValue = input;\n }\n if (this.validator) this.validator(this.currentValue);\n this.isSet = true;\n }\n\n get(): T | null {\n return this.isSet ? this.currentValue : this.defaultValue;\n }\n\n parseInput(_inp: string | null): T | null {\n throw Error(\"Not implemented\");\n }\n\n toHelpString(): string {\n return (\n wrapText(\" --\" + this.name + \": \" + this.description, 70) +\n \"\\n\" +\n \" (default: \" +\n JSON.stringify(this.defaultValue) +\n \")\"\n );\n }\n}\n\nclass BooleanFlag extends Flag<boolean> implements IFlag<boolean> {\n constructor(name: string, defaultValue?: boolean, description?: string) {\n super(name, defaultValue ?? false, description);\n }\n\n parseInput(inp: string | null): boolean {\n if (inp === null) {\n // Empty flag value means true for a boolean flag.\n return true;\n }\n inp = inp.toLowerCase();\n if (inp === \"1\" || inp === \"true\" || inp == \"t\") {\n return true;\n } else if (inp === \"0\" || inp === \"false\" || inp == \"f\") {\n return false;\n } else {\n throw Error('Invalid Boolean flag \"' + inp + '\"');\n }\n }\n\n get(): boolean {\n return !!super.get();\n }\n\n toHelpString(): string {\n return (\n wrapText(\" --[no]\" + this.name + \": \" + this.description, 70) +\n \"\\n\" +\n \" (default: \" +\n JSON.stringify(this.defaultValue) +\n \")\"\n );\n }\n}\n\nclass IntegerFlag extends Flag<number> implements IFlag<number> {\n constructor(name: string, defaultValue?: number, description?: string) {\n super(name, defaultValue ?? 0, description);\n }\n\n parseInput(inp: string): number {\n if (isNaN(Number(inp)) || parseInt(inp, 10) !== Number(inp)) {\n throw Error('Invalid Integer flag \"' + inp + '\"');\n }\n return Number(inp);\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (an integer)\";\n }\n}\n\nclass NumberFlag extends Flag<number> implements IFlag<number> {\n constructor(name: string, defaultValue?: number, description?: string) {\n super(name, defaultValue ?? 0, description);\n }\n\n parseInput(inp: string | null): number {\n if (isNaN(Number(inp))) {\n throw Error('Invalid Number flag \"' + inp + '\"');\n }\n return Number(inp);\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (a number)\";\n }\n}\n\nclass StringFlag extends Flag<string> implements IFlag<string> {\n constructor(name: string, defaultValue?: string, description?: string) {\n super(name, defaultValue ?? \"\", description);\n }\n\n parseInput(inp: string | null): string {\n if (inp === null) {\n throw Error('Invalid String flag \"' + inp + '\"');\n }\n return inp;\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (a string)\";\n }\n}\n\nclass StringListFlag extends Flag<string[]> implements IFlag<string[]> {\n constructor(name: string, defaultValue?: string[], description?: string) {\n super(name, defaultValue ?? [], description);\n }\n\n parseInput(inp: string | null): string[] {\n if (inp === null) return [];\n else return inp.split(\",\");\n }\n}\n\nclass MultiStringFlag extends Flag<string[]> implements IFlag<string[]> {\n constructor(name: string, defaultValue?: string[], description?: string) {\n super(name, defaultValue ?? [], description);\n }\n\n set(input: string[]): void {\n if (this.validator) this.validator(input);\n if (!this.currentValue) this.currentValue = [];\n this.currentValue.push(...input);\n this.isSet = true;\n }\n}\n\n// Internal flags\nfunction registerInternalFlags(): void {\n defineBoolean(\"help\").setDescription(\"Shows this help text.\").setSecret(true);\n // TODO: --flagsfile\n}\n\nregisterInternalFlags();\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0BA,IAAI,OAAO,OAAO,iBAAiB,aAAa;AAC9C,SAAO,eAAe,CAAC;AACzB;AAEA,IAAM,QAAuC,OAAO;AAUpD,IAAI,cAAc;AAElB,IAAI,YACF,kBAAkB,QAAQ,KAAK,CAAC,KAAK,IAAI,MAAM,GAAG,EAAE,IAAI,IAAI;AAMvD,SAAS,eAAe,OAAgB;AAC7C,gBAAc;AAChB;AAMO,SAAS,aAAa,OAAe;AAC1C,cAAY;AACd;AAKO,SAAS,aACd,MACA,cACA,aACe;AACf,SAAO,QAAQ,MAAM,IAAI,WAAW,MAAM,cAAc,WAAW,CAAC;AACtE;AAKO,SAAS,cACd,MACA,cACA,aACgB;AAChB,SAAO,QAAQ,MAAM,IAAI,YAAY,MAAM,cAAc,WAAW,CAAC;AACvE;AAKO,SAAS,cACd,MACA,cACA,aACe;AACf,SAAO,QAAQ,MAAM,IAAI,YAAY,MAAM,cAAc,WAAW,CAAC;AACvE;AAKO,SAAS,aACd,MACA,cACA,aACe;AACf,SAAO,QAAQ,MAAM,IAAI,WAAW,MAAM,cAAc,WAAW,CAAC;AACtE;AAKO,SAAS,iBACd,MACA,cACA,aACiB;AACjB,SAAO,QAAQ,MAAM,IAAI,eAAe,MAAM,cAAc,WAAW,CAAC;AAC1E;AAKO,SAAS,kBACd,MACA,cACA,aACiB;AACjB,SAAO,QAAQ,MAAM,IAAI,gBAAgB,MAAM,cAAc,WAAW,CAAC;AAC3E;AAKO,SAAS,OAAa;AAC3B,MAAI,WAAW;AACb,YAAQ,IAAI,YAAY,IAAI;AAAA,EAC9B;AACA,UAAQ,IAAI,UAAU;AACtB,aAAW,QAAQ,OAAO;AACxB,QAAI,CAAC,MAAM,IAAI,EAAE,UAAU;AACzB,cAAQ,IAAI,MAAM,IAAI,EAAE,aAAa,CAAC;AAAA,IACxC;AAAA,EACF;AACF;AAKO,SAAS,QAAc;AAC5B,gBAAc;AACd,SAAO,KAAK,KAAK,EAAE,QAAQ,CAAC,QAAQ,OAAO,MAAM,GAAG,CAAC;AACrD,wBAAsB;AACxB;AAKO,SAAS,IAAI,MAAuB;AACzC,MAAI,CAAC,MAAM,IAAI,EAAG,OAAM,MAAM,mBAAmB,OAAO,GAAG;AAC3D,SAAO,MAAM,IAAI,EAAE,IAAI;AACzB;AAKO,SAAS,MAAM,MAAuB;AAC3C,MAAI,CAAC,MAAM,IAAI,EAAG,OAAM,MAAM,mBAAmB,OAAO,GAAG;AAC3D,SAAO,MAAM,IAAI,EAAE;AACrB;AAKO,SAAS,MACd,OAAiB,QAAQ,KAAK,MAAM,CAAC,GACrC,oBACU;AACV,MAAI,YAAa,QAAO,CAAC;AAEzB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAElB,QAAI,OAAO,MAAM;AACf,aAAO,KAAK,MAAM,IAAI,CAAC;AAAA,IACzB,WAAW,IAAI,WAAW,IAAI,GAAG;AAC/B,UAAI,OAAO,IAAI,MAAM,CAAC;AACtB,UAAI,QAAuB;AAC3B,UAAI,KAAK,QAAQ,GAAG,IAAI,IAAI;AAC1B,cAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,eAAO,MAAM,CAAC;AACd,gBAAQ,MAAM,MAAM,CAAC,EAAE,KAAK,GAAG;AAAA,MACjC;AAEA,UAAI,SAAS,QAAQ,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,EAAE,WAAW,IAAI,GAAG;AACjE,aAAK,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,KAAK,IAAI,CAAC;AACpC,gBAAQ,KAAK,IAAI,CAAC;AAClB,aAAK,OAAO,IAAI,GAAG,CAAC;AAAA,MACtB;AAEA,UAAI,CAAC,MAAM,IAAI,KAAK,SAAS,QAAQ,KAAK,WAAW,IAAI,GAAG;AAC1D,eAAO,KAAK,MAAM,CAAC;AACnB,gBAAQ;AAAA,MACV;AAEA,UAAI,MAAM,IAAI,GAAG;AACf,YAAI;AACF,gBAAM,IAAI,EAAE,IAAI,KAAK;AAAA,QACvB,SAAS,GAAG;AACV,8BAAoB,MAAM,GAAI,EAAY,OAAO;AAAA,QACnD;AAAA,MACF,WAAW,CAAC,oBAAoB;AAC9B,4BAAoB,MAAM,GAAG,6BAA6B,MAAM,GAAG;AAAA,MACrE;AAAA,IACF,OAAO;AACL,0BAAoB,MAAM,GAAG,uBAAuB,MAAM,GAAG;AAAA,IAC/D;AAAA,EACF;AAEA,gBAAc;AAEd,MAAI,MAAM,KAAK,IAAI,GAAG;AACpB,SAAK;AACL,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,SAAO,KAAK,KAAK,EAAE,QAAQ,CAAC,QAAQ;AAClC,QAAI,MAAM,GAAG,EAAE,cAAc,CAAC,MAAM,GAAG,EAAE,OAAO;AAC9C,0BAAoB,MAAM,IAAI,8BAA8B,MAAM,GAAG;AAAA,IACvE;AAAA,EACF,CAAC;AAED,SAAO,CAAC;AACV;AAGA,IAAI,cAAc;AAElB,SAAS,oBAAoB,MAAgB,GAAW,KAAmB;AACzE,MAAI,WAAW,yBAAyB;AACxC,MAAI,IAAI,IAAI;AACV,gBACE,QACA,KAAK,KAAK,GAAG,IACb,QACA,IAAI,MAAM,KAAK,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,IACzD,IAAI,MAAM,KAAK,CAAC,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG;AAAA,EAC1C;AAEA,MAAI,aAAa;AACf,YAAQ,MAAM,QAAQ;AACtB,YAAQ,KAAK,CAAC;AAAA,EAChB,OAAO;AACL,UAAM,MAAM,QAAQ;AAAA,EACtB;AACF;AAEA,SAAS,QAAW,MAAc,MAA0B;AAC1D,MAAI,YAAa,OAAM,MAAM,0CAA0C;AACvE,MAAI,MAAM,IAAI,EAAG,OAAM,MAAM,4BAA4B,OAAO,GAAG;AACnE,QAAM,IAAI,IAAI;AACd,SAAO;AACT;AAEA,SAAS,SAAS,MAAc,QAAwB;AACtD,QAAM,QAAQ,KAAK,MAAM,IAAI;AAC7B,QAAM,MAAgB,CAAC;AACvB,QAAM,QAAQ,CAAC,SAAS;AACtB,UAAM,UAAU,UAAU,IAAI,UAAU,IAAI,IAAI;AAChD,QAAI,KAAK,SAAS,SAAS;AACzB,UAAI,KAAK,IAAI;AAAA,IACf,OAAO;AACL,YAAM,UAAU,SAAS,MAAM,KAAK,SAAS,GAAG;AAChD,UAAI,WAAW,IAAI;AACjB,YAAI,KAAK,OAAO;AAAA,MAClB;AAAA,IACF;AAAA,EACF,CAAC;AACD,SAAO,IAAI,KAAK,QAAQ;AAC1B;AAEA,SAAS,SACP,MACA,WACA,QACA,KACQ;AACR,QAAM,QAAQ,KAAK,MAAM,SAAS;AAClC,MAAI,UAAU;AACd,QAAM,QAAQ,CAAC,SAAS;AACtB,UAAM,OAAO,UAAU,OAAO;AAC9B,QAAI,KAAK,SAAS,QAAQ;AACxB,UAAI,KAAK,OAAO;AAChB,gBAAU,OAAO;AAAA,IACnB,OAAO;AACL,gBAAU;AAAA,IACZ;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAEA,IAAM,OAAN,MAAkC;AAAA,EAUhC,YAAY,MAAc,cAAiB,aAAsB;AATjE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGE,SAAK,OAAO;AACZ,SAAK,eAAe;AACpB,SAAK,cAAc;AACnB,SAAK,eAAe;AACpB,SAAK,WAAW;AAChB,SAAK,QAAQ;AACb,SAAK,aAAa;AAAA,EACpB;AAAA;AAAA,EAGA,WAAW,cAAuB;AAChC,SAAK,eAAe;AACpB,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,YAAY,YAA2B;AACrC,SAAK,aAAa;AAClB,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,eAAe,aAA2B;AACxC,SAAK,cAAc;AACnB,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,aAAa,WAA+C;AAC1D,SAAK,YAAY;AACjB,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,UAAU,UAAyB;AACjC,SAAK,WAAW;AAChB,WAAO;AAAA,EACT;AAAA,EAEA,IAAI,OAAyB;AAC3B,QAAI,KAAK,OAAO;AACd,YAAM,MAAM,kBAAkB;AAAA,IAChC;AACA,QAAI,OAAO,UAAU,UAAU;AAC7B,WAAK,eAAe,KAAK,WAAW,KAAK;AAAA,IAC3C,WAAW,UAAU,MAAM;AACzB,WAAK,eAAe,KAAK,WAAW,IAAI;AAAA,IAC1C,OAAO;AACL,WAAK,eAAe;AAAA,IACtB;AACA,QAAI,KAAK,UAAW,MAAK,UAAU,KAAK,YAAY;AACpD,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,MAAgB;AACd,WAAO,KAAK,QAAQ,KAAK,eAAe,KAAK;AAAA,EAC/C;AAAA,EAEA,WAAW,MAA+B;AACxC,UAAM,MAAM,iBAAiB;AAAA,EAC/B;AAAA,EAEA,eAAuB;AACrB,WACE,SAAS,SAAS,KAAK,OAAO,OAAO,KAAK,aAAa,EAAE,IACzD,qBAEA,KAAK,UAAU,KAAK,YAAY,IAChC;AAAA,EAEJ;AACF;AAEA,IAAM,cAAN,cAA0B,KAAwC;AAAA,EAChE,YAAY,MAAc,cAAwB,aAAsB;AACtE,UAAM,MAAM,gBAAgB,OAAO,WAAW;AAAA,EAChD;AAAA,EAEA,WAAW,KAA6B;AACtC,QAAI,QAAQ,MAAM;AAEhB,aAAO;AAAA,IACT;AACA,UAAM,IAAI,YAAY;AACtB,QAAI,QAAQ,OAAO,QAAQ,UAAU,OAAO,KAAK;AAC/C,aAAO;AAAA,IACT,WAAW,QAAQ,OAAO,QAAQ,WAAW,OAAO,KAAK;AACvD,aAAO;AAAA,IACT,OAAO;AACL,YAAM,MAAM,2BAA2B,MAAM,GAAG;AAAA,IAClD;AAAA,EACF;AAAA,EAEA,MAAe;AACb,WAAO,CAAC,CAAC,MAAM,IAAI;AAAA,EACrB;AAAA,EAEA,eAAuB;AACrB,WACE,SAAS,aAAa,KAAK,OAAO,OAAO,KAAK,aAAa,EAAE,IAC7D,qBAEA,KAAK,UAAU,KAAK,YAAY,IAChC;AAAA,EAEJ;AACF;AAEA,IAAM,cAAN,cAA0B,KAAsC;AAAA,EAC9D,YAAY,MAAc,cAAuB,aAAsB;AACrE,UAAM,MAAM,gBAAgB,GAAG,WAAW;AAAA,EAC5C;AAAA,EAEA,WAAW,KAAqB;AAC9B,QAAI,MAAM,OAAO,GAAG,CAAC,KAAK,SAAS,KAAK,EAAE,MAAM,OAAO,GAAG,GAAG;AAC3D,YAAM,MAAM,2BAA2B,MAAM,GAAG;AAAA,IAClD;AACA,WAAO,OAAO,GAAG;AAAA,EACnB;AAAA,EAEA,eAAuB;AACrB,WAAO,MAAM,aAAa,IAAI;AAAA,EAChC;AACF;AAEA,IAAM,aAAN,cAAyB,KAAsC;AAAA,EAC7D,YAAY,MAAc,cAAuB,aAAsB;AACrE,UAAM,MAAM,gBAAgB,GAAG,WAAW;AAAA,EAC5C;AAAA,EAEA,WAAW,KAA4B;AACrC,QAAI,MAAM,OAAO,GAAG,CAAC,GAAG;AACtB,YAAM,MAAM,0BAA0B,MAAM,GAAG;AAAA,IACjD;AACA,WAAO,OAAO,GAAG;AAAA,EACnB;AAAA,EAEA,eAAuB;AACrB,WAAO,MAAM,aAAa,IAAI;AAAA,EAChC;AACF;AAEA,IAAM,aAAN,cAAyB,KAAsC;AAAA,EAC7D,YAAY,MAAc,cAAuB,aAAsB;AACrE,UAAM,MAAM,gBAAgB,IAAI,WAAW;AAAA,EAC7C;AAAA,EAEA,WAAW,KAA4B;AACrC,QAAI,QAAQ,MAAM;AAChB,YAAM,MAAM,0BAA0B,MAAM,GAAG;AAAA,IACjD;AACA,WAAO;AAAA,EACT;AAAA,EAEA,eAAuB;AACrB,WAAO,MAAM,aAAa,IAAI;AAAA,EAChC;AACF;AAEA,IAAM,iBAAN,cAA6B,KAA0C;AAAA,EACrE,YAAY,MAAc,cAAyB,aAAsB;AACvE,UAAM,MAAM,gBAAgB,CAAC,GAAG,WAAW;AAAA,EAC7C;AAAA,EAEA,WAAW,KAA8B;AACvC,QAAI,QAAQ,KAAM,QAAO,CAAC;AAAA,QACrB,QAAO,IAAI,MAAM,GAAG;AAAA,EAC3B;AACF;AAEA,IAAM,kBAAN,cAA8B,KAA0C;AAAA,EACtE,YAAY,MAAc,cAAyB,aAAsB;AACvE,UAAM,MAAM,gBAAgB,CAAC,GAAG,WAAW;AAAA,EAC7C;AAAA,EAEA,IAAI,OAAuB;AACzB,QAAI,KAAK,UAAW,MAAK,UAAU,KAAK;AACxC,QAAI,CAAC,KAAK,aAAc,MAAK,eAAe,CAAC;AAC7C,SAAK,aAAa,KAAK,GAAG,KAAK;AAC/B,SAAK,QAAQ;AAAA,EACf;AACF;AAGA,SAAS,wBAA8B;AACrC,gBAAc,MAAM,EAAE,eAAe,uBAAuB,EAAE,UAAU,IAAI;AAE9E;AAEA,sBAAsB;","names":[]}
|
package/dist/flags.d.cts
CHANGED
|
@@ -6,7 +6,9 @@ interface IFlag<T> {
|
|
|
6
6
|
validator?: (input: T | null) => boolean;
|
|
7
7
|
isSecret: boolean;
|
|
8
8
|
isSet: boolean;
|
|
9
|
+
isRequired: boolean;
|
|
9
10
|
setDefault(defaultValue: T): this;
|
|
11
|
+
setRequired(required: boolean): this;
|
|
10
12
|
setDescription(description: string): this;
|
|
11
13
|
setValidator(validator: (input: T | null) => boolean): this;
|
|
12
14
|
setSecret(isSecret: boolean): this;
|
|
@@ -51,7 +53,7 @@ declare function defineInteger(name: string, defaultValue?: number, description?
|
|
|
51
53
|
*/
|
|
52
54
|
declare function defineNumber(name: string, defaultValue?: number, description?: string): IFlag<number>;
|
|
53
55
|
/**
|
|
54
|
-
* Defines a string list flag. e.g. --
|
|
56
|
+
* Defines a string list flag. e.g. --animal=frog,bat,chicken
|
|
55
57
|
*/
|
|
56
58
|
declare function defineStringList(name: string, defaultValue?: string[], description?: string): IFlag<string[]>;
|
|
57
59
|
/**
|
package/dist/flags.d.ts
CHANGED
|
@@ -6,7 +6,9 @@ interface IFlag<T> {
|
|
|
6
6
|
validator?: (input: T | null) => boolean;
|
|
7
7
|
isSecret: boolean;
|
|
8
8
|
isSet: boolean;
|
|
9
|
+
isRequired: boolean;
|
|
9
10
|
setDefault(defaultValue: T): this;
|
|
11
|
+
setRequired(required: boolean): this;
|
|
10
12
|
setDescription(description: string): this;
|
|
11
13
|
setValidator(validator: (input: T | null) => boolean): this;
|
|
12
14
|
setSecret(isSecret: boolean): this;
|
|
@@ -51,7 +53,7 @@ declare function defineInteger(name: string, defaultValue?: number, description?
|
|
|
51
53
|
*/
|
|
52
54
|
declare function defineNumber(name: string, defaultValue?: number, description?: string): IFlag<number>;
|
|
53
55
|
/**
|
|
54
|
-
* Defines a string list flag. e.g. --
|
|
56
|
+
* Defines a string list flag. e.g. --animal=frog,bat,chicken
|
|
55
57
|
*/
|
|
56
58
|
declare function defineStringList(name: string, defaultValue?: string[], description?: string): IFlag<string[]>;
|
|
57
59
|
/**
|
package/dist/flags.js
CHANGED
|
@@ -98,11 +98,19 @@ function parse(args = process.argv.slice(2), ignoreUnrecognized) {
|
|
|
98
98
|
help();
|
|
99
99
|
process.exit(0);
|
|
100
100
|
}
|
|
101
|
+
Object.keys(FLAGS).forEach((key) => {
|
|
102
|
+
if (FLAGS[key].isRequired && !FLAGS[key].isSet) {
|
|
103
|
+
throwFlagParseError(args, -1, 'Missing required flag "--' + key + '"');
|
|
104
|
+
}
|
|
105
|
+
});
|
|
101
106
|
return [];
|
|
102
107
|
}
|
|
103
108
|
var parseCalled = false;
|
|
104
109
|
function throwFlagParseError(args, i, msg) {
|
|
105
|
-
|
|
110
|
+
let errorMsg = "FLAG PARSING ERROR: " + msg;
|
|
111
|
+
if (i > -1) {
|
|
112
|
+
errorMsg += "\n " + args.join(" ") + "\n " + new Array(args.slice(0, i).join(" ").length + 2).join(" ") + new Array(args[i].length + 1).join("^");
|
|
113
|
+
}
|
|
106
114
|
if (exitOnError) {
|
|
107
115
|
console.error(errorMsg);
|
|
108
116
|
process.exit(1);
|
|
@@ -155,25 +163,36 @@ var Flag = class {
|
|
|
155
163
|
__publicField(this, "validator");
|
|
156
164
|
__publicField(this, "isSecret");
|
|
157
165
|
__publicField(this, "isSet");
|
|
166
|
+
__publicField(this, "isRequired");
|
|
158
167
|
this.name = name;
|
|
159
168
|
this.defaultValue = defaultValue;
|
|
160
169
|
this.description = description;
|
|
161
170
|
this.currentValue = null;
|
|
162
171
|
this.isSecret = false;
|
|
163
172
|
this.isSet = false;
|
|
173
|
+
this.isRequired = false;
|
|
164
174
|
}
|
|
175
|
+
/** Set a default value. */
|
|
165
176
|
setDefault(defaultValue) {
|
|
166
177
|
this.defaultValue = defaultValue;
|
|
167
178
|
return this;
|
|
168
179
|
}
|
|
180
|
+
/** Set whether this flag is required. */
|
|
181
|
+
setRequired(isRequired) {
|
|
182
|
+
this.isRequired = isRequired;
|
|
183
|
+
return this;
|
|
184
|
+
}
|
|
185
|
+
/** Set a description for use in the help message. */
|
|
169
186
|
setDescription(description) {
|
|
170
187
|
this.description = description;
|
|
171
188
|
return this;
|
|
172
189
|
}
|
|
190
|
+
/** Set a custom validator. */
|
|
173
191
|
setValidator(validator) {
|
|
174
192
|
this.validator = validator;
|
|
175
193
|
return this;
|
|
176
194
|
}
|
|
195
|
+
/** Hide this flag from the help message. */
|
|
177
196
|
setSecret(isSecret) {
|
|
178
197
|
this.isSecret = isSecret;
|
|
179
198
|
return this;
|
package/dist/flags.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/flags.ts"],"sourcesContent":["// Define interfaces for our flag types\ninterface IFlag<T> {\n name: string;\n defaultValue: T;\n description?: string;\n currentValue: T | null;\n validator?: (input: T | null) => boolean;\n isSecret: boolean;\n isSet: boolean;\n setDefault(defaultValue: T): this;\n setDescription(description: string): this;\n setValidator(validator: (input: T | null) => boolean): this;\n setSecret(isSecret: boolean): this;\n set(input: T): void;\n get(): T | null;\n parseInput(inp: string): T | null;\n toHelpString(): string;\n}\n\n// Define the global flags object\ndeclare global {\n var GLOBAL_FLAGS: { [key: string]: IFlag<any> };\n}\n\nif (typeof global.GLOBAL_FLAGS === \"undefined\") {\n global.GLOBAL_FLAGS = {};\n}\n\nconst FLAGS: { [key: string]: IFlag<any> } = global.GLOBAL_FLAGS;\n\n/**\n * An object containing a map of flag objects. If different modules are\n * importing different versions of the library we want them to use the same\n * FLAGS object. This does mean that the flags library needs to be backwards\n * compatible.\n */\nexport { FLAGS };\n\nlet exitOnError = true;\n\nlet usageInfo =\n \"Usage: node \" + (process.argv[1] || \"\").split(\"/\").pop() + \" [options]\";\n\n/**\n * If true, then the process will be nicely exit on a parse error. If false,\n * an Error will be thrown. Set to false in tests.\n */\nexport function setExitOnError(value: boolean) {\n exitOnError = value;\n}\n\n/**\n * Allows an app to add extra usage information that will be shown in the help\n * message, above the flags.\n */\nexport function setUsageInfo(value: string) {\n usageInfo = value;\n}\n\n/**\n * Defines a string flag. e.g. --servername=bob\n */\nexport function defineString(\n name: string,\n defaultValue?: string,\n description?: string\n): IFlag<string> {\n return addFlag(name, new StringFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a boolean flag. e.g. --turnonlights\n */\nexport function defineBoolean(\n name: string,\n defaultValue?: boolean,\n description?: string\n): IFlag<boolean> {\n return addFlag(name, new BooleanFlag(name, defaultValue, description));\n}\n\n/**\n * Defines an integer flag. e.g. --age=12\n */\nexport function defineInteger(\n name: string,\n defaultValue?: number,\n description?: string\n): IFlag<number> {\n return addFlag(name, new IntegerFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a number flag. e.g. --number=1.345\n */\nexport function defineNumber(\n name: string,\n defaultValue?: number,\n description?: string\n): IFlag<number> {\n return addFlag(name, new NumberFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a string list flag. e.g. --anmial=frog,bat,chicken\n */\nexport function defineStringList(\n name: string,\n defaultValue?: string[],\n description?: string\n): IFlag<string[]> {\n return addFlag(name, new StringListFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a multi string flag. e.g. --allowedip=127.0.0.1 --allowedip=127.0.0.2\n */\nexport function defineMultiString(\n name: string,\n defaultValue?: string[],\n description?: string\n): IFlag<string[]> {\n return addFlag(name, new MultiStringFlag(name, defaultValue, description));\n}\n\n/**\n * Dumps the help text to the console.\n */\nexport function help(): void {\n if (usageInfo) {\n console.log(usageInfo + \"\\n\");\n }\n console.log(\"Options:\");\n for (const flag in FLAGS) {\n if (!FLAGS[flag].isSecret) {\n console.log(FLAGS[flag].toHelpString());\n }\n }\n}\n\n/**\n * Resets the flag values.\n */\nexport function reset(): void {\n parseCalled = false;\n Object.keys(FLAGS).forEach((key) => delete FLAGS[key]);\n registerInternalFlags();\n}\n\n/**\n * Gets the current value of the given flag.\n */\nexport function get(name: string): unknown {\n if (!FLAGS[name]) throw Error('Unknown flag \"' + name + '\"');\n return FLAGS[name].get();\n}\n\n/**\n * Gets whether or not the flag was set.\n */\nexport function isSet(name: string): boolean {\n if (!FLAGS[name]) throw Error('Unknown flag \"' + name + '\"');\n return FLAGS[name].isSet;\n}\n\n/**\n * Parses process.argv for flags. Idempotent if called multiple times.\n */\nexport function parse(\n args: string[] = process.argv.slice(2),\n ignoreUnrecognized?: boolean\n): string[] {\n if (parseCalled) return [];\n\n for (let i = 0; i < args.length; i++) {\n const arg = args[i];\n\n if (arg == \"--\") {\n return args.slice(i + 1);\n } else if (arg.startsWith(\"--\")) {\n let flag = arg.slice(2);\n let value: string | null = null;\n if (flag.indexOf(\"=\") > -1) {\n const parts = flag.split(\"=\");\n flag = parts[0];\n value = parts.slice(1).join(\"=\");\n }\n\n if (value == null && args[i + 1] && !args[i + 1].startsWith(\"--\")) {\n args[i] = args[i] + \" \" + args[i + 1];\n value = args[i + 1];\n args.splice(i + 1, 1);\n }\n\n if (!FLAGS[flag] && value == null && flag.startsWith(\"no\")) {\n flag = flag.slice(2);\n value = \"0\";\n }\n\n if (FLAGS[flag]) {\n try {\n FLAGS[flag].set(value);\n } catch (e) {\n throwFlagParseError(args, i, (e as Error).message);\n }\n } else if (!ignoreUnrecognized) {\n throwFlagParseError(args, i, 'Unrecognized flag name \"' + arg + '\"');\n }\n } else {\n throwFlagParseError(args, i, 'Invalid argument \"' + arg + '\"');\n }\n }\n\n parseCalled = true;\n\n if (FLAGS.help.get()) {\n help();\n process.exit(0);\n }\n\n return [];\n}\n\n// Private helpers\nlet parseCalled = false;\n\nfunction throwFlagParseError(args: string[], i: number, msg: string): void {\n const errorMsg =\n \"FLAG PARSING ERROR: \" +\n msg +\n \"\\n \" +\n args.join(\" \") +\n \"\\n \" +\n new Array(args.slice(0, i).join(\" \").length + 2).join(\" \") +\n new Array(args[i].length + 1).join(\"^\");\n\n if (exitOnError) {\n console.error(errorMsg);\n process.exit(1);\n } else {\n throw Error(errorMsg);\n }\n}\n\nfunction addFlag<T>(name: string, flag: IFlag<T>): IFlag<T> {\n if (parseCalled) throw Error(\"Can not register new flags after parse()\");\n if (FLAGS[name]) throw Error('Flag already defined: \"' + name + '\"');\n FLAGS[name] = flag;\n return flag;\n}\n\nfunction wrapText(text: string, maxLen: number): string {\n const lines = text.split(\"\\n\");\n const out: string[] = [];\n lines.forEach((line) => {\n const maxLenx = maxLen + (out.length == 0 ? 4 : 0);\n if (line.length < maxLenx) {\n out.push(line);\n } else {\n const current = wrapLine(line, \" \", maxLenx, out);\n if (current != \"\") {\n out.push(current);\n }\n }\n });\n return out.join(\"\\n \");\n}\n\nfunction wrapLine(\n line: string,\n delimiter: string,\n maxLen: number,\n out: string[]\n): string {\n const parts = line.split(delimiter);\n let current = \"\";\n parts.forEach((part) => {\n const next = current + part + delimiter;\n if (next.length > maxLen) {\n out.push(current);\n current = part + delimiter;\n } else {\n current = next;\n }\n });\n return current;\n}\n\nclass Flag<T> implements IFlag<T> {\n name: string;\n defaultValue: T;\n description?: string;\n currentValue: T | null;\n validator?: (input: T | null) => boolean;\n isSecret: boolean;\n isSet: boolean;\n\n constructor(name: string, defaultValue: T, description?: string) {\n this.name = name;\n this.defaultValue = defaultValue;\n this.description = description;\n this.currentValue = null;\n this.isSecret = false;\n this.isSet = false;\n }\n\n setDefault(defaultValue: T): this {\n this.defaultValue = defaultValue;\n return this;\n }\n\n setDescription(description: string): this {\n this.description = description;\n return this;\n }\n\n setValidator(validator: (input: T | null) => boolean): this {\n this.validator = validator;\n return this;\n }\n\n setSecret(isSecret: boolean): this {\n this.isSecret = isSecret;\n return this;\n }\n\n set(input: T | string): void {\n if (this.isSet) {\n throw Error(\"Flag already set\");\n }\n if (typeof input === \"string\") {\n this.currentValue = this.parseInput(input);\n } else if (input === null) {\n this.currentValue = this.parseInput(null);\n } else {\n this.currentValue = input;\n }\n if (this.validator) this.validator(this.currentValue);\n this.isSet = true;\n }\n\n get(): T | null {\n return this.isSet ? this.currentValue : this.defaultValue;\n }\n\n parseInput(_inp: string | null): T | null {\n throw Error(\"Not implemented\");\n }\n\n toHelpString(): string {\n return (\n wrapText(\" --\" + this.name + \": \" + this.description, 70) +\n \"\\n\" +\n \" (default: \" +\n JSON.stringify(this.defaultValue) +\n \")\"\n );\n }\n}\n\nclass BooleanFlag extends Flag<boolean> implements IFlag<boolean> {\n constructor(name: string, defaultValue?: boolean, description?: string) {\n super(name, defaultValue ?? false, description);\n }\n\n parseInput(inp: string | null): boolean {\n if (inp === null) {\n // Empty flag value means true for a boolean flag.\n return true;\n }\n inp = inp.toLowerCase();\n if (inp === \"1\" || inp === \"true\" || inp == \"t\") {\n return true;\n } else if (inp === \"0\" || inp === \"false\" || inp == \"f\") {\n return false;\n } else {\n throw Error('Invalid Boolean flag \"' + inp + '\"');\n }\n }\n\n get(): boolean {\n return !!super.get();\n }\n\n toHelpString(): string {\n return (\n wrapText(\" --[no]\" + this.name + \": \" + this.description, 70) +\n \"\\n\" +\n \" (default: \" +\n JSON.stringify(this.defaultValue) +\n \")\"\n );\n }\n}\n\nclass IntegerFlag extends Flag<number> implements IFlag<number> {\n constructor(name: string, defaultValue?: number, description?: string) {\n super(name, defaultValue ?? 0, description);\n }\n\n parseInput(inp: string): number {\n if (isNaN(Number(inp)) || parseInt(inp, 10) !== Number(inp)) {\n throw Error('Invalid Integer flag \"' + inp + '\"');\n }\n return Number(inp);\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (an integer)\";\n }\n}\n\nclass NumberFlag extends Flag<number> implements IFlag<number> {\n constructor(name: string, defaultValue?: number, description?: string) {\n super(name, defaultValue ?? 0, description);\n }\n\n parseInput(inp: string | null): number {\n if (isNaN(Number(inp))) {\n throw Error('Invalid Number flag \"' + inp + '\"');\n }\n return Number(inp);\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (a number)\";\n }\n}\n\nclass StringFlag extends Flag<string> implements IFlag<string> {\n constructor(name: string, defaultValue?: string, description?: string) {\n super(name, defaultValue ?? \"\", description);\n }\n\n parseInput(inp: string | null): string {\n if (inp === null) {\n throw Error('Invalid String flag \"' + inp + '\"');\n }\n return inp;\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (a string)\";\n }\n}\n\nclass StringListFlag extends Flag<string[]> implements IFlag<string[]> {\n constructor(name: string, defaultValue?: string[], description?: string) {\n super(name, defaultValue ?? [], description);\n }\n\n parseInput(inp: string | null): string[] {\n if (inp === null) return [];\n else return inp.split(\",\");\n }\n}\n\nclass MultiStringFlag extends Flag<string[]> implements IFlag<string[]> {\n constructor(name: string, defaultValue?: string[], description?: string) {\n super(name, defaultValue ?? [], description);\n }\n\n set(input: string[]): void {\n if (this.validator) this.validator(input);\n if (!this.currentValue) this.currentValue = [];\n this.currentValue.push(...input);\n this.isSet = true;\n }\n}\n\n// Internal flags\nfunction registerInternalFlags(): void {\n defineBoolean(\"help\").setDescription(\"Shows this help text.\").setSecret(true);\n // TODO: --flagsfile\n}\n\nregisterInternalFlags();\n"],"mappings":";;;;;AAwBA,IAAI,OAAO,OAAO,iBAAiB,aAAa;AAC9C,SAAO,eAAe,CAAC;AACzB;AAEA,IAAM,QAAuC,OAAO;AAUpD,IAAI,cAAc;AAElB,IAAI,YACF,kBAAkB,QAAQ,KAAK,CAAC,KAAK,IAAI,MAAM,GAAG,EAAE,IAAI,IAAI;AAMvD,SAAS,eAAe,OAAgB;AAC7C,gBAAc;AAChB;AAMO,SAAS,aAAa,OAAe;AAC1C,cAAY;AACd;AAKO,SAAS,aACd,MACA,cACA,aACe;AACf,SAAO,QAAQ,MAAM,IAAI,WAAW,MAAM,cAAc,WAAW,CAAC;AACtE;AAKO,SAAS,cACd,MACA,cACA,aACgB;AAChB,SAAO,QAAQ,MAAM,IAAI,YAAY,MAAM,cAAc,WAAW,CAAC;AACvE;AAKO,SAAS,cACd,MACA,cACA,aACe;AACf,SAAO,QAAQ,MAAM,IAAI,YAAY,MAAM,cAAc,WAAW,CAAC;AACvE;AAKO,SAAS,aACd,MACA,cACA,aACe;AACf,SAAO,QAAQ,MAAM,IAAI,WAAW,MAAM,cAAc,WAAW,CAAC;AACtE;AAKO,SAAS,iBACd,MACA,cACA,aACiB;AACjB,SAAO,QAAQ,MAAM,IAAI,eAAe,MAAM,cAAc,WAAW,CAAC;AAC1E;AAKO,SAAS,kBACd,MACA,cACA,aACiB;AACjB,SAAO,QAAQ,MAAM,IAAI,gBAAgB,MAAM,cAAc,WAAW,CAAC;AAC3E;AAKO,SAAS,OAAa;AAC3B,MAAI,WAAW;AACb,YAAQ,IAAI,YAAY,IAAI;AAAA,EAC9B;AACA,UAAQ,IAAI,UAAU;AACtB,aAAW,QAAQ,OAAO;AACxB,QAAI,CAAC,MAAM,IAAI,EAAE,UAAU;AACzB,cAAQ,IAAI,MAAM,IAAI,EAAE,aAAa,CAAC;AAAA,IACxC;AAAA,EACF;AACF;AAKO,SAAS,QAAc;AAC5B,gBAAc;AACd,SAAO,KAAK,KAAK,EAAE,QAAQ,CAAC,QAAQ,OAAO,MAAM,GAAG,CAAC;AACrD,wBAAsB;AACxB;AAKO,SAAS,IAAI,MAAuB;AACzC,MAAI,CAAC,MAAM,IAAI,EAAG,OAAM,MAAM,mBAAmB,OAAO,GAAG;AAC3D,SAAO,MAAM,IAAI,EAAE,IAAI;AACzB;AAKO,SAAS,MAAM,MAAuB;AAC3C,MAAI,CAAC,MAAM,IAAI,EAAG,OAAM,MAAM,mBAAmB,OAAO,GAAG;AAC3D,SAAO,MAAM,IAAI,EAAE;AACrB;AAKO,SAAS,MACd,OAAiB,QAAQ,KAAK,MAAM,CAAC,GACrC,oBACU;AACV,MAAI,YAAa,QAAO,CAAC;AAEzB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAElB,QAAI,OAAO,MAAM;AACf,aAAO,KAAK,MAAM,IAAI,CAAC;AAAA,IACzB,WAAW,IAAI,WAAW,IAAI,GAAG;AAC/B,UAAI,OAAO,IAAI,MAAM,CAAC;AACtB,UAAI,QAAuB;AAC3B,UAAI,KAAK,QAAQ,GAAG,IAAI,IAAI;AAC1B,cAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,eAAO,MAAM,CAAC;AACd,gBAAQ,MAAM,MAAM,CAAC,EAAE,KAAK,GAAG;AAAA,MACjC;AAEA,UAAI,SAAS,QAAQ,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,EAAE,WAAW,IAAI,GAAG;AACjE,aAAK,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,KAAK,IAAI,CAAC;AACpC,gBAAQ,KAAK,IAAI,CAAC;AAClB,aAAK,OAAO,IAAI,GAAG,CAAC;AAAA,MACtB;AAEA,UAAI,CAAC,MAAM,IAAI,KAAK,SAAS,QAAQ,KAAK,WAAW,IAAI,GAAG;AAC1D,eAAO,KAAK,MAAM,CAAC;AACnB,gBAAQ;AAAA,MACV;AAEA,UAAI,MAAM,IAAI,GAAG;AACf,YAAI;AACF,gBAAM,IAAI,EAAE,IAAI,KAAK;AAAA,QACvB,SAAS,GAAG;AACV,8BAAoB,MAAM,GAAI,EAAY,OAAO;AAAA,QACnD;AAAA,MACF,WAAW,CAAC,oBAAoB;AAC9B,4BAAoB,MAAM,GAAG,6BAA6B,MAAM,GAAG;AAAA,MACrE;AAAA,IACF,OAAO;AACL,0BAAoB,MAAM,GAAG,uBAAuB,MAAM,GAAG;AAAA,IAC/D;AAAA,EACF;AAEA,gBAAc;AAEd,MAAI,MAAM,KAAK,IAAI,GAAG;AACpB,SAAK;AACL,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,SAAO,CAAC;AACV;AAGA,IAAI,cAAc;AAElB,SAAS,oBAAoB,MAAgB,GAAW,KAAmB;AACzE,QAAM,WACJ,yBACA,MACA,SACA,KAAK,KAAK,GAAG,IACb,QACA,IAAI,MAAM,KAAK,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,IACzD,IAAI,MAAM,KAAK,CAAC,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG;AAExC,MAAI,aAAa;AACf,YAAQ,MAAM,QAAQ;AACtB,YAAQ,KAAK,CAAC;AAAA,EAChB,OAAO;AACL,UAAM,MAAM,QAAQ;AAAA,EACtB;AACF;AAEA,SAAS,QAAW,MAAc,MAA0B;AAC1D,MAAI,YAAa,OAAM,MAAM,0CAA0C;AACvE,MAAI,MAAM,IAAI,EAAG,OAAM,MAAM,4BAA4B,OAAO,GAAG;AACnE,QAAM,IAAI,IAAI;AACd,SAAO;AACT;AAEA,SAAS,SAAS,MAAc,QAAwB;AACtD,QAAM,QAAQ,KAAK,MAAM,IAAI;AAC7B,QAAM,MAAgB,CAAC;AACvB,QAAM,QAAQ,CAAC,SAAS;AACtB,UAAM,UAAU,UAAU,IAAI,UAAU,IAAI,IAAI;AAChD,QAAI,KAAK,SAAS,SAAS;AACzB,UAAI,KAAK,IAAI;AAAA,IACf,OAAO;AACL,YAAM,UAAU,SAAS,MAAM,KAAK,SAAS,GAAG;AAChD,UAAI,WAAW,IAAI;AACjB,YAAI,KAAK,OAAO;AAAA,MAClB;AAAA,IACF;AAAA,EACF,CAAC;AACD,SAAO,IAAI,KAAK,QAAQ;AAC1B;AAEA,SAAS,SACP,MACA,WACA,QACA,KACQ;AACR,QAAM,QAAQ,KAAK,MAAM,SAAS;AAClC,MAAI,UAAU;AACd,QAAM,QAAQ,CAAC,SAAS;AACtB,UAAM,OAAO,UAAU,OAAO;AAC9B,QAAI,KAAK,SAAS,QAAQ;AACxB,UAAI,KAAK,OAAO;AAChB,gBAAU,OAAO;AAAA,IACnB,OAAO;AACL,gBAAU;AAAA,IACZ;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAEA,IAAM,OAAN,MAAkC;AAAA,EAShC,YAAY,MAAc,cAAiB,aAAsB;AARjE;AACA;AACA;AACA;AACA;AACA;AACA;AAGE,SAAK,OAAO;AACZ,SAAK,eAAe;AACpB,SAAK,cAAc;AACnB,SAAK,eAAe;AACpB,SAAK,WAAW;AAChB,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,WAAW,cAAuB;AAChC,SAAK,eAAe;AACpB,WAAO;AAAA,EACT;AAAA,EAEA,eAAe,aAA2B;AACxC,SAAK,cAAc;AACnB,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,WAA+C;AAC1D,SAAK,YAAY;AACjB,WAAO;AAAA,EACT;AAAA,EAEA,UAAU,UAAyB;AACjC,SAAK,WAAW;AAChB,WAAO;AAAA,EACT;AAAA,EAEA,IAAI,OAAyB;AAC3B,QAAI,KAAK,OAAO;AACd,YAAM,MAAM,kBAAkB;AAAA,IAChC;AACA,QAAI,OAAO,UAAU,UAAU;AAC7B,WAAK,eAAe,KAAK,WAAW,KAAK;AAAA,IAC3C,WAAW,UAAU,MAAM;AACzB,WAAK,eAAe,KAAK,WAAW,IAAI;AAAA,IAC1C,OAAO;AACL,WAAK,eAAe;AAAA,IACtB;AACA,QAAI,KAAK,UAAW,MAAK,UAAU,KAAK,YAAY;AACpD,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,MAAgB;AACd,WAAO,KAAK,QAAQ,KAAK,eAAe,KAAK;AAAA,EAC/C;AAAA,EAEA,WAAW,MAA+B;AACxC,UAAM,MAAM,iBAAiB;AAAA,EAC/B;AAAA,EAEA,eAAuB;AACrB,WACE,SAAS,SAAS,KAAK,OAAO,OAAO,KAAK,aAAa,EAAE,IACzD,qBAEA,KAAK,UAAU,KAAK,YAAY,IAChC;AAAA,EAEJ;AACF;AAEA,IAAM,cAAN,cAA0B,KAAwC;AAAA,EAChE,YAAY,MAAc,cAAwB,aAAsB;AACtE,UAAM,MAAM,gBAAgB,OAAO,WAAW;AAAA,EAChD;AAAA,EAEA,WAAW,KAA6B;AACtC,QAAI,QAAQ,MAAM;AAEhB,aAAO;AAAA,IACT;AACA,UAAM,IAAI,YAAY;AACtB,QAAI,QAAQ,OAAO,QAAQ,UAAU,OAAO,KAAK;AAC/C,aAAO;AAAA,IACT,WAAW,QAAQ,OAAO,QAAQ,WAAW,OAAO,KAAK;AACvD,aAAO;AAAA,IACT,OAAO;AACL,YAAM,MAAM,2BAA2B,MAAM,GAAG;AAAA,IAClD;AAAA,EACF;AAAA,EAEA,MAAe;AACb,WAAO,CAAC,CAAC,MAAM,IAAI;AAAA,EACrB;AAAA,EAEA,eAAuB;AACrB,WACE,SAAS,aAAa,KAAK,OAAO,OAAO,KAAK,aAAa,EAAE,IAC7D,qBAEA,KAAK,UAAU,KAAK,YAAY,IAChC;AAAA,EAEJ;AACF;AAEA,IAAM,cAAN,cAA0B,KAAsC;AAAA,EAC9D,YAAY,MAAc,cAAuB,aAAsB;AACrE,UAAM,MAAM,gBAAgB,GAAG,WAAW;AAAA,EAC5C;AAAA,EAEA,WAAW,KAAqB;AAC9B,QAAI,MAAM,OAAO,GAAG,CAAC,KAAK,SAAS,KAAK,EAAE,MAAM,OAAO,GAAG,GAAG;AAC3D,YAAM,MAAM,2BAA2B,MAAM,GAAG;AAAA,IAClD;AACA,WAAO,OAAO,GAAG;AAAA,EACnB;AAAA,EAEA,eAAuB;AACrB,WAAO,MAAM,aAAa,IAAI;AAAA,EAChC;AACF;AAEA,IAAM,aAAN,cAAyB,KAAsC;AAAA,EAC7D,YAAY,MAAc,cAAuB,aAAsB;AACrE,UAAM,MAAM,gBAAgB,GAAG,WAAW;AAAA,EAC5C;AAAA,EAEA,WAAW,KAA4B;AACrC,QAAI,MAAM,OAAO,GAAG,CAAC,GAAG;AACtB,YAAM,MAAM,0BAA0B,MAAM,GAAG;AAAA,IACjD;AACA,WAAO,OAAO,GAAG;AAAA,EACnB;AAAA,EAEA,eAAuB;AACrB,WAAO,MAAM,aAAa,IAAI;AAAA,EAChC;AACF;AAEA,IAAM,aAAN,cAAyB,KAAsC;AAAA,EAC7D,YAAY,MAAc,cAAuB,aAAsB;AACrE,UAAM,MAAM,gBAAgB,IAAI,WAAW;AAAA,EAC7C;AAAA,EAEA,WAAW,KAA4B;AACrC,QAAI,QAAQ,MAAM;AAChB,YAAM,MAAM,0BAA0B,MAAM,GAAG;AAAA,IACjD;AACA,WAAO;AAAA,EACT;AAAA,EAEA,eAAuB;AACrB,WAAO,MAAM,aAAa,IAAI;AAAA,EAChC;AACF;AAEA,IAAM,iBAAN,cAA6B,KAA0C;AAAA,EACrE,YAAY,MAAc,cAAyB,aAAsB;AACvE,UAAM,MAAM,gBAAgB,CAAC,GAAG,WAAW;AAAA,EAC7C;AAAA,EAEA,WAAW,KAA8B;AACvC,QAAI,QAAQ,KAAM,QAAO,CAAC;AAAA,QACrB,QAAO,IAAI,MAAM,GAAG;AAAA,EAC3B;AACF;AAEA,IAAM,kBAAN,cAA8B,KAA0C;AAAA,EACtE,YAAY,MAAc,cAAyB,aAAsB;AACvE,UAAM,MAAM,gBAAgB,CAAC,GAAG,WAAW;AAAA,EAC7C;AAAA,EAEA,IAAI,OAAuB;AACzB,QAAI,KAAK,UAAW,MAAK,UAAU,KAAK;AACxC,QAAI,CAAC,KAAK,aAAc,MAAK,eAAe,CAAC;AAC7C,SAAK,aAAa,KAAK,GAAG,KAAK;AAC/B,SAAK,QAAQ;AAAA,EACf;AACF;AAGA,SAAS,wBAA8B;AACrC,gBAAc,MAAM,EAAE,eAAe,uBAAuB,EAAE,UAAU,IAAI;AAE9E;AAEA,sBAAsB;","names":[]}
|
|
1
|
+
{"version":3,"sources":["../src/flags.ts"],"sourcesContent":["// Define interfaces for our flag types\ninterface IFlag<T> {\n name: string;\n defaultValue: T;\n description?: string;\n currentValue: T | null;\n validator?: (input: T | null) => boolean;\n isSecret: boolean;\n isSet: boolean;\n isRequired: boolean;\n setDefault(defaultValue: T): this;\n setRequired(required: boolean): this;\n setDescription(description: string): this;\n setValidator(validator: (input: T | null) => boolean): this;\n setSecret(isSecret: boolean): this;\n set(input: T): void;\n get(): T | null;\n parseInput(inp: string): T | null;\n toHelpString(): string;\n}\n\n// Define the global flags object\ndeclare global {\n var GLOBAL_FLAGS: { [key: string]: IFlag<any> };\n}\n\nif (typeof global.GLOBAL_FLAGS === \"undefined\") {\n global.GLOBAL_FLAGS = {};\n}\n\nconst FLAGS: { [key: string]: IFlag<any> } = global.GLOBAL_FLAGS;\n\n/**\n * An object containing a map of flag objects. If different modules are\n * importing different versions of the library we want them to use the same\n * FLAGS object. This does mean that the flags library needs to be backwards\n * compatible.\n */\nexport { FLAGS };\n\nlet exitOnError = true;\n\nlet usageInfo =\n \"Usage: node \" + (process.argv[1] || \"\").split(\"/\").pop() + \" [options]\";\n\n/**\n * If true, then the process will be nicely exit on a parse error. If false,\n * an Error will be thrown. Set to false in tests.\n */\nexport function setExitOnError(value: boolean) {\n exitOnError = value;\n}\n\n/**\n * Allows an app to add extra usage information that will be shown in the help\n * message, above the flags.\n */\nexport function setUsageInfo(value: string) {\n usageInfo = value;\n}\n\n/**\n * Defines a string flag. e.g. --servername=bob\n */\nexport function defineString(\n name: string,\n defaultValue?: string,\n description?: string\n): IFlag<string> {\n return addFlag(name, new StringFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a boolean flag. e.g. --turnonlights\n */\nexport function defineBoolean(\n name: string,\n defaultValue?: boolean,\n description?: string\n): IFlag<boolean> {\n return addFlag(name, new BooleanFlag(name, defaultValue, description));\n}\n\n/**\n * Defines an integer flag. e.g. --age=12\n */\nexport function defineInteger(\n name: string,\n defaultValue?: number,\n description?: string\n): IFlag<number> {\n return addFlag(name, new IntegerFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a number flag. e.g. --number=1.345\n */\nexport function defineNumber(\n name: string,\n defaultValue?: number,\n description?: string\n): IFlag<number> {\n return addFlag(name, new NumberFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a string list flag. e.g. --animal=frog,bat,chicken\n */\nexport function defineStringList(\n name: string,\n defaultValue?: string[],\n description?: string\n): IFlag<string[]> {\n return addFlag(name, new StringListFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a multi string flag. e.g. --allowedip=127.0.0.1 --allowedip=127.0.0.2\n */\nexport function defineMultiString(\n name: string,\n defaultValue?: string[],\n description?: string\n): IFlag<string[]> {\n return addFlag(name, new MultiStringFlag(name, defaultValue, description));\n}\n\n/**\n * Dumps the help text to the console.\n */\nexport function help(): void {\n if (usageInfo) {\n console.log(usageInfo + \"\\n\");\n }\n console.log(\"Options:\");\n for (const flag in FLAGS) {\n if (!FLAGS[flag].isSecret) {\n console.log(FLAGS[flag].toHelpString());\n }\n }\n}\n\n/**\n * Resets the flag values.\n */\nexport function reset(): void {\n parseCalled = false;\n Object.keys(FLAGS).forEach((key) => delete FLAGS[key]);\n registerInternalFlags();\n}\n\n/**\n * Gets the current value of the given flag.\n */\nexport function get(name: string): unknown {\n if (!FLAGS[name]) throw Error('Unknown flag \"' + name + '\"');\n return FLAGS[name].get();\n}\n\n/**\n * Gets whether or not the flag was set.\n */\nexport function isSet(name: string): boolean {\n if (!FLAGS[name]) throw Error('Unknown flag \"' + name + '\"');\n return FLAGS[name].isSet;\n}\n\n/**\n * Parses process.argv for flags. Idempotent if called multiple times.\n */\nexport function parse(\n args: string[] = process.argv.slice(2),\n ignoreUnrecognized?: boolean\n): string[] {\n if (parseCalled) return [];\n\n for (let i = 0; i < args.length; i++) {\n const arg = args[i];\n\n if (arg == \"--\") {\n return args.slice(i + 1);\n } else if (arg.startsWith(\"--\")) {\n let flag = arg.slice(2);\n let value: string | null = null;\n if (flag.indexOf(\"=\") > -1) {\n const parts = flag.split(\"=\");\n flag = parts[0];\n value = parts.slice(1).join(\"=\");\n }\n\n if (value == null && args[i + 1] && !args[i + 1].startsWith(\"--\")) {\n args[i] = args[i] + \" \" + args[i + 1];\n value = args[i + 1];\n args.splice(i + 1, 1);\n }\n\n if (!FLAGS[flag] && value == null && flag.startsWith(\"no\")) {\n flag = flag.slice(2);\n value = \"0\";\n }\n\n if (FLAGS[flag]) {\n try {\n FLAGS[flag].set(value);\n } catch (e) {\n throwFlagParseError(args, i, (e as Error).message);\n }\n } else if (!ignoreUnrecognized) {\n throwFlagParseError(args, i, 'Unrecognized flag name \"' + arg + '\"');\n }\n } else {\n throwFlagParseError(args, i, 'Invalid argument \"' + arg + '\"');\n }\n }\n\n parseCalled = true;\n\n if (FLAGS.help.get()) {\n help();\n process.exit(0);\n }\n\n Object.keys(FLAGS).forEach((key) => {\n if (FLAGS[key].isRequired && !FLAGS[key].isSet) {\n throwFlagParseError(args, -1, 'Missing required flag \"--' + key + '\"');\n }\n });\n\n return [];\n}\n\n// Private helpers\nlet parseCalled = false;\n\nfunction throwFlagParseError(args: string[], i: number, msg: string): void {\n let errorMsg = \"FLAG PARSING ERROR: \" + msg;\n if (i > -1) {\n errorMsg +=\n \"\\n \" +\n args.join(\" \") +\n \"\\n \" +\n new Array(args.slice(0, i).join(\" \").length + 2).join(\" \") +\n new Array(args[i].length + 1).join(\"^\");\n }\n\n if (exitOnError) {\n console.error(errorMsg);\n process.exit(1);\n } else {\n throw Error(errorMsg);\n }\n}\n\nfunction addFlag<T>(name: string, flag: IFlag<T>): IFlag<T> {\n if (parseCalled) throw Error(\"Can not register new flags after parse()\");\n if (FLAGS[name]) throw Error('Flag already defined: \"' + name + '\"');\n FLAGS[name] = flag;\n return flag;\n}\n\nfunction wrapText(text: string, maxLen: number): string {\n const lines = text.split(\"\\n\");\n const out: string[] = [];\n lines.forEach((line) => {\n const maxLenx = maxLen + (out.length == 0 ? 4 : 0);\n if (line.length < maxLenx) {\n out.push(line);\n } else {\n const current = wrapLine(line, \" \", maxLenx, out);\n if (current != \"\") {\n out.push(current);\n }\n }\n });\n return out.join(\"\\n \");\n}\n\nfunction wrapLine(\n line: string,\n delimiter: string,\n maxLen: number,\n out: string[]\n): string {\n const parts = line.split(delimiter);\n let current = \"\";\n parts.forEach((part) => {\n const next = current + part + delimiter;\n if (next.length > maxLen) {\n out.push(current);\n current = part + delimiter;\n } else {\n current = next;\n }\n });\n return current;\n}\n\nclass Flag<T> implements IFlag<T> {\n name: string;\n defaultValue: T;\n description?: string;\n currentValue: T | null;\n validator?: (input: T | null) => boolean;\n isSecret: boolean;\n isSet: boolean;\n isRequired: boolean;\n\n constructor(name: string, defaultValue: T, description?: string) {\n this.name = name;\n this.defaultValue = defaultValue;\n this.description = description;\n this.currentValue = null;\n this.isSecret = false;\n this.isSet = false;\n this.isRequired = false;\n }\n\n /** Set a default value. */\n setDefault(defaultValue: T): this {\n this.defaultValue = defaultValue;\n return this;\n }\n\n /** Set whether this flag is required. */\n setRequired(isRequired: boolean): this {\n this.isRequired = isRequired;\n return this;\n }\n\n /** Set a description for use in the help message. */\n setDescription(description: string): this {\n this.description = description;\n return this;\n }\n\n /** Set a custom validator. */\n setValidator(validator: (input: T | null) => boolean): this {\n this.validator = validator;\n return this;\n }\n\n /** Hide this flag from the help message. */\n setSecret(isSecret: boolean): this {\n this.isSecret = isSecret;\n return this;\n }\n\n set(input: T | string): void {\n if (this.isSet) {\n throw Error(\"Flag already set\");\n }\n if (typeof input === \"string\") {\n this.currentValue = this.parseInput(input);\n } else if (input === null) {\n this.currentValue = this.parseInput(null);\n } else {\n this.currentValue = input;\n }\n if (this.validator) this.validator(this.currentValue);\n this.isSet = true;\n }\n\n get(): T | null {\n return this.isSet ? this.currentValue : this.defaultValue;\n }\n\n parseInput(_inp: string | null): T | null {\n throw Error(\"Not implemented\");\n }\n\n toHelpString(): string {\n return (\n wrapText(\" --\" + this.name + \": \" + this.description, 70) +\n \"\\n\" +\n \" (default: \" +\n JSON.stringify(this.defaultValue) +\n \")\"\n );\n }\n}\n\nclass BooleanFlag extends Flag<boolean> implements IFlag<boolean> {\n constructor(name: string, defaultValue?: boolean, description?: string) {\n super(name, defaultValue ?? false, description);\n }\n\n parseInput(inp: string | null): boolean {\n if (inp === null) {\n // Empty flag value means true for a boolean flag.\n return true;\n }\n inp = inp.toLowerCase();\n if (inp === \"1\" || inp === \"true\" || inp == \"t\") {\n return true;\n } else if (inp === \"0\" || inp === \"false\" || inp == \"f\") {\n return false;\n } else {\n throw Error('Invalid Boolean flag \"' + inp + '\"');\n }\n }\n\n get(): boolean {\n return !!super.get();\n }\n\n toHelpString(): string {\n return (\n wrapText(\" --[no]\" + this.name + \": \" + this.description, 70) +\n \"\\n\" +\n \" (default: \" +\n JSON.stringify(this.defaultValue) +\n \")\"\n );\n }\n}\n\nclass IntegerFlag extends Flag<number> implements IFlag<number> {\n constructor(name: string, defaultValue?: number, description?: string) {\n super(name, defaultValue ?? 0, description);\n }\n\n parseInput(inp: string): number {\n if (isNaN(Number(inp)) || parseInt(inp, 10) !== Number(inp)) {\n throw Error('Invalid Integer flag \"' + inp + '\"');\n }\n return Number(inp);\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (an integer)\";\n }\n}\n\nclass NumberFlag extends Flag<number> implements IFlag<number> {\n constructor(name: string, defaultValue?: number, description?: string) {\n super(name, defaultValue ?? 0, description);\n }\n\n parseInput(inp: string | null): number {\n if (isNaN(Number(inp))) {\n throw Error('Invalid Number flag \"' + inp + '\"');\n }\n return Number(inp);\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (a number)\";\n }\n}\n\nclass StringFlag extends Flag<string> implements IFlag<string> {\n constructor(name: string, defaultValue?: string, description?: string) {\n super(name, defaultValue ?? \"\", description);\n }\n\n parseInput(inp: string | null): string {\n if (inp === null) {\n throw Error('Invalid String flag \"' + inp + '\"');\n }\n return inp;\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (a string)\";\n }\n}\n\nclass StringListFlag extends Flag<string[]> implements IFlag<string[]> {\n constructor(name: string, defaultValue?: string[], description?: string) {\n super(name, defaultValue ?? [], description);\n }\n\n parseInput(inp: string | null): string[] {\n if (inp === null) return [];\n else return inp.split(\",\");\n }\n}\n\nclass MultiStringFlag extends Flag<string[]> implements IFlag<string[]> {\n constructor(name: string, defaultValue?: string[], description?: string) {\n super(name, defaultValue ?? [], description);\n }\n\n set(input: string[]): void {\n if (this.validator) this.validator(input);\n if (!this.currentValue) this.currentValue = [];\n this.currentValue.push(...input);\n this.isSet = true;\n }\n}\n\n// Internal flags\nfunction registerInternalFlags(): void {\n defineBoolean(\"help\").setDescription(\"Shows this help text.\").setSecret(true);\n // TODO: --flagsfile\n}\n\nregisterInternalFlags();\n"],"mappings":"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","names":[]}
|
package/package.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "flags",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.2",
|
|
4
4
|
"description": "Flag library for node.js",
|
|
5
5
|
"type": "module",
|
|
6
|
-
"main": "dist/
|
|
7
|
-
"types": "dist/
|
|
6
|
+
"main": "dist/flags.js",
|
|
7
|
+
"types": "dist/flags.d.ts",
|
|
8
8
|
"files": [
|
|
9
9
|
"/dist"
|
|
10
10
|
],
|