node-task-runner
v2.4.1
Published
A promise-based dependency-free task runner for Node.
Downloads
117
Readme
Node-Task-Runner
A promise-based dependency-free task runner for Node. This library was inspired by the Start-Runner.
Installation
npm install node-task-runner
CLI
Usage: ntr [options] <tasks> -- [arguments]
Options:
--file=<file> tasks file path, tasks.js by default
--parallel execute tasks in parallel rather than in sequence
Task definition
const tasks = {};
tasks.task1 = (reporter) => {
return new Promise((resolve) => {
setTimeout(() => {
resolve("test chain value");
}, 1000);
});
};
tasks.task2 = (reporter, chainValue, arg1, arg2) => {
reporter(`[chainValue: ${chainValue}, arg1: ${arg1}, arg2: ${arg2}]`);
return new Promise((resolve) => {
setTimeout(() => {
resolve();
}, 5000);
});
};
module.exports = {
tasks: tasks,
reporter: (m) => console.log(m)
};
You have to export all tasks that should be available. The name of the function is used as task name. All tasks should return a Promise. If they do not, the behavior is the same as Promise.resolve()
.
The reporter
function which is passed to all tasks as first argument should be used to emit output to the command line. This is important in parallel mode to avoid mixed up task output. The runner collects all output submitted through the reporter
function and emits all if a task finishes. In non-parallel mode the output is emitted immediately as console.log
would do. The reporter
function can be set with an export in the tasks-file as shown above. console.log
will be the default-value
if no reporter is exported.
In sequential mode previously resolved values, are passed to the next task function as second parameter. This feature is not available in parallel mode. In the above example, "task2" would receive "test chain value" as chainValue
if "task1" was executed before. If no value was resolved undefined
is passed.
The given task arguments from the cli are passed to all tasks as separate variables.
Messages of this library are colored, if chalk
is installed.
Run tasks manually
const ntr = require('node-task-runner');
...
tasks.task3 = (reporter) => {
return Promise.all([ntr.runTask("task1", true), ntr.runTask("task2", true)]);
};
...
Run functions manually
const ntr = require('node-task-runner');
...
tasks.task3 = (reporter) => {
return Promise.all([ntr.runFunction("func1", () => { /* do something */ }, true), ntr.runFunction("func2", () => { /* do something */ }, true)]);
};
...
You could run other tasks or functions sequentially or parallel from another task too. The last argument indicates if console outputs should be collected and emitted on
task-end or if they should be printed immediately. Default value is false
.