cli-args-parser

import { Parser } from 'cli-args-parser'; import { z } from 'zod'; // 1. Define your CLI argument schema using Zod const argsSchema = z.object({ name: z.string().min(1).describe('The name to greet.'), age: z.number().int().positive().optional().describe('The user\'s age.'), verbose: z.boolean().default(false).describe('Enable verbose output.'), output: z.enum(['json', 'text']).default('text').describe('Output format.'), }).strict(); // Use .strict() to disallow unknown arguments // 2. Initialize the parser with your schema and optional metadata const parser = new Parser({ schema: argsSchema, usage: 'Usage: my-cli --name <name> [--age <age>] [--verbose] [--output <format>]', description: 'A simple greeting CLI application with schema validation.', version: '1.0.6', // Make sure to match your package's actual version examples: [ 'my-cli --name Alice --age 30 --verbose', 'my-cli --name Bob --output json' ] }); // 3. Parse command-line arguments (excluding 'node' and script path) try { const parsedArgs = parser.parse(process.argv.slice(2)); if (parsedArgs.output === 'json') { console.log(JSON.stringify(parsedArgs, null, 2)); } else { let greeting = `Hello, ${parsedArgs.name}!`; if (parsedArgs.age) { greeting += ` You are ${parsedArgs.age} years old.`; } if (parsedArgs.verbose) { greeting += ` (Verbose mode active.)`; } console.log(greeting); } } catch (error) { if (error instanceof Error) { console.error(`CLI Error: ${error.message}`); } else { console.error('An unknown error occurred during CLI parsing.'); } process.exit(1); // Exit with a non-zero code on error }