Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
cliui
Advanced tools
Package description
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.
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());
Chalk is a popular npm package for styling terminal strings with colors and styles but does not provide layout controls like cliui.
Boxen allows you to create boxes in the terminal to highlight content. It is similar to cliui in that it helps format CLI output but does not offer the same level of layout control.
Inquirer.js is a comprehensive library for creating interactive command-line user interfaces. It includes features for prompting users but is more focused on user input than output formatting like cliui.
Blessed is a high-level terminal interface library that is more complex and feature-rich than cliui, offering a full-fledged terminal interface API, including screen widgets and mouse events.
Changelog
Readme
easily create complex multi-column command-line-interfaces.
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())
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())
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]
cliui = require('cliui')
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
.
Enable or disable the wrapping of text in a column.
Create a row with any number of columns, a column can either be a string, or an object with the following options:
right
or center
.[top, right, bottom, left]
.Similar to div
, except the next row will be appended without
a new line being created.
Resets the UI elements of the current cliui instance, maintaining the values
set for width
and wrap
.
FAQs
easily create complex multi-column command-line-interfaces
The npm package cliui receives a total of 64,208,447 weekly downloads. As such, cliui popularity was classified as popular.
We found that cliui demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
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.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.