flags 0.1.2 → 0.2.0

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/dist/flags.js ADDED
@@ -0,0 +1,311 @@
1
+ var __defProp = Object.defineProperty;
2
+ var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
3
+ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
4
+
5
+ // src/flags.ts
6
+ if (typeof global.GLOBAL_FLAGS === "undefined") {
7
+ global.GLOBAL_FLAGS = {};
8
+ }
9
+ var FLAGS = global.GLOBAL_FLAGS;
10
+ var exitOnError = true;
11
+ var usageInfo = "Usage: node " + (process.argv[1] || "").split("/").pop() + " [options]";
12
+ function setExitOnError(value) {
13
+ exitOnError = value;
14
+ }
15
+ function setUsageInfo(value) {
16
+ usageInfo = value;
17
+ }
18
+ function defineString(name, defaultValue, description) {
19
+ return addFlag(name, new StringFlag(name, defaultValue, description));
20
+ }
21
+ function defineBoolean(name, defaultValue, description) {
22
+ return addFlag(name, new BooleanFlag(name, defaultValue, description));
23
+ }
24
+ function defineInteger(name, defaultValue, description) {
25
+ return addFlag(name, new IntegerFlag(name, defaultValue, description));
26
+ }
27
+ function defineNumber(name, defaultValue, description) {
28
+ return addFlag(name, new NumberFlag(name, defaultValue, description));
29
+ }
30
+ function defineStringList(name, defaultValue, description) {
31
+ return addFlag(name, new StringListFlag(name, defaultValue, description));
32
+ }
33
+ function defineMultiString(name, defaultValue, description) {
34
+ return addFlag(name, new MultiStringFlag(name, defaultValue, description));
35
+ }
36
+ function help() {
37
+ if (usageInfo) {
38
+ console.log(usageInfo + "\n");
39
+ }
40
+ console.log("Options:");
41
+ for (const flag in FLAGS) {
42
+ if (!FLAGS[flag].isSecret) {
43
+ console.log(FLAGS[flag].toHelpString());
44
+ }
45
+ }
46
+ }
47
+ function reset() {
48
+ parseCalled = false;
49
+ Object.keys(FLAGS).forEach((key) => delete FLAGS[key]);
50
+ registerInternalFlags();
51
+ }
52
+ function get(name) {
53
+ if (!FLAGS[name]) throw Error('Unknown flag "' + name + '"');
54
+ return FLAGS[name].get();
55
+ }
56
+ function isSet(name) {
57
+ if (!FLAGS[name]) throw Error('Unknown flag "' + name + '"');
58
+ return FLAGS[name].isSet;
59
+ }
60
+ function parse(args = process.argv.slice(2), ignoreUnrecognized) {
61
+ if (parseCalled) return [];
62
+ for (let i = 0; i < args.length; i++) {
63
+ const arg = args[i];
64
+ if (arg == "--") {
65
+ return args.slice(i + 1);
66
+ } else if (arg.startsWith("--")) {
67
+ let flag = arg.slice(2);
68
+ let value = null;
69
+ if (flag.indexOf("=") > -1) {
70
+ const parts = flag.split("=");
71
+ flag = parts[0];
72
+ value = parts.slice(1).join("=");
73
+ }
74
+ if (value == null && args[i + 1] && !args[i + 1].startsWith("--")) {
75
+ args[i] = args[i] + " " + args[i + 1];
76
+ value = args[i + 1];
77
+ args.splice(i + 1, 1);
78
+ }
79
+ if (!FLAGS[flag] && value == null && flag.startsWith("no")) {
80
+ flag = flag.slice(2);
81
+ value = "0";
82
+ }
83
+ if (FLAGS[flag]) {
84
+ try {
85
+ FLAGS[flag].set(value);
86
+ } catch (e) {
87
+ throwFlagParseError(args, i, e.message);
88
+ }
89
+ } else if (!ignoreUnrecognized) {
90
+ throwFlagParseError(args, i, 'Unrecognized flag name "' + arg + '"');
91
+ }
92
+ } else {
93
+ throwFlagParseError(args, i, 'Invalid argument "' + arg + '"');
94
+ }
95
+ }
96
+ parseCalled = true;
97
+ if (FLAGS.help.get()) {
98
+ help();
99
+ process.exit(0);
100
+ }
101
+ return [];
102
+ }
103
+ var parseCalled = false;
104
+ 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("^");
106
+ if (exitOnError) {
107
+ console.error(errorMsg);
108
+ process.exit(1);
109
+ } else {
110
+ throw Error(errorMsg);
111
+ }
112
+ }
113
+ function addFlag(name, flag) {
114
+ if (parseCalled) throw Error("Can not register new flags after parse()");
115
+ if (FLAGS[name]) throw Error('Flag already defined: "' + name + '"');
116
+ FLAGS[name] = flag;
117
+ return flag;
118
+ }
119
+ function wrapText(text, maxLen) {
120
+ const lines = text.split("\n");
121
+ const out = [];
122
+ lines.forEach((line) => {
123
+ const maxLenx = maxLen + (out.length == 0 ? 4 : 0);
124
+ if (line.length < maxLenx) {
125
+ out.push(line);
126
+ } else {
127
+ const current = wrapLine(line, " ", maxLenx, out);
128
+ if (current != "") {
129
+ out.push(current);
130
+ }
131
+ }
132
+ });
133
+ return out.join("\n ");
134
+ }
135
+ function wrapLine(line, delimiter, maxLen, out) {
136
+ const parts = line.split(delimiter);
137
+ let current = "";
138
+ parts.forEach((part) => {
139
+ const next = current + part + delimiter;
140
+ if (next.length > maxLen) {
141
+ out.push(current);
142
+ current = part + delimiter;
143
+ } else {
144
+ current = next;
145
+ }
146
+ });
147
+ return current;
148
+ }
149
+ var Flag = class {
150
+ constructor(name, defaultValue, description) {
151
+ __publicField(this, "name");
152
+ __publicField(this, "defaultValue");
153
+ __publicField(this, "description");
154
+ __publicField(this, "currentValue");
155
+ __publicField(this, "validator");
156
+ __publicField(this, "isSecret");
157
+ __publicField(this, "isSet");
158
+ this.name = name;
159
+ this.defaultValue = defaultValue;
160
+ this.description = description;
161
+ this.currentValue = null;
162
+ this.isSecret = false;
163
+ this.isSet = false;
164
+ }
165
+ setDefault(defaultValue) {
166
+ this.defaultValue = defaultValue;
167
+ return this;
168
+ }
169
+ setDescription(description) {
170
+ this.description = description;
171
+ return this;
172
+ }
173
+ setValidator(validator) {
174
+ this.validator = validator;
175
+ return this;
176
+ }
177
+ setSecret(isSecret) {
178
+ this.isSecret = isSecret;
179
+ return this;
180
+ }
181
+ set(input) {
182
+ if (this.isSet) {
183
+ throw Error("Flag already set");
184
+ }
185
+ if (typeof input === "string") {
186
+ this.currentValue = this.parseInput(input);
187
+ } else if (input === null) {
188
+ this.currentValue = this.parseInput(null);
189
+ } else {
190
+ this.currentValue = input;
191
+ }
192
+ if (this.validator) this.validator(this.currentValue);
193
+ this.isSet = true;
194
+ }
195
+ get() {
196
+ return this.isSet ? this.currentValue : this.defaultValue;
197
+ }
198
+ parseInput(_inp) {
199
+ throw Error("Not implemented");
200
+ }
201
+ toHelpString() {
202
+ return wrapText(" --" + this.name + ": " + this.description, 70) + "\n (default: " + JSON.stringify(this.defaultValue) + ")";
203
+ }
204
+ };
205
+ var BooleanFlag = class extends Flag {
206
+ constructor(name, defaultValue, description) {
207
+ super(name, defaultValue ?? false, description);
208
+ }
209
+ parseInput(inp) {
210
+ if (inp === null) {
211
+ return true;
212
+ }
213
+ inp = inp.toLowerCase();
214
+ if (inp === "1" || inp === "true" || inp == "t") {
215
+ return true;
216
+ } else if (inp === "0" || inp === "false" || inp == "f") {
217
+ return false;
218
+ } else {
219
+ throw Error('Invalid Boolean flag "' + inp + '"');
220
+ }
221
+ }
222
+ get() {
223
+ return !!super.get();
224
+ }
225
+ toHelpString() {
226
+ return wrapText(" --[no]" + this.name + ": " + this.description, 70) + "\n (default: " + JSON.stringify(this.defaultValue) + ")";
227
+ }
228
+ };
229
+ var IntegerFlag = class extends Flag {
230
+ constructor(name, defaultValue, description) {
231
+ super(name, defaultValue ?? 0, description);
232
+ }
233
+ parseInput(inp) {
234
+ if (isNaN(Number(inp)) || parseInt(inp, 10) !== Number(inp)) {
235
+ throw Error('Invalid Integer flag "' + inp + '"');
236
+ }
237
+ return Number(inp);
238
+ }
239
+ toHelpString() {
240
+ return super.toHelpString() + "\n (an integer)";
241
+ }
242
+ };
243
+ var NumberFlag = class extends Flag {
244
+ constructor(name, defaultValue, description) {
245
+ super(name, defaultValue ?? 0, description);
246
+ }
247
+ parseInput(inp) {
248
+ if (isNaN(Number(inp))) {
249
+ throw Error('Invalid Number flag "' + inp + '"');
250
+ }
251
+ return Number(inp);
252
+ }
253
+ toHelpString() {
254
+ return super.toHelpString() + "\n (a number)";
255
+ }
256
+ };
257
+ var StringFlag = class extends Flag {
258
+ constructor(name, defaultValue, description) {
259
+ super(name, defaultValue ?? "", description);
260
+ }
261
+ parseInput(inp) {
262
+ if (inp === null) {
263
+ throw Error('Invalid String flag "' + inp + '"');
264
+ }
265
+ return inp;
266
+ }
267
+ toHelpString() {
268
+ return super.toHelpString() + "\n (a string)";
269
+ }
270
+ };
271
+ var StringListFlag = class extends Flag {
272
+ constructor(name, defaultValue, description) {
273
+ super(name, defaultValue ?? [], description);
274
+ }
275
+ parseInput(inp) {
276
+ if (inp === null) return [];
277
+ else return inp.split(",");
278
+ }
279
+ };
280
+ var MultiStringFlag = class extends Flag {
281
+ constructor(name, defaultValue, description) {
282
+ super(name, defaultValue ?? [], description);
283
+ }
284
+ set(input) {
285
+ if (this.validator) this.validator(input);
286
+ if (!this.currentValue) this.currentValue = [];
287
+ this.currentValue.push(...input);
288
+ this.isSet = true;
289
+ }
290
+ };
291
+ function registerInternalFlags() {
292
+ defineBoolean("help").setDescription("Shows this help text.").setSecret(true);
293
+ }
294
+ registerInternalFlags();
295
+ export {
296
+ FLAGS,
297
+ defineBoolean,
298
+ defineInteger,
299
+ defineMultiString,
300
+ defineNumber,
301
+ defineString,
302
+ defineStringList,
303
+ get,
304
+ help,
305
+ isSet,
306
+ parse,
307
+ reset,
308
+ setExitOnError,
309
+ setUsageInfo
310
+ };
311
+ //# sourceMappingURL=flags.js.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 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":[]}
package/package.json CHANGED
@@ -1,18 +1,42 @@
1
1
  {
2
- "name" : "flags",
3
- "version" : "0.1.2",
4
- "description" : "Flag library for node.js",
5
- "keywords" : ["flag", "args", "command line"],
6
- "repository" : {
7
- "type" : "git",
8
- "url" : "http://github.com/dpup/node-flags.git"
2
+ "name": "flags",
3
+ "version": "0.2.0",
4
+ "description": "Flag library for node.js",
5
+ "type": "module",
6
+ "main": "dist/index.js",
7
+ "types": "dist/index.d.ts",
8
+ "files": [
9
+ "/dist"
10
+ ],
11
+ "keywords": [
12
+ "flag",
13
+ "args",
14
+ "command line"
15
+ ],
16
+ "repository": {
17
+ "type": "git",
18
+ "url": "http://github.com/dpup/node-flags.git"
9
19
  },
10
- "homepage" : "https://github.com/dpup/node-flags",
11
- "author" : {
12
- "name" : "Daniel Pupius",
13
- "email" : "dan@pupi.us",
14
- "url" : "http://pupius.co.uk"
20
+ "homepage": "https://github.com/dpup/node-flags",
21
+ "author": {
22
+ "name": "Daniel Pupius",
23
+ "email": "dan@pupi.us",
24
+ "url": "http://pupius.co.uk"
15
25
  },
16
- "main" : "./lib/flags.js",
17
- "directories": {"lib": "./lib"}
18
- }
26
+ "devDependencies": {
27
+ "@eslint/js": "^9.2.0",
28
+ "@types/eslint": "^8.56.10",
29
+ "@typescript-eslint/parser": "^7.8.0",
30
+ "eslint": "^9.2.0",
31
+ "ts-node": "^10.9.2",
32
+ "tsup": "^8.0.2",
33
+ "tsx": "^4.19.1",
34
+ "typescript": "^5.4.5",
35
+ "typescript-eslint": "^7.8.0"
36
+ },
37
+ "scripts": {
38
+ "build": "tsup",
39
+ "test": "node --import tsx --test tests/**/*_test.ts",
40
+ "lint": "eslint ."
41
+ }
42
+ }
@@ -1,34 +0,0 @@
1
- /**
2
- * @fileoverview Basic example of flag usage.
3
- *
4
- * Try:
5
- * node example.js --name='Dan Pupius' --age=31 --height=1.85 \
6
- * --pets=Ada,Oscar --hobby=triathlon --hobby=photography
7
- *
8
- * @author dan@pupi.us (Daniel Pupius)
9
- */
10
-
11
- var flags = require('flags');
12
-
13
- flags.defineString('name', 'Billy Noone', 'Your name.');
14
- flags.defineInteger('age', 21, 'Your age in whole years.\nThis is a really ' +
15
- 'long and informative description that tells you how to accurately ' +
16
- 'specify your age as a flag. It\'s not really useful, just using it to ' +
17
- 'test out the help text with long descriptions.');
18
- flags.defineNumber('height', 1.80, 'Your height in meters.');
19
- flags.defineStringList('pets', [], 'Comma separated list of your pets.');
20
- flags.defineMultiString('hobby', ['chess', 'tv'], 'A hobby.');
21
- flags.defineBoolean('active', false, 'Whether the user is active.')
22
-
23
- flags.parse();
24
-
25
- // ====
26
-
27
- var info = [];
28
- info.push('Name : ' + flags.get('name'));
29
- info.push('Age : ' + flags.get('age'));
30
- info.push('Height : ' + flags.get('height') + '"');
31
- info.push('Pets : ' + flags.get('pets').join(', '));
32
- info.push('Hobbies : \n ' + flags.get('hobby').join('\n '));
33
-
34
- console.log(info.join('\n'));