This package has been deprecated

Author message:

Turbocolor has been deprecated. Please upgrade to Colorette 'npm i colorette'

turbocolor
TypeScript icon, indicating that this package has built-in type declarations

2.6.1 • Public • Published

Turbocolor

CI Coverage

Turbocolor is a Node.js library for colorizing text using ANSI escape sequences.

Features

Installation

npm i turbocolor

Usage

const tc = require("turbocolor")

Using styles.

console.log(tc.red("Hello!"))

Chaining styles.

console.log(tc.red.bold("Turbo") + tc.bgRed.white("Color"))

Using template literals.

console.log(`
  ${tc.bold("Score")}${100}
  Lives: ${tc.red.inverse(1)}
  Level: ${tc.bgCyan.black.inverse(2)}
`)

Nesting styles.

console.log(`Normal ${tc.bold(`Bold ${tc.red("Bold/Red")} Bold`)} Normal`)

Using console.log string substitution.

console.log(tc.green("Total: $%f"), 1.99)

API

tc.style[.style...](string)

Every style function can be chained or nested with one another and when invoked, will return the given string argument wrapped in the corresponding ANSI escape codes. Style precedence is determined by chaining order in a first-come, first-served basis. This means that tc.red.green.blue is reduced to tc.red.

tc.Styles

Turbocolor exports ANSI escape codes for each available style. Use them if you want to stylize console output manually.

const { Styles } = require("turbocolor")
 
console.log(`${Styles.red.open}Red${Styles.red.close}`)

tc.enabled

Color support is automatically enabled if your terminal supports it, but you can toggle it on/off as needed.

const tc = require("turbocolor")
 
tc.enabled = false

Styles

Turbocolor only supports the regular color set at the moment. If you want to use the high intensity variations or need 256 color/Truecolor support, please use chalk instead.

Colors Background Colors Modifiers
black bgBlack dim
red bgRed bold
green bgGreen hidden
yellow bgYellow italic
blue bgBlue underline
magenta bgMagenta inverse
cyan bgCyan strikethrough
white bgWhite reset
gray

Benchmark Results

All tests run on a 2.4GHz Intel Core i7 CPU with 16 GB memory.

npm i -C bench && node bench
# Using Styles
chalk × 8,510 ops/sec
kleur × 298,812 ops/sec
ansi-colors × 299,145 ops/sec
turbocolor × 606,180 ops/sec

# Chaining Styles
chalk × 1,881 ops/sec
kleur × 43,187 ops/sec
ansi-colors × 22,549 ops/sec
turbocolor × 58,745 ops/sec

# Nesting Styles
chalk × 12,449 ops/sec
kleur × 183,384 ops/sec
ansi-colors × 123,488 ops/sec
turbocolor × 197,616 ops/sec

License

Turbocolor is MIT licensed. See LICENSE.

Package Sidebar

Install

npm i turbocolor

Weekly Downloads

1,064

Version

2.6.1

License

MIT

Unpacked Size

9.97 kB

Total Files

5

Last publish

Collaborators

  • npm