Metadata-Version: 2.1
Name: prettylog
Version: 0.2.0
Summary: Let's write beautiful logs
Home-page: UNKNOWN
Author: Dmitry Orlov
Author-email: me@mosquito.su
Maintainer: Dmitry Orlov
Maintainer-email: me@mosquito.su
License: Apache 2
Platform: all
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3 :: Only
Provides-Extra: develop
Requires-Dist: colorlog
Requires-Dist: fast-json
Requires-Dist: typing (>=3.5.3); python_version < "3.5"
Provides-Extra: develop
Requires-Dist: coverage (!=4.3); extra == 'develop'
Requires-Dist: pylama; extra == 'develop'
Requires-Dist: pytest; extra == 'develop'
Requires-Dist: pytest-cov; extra == 'develop'
Requires-Dist: timeout-decorator; extra == 'develop'
Requires-Dist: tox (>=2.4); extra == 'develop'

prettylog
=========

.. image:: https://coveralls.io/repos/github/mosquito/prettylog/badge.svg?branch=master
    :target: https://coveralls.io/github/mosquito/prettylog
    :alt: Coveralls

.. image:: https://travis-ci.org/mosquito/prettylog.svg
    :target: https://travis-ci.org/mosquito/prettylog
    :alt: Travis CI

.. image:: https://img.shields.io/pypi/v/prettylog.svg
    :target: https://pypi.python.org/pypi/prettylog/
    :alt: Latest Version

.. image:: https://img.shields.io/pypi/wheel/prettylog.svg
    :target: https://pypi.python.org/pypi/prettylog/

.. image:: https://img.shields.io/pypi/pyversions/prettylog.svg
    :target: https://pypi.python.org/pypi/prettylog/

.. image:: https://img.shields.io/pypi/l/prettylog.svg
    :target: https://pypi.python.org/pypi/prettylog/

Let's write beautiful logs:

.. code-block:: python

    import logging
    from prettylog import basic_config


    # Configure logging
    basic_config(level=logging.INFO, buffered=False, log_format='color')


Available formats
-----------------

* stream - default behaviour
* color - colored logs
* json - json representation
* syslog - writes to syslog

Quick start
-----------

Setting up json logs:

.. code-block:: python

    import logging
    from prettylog import basic_config


    # Configure logging
    basic_config(level=logging.INFO, buffered=False, log_format='json')


Buffered log handler
++++++++++++++++++++

Parameter `buffered=True` enables memory buffer which flushing logs delayed.

.. code-block:: python

    import logging
    from prettylog import basic_config

    basic_config(
        level=logging.INFO,
        buffered=True,
        buffer_size=10,             # flush each 10 log records
        flush_level=loggging.ERROR, # or when record with this level will be sent
        log_format='color',
    )


