@squirrel-forge/node-cfx

Node stdout/console styler, replace the basic console methods and allow for coloured output.

Install

npm i @squirrel-forge/node-cfx

Example output

@squirrel-forge/node-cfx example text output">

Usage

Getting and using a default instance.

const { cfx } = require( '@squirrel-forge/node-cfx' );
cfx.log( '[ul][fgreen]underlined green text[re]' );

Default styled output.

cfx.success( 'success' );
cfx.error( 'error' );
cfx.warn( 'warning' );
cfx.info( 'info' );

Objects will not be styled, but outputted in plain, so you may mix arguments like with the console object.

cfx.success( 'success', { some : 'object' }, 'another message' );

Get a styled string:

const str = cfx.setStyle( '[ul][fgreen]underlined green text[re]' ); // \x1b[4m\x1b[32munderlined green text\x1b[0m

To enable automatic prefixing with the current timestamp set the prependTime property:

cfx.prependTime = true;

To change the timestamp style, use the timestampPrefix and timestampSuffix properties:

cfx.timestampPrefix = '[fwhite][[re][th]';
cfx.timestampSuffix = '[re][fwhite]][re] ';

Setting a custom timestamp format, see time-stamp for details.

cfx.timestampFormat = 'YYYY-MM-DD HH:mm:ss';

Styling options

Control and text style

Text and background colors

Overriding default styles

Default styles and reset.

cfx.style = {
    error : '[bred][fwhite] ',
    warn : '[byellow][fblack] ',
    info : '[bblack][fcyan] ',
    success : '[bgreen][fblack] ',
};
this.styleReset = ' [re]';

Default reset, used when no other reset is passed to the internal _write method, useful when making your own style methods.

cfx.defaultReset = ' [re]';

Creating a custom instance

const { ASCIIREF, OutputStyler } = require( '@squirrel-forge/node-cfx' );
const myCfx = new OutputStyler( ASCIIREF, console );

Extending the styler

const { ASCIIREF, OutputStyler } = require( '@squirrel-forge/node-cfx' );
// Extended styler class
class MyOutputStyler extends OutputStyler {
    constructor() {
        super( ASCIIREF, console );
        // Extend the constructor or set default options
    }
    // Add override or extend any methods
}

Issues and docs

If you encounter any issues, please report here.

Check the sourcecode on github for detailed comments.