Metadata-Version: 2.1
Name: balsa
Version: 0.0.9
Summary: logging utility
Home-page: https://github.com/jamesabel/balsa
Author: James Abel
Author-email: j@abel.co
License: MIT License
Download-URL: https://github.com/jamesabel/balsa/archive/master.zip
Keywords: logging,utility
Platform: UNKNOWN
Description-Content-Type: text/x-rst
Requires-Dist: appdirs
Requires-Dist: attrs


.. this file is kept in the docs\source directory and COPIED to the project root directory.
.. DO NOT edit the copy in the project root directory.

balsa (logging utility)
=======================

Simple to use package that sets up Python logging.  With just a few lines of code get well formatted file and
console or GUI logging.


Simple Example
==============

.. code:: python

    from balsa import get_logger, Balsa

    application_name = 'example'

    log = get_logger(application_name)


    def main():
        balsa = Balsa(application_name, 'james abel')
        balsa.init_logger()
        log.error('my error example')


This will yield output of this form:

.. code-block:: console

    2018-04-15 11:25:58,507 - example - balsa_simple_example.py - 12 - main - ERROR - my error example


Where did the name come from?
=============================
Balsa lumber is very soft and light, with a coarse, open grain.
The Balsa package is light weight, malleable, and open source.


