// TODO add link to book repo
automatically load book logging configuration from your environment or valid bookrc.js files.
bookrc allows you to configure your book logging in one place for your project. It follows a simple lookup pattern and returns either your
bookrc.js file or the default
Lets say we have application code which wants to do some logging and we want the logging to be sent to various locations and processed through the book middleware stack.
In the root of our app, we would create a
bookrc.js file which can setup additional middleware and logging features.
var log = require('book').default(); var raven = require('book-raven'); var git = require('book-git'); // we want to add a .commit field to our log entry with the git commit hash log.use(git(__dirname)); // we want to log errors to raven log.use(raven(process.env.SENTRY_DSN)); // now we just expose the logging object module.exports = log;
Now we just
require('bookrc') and use it like we used
book before. Except now our logs will run through our middleware stack and be tagged with our commit id and send to sentry for alerting.
Our app code does not have to change much at all. Simply update
require('bookrc') and you are set.
// instead of require('book'), use require('bookrc'); var log = require('bookrc'); // now you can just log as before, no other changes log.info('foo'); log.error('bar');
BOOK_RC env variable
If bookrc.js does not exist in the root of your project, or bookrc cannot find it. You can specify it manually using the
BOOK_RC environment variable. Set the variable to the absolute location of the bookrc.js file and bookrc will load that instead of searching.
Bookrc does not depend on book and vice versa. You must install both to have logging functionality. Bookrc is simply a dynamic loader for the bookrc.js file in your project.
npm install bookrc npm install book