README.md

echo-cli

A cross-platform CLI for outputting text to the command line (with escape sequences)

Why? Because Windows’ CMD doesn’t support escape sequences, and even a new line is printed differently from Bash. This makes outputting something from npm scripts much more challenging.

Install

To use in your package:

npm install --save-dev echo-cli

To use from the command line:

npm install --global echo-cli

Usage

echo-cli supports all JavaScript escape sequences described on the according MDN page. Feel free to open an issue if you need the Bash escape sequences too.

When passing an escape sequence, wrap the passed text into quotes to prevent Bash from interpreting the sequence on its own.

// In package.json
{
    "scripts": {
        "build": "echo-cli Building the project... && babel src -d dist",
        "test": "echo-cli 'Running the tests...\\nThis usually takes a couple of minutes.' && ava",
    }
}

// Or in Webpack config
{
    plugins: [
        new WebpackShellPlugin({
            onBuildEnd: ['copyfiles dist ../archive/dist && echo-cli "\\nCopied the build results"']
        })
    ]
}

# Or in a shell
$ echo-cli "Hello,\nworld!"
Hello,
world

License

MIT © Ivan Akulov