Composer-runtimes NPM

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
options.displayTime {Function}: Override how the starting and finished times are displayed. See below
options.displayDuration {Function}: Override how the run duration is displayed. See below

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));