catacli
Super TypeScript-friendly commander helper.
install
$ npm install catacli
usage
Simple Command
Using reduceFlag
, makePositionalArguments
and makeCommand
, you can implements handler functions with typed args.
import {
makeBooleanFlag,
makeNumberFlag,
makeStringFlag,
makeCommand,
reduceFlag,
makeStringArgument,
makePositionalArguments
} from "catacli";
const booleanFlag = makeBooleanFlag("opts1", {
usage: "boolean example"
});
const numberFlag = makeNumberFlag("opts2", {
default: 1, // you can pass default value,
usage: "number example"
});
const stringFlag = makeStringFlag("opts3", {
alias: "a", // you can specify alias (short-hand flag)
usage: "string example"
});
const stringArg = makeStringArgument("arg1");
const flags = reduceFlag(booleanFlag, numberFlag, stringFlag);
const args = makePositionalArguments(stringArg);
const command = makeCommand({
name: "example",
description: "catacli is typescript-friendly commander tool",
version: "0.0.1",
usage: "simple [OPTIONS] arg1",
flag: flags,
positionalArguments: args,
handler: (args, opts) => {
/* YOUR COMMAND LOGIC IS HERE */
console.log("positionalArgs: ", args.arg1.value); // ok and inferred as string type
console.log("flag opts1: ", opts.opts1.value); // ok and inferred as boolean type
console.log("flag opts2: ", opts.opts2.value); // ok and inferred as number type
console.log("flag opts3: ", opts.opts3.value); // ok and inferred as string type
// opts.arg4; // ng compile error
}
});
command(process.argv.splice(2));
running with ts-node
$ ts-node main.ts --opts1 --opts2 123 --opts3 test args
and got these outputs.
positionalArgs: args
flag opts1: true
flag opts2: 123
flag opts3: test
Short-hand flag
--opts3
is also acceptable with -a
flag.
% ts-node main.ts --opts1 --opts2 123 -a test args
positionalArgs: args
flag opts1: true
flag opts2: 123
flag opts3: test
with Help
You can show rich help texts with --help
flag by default.
$ ts-node main.ts --opts1 -a test --opts3 123 args --help
NAME:
example - catacli is typescript-friendly commander tool
USAGE:
simple [OPTIONS] arg1
VERSION:
0.0.1
ARGUMENTS:
arg1
OPTIONS:
--help show help
--opts1 boolean example
--opts2 number example default=1
--opts3, -a string example
SubCommands
You can create subcommnds with makeSubCommandHandler
.
import {
makeBooleanFlag,
makeNumberFlag,
makeStringFlag,
makeCommand,
reduceFlag,
makeStringArgument,
makePositionalArguments,
makeSubCommandHandler,
makeSubCommandNameArgument
} from "catacli";
const booleanFlag = makeBooleanFlag("opts1", {
usage: "boolean example"
});
const numberFlag = makeNumberFlag("opts2", {
default: 1, // you can pass default value,
usage: "number example"
});
const stringFlag = makeStringFlag("opts3", {
alias: "a", // you can specify alias value
usage: "string example"
});
const flags = reduceFlag(booleanFlag, numberFlag, stringFlag);
const sub1Flag = reduceFlag(flags, makeStringFlag("subflag1"));
const stringArg = makeStringArgument("arg1");
const args = makePositionalArguments(stringArg);
const subCommand1 = makeCommand({
name: "sub1",
description: "catacli subcommand example (sub1)",
version: "0.0.1",
usage: "example [OPTIONS] sub1 [SUB COMMAND OPTIONS]",
flag: sub1Flag,
positionalArguments: args,
handler: (args, flags) => {
console.log("arg1: ", args.arg1.value);
console.log("opts1: ", flags.opts1.value);
console.log("opts2: ", flags.opts2.value);
console.log("opts3: ", flags.opts3.value);
console.log("subflag1: ", flags.subflag1.value); // inffered as a string type
}
});
const sub2Flag = reduceFlag(flags, makeStringFlag("subflag2"));
const subCommand2 = makeCommand({
name: "sub2",
description: "catacli subcommand example (sub2)",
version: "0.0.1",
usage: "example [OPTIONS] sub2 [SUB COMMAND OPTIONS]",
flag: sub2Flag,
handler: (_, flags) => {
console.log("subflag2: ", flags.subflag2.value);
}
});
const commandNames = makePositionalArguments(
makeSubCommandNameArgument("sub1", "sub2")
);
const command = makeCommand({
name: "example",
description: "catacli is typescript-friendly commander tool",
version: "0.0.1",
usage: "simple [OPTIONS] [COMMAND_NAME] [SUB COMMAND OPTIONS]",
flag: flags,
/* YOU MUST SPECIFY positionalArguments with `makeSubCommandNameArgument` */
positionalArguments: commandNames /* YOU MUST SPECIFY positionalArguments with `makeSubCommandNameArgument` */,
/* passing sub commands with commandName to `makeSubCommandHandler()` */
handler: makeSubCommandHandler(
{ name: "sub1", command: subCommand1 },
{ name: "sub2", command: subCommand2 }
)
});
command(process.argv.splice(2));
running with ts-node
$ ts-node main.ts --opts1 --opts2 123 --opts3 test sub1 --subflag1 test sub-positional-args
arg1: sub-positional-args
opts1: true
opts2: 123
opts3: test
subflag1: test
and also shows rich help texts with --help
.
% ts-node main.ts --opts1 --opts2 123 --opts3 test sub1 --subflag1 test sub-positional-args --help
NAME:
example sub1 - catacli subcommand example (sub1)
USAGE:
example [OPTIONS] sub1 [SUB COMMAND OPTIONS]
VERSION:
0.0.1
ARGUMENTS:
arg1
OPTIONS:
--opts3, -a string example
--opts2 number example default=1
--opts1 boolean example
SUB OPTIONS:
--subflag1
--help show help
License
This project is licensed under the Apache License 2.0 License - see the LICENSE file for details