Simple task runner

Installation

1npm install runner

Usage

Runner can be started by using npm or npx commands.

Run with npm:

1npm run build

where build is an npm script in the package.json which contains a runner command.

Run with npx:

1npx runner

The runner command format:

1runner [options] [<task>]

Available options:

Option	Description
-c, --config	Configuration file is a script which contains tasks definitions. Default value - runner.js.
-s, --serial	Run all given tasks sequentially (instead of in parallel).

These two commands are identical:

1npx runner
2npx runner --config runner.js

To run a webpack:build task from a custom configuration file:

1npx runner -c tasks/develop.js webpack:build 

Without the task name starts the default task:

1npx runner -c tasks/develop.js 

API

Add to the scope:

1import runner from 'runner';

Create a simple task:

1runner.task('make', function () {
2    // some actions
3});

More examples of tasks creation and execution are available in the cjs-runner package.

Add an alias to an existing task:

1runner.alias('build', 'make');

Run task on a key or keys combination press:

1runner.keystroke('build', 'ctrl+b');

Files watching

To execute a specific task on some file changes:

1runner.watch('src/script/**/*.js', 'webpack:build');

To execute a named or anonymous function:

1runner.watch('src/script/**/*.js', function rebuild ( done ) {
2    // function name "rebuild" is used as task name
3    // otherwise <noname> is printed
4    done();
5});

To execute task series:

1runner.watch('src/script/**/*.js', runner.serial('lint', 'build'));

Before calling runner.watch it's possible to configure the watch:

1runner.watch.config = {
2    // some configuration 
3};

All available configurations you can see in the underlying chokidar package.

Contribution

If you have any problems or suggestions please open an issue according to the contribution rules.

License

runner is released under the GPL-3.0 License.