@poppinss/colors

Wrapper over kleur with better support for testing

Why this package exists?

This package is a wrapper over kleur with additional implementations to make testing easier and work seamlessly with terminals/stdout streams that do not support colors.

Usage

Install the package from the npm registry as follows.

1npm i @poppinss/colors

And use it as follows. The ansi method returns an instance of the kleur package.

1import useColors from '@poppinss/colors'
2const colors = useColors.ansi()
3
4console.log(colors.red('this is an error'))
5console.log(colors.cyan('hello world'))

Chaining methods

1const colors = useColors.ansi()
2console.log(colors.red().bgBlack('this is an error'))

Raw implementation

The raw implementation is ideal for testing. Instead of outputting ANSI escape codes, we wrap the string with transformation names. For example:

1import useColors from '@poppinss/colors'
2const colors = useColors.raw()
3
4console.log(colors.red('hello world'))
5// OUTPUT: red(hello world)
6
7console.log(colors.bgBlack().red('hello world'))
8// OUTPUT: bgBlack(red(hello world))

As you can notice, the output is a plain text value, so it is easier to write assertions against it.

1assert.equal(colors.red('hello world'), 'red(hello world)')

Silent output

The silent mode does not perform any transformations on the string and returns the value. This is helpful when the output terminal or stdout stream does not support colors.

1import useColors from '@poppinss/colors'
2const colors = useColors.silent()
3
4console.log(colors.red('hello world'))
5// OUTPUT: hello world
6
7console.log(colors.bgBlack().red('hello world'))
8// OUTPUT: hello world

Pick based on the runtime environment

Ideally, you will use one of the available implementations based on some runtime environment. For example:

1import useColors from '@poppinss/colors'
2import supportsColor from 'supports-color'
3
4const isTestEnv = process.env.NODE_ENV === 'test'
5
6const colors = isTestEnv
7  ? useColors.raw() // use raw in test environment
8  : supportsColor.stdout
9    ? useColors.ansi() // use kleur when stdout has colors
10    : useColors.silent() // use silent mode 
11
12export default colors