TheThing
/
node-bunyan-lite
1
0
Fork 0
Code Issues Pull Requests Projects Releases 1 Wiki Activity

clean up README sectioN

This commit is contained in:
Trent Mick 2014-09-21 21:35:27 -07:00
parent 9e6a199ca5
commit f5e5d577f0
1 changed files with 53 additions and 49 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

102
README.md
View File

@ -943,15 +943,13 @@ Output of the above might be:
# Browserify # Browserify
XXX explain
As the [Browserify](http://browserify.org/) site says it "lets you As the [Browserify](http://browserify.org/) site says it "lets you
`require('modules')` in the browser by bundling up all of your dependencies." `require('modules')` in the browser by bundling up all of your dependencies."
It is a build tool to run on your node.js script to bundle up your script and It is a build tool to run on your node.js script to bundle up your script and
all its node.js dependencies into a single file that is runnable in the all its node.js dependencies into a single file that is runnable in the
browser via: browser via:
<script src="foo.browser.js"></script> <script src="play.browser.js"></script>
As of version 1.1.0, node-bunyan supports being run via Browserify. The As of version 1.1.0, node-bunyan supports being run via Browserify. The
default [stream](#streams) when running in the browser is one that emits default [stream](#streams) when running in the browser is one that emits
@ -965,69 +963,75 @@ script.
$ npm install browserify bunyan $ npm install browserify bunyan
2. An example script using Bunyan, "foo.js": 2. An example script using Bunyan, "play.js":
var bunyan = require('bunyan'); ```javascript
var log = bunyan.createLogger({name: 'play', level: 'debug'}); var bunyan = require('bunyan');
log.trace('this one does not emit'); var log = bunyan.createLogger({name: 'play', level: 'debug'});
log.debug('hi on debug'); // console.log log.trace('this one does not emit');
log.info('hi on info'); // console.info log.debug('hi on debug'); // console.log
log.warn('hi on warn'); // console.warn log.info('hi on info'); // console.info
log.error('hi on error'); // console.error log.warn('hi on warn'); // console.warn
log.error('hi on error'); // console.error
```
3. Build this into a bundle to run in the browser, "foo.browser.js": 3. Build this into a bundle to run in the browser, "play.browser.js":
$ ./node_modules/.bin/browserify foo.js -o foo.browser.js $ ./node_modules/.bin/browserify play.js -o play.browser.js
4. Put that into an HTML file, "foo.html": 4. Put that into an HTML file, "play.html":
<!DOCTYPE html> ```html
<html> <!DOCTYPE html>
<head> <html>
<meta charset="utf-8"> <head>
<script src="foo.browser.js"></script> <meta charset="utf-8">
</head> <script src="play.browser.js"></script>
<body> </head>
<div>hi</div> <body>
</body> <div>hi</div>
</html> </body>
</html>
```
5. Open that in your browser and open your browser console: 5. Open that in your browser and open your browser console:
$ open foo.html $ open play.html
Here is what it looks like in Firefox's console: ![Bunyan + Browserify in the Here is what it looks like in Firefox's console: ![Bunyan + Browserify in the
Firefox console](./docs/img/bunyan.browserify.png) Firefox console](./docs/img/bunyan.browserify.png)
For some the raw log records might not be desired, to have a rendered log line For some, the raw log records might not be desired. To have a rendered log line
you'll want to add your own stream, starting with something like this: you'll want to add your own stream, starting with something like this:
function MyRawStream() {} ```javascript
MyRawStream.prototype.write = function (rec) { function MyRawStream() {}
var nameFromLevel = { MyRawStream.prototype.write = function (rec) {
TRACE: 'TRACE' var nameFromLevel = {
DEBUG: 'DEBUG', TRACE: 'TRACE'
INFO: 'INFO', DEBUG: 'DEBUG',
WARN: 'WARN', INFO: 'INFO',
ERROR: 'ERROR', WARN: 'WARN',
FATAL: 'FATAL' ERROR: 'ERROR',
}; FATAL: 'FATAL'
console.log('[%s] %s: %s', rec.time, nameFromLevel[rec.level], rec.msg); };
} console.log('[%s] %s: %s', rec.time, nameFromLevel[rec.level], rec.msg);
}
var log = bunyan.createLogger({ var log = bunyan.createLogger({
name: 'foo', name: 'play',
streams: [ streams: [
{ {
level: 'info', level: 'info',
stream: new MyRawStream(), stream: new MyRawStream(),
type: 'raw' type: 'raw'
}, },
] ]
}); });
log.info('hi on info'); log.info('hi on info');
```