Skip to content

Commit

Permalink
Update docs; bump patch version
Browse files Browse the repository at this point in the history
  • Loading branch information
dnjstrom committed Dec 26, 2020
1 parent 6713722 commit e184995
Show file tree
Hide file tree
Showing 2 changed files with 45 additions and 16 deletions.
59 changes: 44 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,37 @@
# pino-dev

A simple prettifier for `pino` with built-in support for commonly used ecosystem packages (currently `pino-http` and `pino-debug`).
A simple prettifier for [pino](https://github.com/pinojs/pino) with built-in support for common ecosystem packages. Designed to be clear, unintrusive and to the point with sensible defaults optimized for use during development.

![Screenshot](https://github.com/dnjstrom/pino-dev/blob/main/screenshot.png?raw=true)

## Supported packages

* [pino](https://github.com/pinojs/pino)
* [pino-debug](https://github.com/pinojs/pino-debug)
* [pino-http](https://github.com/pinojs/pino-http)

Is your favorite pino package not yet supported? Request support [here](https://github.com/dnjstrom/pino-dev/issues/new).


## Issues

Discovered a problem with pino-dev? [Report an issue](https://github.com/dnjstrom/pino-dev/issues/new).

## Quickstart

Install with one of the commands below
Install using one of the commands below
```bash
npm install --save-dev pino-dev
yarn add --dev pino-dev
```

Then pipe the output of your `pino`-enhanced app to the `pino-dev` cli in your package.json.
then pipe the output of your `pino`-enhanced app to the `pino-dev` cli

```bash
./start-your-app | pino-dev
```

Often it's convenient to add this to your package.json scripts to not have to remember it.
```json
{
"scripts": {
Expand All @@ -29,7 +48,7 @@ yarn start | npx pino-dev

## Configuration

Any configuration can be stored as a `pino-dev.config.json` or `pino-dev.config.js` file at the root of your repo. It's also possible to use a `"pino-dev": {...}` key in your `package.json`.
Configuration is preferably stored as a `pino-dev.config.json` or `pino-dev.config.js` file at the root of your repo. It's also possible to use a `"pino-dev": {...}` key in your `package.json`.

### Default config
```json
Expand All @@ -51,10 +70,29 @@ Any configuration can be stored as a `pino-dev.config.json` or `pino-dev.config.
}
```

It's also possible to override the configuration file with the command-line arguments below:
#### newline

The newline character used in prettified output. Usually dependent on your operating system, it's either "\n" (default) or "\r\n".

#### time-format

The time format to use (syntax according to https://www.npmjs.com/package/date-fns).

#### propertyMap

This configuration allows you to map arbitrary incoming properties to semantic pino-dev properties using json. For instance,

```echo '{"message": "foobar"}' | pino-dev --property-map '{"msg": "message"}'```

would map the `message` property in the incoming json to the semantic property `msg` which enables `pino-dev` to understand how to format the log. For deep properties it's possible to use dot-notation, and mapping to a boolean `false` will disable the default mapping (e.g. `pino-dev --property-map '{"name": false}'` won't display the name in the prettified output).


### Command line arguments

It's also possible to specify/override configuration with command-line arguments:

```
Usage: pino dev [options]
Usage: pino-dev [options]
--color Force color.
-h, --help Output usage information
Expand All @@ -65,12 +103,3 @@ Usage: pino dev [options]
-v, --version Output the version number
```

#### propertyMap

This configuration allows you to map arbitrary incoming properties to semantic pino-dev properties using json. For instance,

```echo '{"message": "foobar"}' | pino-dev --property-map '{"msg": "message"}'```

would map the `message` property in the incoming json to the semantic property `msg` which enables `pino-dev` to understand how to format the log. For deep properties it's possible to use dot-notation, and mapping to a boolean `false` will disable the default mapping (e.g. `pino-dev --property-map '{"name": false}'` won't display the name in the prettified output).


2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "pino-dev",
"version": "1.0.3",
"version": "1.0.4",
"description": "A simple prettifier for pino with built-in support for commonly used ecosystem packages.",
"author": "Daniel Ström <[email protected]>",
"license": "ISC",
Expand Down

0 comments on commit e184995

Please sign in to comment.