colorz

Ansi escaped color styling for the console and terminal

  • colorz

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
colorz
210.1.98 years ago8 years agoMinified + gzip package size for colorz in KB

Readme

colorz
!NPM versionnpm-imagenpm-url !schoolmarm-standard-stylemarm-imagemarm-url !experimentalstability-imagestability-url !Downloadsdownloads-imagedownloads-url
Ansi escaped color styling for the console/terminal

Why?

It loads fast. It runs fast. It's lightweight. It has no dependencies. I wanted to learn.

Installation

$ npm install colorz

Usage

see the example.js for further usage
var colorz = require('colorz')

colorz.red('because')
colorz.brRed('because')
colorz.green('because')
colorz.brGreen('because')
colorz.magenta('becaaaausssse')
colorz.cyan('because')
colorz.white('of')
colorz.gray('the')
colorz.inverse('wonderful')
colorz.black('things')
colorz.strikethrough('he')
colorz.red('does')
colorz.bgRed('da da da da da da da, dum dum')
colorz.underline(colorz.cyan('we\'re off to see the wizard'))
colorz.dim('the wonderful wizard of OZ!')
colorz.bold('hello world')

// you can also make things a bit easier for yourself 
const red = colorz.red
const blu = colorz.blue
// etc, etc.

console.log(red('Hello World'))
My iterm setup. YMMV

API

.[style](msg)

Enter a syle and your text message, i.e., colorz.inverse('Hello')
List of styles used by the API modifiers
reset
bold
dim
italic
underline
inverse
hidden
strikethrough
foregrounds
black
gray
grey
red
green
yellow
blue
magenta
cyan
white

bright foregrounds
brBlack
brGray
brGrey
brRed
brGreen
brYellow
brBlue
brMagenta
brCyan
brWhite

backgrounds
bgBlack
bgGray
bgGrey
bgRed
bgGreen
bgYellow
bgBlue
bgMagenta
bgCyan
bgWhite

bright backgrounds
bbBlack
bbGray
bbGrey
bbRed
bbGreen
bbYellow
bbBlue
bbMagenta
bbCyan
bbWhite

.strip(ansiDecoratedTextMsg)

Strip the ansi escaped sequences off the text
var text = colorz.cyan('Hello')
console.log(colorz.strip(text))
// --> Hello

.expose(color:STRING[, text:STRING, noColor:BOOLEAN])

Expose the ansi escape strings in color (default)
console.log(colorz.expose('green'))
console.log(colorz.expose('cyan', 'See me now'))
console.log(colorz.expose('bgYellow', 'I am a background', true))
console.log(colorz.expose('magenta', false))

See Also

There are many ansi escape terminal coloring applications running in the wild. Here are a few to start with:
  • chalk. Terminal string styling done right. Much color.
    colors. get colors in your node.js console
    colour.js. A cored, fixed, documented and optimized version of the popular colors.js
    neocolor. Minimal library for colored console output
    ansi-wrap. Create ansi colors by passing the open and close codes.
    clor. Sexy terminal styles
    colorful. colorful environment for command line tools in node

License

ISC