README.rst

Do not use this, use this instead: https://github.com/jteppinette/python-logfmter

This project is now managed by @wlonk at https://github.com/wlonk/logfmt-python.

Logfmt

Python package for parsing log lines in the logfmt style. See the original project by Blake Mizerany and Keith Rarick for information about logfmt conventions and use: https://github.com/kr/logfmt

Using logfmt

Easily process lines from logfmt formatted input:

from logfmt import parse

input = StringIO('\n'.join(['key1=value1', 'key2=value2']))
for values in parse(input):
    print values

This program produces this output:

{'key1': 'value1'}
{'key2': 'value2'}

Easily generate lines in logfmt formatted output

from logfmt import format

for line in format({'key1': 'value1'}, {'key2': 'value2'}):
    print line

This program produces this output:

key1="value1"
key2="value2"

Installation

To install it, simply:

pip install logfmt

Building and publishing

Update pyproject.toml's version number, commit and tag appropriately.

Ensure you have poetry installed, pip install poetry, then:

poetry publish