modulelog #

A library that allows easy userland swapping of different logging libraries.

By default it uses the built-in util.debuglog but any npm module can be
required and used, provided it has at least some of warn, info, error,
debug methods that it exposes on its exports. console can also be used,
except that no debug methods will be logged.

$3

``JS
var log = require('modulelog')('mymodulename');
log.setClass('console');
function cb(err) {
log.error("An error occured", {error: err});
}
`

A common use case would be to use flags
and allow the user to pass the class name via --logger:

`JS
var log = require('modulelog')('mymodulename'),
flags = require('flags');
flags.defineString('logger', 'debug', 'Your name');
flags.parse();
log.setClass(flags.get('logger'));
`

Methods ##

Note: you must pass your module/app name to the result of
require('modulelog') in order to get an instance to log with. The actual
class and level is globally controlled across modules but each module
must have a name for the debuglog prefix.

$3

Change the default logging library to be name. Built-in values are default,
debuglog, console. If an empty string is passed in, all logs will be
discarded. Any non-built-in values will be passed to require.

$3

Calls setLevel on the backing library. If the library doesn't support
different levels (like debuglog or console) then this does nothing.

$3

Calls the corresponding method on the backing library. If the library has no
fatal method, then error is called instead. After logging, process.exit
is invoked.

Static Methods ##

If you're trying to set the level or class in a static fashion setLevel and
setClass` are both exposed statically on the exports for the module.