flags 0.1.3 → 0.2.1

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 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,124 +1,122 @@
1
1
  # Node-Flags
2
2
 
3
- This is a flags library for use with [node.js](http://nodejs.org/). Flag definitions can be distributed across multiple files, as long as they are defined before `flags.parse()` is called.
3
+ A flexible and easy-to-use command-line flag parsing library for Node.js applications.
4
4
 
5
- ## Installation
6
-
7
- Fork the latest source from github, or else use NPM:
8
-
9
- npm install flags
10
-
11
- ## Example
12
-
13
- var flags = require('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', []);
20
-
21
- flags.parse();
22
-
23
- // ====
24
-
25
- var info = [];
26
- info.push('Name : ' + flags.get('name'));
27
- info.push('Age : ' + flags.get('age'));
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
5
+ [![npm version](https://badge.fury.io/js/flags.svg)](https://badge.fury.io/js/flags)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
37
7
 
38
- ## Passing Flags
8
+ ## Features
39
9
 
40
- * Flag names should be prefixed with two dashes: e.g. `--flagname`
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`
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
44
15
 
45
- ## Defining Flags
16
+ ## Installation
46
17
 
47
- To define flags, use one of the defineX functions exported by the `flags` module:
18
+ Install using your favorite package manager:
48
19
 
49
- **flags.defineString** - Takes the raw input from the command line.
20
+ ```bash
21
+ npm install flags
22
+ # or
23
+ yarn add flags
24
+ # or
25
+ pnpm add flags
26
+ ```
50
27
 
51
- **flags.defineBoolean** - Usually doesn't take a value, passing --flag will set the corresponding flag to true. Also supported are --noflag to set it to false and --flag=true or --flag=false or --flag=0 or --flag=1 or --flag=f or --flag=t
28
+ ## Usage
52
29
 
53
- **flags.defineInteger** - Must take a value and will be cast to a Number. Passing a non-integer arg will throw.
30
+ Here's a quick example of how to use Node-Flags:
54
31
 
55
- **flags.defineNumber** - Must take a value and will be cast to a number. Passing an arg that evaluates to NaN will throw.
32
+ ```javascript
33
+ import * as flags from "flags";
56
34
 
57
- **flags.defineStringList** - Takes a comma separated argument list and returns an array as it's value.
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");
58
41
 
59
- **flags.defineMultiString** - Same as defineString but allows multiple flags to be passed. All values will be returned in an array.
42
+ // Parse command-line arguments
43
+ flags.parse();
60
44
 
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
+ ];
61
53
 
62
- All the define methods take the same arguments:
54
+ console.log(info.join("\n"));
55
+ ```
63
56
 
64
- flags.defineX(name, opt_default, opt_description);
57
+ Run your script with flags:
65
58
 
66
- `name` - The flag's name.
67
- `opt_default` - [optional] The default value if not specified on the command line.
68
- `opt_description` - [optional] Description to show in the help text.
59
+ ```bash
60
+ node example.js --name="John Doe" --age=30 --height=1.75 --pets=dog,cat --hobby=reading --hobby=gaming
61
+ ```
69
62
 
70
- The methods return a Flag object that exposes the following methods, for additional configuration:
63
+ ## Defining Flags
71
64
 
72
- `flag.setDefault({*} defaultValue)` - Sets the flag's default value.
73
- `flag.setDescription({string} description)` - Sets the flag's description field.
74
- `flag.setValidator({function(string)} validator)` - Sets a function for validating the input, should throw if the input isn't valid.
75
- `flag.setSecret({boolean} secret)` - If set to true then the flag won't show up in the help text.
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
+ ```
76
88
 
77
- These setters return the flag instance so they can be chained:
89
+ ## Passing Flags
78
90
 
79
- flags.defineString('test').
80
- setDefault('empty').
81
- setDescription('A test flag').
82
- setValidator(function(inp) {
83
- if (inp.substr(0, 1) != 'e') {
84
- throw Error('Flag must start with an "e"');
85
- }
86
- });
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`
87
95
 
88
96
  ## Querying Flag Values
89
97
 
90
- A flag's value can be queried by either calling `flags.get('flagname')` or by querying the flags object directly `flags.FLAGS.flagname.get()`.
91
-
92
- 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()`.
93
99
 
94
- flag.name
95
- flag.defaultValue
96
- flag.currentValue
97
- flag.isSet
100
+ Flag objects also provide properties like `name`, `defaultValue`, `currentValue`, and `isSet`.
98
101
 
99
- ## Testing
100
-
101
- By default `flags.parse` uses process.argv and slices off the first 2 elements. For tests you can pass a predefined set of arguments as an array:
102
-
103
- flags.parse(['--flag', '--nofood', '--foo=bar']);
102
+ ## Help Text
104
103
 
105
- If you want to change flags between test cases, you may call:
104
+ Node-Flags automatically generates help text. Access it by running your script with the `--help` flag.
106
105
 
107
- flags.reset();
108
-
109
- ## TODOs
110
-
111
- * Support --flagsfile
112
- * Support multi space separated flags, e.g. --files file1 file2 file3
106
+ ## Testing
113
107
 
114
- ## Licence
108
+ For testing, you can pass predefined arguments to `flags.parse()`:
115
109
 
116
- The MIT License (MIT)
110
+ ```javascript
111
+ flags.parse(["--flag1", "--noflag2", "--flag3=value"]);
112
+ ```
117
113
 
118
- Copyright (c) 2011 Daniel Pupius
114
+ Reset flags between test cases:
119
115
 
120
- 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:
116
+ ```javascript
117
+ flags.reset();
118
+ ```
121
119
 
122
- The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
120
+ ## License
123
121
 
124
- 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.
122
+ This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
package/dist/flags.cjs ADDED
@@ -0,0 +1,366 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
7
+ var __export = (target, all) => {
8
+ for (var name in all)
9
+ __defProp(target, name, { get: all[name], enumerable: true });
10
+ };
11
+ var __copyProps = (to, from, except, desc) => {
12
+ if (from && typeof from === "object" || typeof from === "function") {
13
+ for (let key of __getOwnPropNames(from))
14
+ if (!__hasOwnProp.call(to, key) && key !== except)
15
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
16
+ }
17
+ return to;
18
+ };
19
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
20
+ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
21
+
22
+ // src/flags.ts
23
+ var flags_exports = {};
24
+ __export(flags_exports, {
25
+ FLAGS: () => FLAGS,
26
+ defineBoolean: () => defineBoolean,
27
+ defineInteger: () => defineInteger,
28
+ defineMultiString: () => defineMultiString,
29
+ defineNumber: () => defineNumber,
30
+ defineString: () => defineString,
31
+ defineStringList: () => defineStringList,
32
+ get: () => get,
33
+ help: () => help,
34
+ isSet: () => isSet,
35
+ parse: () => parse,
36
+ reset: () => reset,
37
+ setExitOnError: () => setExitOnError,
38
+ setUsageInfo: () => setUsageInfo
39
+ });
40
+ module.exports = __toCommonJS(flags_exports);
41
+ if (typeof global.GLOBAL_FLAGS === "undefined") {
42
+ global.GLOBAL_FLAGS = {};
43
+ }
44
+ var FLAGS = global.GLOBAL_FLAGS;
45
+ var exitOnError = true;
46
+ var usageInfo = "Usage: node " + (process.argv[1] || "").split("/").pop() + " [options]";
47
+ function setExitOnError(value) {
48
+ exitOnError = value;
49
+ }
50
+ function setUsageInfo(value) {
51
+ usageInfo = value;
52
+ }
53
+ function defineString(name, defaultValue, description) {
54
+ return addFlag(name, new StringFlag(name, defaultValue, description));
55
+ }
56
+ function defineBoolean(name, defaultValue, description) {
57
+ return addFlag(name, new BooleanFlag(name, defaultValue, description));
58
+ }
59
+ function defineInteger(name, defaultValue, description) {
60
+ return addFlag(name, new IntegerFlag(name, defaultValue, description));
61
+ }
62
+ function defineNumber(name, defaultValue, description) {
63
+ return addFlag(name, new NumberFlag(name, defaultValue, description));
64
+ }
65
+ function defineStringList(name, defaultValue, description) {
66
+ return addFlag(name, new StringListFlag(name, defaultValue, description));
67
+ }
68
+ function defineMultiString(name, defaultValue, description) {
69
+ return addFlag(name, new MultiStringFlag(name, defaultValue, description));
70
+ }
71
+ function help() {
72
+ if (usageInfo) {
73
+ console.log(usageInfo + "\n");
74
+ }
75
+ console.log("Options:");
76
+ for (const flag in FLAGS) {
77
+ if (!FLAGS[flag].isSecret) {
78
+ console.log(FLAGS[flag].toHelpString());
79
+ }
80
+ }
81
+ }
82
+ function reset() {
83
+ parseCalled = false;
84
+ Object.keys(FLAGS).forEach((key) => delete FLAGS[key]);
85
+ registerInternalFlags();
86
+ }
87
+ function get(name) {
88
+ if (!FLAGS[name]) throw Error('Unknown flag "' + name + '"');
89
+ return FLAGS[name].get();
90
+ }
91
+ function isSet(name) {
92
+ if (!FLAGS[name]) throw Error('Unknown flag "' + name + '"');
93
+ return FLAGS[name].isSet;
94
+ }
95
+ function parse(args = process.argv.slice(2), ignoreUnrecognized) {
96
+ if (parseCalled) return [];
97
+ for (let i = 0; i < args.length; i++) {
98
+ const arg = args[i];
99
+ if (arg == "--") {
100
+ return args.slice(i + 1);
101
+ } else if (arg.startsWith("--")) {
102
+ let flag = arg.slice(2);
103
+ let value = null;
104
+ if (flag.indexOf("=") > -1) {
105
+ const parts = flag.split("=");
106
+ flag = parts[0];
107
+ value = parts.slice(1).join("=");
108
+ }
109
+ if (value == null && args[i + 1] && !args[i + 1].startsWith("--")) {
110
+ args[i] = args[i] + " " + args[i + 1];
111
+ value = args[i + 1];
112
+ args.splice(i + 1, 1);
113
+ }
114
+ if (!FLAGS[flag] && value == null && flag.startsWith("no")) {
115
+ flag = flag.slice(2);
116
+ value = "0";
117
+ }
118
+ if (FLAGS[flag]) {
119
+ try {
120
+ FLAGS[flag].set(value);
121
+ } catch (e) {
122
+ throwFlagParseError(args, i, e.message);
123
+ }
124
+ } else if (!ignoreUnrecognized) {
125
+ throwFlagParseError(args, i, 'Unrecognized flag name "' + arg + '"');
126
+ }
127
+ } else {
128
+ throwFlagParseError(args, i, 'Invalid argument "' + arg + '"');
129
+ }
130
+ }
131
+ parseCalled = true;
132
+ if (FLAGS.help.get()) {
133
+ help();
134
+ process.exit(0);
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
+ });
141
+ return [];
142
+ }
143
+ var parseCalled = false;
144
+ function throwFlagParseError(args, i, msg) {
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
+ }
149
+ if (exitOnError) {
150
+ console.error(errorMsg);
151
+ process.exit(1);
152
+ } else {
153
+ throw Error(errorMsg);
154
+ }
155
+ }
156
+ function addFlag(name, flag) {
157
+ if (parseCalled) throw Error("Can not register new flags after parse()");
158
+ if (FLAGS[name]) throw Error('Flag already defined: "' + name + '"');
159
+ FLAGS[name] = flag;
160
+ return flag;
161
+ }
162
+ function wrapText(text, maxLen) {
163
+ const lines = text.split("\n");
164
+ const out = [];
165
+ lines.forEach((line) => {
166
+ const maxLenx = maxLen + (out.length == 0 ? 4 : 0);
167
+ if (line.length < maxLenx) {
168
+ out.push(line);
169
+ } else {
170
+ const current = wrapLine(line, " ", maxLenx, out);
171
+ if (current != "") {
172
+ out.push(current);
173
+ }
174
+ }
175
+ });
176
+ return out.join("\n ");
177
+ }
178
+ function wrapLine(line, delimiter, maxLen, out) {
179
+ const parts = line.split(delimiter);
180
+ let current = "";
181
+ parts.forEach((part) => {
182
+ const next = current + part + delimiter;
183
+ if (next.length > maxLen) {
184
+ out.push(current);
185
+ current = part + delimiter;
186
+ } else {
187
+ current = next;
188
+ }
189
+ });
190
+ return current;
191
+ }
192
+ var Flag = class {
193
+ constructor(name, defaultValue, description) {
194
+ __publicField(this, "name");
195
+ __publicField(this, "defaultValue");
196
+ __publicField(this, "description");
197
+ __publicField(this, "currentValue");
198
+ __publicField(this, "validator");
199
+ __publicField(this, "isSecret");
200
+ __publicField(this, "isSet");
201
+ __publicField(this, "isRequired");
202
+ this.name = name;
203
+ this.defaultValue = defaultValue;
204
+ this.description = description;
205
+ this.currentValue = null;
206
+ this.isSecret = false;
207
+ this.isSet = false;
208
+ this.isRequired = false;
209
+ }
210
+ /** Set a default value. */
211
+ setDefault(defaultValue) {
212
+ this.defaultValue = defaultValue;
213
+ return this;
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. */
221
+ setDescription(description) {
222
+ this.description = description;
223
+ return this;
224
+ }
225
+ /** Set a custom validator. */
226
+ setValidator(validator) {
227
+ this.validator = validator;
228
+ return this;
229
+ }
230
+ /** Hide this flag from the help message. */
231
+ setSecret(isSecret) {
232
+ this.isSecret = isSecret;
233
+ return this;
234
+ }
235
+ set(input) {
236
+ if (this.isSet) {
237
+ throw Error("Flag already set");
238
+ }
239
+ if (typeof input === "string") {
240
+ this.currentValue = this.parseInput(input);
241
+ } else if (input === null) {
242
+ this.currentValue = this.parseInput(null);
243
+ } else {
244
+ this.currentValue = input;
245
+ }
246
+ if (this.validator) this.validator(this.currentValue);
247
+ this.isSet = true;
248
+ }
249
+ get() {
250
+ return this.isSet ? this.currentValue : this.defaultValue;
251
+ }
252
+ parseInput(_inp) {
253
+ throw Error("Not implemented");
254
+ }
255
+ toHelpString() {
256
+ return wrapText(" --" + this.name + ": " + this.description, 70) + "\n (default: " + JSON.stringify(this.defaultValue) + ")";
257
+ }
258
+ };
259
+ var BooleanFlag = class extends Flag {
260
+ constructor(name, defaultValue, description) {
261
+ super(name, defaultValue ?? false, description);
262
+ }
263
+ parseInput(inp) {
264
+ if (inp === null) {
265
+ return true;
266
+ }
267
+ inp = inp.toLowerCase();
268
+ if (inp === "1" || inp === "true" || inp == "t") {
269
+ return true;
270
+ } else if (inp === "0" || inp === "false" || inp == "f") {
271
+ return false;
272
+ } else {
273
+ throw Error('Invalid Boolean flag "' + inp + '"');
274
+ }
275
+ }
276
+ get() {
277
+ return !!super.get();
278
+ }
279
+ toHelpString() {
280
+ return wrapText(" --[no]" + this.name + ": " + this.description, 70) + "\n (default: " + JSON.stringify(this.defaultValue) + ")";
281
+ }
282
+ };
283
+ var IntegerFlag = class extends Flag {
284
+ constructor(name, defaultValue, description) {
285
+ super(name, defaultValue ?? 0, description);
286
+ }
287
+ parseInput(inp) {
288
+ if (isNaN(Number(inp)) || parseInt(inp, 10) !== Number(inp)) {
289
+ throw Error('Invalid Integer flag "' + inp + '"');
290
+ }
291
+ return Number(inp);
292
+ }
293
+ toHelpString() {
294
+ return super.toHelpString() + "\n (an integer)";
295
+ }
296
+ };
297
+ var NumberFlag = class extends Flag {
298
+ constructor(name, defaultValue, description) {
299
+ super(name, defaultValue ?? 0, description);
300
+ }
301
+ parseInput(inp) {
302
+ if (isNaN(Number(inp))) {
303
+ throw Error('Invalid Number flag "' + inp + '"');
304
+ }
305
+ return Number(inp);
306
+ }
307
+ toHelpString() {
308
+ return super.toHelpString() + "\n (a number)";
309
+ }
310
+ };
311
+ var StringFlag = class extends Flag {
312
+ constructor(name, defaultValue, description) {
313
+ super(name, defaultValue ?? "", description);
314
+ }
315
+ parseInput(inp) {
316
+ if (inp === null) {
317
+ throw Error('Invalid String flag "' + inp + '"');
318
+ }
319
+ return inp;
320
+ }
321
+ toHelpString() {
322
+ return super.toHelpString() + "\n (a string)";
323
+ }
324
+ };
325
+ var StringListFlag = class extends Flag {
326
+ constructor(name, defaultValue, description) {
327
+ super(name, defaultValue ?? [], description);
328
+ }
329
+ parseInput(inp) {
330
+ if (inp === null) return [];
331
+ else return inp.split(",");
332
+ }
333
+ };
334
+ var MultiStringFlag = class extends Flag {
335
+ constructor(name, defaultValue, description) {
336
+ super(name, defaultValue ?? [], description);
337
+ }
338
+ set(input) {
339
+ if (this.validator) this.validator(input);
340
+ if (!this.currentValue) this.currentValue = [];
341
+ this.currentValue.push(...input);
342
+ this.isSet = true;
343
+ }
344
+ };
345
+ function registerInternalFlags() {
346
+ defineBoolean("help").setDescription("Shows this help text.").setSecret(true);
347
+ }
348
+ registerInternalFlags();
349
+ // Annotate the CommonJS export names for ESM import in node:
350
+ 0 && (module.exports = {
351
+ FLAGS,
352
+ defineBoolean,
353
+ defineInteger,
354
+ defineMultiString,
355
+ defineNumber,
356
+ defineString,
357
+ defineStringList,
358
+ get,
359
+ help,
360
+ isSet,
361
+ parse,
362
+ reset,
363
+ setExitOnError,
364
+ setUsageInfo
365
+ });
366
+ //# sourceMappingURL=flags.cjs.map
@@ -0,0 +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 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":[]}