Status!

Makes a little stdout status bar. Currently something I made to use for tooling in node. Very early/rough stage, changing often.

npm install node-status

An example!

// Initialize the item with options

var status = require('node-status')

var pizzas = status.addItem("pizza", {
  type: ['bar','percentage'],
  max: 8
})

// Start the status-bar
status.start()

// Increment the item whenever you need it updated
pizzas.inc()
pizzas.inc(3)

Example output: (More examples in example.js)

Config

Status accepts the following config options on start():

• invert: defaults to true.
• interval: defaults to 250. Number of milliseconds per re-draw interval.

status.start({
    invert: false, 
    interval: 200
})

Item Options

All item options are optional.

• type: defaults to 'count'. Accepts a single type, or an array of types:
  • function(item){ retun item.count }: specify a type as a custom function to process
  • count: displays the current count. Will display count/max if max is specified.
  • bar: displays a progress bar of ten segments. Only displays if max is set.
  • percentage: displays a percentage to 2 decimals. Only displays if max is set. Precision can be set manually.
  • time: displays the current time since the application started.
  • text: use to display a string value, set as the text property of the item.
• label: defaults to item name. The label that precedes the count/status.
• count: defaults to 0 (zero). Can specify a starting count.
• max: Will cause 'count' type to display as <count>/<max>. Required for some types.
• color: Status uses Color to colorize labels. Specifiy colors as strings.
• precision: defaults to 2. The precision used in percentages.

Using Console.log alongside status

Right now, if you have to use console.log after the status bar has started, it can be a bit janky because the stdout line isn't cleared when a console.log is run.

You can utilize an extended console.log by adding this after requiring status.

console = status.console()

Todo's

• Add an option to have the bar always at the bottom of the terminal window or just at the bottom of the current page