Metadata-Version: 2.0
Name: bottle-log
Version: 1.0.0
Summary: Improved logging for Bottle.
Home-page: https://github.com/romabysen/bottle-log
Author: Lars Hansson
Author-email: romabysen@gmail.com
License: New BSD
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Environment :: Web Environment
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Framework :: Bottle
Classifier: License :: OSI Approved :: BSD License
Requires-Dist: bottle (>=0.10.0)

Improved logging for Bottle.

Use
===
In order to catch exceptions from other plugins the LoggingPlugin should be
the first plugin you install to the application.

.. code-block:: python

    import bottle
    from bottle_log import LoggingPlugin

    app = bottle.Bottle()
    app.install(LoggingPlugin(app.config))

    @app.get('/test')
    def test(logger):
        logger.warning('This is only a test')
        return {}

Configuration
=============
The plugin uses the following configuration keys:

**logging.level**

The logging level. Possible values: `debug`, `info`, `warning`, `error`, `critical`.
Defaults to `warning`.

**logging.format**

The logging format. See the python logging documentation for the format.
Defaults to "`[%(asctime)s] %(levelname)s: %(name)s: %(message)s`"

**logging.utc**

If `True`, the default, time stamps are in UTC.

Logging
=======
The standard logger, used by the `logger` keyword, prints to stderr by default.

Exception logging
=================
This plugin also provides an exception logger ('bottle.exception'). By default
this logger does nothing, since bottle prints all exceptions to stderr, but it can be
useful if you want to log exceptions to somewhere else.
For example, logging to Logentries:

.. code-block:: python

    import bottle
    from logentries import LogentriesHandler
    from bottle_log import LoggingPlugin

    app = bottle.Bottle()
    app.install(LoggingPlugin(app.config))
    le_handler = LogentriesHandler('logentries-api-token')
    logging.getLogger('bottle.exception').addHandler(le_handler)


