mirror of
https://github.com/sprockets/sprockets.logging.git
synced 2024-11-14 11:19:26 +00:00
Making logs nicer since 2015!
37ff1180f9
tornado_log_function: Make work with Tornado 4.3. |
||
---|---|---|
docs | ||
examples | ||
sprockets | ||
.gitignore | ||
.travis.yml | ||
LICENSE | ||
MANIFEST.in | ||
README.rst | ||
setup.cfg | ||
setup.py | ||
tests.py | ||
tox.ini |
sprockets.logging ================= Making logs nicer since 2015! |Version| |Downloads| |Travis| |CodeCov| |ReadTheDocs| Installation ------------ ``sprockets.logging`` is available on the `Python Package Index <https://pypi.python.org/pypi/sprockets.logging>`_ and can be installed via ``pip`` or ``easy_install``: .. code-block:: bash pip install sprockets.logging Documentation ------------- https://sprocketslogging.readthedocs.org Requirements ------------ - No external requirements Example ------- This examples demonstrates the most basic usage of ``sprockets.logging`` .. code-block:: python import logging import sys import sprockets.logging formatter = logging.Formatter('%(levelname)s %(message)s {%(context)s}') handler = logging.StreamHandler(sys.stdout) handler.setFormatter(formatter) handler.addFilter(sprockets.logging.ContextFilter(properties=['context'])) logging.Logger.root.addHandler(handler) logging.Logger.root.setLevel(logging.DEBUG) # Outputs: INFO Hi there {None} logging.info('Hi there') # Outputs: INFO No KeyError {bah} logging.info('No KeyError', extra={'context': 'bah'}) # Outputs: INFO Now with context! {foo} adapted = logging.LoggerAdapter(logging.Logger.root, extra={'context': 'foo'}) adapted.info('Now with context!') Source ------ ``sprockets.logging`` source is available on Github at `https://github.com/sprockets/sprockets.logging <https://github.com/sprockets/sprockets.logging>`_ License ------- ``sprockets.logging`` is released under the `3-Clause BSD license <https://github.com/sprockets/sprockets.logging/blob/master/LICENSE>`_. .. |Version| image:: https://badge.fury.io/py/sprockets.logging.svg? :target: http://badge.fury.io/py/sprockets.logging .. |Travis| image:: https://travis-ci.org/sprockets/sprockets.logging.svg?branch=master :target: https://travis-ci.org/sprockets/sprockets.logging .. |CodeCov| image:: http://codecov.io/github/sprockets/sprockets.logging/coverage.svg?branch=master :target: https://codecov.io/github/sprockets/sprockets.logging?branch=master .. |Downloads| image:: https://pypip.in/d/sprockets.logging/badge.svg? :target: https://pypi.python.org/pypi/sprockets.logging .. |ReadTheDocs| image:: https://readthedocs.org/projects/sprocketslogging/badge/ :target: https://sprocketslogging.readthedocs.org