Metadata-Version: 2.4
Name: py12flogging
Version: 0.8.0
Summary: Python logging module for developing microservices conforming to 12 Factor App methodology.
Home-page: https://gitlab.tuni.fi/fsd/py12flogging
Author: Toni Sissala
Author-email: support.fsd+py12flogging@tuni.fi
License: EUPL v1.2
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: European Union Public Licence 1.2 (EUPL 1.2)
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: summary

Py12fLogging
============

Python logging module for developing microservices conforming to 12 Factor App
methodology. Depends only on Python standard lib. However, setuptools may be
installed to provide additional functionality.


Installation
------------

Py12fLogging is available to install from PyPI::

   pip install py12flogging


Usage
-----

Py12fLogging is a module used for developing microservices. It is not a standalone
application. See module documentation for more information.

Example use of log_formatter -module::

   import logging
   from py12flogging import log_formatter
   log_formatter.setup_app_logging('my_app')
   logging.info('all done')


PrettyPrint logging output
^^^^^^^^^^^^^^^^^^^^^^^^^^

Developers may wish to restructure log output stream of an application while it's
under development. This can be achieved by using pprint command line application,
which prettyprints the log output stream coming from stdin and flushes immediately
to stdout. See module documentation for more information.

Pipe application's stdout to pprint-module::

   ./my_app.py | python -m py12flogging.pprint
