0.1.0 • Published 12 years ago

ledger v0.1.0

Weekly downloads
2
License
-
Repository
bitbucket
Last release
12 years ago

#Ledger Ledger is an event based NodeJS module used for logging events to stdout, files or MongoDB.

Ledger overwrites console.log console.info console.warn and console.error to allow all output to be either colorized or outputted to a file or a MongoDB server.

##Installation:

npm install ledger

##Usage: //this will output to stdout/stderr //ledger.log and MongoDB listening at 127.0.0.1 var ledger = (require('ledger')({ logFile: 'ledger.log', logDb: true, });

ledger.on('log::error', function(time, msg){
    //do something special with errors
});

ledger.on('log::*', function(time, msg){
    //log catchall
});

console.log('log');
console.info('info');
console.warn('warn');
console.error('error');

##Options:

useColor: Boolean //whether to colorize stdout/stderr, Default: true
separator: String //separator used when building messages, Default: ' > '
timeFormatter: Function(date) //function used when formatting Date object to a string, Default: function(date){ return date.toString(); }

logStdout: Boolean //whether or not to print to stdout/stderr, Default: true
logFile: String //file to log all messages to, Default: false
logDb: Boolean //whether or not to log to a MongoDB server, Default: false

dbHost: String //host of MongoDB server, Default: '127.0.0.1'
dbPort: String //port that MongoDB server is listengin on, Default: '27017'
dbName: String //name of MongoDB database, Default: 'ledger'
dbCollection: String //name of collection to store messages in, Default: 'log'
dbUser: String //username to use when connecting to MongoDB server, Default: false
dbPass: String //password used to connect to MongoDB server, Default: false

##Methods:

log(msg) //mapped to console.log
info(msg) //mapped to console.info
warn(msg) //mapped to console.warn
error(msg) //mapped to console.error
now() //get the current time using timeFormatter setting

##Events:

log::log: (time, msg) //event that gets called after a call to console.log
log::info: (time, msg) //event that gets called after a call to console.info
log::warn: (time, msg) //event that gets called after a call to console.warn
log::error: (time, msg) //event that gets called after a call to console.error