Knoblr
Knoblr is a simple logging library to help node developers.
It basically adds a funcionality of displaying three tips of logs:
- Warns
- Errors
- Info
Very simple. And it comes along with a timestamp and color codes!
Installing
Just do a npm install --save knoblr
Using
In your file require the logger:
const log = require('knoblr');
Then you can use like this:
const log = require('knoblr');
log.warn('This is a warn text');
log.error('This is an error text');
log.info('This is an info text');
This will be the output:
Customizing usage
There are options to customize the output of the log, such as:
- Datetime formats
- Whether or not to display the timestamp
- Displaying log type
- Logging colors
Datetime formats
Knoblr uses Moment.js to issue times and formats, so all the Moment's formats will be compatible with Knoblr.
Refer to this url to know more about formats.
In order to set the time formats you can do:
const log = require('knoblr');
log.setTimeFormat("Your format Here");
log.warn('This is a warn text with your timestamp');
log.error('This is an error text with your timestamp');
log.info('This is an info text with your timestamp');
The default time format is YYYY-MM-DD HH:mm:ss
(In other words its <4-digit year>/<2-digit month>/<2-digit-day> <24h hours>:<2-digit minutes>:<2-digit seconds>
).
Displaying the timestamp
You have the choice not to display the timestamp along with the log, just set:
const log = require('knoblr');
log.displayTimestamp(false);
log.warn('This is a warn text without the timestamp');
log.error('This is an error text without the timestamp');
log.info('This is an info text without the timestamp');
Displaying log type
Same as before, you can choose not to show {WARN}
, {INFO}
and {ERROR}
texts during logs, for that to happen all you have to do is:
const log = require('knoblr');
log.displayLogType(false);
log.warn('This is a warn text without the log type');
log.error('This is an error text without the log type');
log.info('This is an info text without the log type');
Log colors
Knoblr uses Chalk as colorizer, so you can set an instance of chalk using Knoblr return implementation object.
Knoblr exposes chalk as an instance so the you don't need to require it:
const log = require("../dist/log.js");
log.setLogColor('info', log.colors.green);
log.setLogColor('warn', log.colors.cyan);
log.setLogColor('error', log.colors.bgYellow);
log.warn('This will be cyan');
log.error('This will have an awesome yellow bg');
log.info('This will be green');
Reset
If you want to switch back to the original values just perform a log.reset()
.
Check the basetest file to get a glimpse of all commands.
This will be the output of the tests: