cli-ux

What is cli-ux?

The cli-ux npm package provides a set of utilities for building command-line interfaces (CLIs). It offers features such as progress bars, spinners, prompts, and table formatting to enhance the user experience of CLI applications.

What are cli-ux's main functionalities?

Progress Bar

This feature allows you to display a progress bar in the terminal. The code sample demonstrates how to create and update a progress bar that increments by 5% every 100 milliseconds until it reaches 100%.

const cli = require('cli-ux');

const progress = cli.progress({ format: 'progress [{bar}] {percentage}% | ETA: {eta}s' });
progress.start(100, 0);

let value = 0;
const interval = setInterval(() => {
  value += 5;
  progress.update(value);
  if (value >= 100) {
    clearInterval(interval);
    progress.stop();
  }
}, 100);

Spinner

This feature provides a spinner to indicate ongoing processes. The code sample shows how to start a spinner with a message and stop it after 3 seconds with a 'done' message.

const cli = require('cli-ux');

cli.action.start('Processing');
setTimeout(() => {
  cli.action.stop('done');
}, 3000);

Prompt

This feature allows you to prompt the user for input. The code sample demonstrates how to ask the user for their name and then greet them with the provided input.

const cli = require('cli-ux');

(async () => {
  const name = await cli.prompt('What is your name?');
  console.log(`Hello, ${name}!`);
})();

Table

This feature allows you to display data in a table format. The code sample shows how to create a table with two columns: 'name' and 'age', and display two rows of data.

const cli = require('cli-ux');

const data = [
  { name: 'John', age: 30 },
  { name: 'Jane', age: 25 }
];
cli.table(data, {
  name: {
    minWidth: 7
  },
  age: {
    header: 'Age'
  }
});

Other packages similar to cli-ux

ora

Ora is a lightweight and elegant terminal spinner. It provides similar functionality to the spinner feature in cli-ux but focuses solely on spinners, offering more customization options and better performance.

inquirer

Inquirer is a powerful library for creating interactive command-line prompts. It offers more advanced and flexible prompt types compared to cli-ux, making it a better choice for complex user interactions.

blessed

Blessed is a comprehensive library for building terminal interfaces. It provides a wide range of widgets, including tables, forms, and more, offering greater flexibility and customization than cli-ux.

progress

Progress is a simple and flexible progress bar library for Node.js. It offers similar functionality to the progress bar feature in cli-ux but with a more minimalistic approach and fewer dependencies.

README

The README file is missing

Changelog

3.0.0 (2018-01-19)

Bug Fixes

• add sourceMap (11375af)
• added actions (8782559)
• export ExitError (47e372b)
• only handle errors once (f969ff3)
• rethrow errors (08be292)
• scope exitErr (01eac05)
• scopes (e0394f6)
• use old error style (f10be7d)

Features

• added styledHeader and styledJSON (3c9f01d)
• added styledHeader and styledJSON (00f2913)
• v3 (07e27d5)
• v3 (0c03a77)

BREAKING CHANGES

• removed mocking ability. Use @dxcli/dev-test or std-mocks instead for this functionality.

<a name="2.1.0"></a>