@trenskow/arguments-parser 0.2.11 → 0.2.13

package/lib/index.js

@@ -23,13 +23,25 @@ plugins.use(() => ({
 	formalize: (schema) => schema
 }));
 
-const argumentsParser = ({ args = process.argv.slice(2), argvLevel = 0, placeholder = '<>', command, strings = {} } = {}) => {
+const argumentsParser = (
+	{
+		args = process.argv.slice(2),
+		argvLevel = 0,
+		placeholder = '<>',
+		command,
+		strings = {},
+		help: {
+			usage: helpUsage,
+			options: helpOptions,
+		} = {}
+	} = {}
+) => {
 
 	const [ opening, closing ] = placeholder.split('');
 
 	const base = `${process.argv.slice(1, argvLevel + 2).map(((arg) => basename(arg))).join(' ')}`;
 
-	const list = (items) => {
+	const list = (print, items) => {
 
 		const maxLength = Object.keys(items)
 			.reduce((length, key) => Math.max(length, key.length), 0);
@@ -42,18 +54,49 @@ const argumentsParser = ({ args = process.argv.slice(2), argvLevel = 0, placehol
 
 	};
 
+	if (typeof helpUsage === 'undefined') {
+		helpUsage = [
+			strings?.help?.usage || 'Usage:',
+			base
+		];
+	}
+
+	const printHelp = (error) => {
+
+		print();
+
+		print(helpUsage.join(' '));
+
+		if (helpOptions) {
+			print.nn(helpOptions);
+		}
+
+		if (error) {
+			print();
+			print.bold((strings?.commands?.help?.error || 'Error: <message>')
+				.replace('<message>', error.message));
+		}
+
+		print();
+
+		process.exit(error ? 1 : 0);
+
+	};
+
+	const checkHelp = () => {
+		if (args[0] === '--help') printHelp();
+	};
+
 	return {
 		get base() {
 			return base;
 		},
 		command: async (commands) => {
 
-			const printHelp = (error) => {
+			helpUsage.push(`${opening}${strings?.commands?.help?.placeholder || 'command'}${closing}`);
+
+			helpOptions = print.toString((print) => {
 
-				print();
-				print((strings?.commands?.help?.usage || 'Usage: <base> <command>')
-					.replace('<base>', base)
-					.replace('<command>', `${opening}command${closing}`));
 				print();
 				print(strings?.commands?.help?.available || 'Available commands:');
 				print();
@@ -65,24 +108,15 @@ const argumentsParser = ({ args = process.argv.slice(2), argvLevel = 0, placehol
 
 				tools.sort((a, b) => a.name > b.name ? 1 : -1);
 
-				list(Object.fromEntries(tools
+				list(print, Object.fromEntries(tools
 					.map((tool) => [tool.name, tool.description || (strings?.commands?.help?.noDescription || 'No description')])));
 
-				if (error) {
-					print();
-					print();
-					print((strings?.commands?.help?.error || 'Error: <message>')
-						.replace('<message>', error.message));
-				}
-
-				print();
-
-				process.exit(error ? 1 : 0);
-
-			};
+			});
 
 			if (args.length === 0) printHelp();
 
+			checkHelp();
+
 			const tool = caseit(args[0]);
 
 			if (!commands[tool]) {
@@ -129,29 +163,16 @@ const argumentsParser = ({ args = process.argv.slice(2), argvLevel = 0, placehol
 				.all()
 				.filter((keyPath) => keyPath);
 
-			const printHelp = (error) => {
+			helpUsage.push(`${opening}${strings?.options?.help?.placeholder || 'options'}${closing}`);
 
-				if (typeof options?.command?.description === 'string') {
-					print();
-					print(options.command.description);
-				}
+			if (allKeyPaths.length) {
 
-				print();
-				print.nn(
-					(strings?.options?.help?.usage || 'Usage: <base> <options>')
-						.replace('<base>', base)
-						.replace('<options>', `${opening}options${closing}`));
-
-				if (options.help?.postfix) print.nn(options.help.postfix);
-
-				print();
-
-				if (allKeyPaths.length) {
+				helpOptions = print.toString((print) => {
 
 					print();
-					print(strings?.options?.help?.options || 'Options:');
+					print(strings?.options?.help?.title || 'Options:');
 
-					list(Object.fromEntries(allKeyPaths
+					list(print, Object.fromEntries(allKeyPaths
 						.map((keyPath) => {
 
 							const keyPathSchema = keyPaths(schema).get(keyPath);
@@ -191,28 +212,10 @@ const argumentsParser = ({ args = process.argv.slice(2), argvLevel = 0, placehol
 
 						})));
 
-				}
-
-				print();
-
-				if (error) {
-
-					(error.errors || [error])
-						.forEach((error) => {
-							if (error.keyPath) {
-								print.err(`--${caseit(error.keyPath.join('.'), 'kebab')}: ${error.message}`);
-							} else {
-								print.err(error.message);
-							}
-						});
-
-					print();
-
-				}
-
-				process.exit(error ? 1 : 0);
+				});
+			}
 
-			};
+			checkHelp();
 
 			let data = {};
 			let rest = [];
@@ -230,8 +233,6 @@ const argumentsParser = ({ args = process.argv.slice(2), argvLevel = 0, placehol
 
 				const key = caseit(arg);
 
-				if (key === 'help') printHelp();
-
 				if (!keyPaths(schema).all().includes(key)) {
 					printHelp(
 						new Error(
@@ -281,9 +282,47 @@ const argumentsParser = ({ args = process.argv.slice(2), argvLevel = 0, placehol
 			});
 
 		},
-		pop: async () => {
-			if (args.length === 0) return;
-			return args.shift();
+		values: async (schema) => {
+
+			schema = formalize(schema);
+
+			if (schema.type !== Object) {
+				throw new Error('Schema must be an object.');
+			}
+
+			const schemaKeyPaths = keyPaths(schema);
+
+			const allKeyPaths = schemaKeyPaths.all({ maxDepth: 2 })
+				.filter((keyPath) => keyPath);
+
+			let lastNonRequiredIndex = -1;
+
+			allKeyPaths
+				.forEach((keyPath, idx) => {
+
+					const schema = schemaKeyPaths.get(keyPath);
+
+					if (schema.required && idx > lastNonRequiredIndex + 1) {
+						throw new Error('Required arguments must come first.');
+					}
+
+					if (schema.type !== String) {
+						throw new Error('Schema must be an object of strings.');
+					}
+
+					helpUsage = helpUsage.concat([`${opening}${caseit(keyPath, 'kebab')}${closing}`]);
+
+				});
+
+			checkHelp();
+
+			try {
+				return await isvalid(Object.fromEntries(
+					allKeyPaths.map((keyPath, idx) => [keyPath, args[idx]])), schema);
+			} catch (error) {
+				return printHelp(error);
+			}
+
 		}
 	};
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@trenskow/arguments-parser",
-	"version": "0.2.11",
+	"version": "0.2.13",
 	"description": "Yet another arguments parser.",
 	"main": "index.js",
 	"type": "module",
@@ -25,7 +25,7 @@
 	"homepage": "https://github.com/trenskow/arguments-parser#readme",
 	"dependencies": {
 		"@trenskow/caseit": "^1.4.6",
-		"@trenskow/print": "^0.1.6",
+		"@trenskow/print": "^0.1.7",
 		"isvalid": "^4.1.27"
 	},
 	"devDependencies": {