custom-log v0.3.1

custom-log

A tiny (~2kb) flexible logger, very basic, simple and fast. Will add some features over time.

custom-log is targeted at the Browser as a tiny helper that makes available any custom log function you can create yourself, and which can be enabled/disabled individually.

Although there are plenty full-fledged loggers for use in node, you can use this one instead if you don't need a zillion features but rather prefer simplicity.

How to use?

First install:

Browser: <script src="./custom-log.min.js"></script>

Node: npm install --save custom-log

<function> customLog( <string>/<object> init )

Returns a log function based on the init argument. The init argument can be either a string or an object. If init is a string, only the base log function's prefix can be set with a string. In case init is an object, multiple custom log functions with their own prefix strings can be defined in the init object. To set the base log function prefix in a init object, use the reserved 'log' key. See some examples below:

// customLog is global when loaded in browser, for node use:
const customLog= require( 'custom-log' );


// create a single log function without prefix:
const log= customLog();

log( 'hey!' );
// hey!


// create a log function with multiple custom log functions attached to it
// you can silently enable/disable by adding settings if needed:
const settings = {
	silentDisable	: false	// default
	silentEnable	: false	// default
};

const log= customLog({
	info		: 'INFO: ',
	warning		: 'WARNING: ',
	error		: 'ERROR: ',
	listener	: 'LISTENER: ',
	dal			: 'DAL: '
	// use the result of a function as prefix for logs
	time		: () => new Date()
}, settings );

log( 'hello' );
// hello

log.info( 'easy!' );
// INFO: easy!

log.dal( 'Success! Payload: ', 'some payload' );
// DAL: Success! Payload: some payload

// now temporarily turn off dal messages:
log.dal.disable();

// and turn them on again:
log.dal.enable();

// disable or enable multiple levels at once
// arguments can be either (space seperated)String, Array of strings, multiple Strings
log.disable( 'dal listener error log' );
// or
log.enable( 'error', 'listener', 'log' );
// or
log.enable( ['error', 'listener', 'log'] );

change log

0.3.0

• removes log.assert
• adds dynamic function prefix
• adds 'silentEnable' and 'silentDisable' initialization modes

0.2.3

• removes leading space for default log without prefix
• log.assert is way too naive and you better use something like the 'assert' npm lib for that. log.assert is now deprecated and will be removed over time.

0.2.1

changes license to MIT

0.1.9

Fixed bug that caused a crash on using the disable or enable function

0.1.6

Added log.assert function

0.1.0

Initial commit.

###license

MIT