bitandblack-console

Bit&Black Console

Create command line interfaces without pain.

This library is heavily inspired by the awesome Symfony Console.

Installation

This library is made for the use with Node. Add it to your project by running $ npm install bitandblack-console or $ yarn add bitandblack-console.

Usage

The Console tool consists of two parts: the commands and the application that executes them. To create a command, you need to create a class that extends the existing AbstractConsoleCommand class.

This is a simple command that outputs some text to the command line:

import { AbstractConsoleCommand, ConsoleCommandInterface, InputInterface, OutputInterface } from "bitandblack-console";

class TestCommand extends AbstractConsoleCommand {
    configure(): void {
        this
            .setName("test")
            .setDescription("This is my first command.")
        ;
    }

    execute(input: InputInterface, output: OutputInterface): number {
        output.writeln("It works!");
        return ConsoleCommandInterface.SUCCESS;
    }
}

export { TestCommand }

To make this command available in the console application, we need to initialize a Application object and add the TestCommand there.

Create a bin/console file with the following content:

#!/usr/bin/env node

const { Application } = require("bitandblack-console/src/Application");
const { TestCommand } = require("../src/Commands/TestCommand");

const application = new Application();
application
    .addCommand(new TestCommand())
    .run()
;

Now you are able to run your console application by calling $ bin/console and the test command by calling $ bin/console test.

Help

If you have any questions, feel free to contact us under [e-mail].

Further information about Bit&Black can be found under www.bitandblack.com.