contextual logging library, no patch, no logging module replacement
Project description
contextual logging library, no patch, no logging module replacement
features
structured logging
contextual logging (via logger.bind)
(no conflicts (stdlib’s logging module))
example
main.py
from monokaki import basic_config, get_logger
import logging
logger = get_logger(__name__)
def run(log):
log.info("hello")
log.debug("hmm..")
def main():
log = logger.bind(name="foo")
run(log)
logger.info("bye")
# normal stdlib's logger
normallogger = logging.getLogger("stdlib's")
normallogger.info("hai")
if __name__ == "__main__":
import argparse
parser = argparse.ArgumentParser()
parser.add_argument(
"--logging", choices=list(sorted(logging._nameToLevel.keys())), default="INFO"
)
args = parser.parse_args()
basic_config(level=logging._nameToLevel[args.logging])
main()
$ python examples/readme/main.py
{"level": "INFO", "logger": "__main__", "msg": "hello", "name": "foo", "time": "2017-05-21 16:03:44,306"}
{"level": "INFO", "logger": "__main__", "msg": "bye", "time": "2017-05-21 16:03:44,307"}
INFO:stdlib's:hai
$ python examples/readme/main.py --logging=DEBUG
{"level": "INFO", "logger": "__main__", "msg": "hello", "name": "foo", "time": "2017-05-21 16:03:44,427"}
{"level": "DEBUG", "logger": "__main__", "msg": "hmm..", "name": "foo", "time": "2017-05-21 16:03:44,427"}
{"level": "INFO", "logger": "__main__", "msg": "bye", "time": "2017-05-21 16:03:44,428"}
INFO:stdlib's:hai
output customization
renderer.py
import json
from collections import OrderedDict
def ordered_json_render(data, record, formatter):
kwargs = OrderedDict()
# see: https://docs.python.org/3/library/logging.html#formatter-objects
kwargs["time"] = formatter.formatTime(record)
# see: https://docs.python.org/3/library/logging.html#logrecord-attributes
kwargs["level"] = record.levelname
kwargs["meg"] = record.msg
kwargs["caller"] = "{}:{}".format(record.pathname, record.lineno)
kwargs["source"] = record.name
# support exc_info or stack_info
if "stack" in data:
kwargs["stack"] = data["stack"]
# extra data
kwargs.update(record.kwargs)
return json.dumps(kwargs, indent=2)
main.py
from monokaki import get_logger, basic_config
logger = get_logger(__name__)
def main():
logger.bind(name="foo").info("hello", age=20)
logger.bind(name="foo").info("bye", age=21)
if __name__ == "__main__":
import logging
from renderer import ordered_json_render
basic_config(level=logging.INFO, renderer=ordered_json_render)
main()
$ python examples/customize-renderer/main.py
{
"time": "2017-05-21 16:03:44,645",
"level": "INFO",
"meg": "hello",
"caller": "examples/customize-renderer/main.py:6",
"source": "__main__",
"name": "foo",
"age": 20
}
{
"time": "2017-05-21 16:03:44,646",
"level": "INFO",
"meg": "bye",
"caller": "examples/customize-renderer/main.py:7",
"source": "__main__",
"name": "foo",
"age": 21
}
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
monokaki-0.1.1.tar.gz
(3.6 kB
view hashes)
Built Distribution
Close
Hashes for monokaki-0.1.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a816e60581e167af8c5e6c0bccf60e76a56c003f0ae224bc97202df7592731dc |
|
MD5 | aa00e1626ec3098f91c04d8e964d90c9 |
|
BLAKE2b-256 | eb6fb54f3f5677ddbf751a464e49589a0a56900e0b33518109564f4e352e82b2 |