Metadata-Version: 2.4
Name: logger-helper
Version: 0.1.0
Summary: A simple way to gather verbose logs from your application!
Home-page: https://github.com/vimist/logger-helper
Author: Vimist
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Bug Tracking
Classifier: Topic :: System :: Logging
Classifier: Topic :: System :: Monitoring
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: summary

Documentation build, testing and linting for the ``master`` branch.

.. image:: https://readthedocs.org/projects/logger-helper/badge/?version=latest
   :target: `the documentation`_

.. image:: https://img.shields.io/pypi/v/logger-helper.svg
   :target: https://pypi.python.org/pypi/logger-helper/0.1.0

.. image:: https://travis-ci.org/vimist/logger-helper.svg?branch=master
   :target: https://travis-ci.org/vimist/logger-helper

.. image:: https://api.codeclimate.com/v1/badges/17691babd47c3cc19e91/maintainability
   :target: https://codeclimate.com/github/vimist/logger-helper/maintainability

.. image:: https://api.codeclimate.com/v1/badges/17691babd47c3cc19e91/test_coverage
   :target: https://codeclimate.com/github/vimist/logger-helper/test_coverage

Logger Helper
=============

Logger Helper provides a simple way to gather verbose logs within your
application. Set up your logging using the standard ``logging`` library and
decorate your classes, methods and functions (or even do it at the module level
with the ``mod`` method) to get detailed logs of what your application is
doing:

.. code-block::

    Calling __main__.Test.add(a = 1, b = 2, c = 3)
    Returned 6 from __main__.Test.add
    Calling __main__.Test.subtract(a = 3, b = 2, c = 2)
    Returned -1 from __main__.Test.subtract
    Calling __main__.Test.divide_by_zero(a = 10)
    Exception ZeroDivisionError occurred, "division by zero"

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

To install the Logger Helper package, ensure you have pip installed using your
distributions package manager and then run the following command:

.. code-block:: bash

    pip install logger-helper

Basic Usage
-----------

You can start using the ``LoggerHelper`` right away.

.. code-block:: python

    import logging
    from logger_helper import LoggerHelper

    # Perform your standard logging setup here

    log = LoggerHelper(logging.getLogger(__name__), logging.DEBUG)

    # DONE! Start decorating your modules, classes and functions:

    @log
    class MyClass:
        def method_1(self):
            pass

        def method_2(self):
            pass

    @log
    def function():
        pass

For more information, be sure to read `the documentation`_. If you clone this
repository and install `invoke`_, you can serve the documentation locally with
``invoke serve-docs``.


.. _invoke: http://www.pyinvoke.org
.. _the documentation: http://logger-helper.readthedocs.io/en/latest
