Package Exports

progress-estimator
progress-estimator/src/index.js
progress-estimator/src/theme
progress-estimator/src/theme.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (progress-estimator) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

progress-estimator

Logs a progress bar and estimation for how long a Promise will take to complete. This library tracks previous durations in order to provide more accurate estimates over time.

Demo

Installation

# use npm
npm install progress-estimator

# use yarn
yarn add progress-estimator

Usage example

const createLogger = require('progress-estimator');
const { join } = require('path');

// All configuration keys are optional, but it's recommended to specify a storage location.
// Learn more about configuration options below.
const logger = createLogger({
  storagePath: join(__dirname, '.progress-estimator'),
});

async function run() {
  await logger(promiseOne, "This is a promise");
  await logger(
    promiseTwo,
    "This is another promise. I think it will take about 1 second",
    {
      estimate: 1000
    }
  );
}

API

`createLogger(optionalConfiguration)`

This method is the default package export. It creates and configures a logger function (documented below). The following configuration options are supported. (They apply only to the logger instance that's returned.)

name	type	Description
`logFunction`	Function	Custom logging function. Defaults to `log-update`. Must define `.done()` and `.clear()` methods.
`spinner`	object	Which spinner from the `cli-spinners` package to use. Defaults to `dots`.
`storagePath`	string	Where to record durations between runs. Defaults to `os.tmpdir()`.
`theme`	object	Custom `chalk` theme. Look to the default theme for a list of required keys.

`logger(promise, labelString, options)`

This method logs a progress bar and estimated duration for a promise. It requires at least two parameters– a Promise and a label (e.g. "Running tests"). The label is SHA1 hashed in order to uniquely identify the promise.

An optional third parameter can be provided as well with the following keys:

name	type	Description
`estimate`	Number	Estimated duration of promise. (This value is used initially, until a history of actual durations have been recorded.)
`id`	String	Uniquely identifies the promise. This value is needed if the label string is not guaranteed to be unique.