Metadata-Version: 2.1
Name: jsonlog-cli
Version: 5.1.0
Summary: Convert structured JSON logs to human-readable output
Home-page: https://github.com/borntyping/jsonlog/tree/master/jsonlog-cli
License: MIT
Author: Sam Clements
Author-email: sam@borntyping.co.uk
Requires-Python: >=3.6,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Dist: click
Requires-Dist: jsonlog
Requires-Dist: jsonschema
Requires-Dist: xdg
Project-URL: Repository, https://github.com/borntyping/jsonlog
Description-Content-Type: text/markdown

jsonlog-cli
===========

A human readable formatter for JSON logs.
 
It's built for use with [jsonlog] but will work well with any log format that
uses line delimited JSON.

![Example output](https://raw.githubusercontent.com/borntyping/jsonlog-cli/master/docs/example.png)

Usage
-----

Pass a file as the only argument to `jsonlog`, or read from STDIN by default.

```bash
jsonlog docs/example.log
```

```bash
python docs/example.py | jsonlog
```

Configuration
-------------

See `jsonlog --help` for all options.

Only show timestamps and messages (defaults to `{timestamp} {level} {name} {message}`).

```bash
jsonlog --format "{timestamp} {message}" docs/example.log
```

Configure the keys of multiline values you want to display (can be specified
multiple times, and defaults to the `traceback` key.)

```bash
jsonlog --format "{timestamp} {message}" docs/example.log
```

Configure the key to extract and use as the records level, controlling the
colour each line is printed in (defaults to the `level` key).

```bash
jsonlog --format "{timestamp} {message}" docs/example.log
```

Authors
-------

* [Sam Clements]

[jsonlog]: https://github.com/borntyping/jsonlog
[Sam Clements]: https://gitlab.com/borntyping

