jsLogMgr
"The most effective debugging tool is still careful thought, coupled with judiciously placed print statements." - Brian Kernighan
Javascript-based logger extension to the console API. The basic design principle behind this implementation is to provide an API extension to the console API while providing some of the benefit of a more robust and configurable logging library.
Features
- Ability to create loggers for specific code contexts (classes, functions, etc),
- Configurable control over:
- color styling of log statements by level,
- date, context, message formatting of logging statements (coming soon)
- log output by level,
- API consistency with the console API for easy replacement and adoption.
Installation
NPM
$ npm install --save jslogmgr
Usage
; { // create the log manager. thislogManager = ; // create a logger, by contextual name. thislogger = thislogManager; thislogger; } { thislogger; thislogger; thislogger; thislogger; thislogger; thislogger; thislogger; thislogger; }
will result in:
Configuration
jsLogger is configurable to allow you to specify a minimum level of output you desire, style output by level, specify your date formatting and (coming soon) format your log output.
Minimum level output
If you want to suppress all output below ERROR when deploying your application, you can set this up by defining the minumum level in the configuration with LoggerConfig.setLevel(logLevel.ERROR)
.
Output styling by level
If you would like to change the styling of the log output by level, you can accomplish this by the LoggerConfig.setLevelStyling(level, styling)
method. the styling
parameter can take any combination of chalk styling attributes. See the Styles section of the chalk page.
Date formatting
You can also change the data format of the log messages by supplying any moment based date format string to LoggerConfig.setDateFormat(format)
.
Contributing
Use Github issues for feature requests and bug reports.
We actively welcome pull requests.
For setting up & starting the project locally, use:
$ git clone https://github.com/nhpace/jsLogMgr$ cd jsLogMgr$ npm install$ npm run dev
LICENSE
MIT