Home

Awesome

base-task NPM version NPM monthly downloads NPM total downloads Linux Build Status

Base plugin that provides a very thin wrapper around https://github.com/doowb/composer for adding task methods to your Base application.

Please consider following this project's author, Jon Schlinkert, and consider starring the project to show your :heart: and support.

Install

Install with npm:

$ npm install --save base-task

Usage

const Base = require('base');
const tasks = require('base-task');
const base = new Base();

base.use(tasks());

/**
 * Define tasks
 */

base.task('foo', cb => {
  console.log('this is foo!');
  cb();
});

base.task('bar', cb => {
  console.log('this is bar!');
  cb();
});

/**
 * Build tasks
 */

base.build(['foo', 'bar'])
  .then(() => {
    // this is foo!
    // this is bar!
    console.log('done!');
  })
  .catch(console.error)

See the composer documentation for more details, or to create bug reports related to running or registering tasks.

API

.task

Register a task

Params

Examples

Register a task.

app.task('default', function() {
  // return the stream to signal "done"
  return app.src('pages/*.hbs')
    .pipe(app.dest('dist'));
});

Register a task with dependencies (other tasks to run before executing the task):

app.task('site', ['styles'], function() {
  return app.src('pages/*.hbs')
    .pipe(app.dest('dist'));
});

app.task('default', ['site']);

Get a task

const task = app.task('site');

.build

Run a task or array of tasks.

Promise examples

// run the "default" task, if defined
app.build();
app.build('default');

// run an array of tasks
app.build(['foo', 'bar'])
  .then(() => console.log('done!'))
  .catch(console.error);

Callback examples

// run the "default" task, if defined
app.build(function(err, results) {
  if (err) return console.error(err);
  console.log(results);
});

app.build('default', function(err, results) {
  if (err) return console.error(err);
  console.log(results);
});

app.build(['foo', 'bar'], function(err, results) {
  if (err) return console.error(err);
  console.log(results);
});

.series

Compose task or list of tasks into a single function that runs the tasks in series.

Params

Example

app.task('foo', cb => {
  console.log('this is foo');
  cb();
});

const build = app.series('foo', cb => {
  console.log('this is bar');
  cb();
});

build(function(err) {
  if (err) return console.error(err);
  console.log('finished');
});
//=> this is foo
//=> this is bar
//=> finished

.parallel

Compose task or list of tasks into a single function that runs the tasks in parallel.

Params

Example

app.task('foo', cb => {
  setTimeout(function() {
    console.log('this is foo');
    cb();
  }, 500);
});

const build = app.parallel('foo', cb => {
  console.log('this is bar');
  cb();
});

build(function(err) {
  if (err) return console.error(err);
  console.log('finished');
});
//=> this is bar
//=> this is foo
//=> finished

Events

The following events are emitted by composer. See the composer docs for more details

on.task

Emitted when a task is register, starting and finished.

app.on('task', function(task) {
  console.log(task.status);
  //=> 'register'
});

on.build

Emitted when a build is starting and finished.

app.on('build', function(build) {
  console.log(build.status);
  //=> 'starting'
});

History

v2.0.0

v0.3.0

About

<details> <summary><strong>Contributing</strong></summary>

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

</details> <details> <summary><strong>Running Tests</strong></summary>

Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:

$ npm install && npm test
</details> <details> <summary><strong>Building docs</strong></summary>

(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)

To generate the readme, run the following command:

$ npm install -g verbose/verb#dev verb-generate-readme && verb
</details>

Related projects

Other base plugins you might be interested in:

Contributors

CommitsContributor
60jonschlinkert
6doowb
2davequick

Author

Jon Schlinkert

License

Copyright © 2018, Jon Schlinkert. Released under the MIT License.


This file was generated by verb-generate-readme, v0.8.0, on November 22, 2018.