composer-runtimes

composer-runtimes

Write composer task start and end times to a stream.

HEADS UP Api changes in 0.5.0

Install

Install with npm

$ npm i composer-runtimes --save

Usage

var composer = require('composer');
var runtimes = require('composer-runtimes');

API

runtimes

Listen to composer events and output runtime information.

Params

• options {Object}: Options to specify color output and stream to write to.
• options.colors {Boolean}: Show ansi colors or not. true by default
• options.stream {Stream}: Output stream to write to. process.stderr by default.
• options.displayName {Function}: Override how the task name is displayed. [See below][displayName]
• options.displayTime {Function}: Override how the starting and finished times are displayed. [See below][displayTime]
• options.displayDuration {Function}: Override how the run duration is displayed. [See below][displayDuration]

Example

runtimes({colors: false})(composer);

displayName

Override how the task name is displayed.

Params

• name {String}: Task name
• options {Object}: Options passed to runtimes and extend with application specific options.
• returns {String}: display name

Example

var options = {
  displayName: function(name, opts) {
    // `this` is the entire `task` object
    return 'Task: ' + name;
  }
};

composer.use(runtimes(options));

displayTime

Override how run times are displayed.

Params

• time {Date}: Javascript Date object.
• options {Object}: Options passed to runtimes and extend with application specific options.
• returns {String}: display time

Example

var formatTime = require('time-stamp')
var options = {
  displayTime: function(time, opts) {
    // `this` is the entire `run` object
    var formatted = formatTime('HH:mm:ss.ms', time);
    return 'Time: ' + formatted;
  }
};
composer.use(runtimes(options));

displayDuration

Override how duration times are displayed.

Params

• duration {Array}: Array from process.hrtime()
• options {Object}: Options passed to runtimes and extend with application specific options.
• returns {String}: display duration

Example

var pretty = require('pretty-time');
var options = {
  displayDuration: function(duration, opts) {
    // `this` is the entire `run` object
    var formatted = pretty(duration, 'μs', 2);
    return 'Duration: ' + formatted;
  }
};

composer.use(runtimes(options));

Related projects

• composer: API-first task runner with three methods: task, run and watch. | homepage
• composer-errors: Listen for and output Composer errors. | homepage

Running tests

Install dev dependencies:

$ npm i -d && npm test

Contributing

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

Author

Brian Woodward

• github/doowb
• twitter/doowb

License

Copyright © 2015 Brian Woodward Released under the MIT license.

---

This file was generated by verb on December 13, 2015.