https://github.com/eugeny-dementev/winston-console-formatter

Pretty print console formatter in yaml like style
https://github.com/eugeny-dementev/winston-console-formatter

Last synced: 15 days ago
JSON representation

Pretty print console formatter in yaml like style

• Host: GitHub
• URL: https://github.com/eugeny-dementev/winston-console-formatter
• Owner: eugeny-dementev
• License: mit
• Archived: true
• Created: 2015-11-10T11:34:40.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2018-11-05T23:07:03.000Z (about 6 years ago)
• Last Synced: 2024-09-19T10:18:34.063Z (about 2 months ago)
• Language: JavaScript
• Size: 234 KB
• Stars: 24
• Watchers: 5
• Forks: 10
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Winston@2 console formatter

[![Build Status][travis-img]][travis-url]

[![Code Coverage][codecov-img]][codecov-url]

Pretty print console formatter in yaml like style for winston@2

## Install

```

npm install winston-console-formatter

```

This is custom config for default winston console transform.

## Usage

```js

const winston = require('winston');

const wcf = require('winston-console-formatter');

const logger = new winston.Logger({

  level: 'silly',

});

const { formatter, timestamp } = wcf();

logger.add(winston.transports.Console, {

  formatter,

  timestamp,

});

logger.log('error', 'message');

logger.log('warn', 'message');

logger.log('info', 'message');

logger.log('verbose', 'message');

logger.log('debug', 'message');

logger.log('silly', 'message');

```

## API

### wcf(options)

#### options

Type: `Object`

##### options.types

Type colors configuration for yamlify-object package
 Default:

```js

wcf({

  types: require('yamlify-object-colors'),

});

```

![Meta object example](/log.png?raw=true "Types example")

To disable types colors pass `false`:

```js

wcf({

  types: false,

});

```

##### options.colors

Message colors by log levels
 Default:

```js

const clc = require('cli-color');

wcf({

  colors: {

    silly: clc.blue,

    debug: clc.cyan,

    info: clc.green,

    warn: clc.yellow,

    error: clc.red,

    verbose: clc.magenta,

  },

});

```

![Levels color](/winston.png?raw=true "Levels color example")

To disable colors pass `false`:

```js

wcf({

  colors: false,

});

```

##### options.stackTrace

Showing passed to meta object `stack` or `trace` prop
 Type: `boolean`


Default: `true`

##### options.meta

Showing meta object
 Type: `boolean`
 Default: `true`

##### options.prefix

Type: `string`
 Default: `''`

##### options.postfix

Type: `string`
 Default: `''`

## Message line

winston-console-formatter can take winston `label` option to enrich message

line:

```js

logger.add(winston.transports.Console, {

  formatter,

  timestamp,

  label: 'some label',

});

logger.log('error', 'message');

```

![Label](/label.png?raw=true "Label example")

Also winston-console-formatter can handle `from` and `stack` props from meta

object to enrich message line

### from

```js

const meta = {

  from: 'Browser',

};

logger.log('error', 'message', meta);

```

![From](/from.png?raw=true "From example")

### stack

```js

try {

  undefined();

} catch (e) {

  logger.error(e.toString(), {

    stack: e.stack,

  });

}

```

![Stack](/stack.png?raw=true "Stack example")

[travis-img]: https://travis-ci.org/eugeny-dementev/winston-console-formatter.svg?branch=master

[travis-url]: https://travis-ci.org/eugeny-dementev/winston-console-formatter

[codecov-img]: https://codecov.io/github/eugeny-dementev/winston-console-formatter/coverage.svg?branch=master

[codecov-url]: https://codecov.io/github/eugeny-dementev/winston-console-formatter?branch=master