You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 7-8.RSVP
Socket
Socket
Sign inDemoInstall

cliui

Package Overview
Dependencies
20
Maintainers
2
Versions
25
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

cliui

easily create complex multi-column command-line-interfaces


Version published
Maintainers
2
Created

Package description

What is cliui?

The cliui npm package is a library for creating complex command-line interfaces with various layout controls such as word-wrapping, alignment, padding, and more. It allows developers to build structured and formatted output for command-line applications.

What are cliui's main functionalities?

Text alignment and wrapping

This feature allows for aligning text within a specified width and automatically wraps text that exceeds the width. Padding can be added around the text.

const cliui = require('cliui')({ width: 80 });

cliui.div(
  { text: 'Some long text that needs to be wrapped', align: 'left', padding: [1, 2, 1, 2] },
  { text: 'Aligned right', align: 'right' }
);

console.log(cliui.toString());

Column-based layout

This feature allows developers to create a layout based on columns, specifying the width of each column for structured output.

const cliui = require('cliui')({ width: 80 });

cliui.div(
  { text: 'Column 1', width: 30 },
  { text: 'Column 2', width: 30 },
  { text: 'Column 3', width: 20 }
);

console.log(cliui.toString());

Complex nested layouts

This feature supports creating nested layouts, allowing for complex and hierarchical interface designs.

const cliui = require('cliui')({ width: 80 });

cliui.div(
  {
    text: 'Top level',
    padding: [1, 0, 1, 0],
    border: true
  },
  {
    text: cliui.div(
      { text: 'Nested level 1', align: 'center' },
      { text: cliui.div(
        { text: 'Nested level 2', align: 'center' }
      )}
    )
  }
);

console.log(cliui.toString());

Other packages similar to cliui

Changelog

Source

8.0.1 (2022-10-01)

Bug Fixes

  • deps: move rollup-plugin-ts to dev deps (#124) (7c8bd6b)

Readme

Source

cliui

ci NPM version Conventional Commits nycrc config on GitHub

easily create complex multi-column command-line-interfaces.

Example

const ui = require('cliui')()

ui.div('Usage: $0 [command] [options]')

ui.div({
  text: 'Options:',
  padding: [2, 0, 1, 0]
})

ui.div(
  {
    text: "-f, --file",
    width: 20,
    padding: [0, 4, 0, 4]
  },
  {
    text: "the file to load." +
      chalk.green("(if this description is long it wraps).")
    ,
    width: 20
  },
  {
    text: chalk.red("[required]"),
    align: 'right'
  }
)

console.log(ui.toString())

Deno/ESM Support

As of v7 cliui supports Deno and ESM:

import cliui from "https://deno.land/x/cliui/deno.ts";

const ui = cliui({})

ui.div('Usage: $0 [command] [options]')

ui.div({
  text: 'Options:',
  padding: [2, 0, 1, 0]
})

ui.div({
  text: "-f, --file",
  width: 20,
  padding: [0, 4, 0, 4]
})

console.log(ui.toString())

Layout DSL

cliui exposes a simple layout DSL:

If you create a single ui.div, passing a string rather than an object:

  • \n: characters will be interpreted as new rows.
  • \t: characters will be interpreted as new columns.
  • \s: characters will be interpreted as padding.

as an example...

var ui = require('./')({
  width: 60
})

ui.div(
  'Usage: node ./bin/foo.js\n' +
  '  <regex>\t  provide a regex\n' +
  '  <glob>\t  provide a glob\t [required]'
)

console.log(ui.toString())

will output:

Usage: node ./bin/foo.js
  <regex>  provide a regex
  <glob>   provide a glob          [required]

Methods

cliui = require('cliui')

cliui({width: integer})

Specify the maximum width of the UI being generated. If no width is provided, cliui will try to get the current window's width and use it, and if that doesn't work, width will be set to 80.

cliui({wrap: boolean})

Enable or disable the wrapping of text in a column.

cliui.div(column, column, column)

Create a row with any number of columns, a column can either be a string, or an object with the following options:

  • text: some text to place in the column.
  • width: the width of a column.
  • align: alignment, right or center.
  • padding: [top, right, bottom, left].
  • border: should a border be placed around the div?

cliui.span(column, column, column)

Similar to div, except the next row will be appended without a new line being created.

cliui.resetOutput()

Resets the UI elements of the current cliui instance, maintaining the values set for width and wrap.

Keywords

FAQs

Package last updated on 01 Oct 2022

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc