mydblog
v1.0.0
Published
A simple logging util for discord. It logs certain events
Downloads
3
Readme
npmlogger
NPM Logger is a package designed to write easily your log files. For more convenience npmlogger extends npmlog, so you can use it with minor changes in your application code.
Installation
npm install npmlogger --save
Basic Usage
// Call npmlogger instead of npmlog
var log = require('npmlogger');
// Set the log level required to be written
log.fileLevel = 'warn';
// Set the basepath for log files
log.fileBasePath = './logs';
// Set the filename
log.fileName = 'mylog.log';
// write error log to mylog.log
log.info('My prefix', 'i am info'); // Displayed but not written
log.error('My prefix', 'i am error'); // Displayed and written
Output :
[Fri Feb 03 2017 18:14:44 GMT+0100 (CET)] [error] [My prefix] i am error
Configuration
Note: All npmlogger methods and variables start with file
.
log.fileName
- {String}
The file name, .log
extension is automaticly added at the end of name.
log.fileBasePath
- {String}
The base path for the logs file, by default this is the logs
directory related to the executed file.
log.fileCreatePath
- {Bool}
When this feature is enabled, the path is automaticly created. Use mkpath package.
log.fileLevel
- {String}
The level to write logs. Any logs at or above this level will be written. The special level silent
will prevent anything from being logged ever.
log.fileColor
- {Bool}
By default npmlogger remove all console colors from file. You can allow colors by setting this option to true.
log.fileMaxSize
- {Number}
Set the max size for the log file, when the limit is reached the file is moved and a new one is created. The size is exprimed in kilobyte
. The new file is
named mylog_1.log
or mylog_error_1.log
if you enable log.fileLevelSuffix.
log.fileDatePrefix
- {String} See dateformat documentation
This option allow you to prefix the filename with your own date format.
Note: The date prefix is always put before log.fileHeadPrefix.
log.fileHeadPrefix
- {Bool}
This option allow you to prefix the files with the log.heading value like heading_mylog.log
.
Important It is highly recommended to use slug keyword for log.heading or enable log.fileSlugify when log.fileHeadPrefix is enabled.
log.fileLevelSuffix
- {Bool}
This option create seperated log file for each log level. So you can have mylog_error.log
, mylog_warn.log
, mylog_info.log
etc...
Important It is highly recommended to use slug keyword for custom level or enable log.fileSlugify when log.fileLevelSuffix is enabled.
log.fileSlugify
- {Bool}
When this feature is enabled the filename is slugified using RCF3986 standard.
Bug & suggestions
If you have any suggestions or have found a bug feel free to use the tracker.