log-a-log/README.md

Simple logger and console enhancement.

# Log-a-log

[![NPM version][npm-image]][npm-url]

A simple logger and optional decorator for console.log() and company.

## Installation
```
npm install log-a-log
```

## Modes
There are a number of operational modes, configured via the `mode` parameter:
* `local` - renders a local, ISO-8601 timestamp
* `coded` - renders a color-coded, UTC, ISO-8601 timestamp
* `pony` - renders a very colorful, UTC, ISO-8601 timestamp
* `utc` [default] - renders single-color, UTC, ISO-8601 UTC timestamp
* `unix` - renders a millisecond-granularity unix timestamp

## Configuration
Uses `@buzuli/color`, so colors can be configured to your preference (https://www.npmjs.com/package/@buzuli/color#configuration).

## Example
```javascript
const logalog = require('log-a-log')

logalog({mode: 'local', alias: 'my-script'})

const name = "world"

console.log(`Hello, ${name}!`)
console.error(`Oh noes, ${name}!`)
```

Sample Output:
```
[2015-10-30T21:52:05.520-06:00]my-script|INFO> Hello, world!
[2015-10-30T21:52:05.520-06:00]my-script|ERROR> Oh noes, world!
```

[npm-url]: https://www.npmjs.com/package/log-a-log
[npm-image]: https://img.shields.io/npm/v/log-a-log.svg