debugnyan
A logging library that combines the simplicity and convenience of debug with the power of bunyan.
Status
Installation
Install the package via npm
:
$ npm install debugnyan --save
Usage
Create a logger by giving it a namespace and then call bunyan's log methods on the returned instance.
By default, similarly to debug
's behaviour, loggers do not output any content. Each logger output can be selectively activated by using the DEBUG
environment variable.
Pattern matching is based on the logger's name and it can optionally contain colons (:
) to create (sub)-components properties on the logger instance.
Consider a logger named foo:bar:biz
:
- this creates a
bunyan
logger with name foo
- and a
bunyan
(simple) child logger with property component
equal to bar
.
var logger1 = require('debugnyan')('foo');
var logger2 = require('debugnyan')('foo:bar');
logger1.debug('net');
logger2.debug('qux');
Example output with DEBUG=foo
:
DEBUG=foo node example.js
{"name":"foo","hostname":"ruimarinho","pid":1,"level":20,"msg":"net","time":"2016-10-04T18:54:14.530Z","v":0}
{"name":"foo","hostname":"ruimarinho","pid":1,"component":"bar","level":20,"msg":"qux","time":"2016-10-04T18:54:14.531Z","v":0}
Example output with DEBUG=foo:bar
:
DEBUG=foo:bar node example.js
{"name":"foo","hostname":"ruimarinho","pid":2,"component":"bar","level":20,"msg":"qux","time":"2016-10-04T18:55:08.217Z","v":0}
The prefix
and suffix
for each component is also customizable:
var logger = require('debugnyan')('foo', {}, { suffix: 'module' });
Tests
$ npm test
Release
$ npm version [<newversion> | major | minor | patch] -m "Release %s"
License
MIT