🥪 Breadc

Yet another Command Line Application Framework with fully strong TypeScript support.

vscode

Features

🔍 TypeScript Infer: IDE will automatically infer the type of your command action function;
💻 Commands: support default command, command alias and sub-commands like git remote add <name> <url>;
📖 East to Learn: very similar with commander.js, cac and there are only 5 APIs for building a CLI application: breadc, command, option, action, run.
🧰 Toolkits: contains many useful tools to build your next CLI application, such as ansi color, process death handler, shell compelete script generation and so on.

Installation

npm i breadc

Usage

Try ./examples/echo.ts.

import { breadc } from 'breadc';

const cli = breadc('echo', { version: '1.0.0' })
  .option('--host <host>', 'specify hostname', { initial: 'localhost' })
  .option('--port <port>', 'specify port', { initial: '3000', cast: (t) => +t });

cli.command('[message]', 'Say something!').action((message, option) => {
  console.log(message ?? 'You can say anything!');
  const { host, port } = option; // { host: string, port: number, '--': string[] }
  console.log(`Host: ${host}`);
  console.log(`Port: ${port}`);
});

cli.run(process.argv.slice(2)).catch((err) => console.error(err));

If you are using IDEs that support TypeScript (like Visual Studio Code), input something using option, and then you will find the option is automatically typed with { host: string, port: number }. In the figure below, Visual Studio Code will automatically infer that the type of option.host is string and the type of option.port is number.