@breadc/core

  

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

!vscode

Installation

``bash
npm i @breadc/core
`

Usage

Try ./examples/echo.ts.

`ts
import { breadc } from '@breadc/core';

const cli = breadc('echo', { version: '1.0.0' })
.option('--host ', 'specify hostname', { initial: 'localhost' })
.option('--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`.

!vscode

Inspiration

+ cac: Simple yet powerful framework for building command-line apps.
+ TypeScript: Documentation - Template Literal Types

License

MIT License © 2023 XLor