nclr

Mini NPM package with coloured log functions and more.

Contributions

Please refer to the contribution guideline.

Contributors

Maximilian Berkmann 🐛 💻 📖 🤔 💬 👀 🛡️ ⚠️	Dependabot 🔧	Semantic Release Bot 📖 📦	Codacy Badger 📖

Documentation

Table of Contents

• index
  • Parameters
• error
  • Parameters
  • Examples
• info
  • Parameters
  • Examples
• dbg
  • Parameters
  • Examples
• out
  • Parameters
  • Examples
• inp
  • Parameters
  • Examples
• warn
  • Parameters
  • Examples
• quest
  • Parameters
  • Examples
• succ
  • Parameters
  • Examples
• extend
  • Parameters
  • Examples
• clr
• clr
• lib
• log
  • Parameters
  • Examples
• use
  • Parameters
  • Examples
• restoreTheme

index

Set of functions for coloured logs.

Parameters

• data ...any

error

• See: log

Print an error.

Parameters

• data ...any Data to print

Examples

1error('Something wrong happened with', new Error(this));

Returns boolean Did it happened?

info

• See: log

Print an information.

Parameters

• data ...any Data to print

Examples

1info('Welcome John');

Returns boolean Did it happened?

dbg

• See: log

Print a debug message.

Parameters

• data ...any Data to print

Examples

1dbg('i=', i);

Returns boolean Did it happened?

out

• See: log

Print an output.

Parameters

• data ...any Data to print

Examples

1out(`1 + 1 = ${rpc('1 1 +')}`);

Returns boolean Did it happened?

inp

• See: log

Print an input.

Parameters

• data ...any Data to print

Examples

1inp(name);

Returns boolean Did it happened?

warn

• See: log

Print a warning.

Parameters

• data ...any Data to print

Examples

1warn('The following function is deprecated');

Returns boolean Did it happened?

quest

• See: log

Print a question.

Parameters

• data ...any Data to print

Examples

1quest('What is your username?');

Returns boolean Did it happened?

succ

• See: log

Print a success log.

Parameters

• data ...any Data to print

Examples

1succ('Achievement unlocked');

Returns boolean Did it happened?

extend

Extend the current theme.

Parameters

• extension {string: (string | Array<string>)} Theme to add

Examples

Using extensions as methods:

1const nclr = require('nclr');
2nclr.extend({
3  suc: ['green', 'underline'],
4  data: 'magenta'
5});
6nclr.suc('Yay!');
7nclr.data(42);

Using extensions as functions:

1const nclr = require('nclr');
2nclr.extend({
3  suc: ['green', 'underline'],
4  data: 'magenta'
5});
6const { suc, data } = nclr;
7suc('Yay!');
8data(42);

• Throws Error Invalid extension key

clr

CLI colours.

clr

Colour/style theme for the CLI.

Type: {inp: string, out: Array<string>, info: string, error: string, warn: string, dbg: string, quest: string}

lib

Set of library functions for nclr.

log

STDOUT log.

Parameters

• data any Data to print

Examples

1log('Lorem ipsum dolore sit amet');

Returns boolean Did it happened?

use

Colourise something.

Parameters

• name string Name of the log in the theme
• data ...any Data

Examples

1let information = use('info', 'Some info styled text');

Nesting

1log('Something', use('warn', 'really ', use('info', 'cool!')));

• Throws Error Invalid name

Returns string Coloured output

restoreTheme

Restore the default fields of the theme.