Skip to content

Multiple, simultaneous, individually controllable spinners for concurrent tasks in Node.js CLI programs

License

Notifications You must be signed in to change notification settings

codekirei/node-multispinner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

node-multispinner

Build Status Coverage Status

About | Installation | API | Examples | Attribution | License

About

node-multispinner is a Node.js module for managing multiple progress indicators (spinners) in CLI apps. This module is especially useful for apps that benefit from simultaneous async task execution (e.g. with Promise.all[]), as it enables live updating individual spinners, in any order, while other spinners continue spinning. Node.js 4.0 or newer is required.

demo-gif

Installation

Install and require as a standard Node module.

Install

  $ npm install --save multispinner

Require

  var Multispinner = require('multispinner')

API

Full documentation available here.

Examples

The examples discussed below can be found here. Run them in a terminal with node:

$ node <example>

Example: events.js

Creates four spinners from an array, then completes them in succession with staggered setTimeout functions. Responds to the success and err completion events.

Example: customAnimation.js

Creates a custom spinner animation with the frames option.

Example: randomInfiniteLoop.js

Creates three to seven spinners with random lorem text and completes them randomly in less than five seconds in an infinite loop. Stubs out the logUpdate.done() function to overwrite the previous output with every loop.

It's kind of mesmerising.

Example: cli-with-promises

A CLI application that reads URLs and parses HTML into text to display in a terminal. Uses meow for CLI support, html-to-text for parsing, and axios for Promise-based HTTP requests. Creates spinners for each URL, and uses Promise.all() to execute the GET requests in parallel.

There are certainly edge cases that this example doesn't account for; it is not meant to be a "real" application. Despite that, the code should be illustrative of how node-multispinner could potentially be used in a real application.

This example is unique in that it requires modules not used in node-multispinner. Before running it, cd into its directory and install the additional requirements from its package.json with npm install.

Attribution

Thanks to sindresorhus for his log-update module, which was a major inspiration for and is used extensively in this module. Log-update is MIT licensed.

License

MIT

About

Multiple, simultaneous, individually controllable spinners for concurrent tasks in Node.js CLI programs

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published