Metadata-Version: 1.1
Name: threepio
Version: 0.1.4
Summary: Minimally improved noise for python. Pragmatic, minimalimproved logging for python.
Home-page: https://github.com/jmatt/threepio
Author: jmatt
Author-email: jmatt@jmatt.org
License: Apache License, Version 2.0
Description: 
        threepio 0.1.4
        Minimally improved noise for python. Pragmatic, minimal improved logging for python.
        
        To install use pip install git+git://github.com/jmatt/threepio
        
        ----
        
        threepio
        ========
        
        Minimally improved noise for python.
        
        Pragmatic, minimal logging for python.
        
        # Install
        ```bash
        pip install -e git://github.com/jmatt/threepio#egg=threepio
        ```
        
        # Use
        
        Just initialize and go.
        
        ```python
        In [1]: import logging
        
        In [2]: import threepio
        
        In [3]: threepio.initialize(log_filename="./c3po.beep.log",
                                    logger_name="super serial project",
                                    app_logging_level=logging.DEBUG,
                                    dep_logging_level=logging.WARN)
        Out[3]: <logging.Logger at 0x106bc4ed0>
        
        In [4]: from threepio import logger as c3po
        
        In [5]: c3po.info("Artoo says that the chances of survival are 725 to 1.")
         
        In [6]: c3po.debug("Actually Artoo has been known to make mistakes...")
        
        In [7]: c3po.warn("from time to time... Oh dear...")
        
        #
        # In c3po.beep.log
        # 2013-05-01 22:29:47,548 super serial project-INFO [<ipython-input-5-b81c1c01169e> 1] Artoo says that the chances of survival are 725 to 1. 
        # 2013-05-01 22:30:01,372 super serial project-DEBUG [<ipython-input-6-089fe0b5bf92> 1] Actually Artoo has been known to make mistakes...
        # 2013-05-01 22:30:11,602 super serial project-WARN [<ipython-input-7-092eb0b3ce76> 1] From time to time... Oh dear... 
        ```
        
        Or create a custom logger and leave the global logger alone.
        
        ```python
        In [1]: import logging
        In [2]: import threepio
        In [3]: woot_logger = threepio.initialize(logger_name="woot",
            app_logging_level=logging.DEBUG,
            dep_logging_level=logging.DEBUG,
            global_logger=False)
        In [4]: woot_logger.debug("RWRAharhrhr!")
        #
        # In the default logging file (threepio.log)
        # 2013-05-01 22:14:06,215 woot-DEBUG [<ipython-input-6-3066a630384a> 1] RWRAharhrhr!
        ```
        
        ***[Luke, Leia and Han start laughing hysterically; it sounds like screaming]***
        
        **C-3PO**: Listen to them, they're dying R2! Curse my metal body, I wasn't fast enough, it's all my fault! My poor Master.
        
        **Luke**: 3PO, we're all right! We're all right! Ha ha! Hey, open the pressure maintenance hatch on unit number... where are we? 3263827!
        
        
        ----
        
        For more information, please see: https://github.com/jmatt/threepio
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Logging
