ts-commands - Readme

Installation

1. npm i ts-commands

Usage

Creating Commands

Create a command file:

src/bin/greet-command.ts

1import { Command, OptionType, ParsedArguments } from 'ts-commands';
2
3interface Args extends ParsedArguments {
4	fname: string;
5	lname: string;
6	informal?: boolean;
7}
8
9export class GreetCommand extends Command {
10	override key = 'greet';
11	override description = 'say hello';
12
13	override positional = [
14		{
15			key: 'fname',
16			type: OptionType.string,
17			description: 'first name',
18			default: 'Tom',
19		},
20		{
21			key: 'lname',
22			type: OptionType.string,
23			description: 'last name',
24			default: 'Tester',
25		},
26	];
27
28	override options = [
29		{
30			key: 'informal',
31			type: OptionType.boolean,
32			default: false,
33			description: 'Informal?',
34		},
35	];
36
37	override async handle(args: Args) {
38		const greeting = args.informal ? 'yo' : 'hello';
39
40		console.log(`${greeting} ${args.fname} ${args.lname}`);
41	}
42}

Registering Commands

Option 1 - Singular Command

If your app only needs one command (e.g. it only does one thing), you can use a singular style CLI:

src/bin/index.ts

1import { CommandRunner } from 'ts-commands';
2import { GreetCommand } from '../commands/greet';
3
4new CommandRunner(new GreetCommand()).run();

Option 2 - Dispatched Commands

Dispatched commands are useful for when you have multiple sub-commands in your CLI, such as migration:run, migration:generate, etc.

Create an index file to register your command(s):

src/bin/index.ts

1import { CommandDispatcher } from 'ts-commands';
2import { FarewellCommand } from './farewell';
3import { GreetCommand } from './greet';
4
5new CommandDispatcher({
6	commands: [FarewellCommand, GreetCommand],
7}).run();

Option 3 - Automatically Register all Commands in a Folder

Use ts-import-ts to load all Commands in a directory. Note, you will need to change each Command to the default export of the module, e.g. export default class MyCommand.... Please read the readme of that package for proper usage.

First, install with npm i ts-import-ts

Create your dispatcher:

src/bin/index.ts

1import { tsimportDirectory } from 'ts-import-ts';
2import { Command, CommandDispatcher } from 'ts-commands';
3
4new CommandDispatcher({
5	commands: tsimportDirectory<typeof Command>('scripts'),
6}).run();

Create Additional Commands

1. Repeat "Creating Commands" section for each command
2. Add each command in the commands of CommandDispatcher