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 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
- 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 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
+ [![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)
20
7
 
21
- flags.parse();
8
+ ## Features
22
9
 
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
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
- - 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`
16
+ ## Installation
44
17
 
45
- ## Defining Flags
18
+ Install using your favorite package manager:
46
19
 
47
- To define flags, use one of the defineX functions exported by the `flags` module:
20
+ ```bash
21
+ npm install flags
22
+ # or
23
+ yarn add flags
24
+ # or
25
+ pnpm add flags
26
+ ```
48
27
 
49
- **flags.defineString** - Takes the raw input from the command line.
28
+ ## Usage
50
29
 
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
30
+ Here's a quick example of how to use Node-Flags:
52
31
 
53
- **flags.defineInteger** - Must take a value and will be cast to a Number. Passing a non-integer arg will throw.
32
+ ```javascript
33
+ import * as flags from "flags";
54
34
 
55
- **flags.defineNumber** - Must take a value and will be cast to a number. Passing an arg that evaluates to NaN will throw.
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
- **flags.defineStringList** - Takes a comma separated argument list and returns an array as it's value.
42
+ // Parse command-line arguments
43
+ flags.parse();
58
44
 
59
- **flags.defineMultiString** - Same as defineString but allows multiple flags to be passed. All values will be returned in an array.
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
- All the define methods take the same arguments:
54
+ console.log(info.join("\n"));
55
+ ```
62
56
 
63
- flags.defineX(name, opt_default, opt_description);
57
+ Run your script with flags:
64
58
 
65
- `name` - The flag's name.
66
- `opt_default` - [optional] The default value if not specified on the command line.
67
- `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
+ ```
68
62
 
69
- The methods return a Flag object that exposes the following methods, for additional configuration:
63
+ ## Defining Flags
70
64
 
71
- `flag.setDefault({*} defaultValue)` - Sets the flag's default value.
72
- `flag.setDescription({string} description)` - Sets the flag's description field.
73
- `flag.setValidator({function(string)} validator)` - Sets a function for validating the input, should throw if the input isn't valid.
74
- `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
+ ```
75
88
 
76
- These setters return the flag instance so they can be chained:
89
+ ## Passing Flags
77
90
 
78
- flags.defineString('test').
79
- setDefault('empty').
80
- setDescription('A test flag').
81
- setValidator(function(inp) {
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
- A flag's value can be queried by either calling `flags.get('flagname')` or by querying the flags object directly `flags.FLAGS.flagname.get()`.
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
- flag.name
94
- flag.defaultValue
95
- flag.currentValue
96
- flag.isSet
100
+ Flag objects also provide properties like `name`, `defaultValue`, `currentValue`, and `isSet`.
97
101
 
98
- ## Testing
102
+ ## Help Text
99
103
 
100
- 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:
104
+ Node-Flags automatically generates help text. Access it by running your script with the `--help` flag.
101
105
 
102
- flags.parse(['--flag', '--nofood', '--foo=bar']);
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
- ## Licence
108
+ For testing, you can pass predefined arguments to `flags.parse()`:
114
109
 
115
- The MIT License (MIT)
110
+ ```javascript
111
+ flags.parse(["--flag1", "--noflag2", "--flag3=value"]);
112
+ ```
116
113
 
117
- Copyright (c) 2011 Daniel Pupius
114
+ Reset flags between test cases:
118
115
 
119
- 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
+ ```
120
119
 
121
- The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
120
+ ## License
122
121
 
123
- 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 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
- const errorMsg = "FLAG PARSING ERROR: " + msg + "\n " + args.join(" ") + "\n " + new Array(args.slice(0, i).join(" ").length + 2).join(" ") + new Array(args[i].length + 1).join("^");
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;
@@ -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":"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","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. --anmial=frog,bat,chicken
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. --anmial=frog,bat,chicken
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
- const errorMsg = "FLAG PARSING ERROR: " + msg + "\n " + args.join(" ") + "\n " + new Array(args.slice(0, i).join(" ").length + 2).join(" ") + new Array(args[i].length + 1).join("^");
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":"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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":"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","names":[]}
package/package.json CHANGED
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "flags",
3
- "version": "0.2.0",
3
+ "version": "0.2.2",
4
4
  "description": "Flag library for node.js",
5
5
  "type": "module",
6
- "main": "dist/index.js",
7
- "types": "dist/index.d.ts",
6
+ "main": "dist/flags.js",
7
+ "types": "dist/flags.d.ts",
8
8
  "files": [
9
9
  "/dist"
10
10
  ],