var logger = require('tp-logger')(/* optional options, see Options below */);
 
// Behaves the same as default console, where you can use string formatting
logger.log('lol: %d hours', 2);
// [2015-12-16T06:49:08+00:00][vanilla.js] lol: 2 hours
 
logger.info('dota');
// [2015-12-16T06:49:08+00:00][vanilla.js] dota
 
logger.warn('cs:go'); // added since 1.0
// [2015-12-16T06:49:08+00:00][vanilla.js] cs:go
 
logger.error(new Error('helldivers').stack);
// [2015-12-16T06:49:08+00:00][vanilla.js] Error: helldivers
//     at Object.<anonymous> (/Users/woozyking/proj/personal/tp-logger/examples/vanilla.js:9:14)
//     at Module._compile (module.js:425:26)
//     at Object.Module._extensions..js (module.js:432:10)
//     at Module.load (module.js:356:32)
//     at Function.Module._load (module.js:313:12)
//     at Function.Module.runMain (module.js:457:10)
//     at startup (node.js:138:18)
//     at node.js:974:3

// NOT Recommended
console = require('tp-logger')(/* optional options, see Options below */);
// ...

var TPLogger = require('tp-logger').TPLogger;
var logger = new TPLogger(/* optional options, see Options below */);
 
console.log(logger instanceof TPLogger); // true
console.log(logger instanceof require('console').Console); // true
 
logger.logOnce({
  fullPath: true // change on the fly behavior
}, 'Log Message');
// [2015-12-16T06:49:08+00:00][/full/path/to/class.js] Log Message
 
logger.meta({
  pid: true // also supports on the fly opt change
});
// [2015-12-16T06:49:08+00:00][class.js][12345]
 
class TPLogger2 extends TPLogger {
  // your implementation, etc
}

var app = require('express')();
var loggerMw = require('tp-logger').middleware(/* same optional options supported, see Options below */);
 
app.get('/', function(req, res, next) {
  // handling request
  // ...
  // something went wrong, a wild error appeared
  return next(error);
});
 
// plug in our logger middleware to log handler passed errors
app.use(loggerMw);

var logger = require('tp-logger')({
  // stream for log() and info(). Not applicable for on the fly `Once` methods
  stdout: <writable stream instances. Default: process.stdout>,
 
  // stream for warn() and error(). Not applicable for on the fly `Once` methods
  stderr: <writable stream instances. Default: process.stderr>,
 
  // whether to use local time or UTC time
  local: <boolean. Default: false>,
  localTs: <Alias of 'local'. Since 0.2>,
 
  // timestamp format
  tsFormat: <string. See moment.js formatting documentation>,
 
  // whether to log full path of the caller or just caller filename
  fullPath: <boolean. Default: false. Since 0.2>,
 
  // whether to log with a supplement of [log|info|err]
  // enforced to true when stdout == stderr
  logType: <boolean. Default: true when stdout == stderr. Since 0.2>,
 
  // include process.pid
  pid: <boolean. Default: false. Since 1.0>
});