Metadata-Version: 1.1
Name: restapi-logging-handler
Version: 0.1.7
Summary: A handler for the python logging module that sends logs         through any REST-ful API. Fully asyncronous. With Loggly support.
Home-page: https://github.com/narwhaljames/restapi-logging-handler.git
Author: RJ Gilligan
Author-email: rj.gilligan@nrgnergy.com
License: MIT
Download-URL: https://github.com/narwhaljames/restapi-logging-handler/tarball/0.1.7
Description: Python RESTful API Asyncronous Logging Handler with Loggly Support
        ==================================================================
        
        A simple logging handler for python that will send any logging events
        out to a RESTful API using HTTP POST requests. Fully asyncronuous using
        requests-futures, tested for Python 2 & 3, and has support for Loggly.
        
        Installation
        ------------
        
        pip install restapi-logging-handler
        
        Usage
        -----
        
        Import whichever module(s) you need:
        
        ::
        
            from restapi_logging_handler import RestApiHandler
            from restapi_logging_handler import LogglyHandler
        
        RESTful API Usage
        ~~~~~~~~~~~~~~~~~
        
        Set your Python logging handler to send logs to a REST-ful API
        
        ::
        
            logger = logging.getLogger(__name__)
            restapiHandler = RestApiHandler('http://my.restfulapi.com/endpoint/')
            logger.addHandler(restapiHandler)
            logger.setLevel(logging.INFO)
            logger.info("Send this to my RESTful API")
        
        By default, it sends the log data as a JSON object. You can currently
        change that to send text instead.
        
        ::
        
            restapiHandler = RestApiHandler('http://my.restfulapi.com/endpoint/', 'text')
        
        Loggly Usage
        ~~~~~~~~~~~~
        
        Set your Python logging handler to send logs out to your Loggly account.
        The LogglyHandler takes as its first argument the custom token given to
        you when you sign up for a Loggly account. The second argument can be a
        tag string, or a list of tags to be associated with the log inside of
        Loggly.
        
        ::
        
            logglyHandler = LogglyHandler('loggly-custom-key', ['tag1','tag2',...])
        
        Testing
        -------
        
        Install tox and run it to test against Python 2 and 3.
        
        ::
        
            sudo pip install nose
            tox
        
        Forking
        -------
        
        If you'd like to extend this to include more REST-ful API's than just
        Loggly, send me a pull request!
        
Keywords: rest,api,logging,handler,loggly
Platform: UNKNOWN
