Metadata-Version: 2.1
Name: django-db-log-plugin
Version: 0.1.1
Summary: Custom DB Log Handler for Django Projects.
Home-page: https://github.com/eduarde/django_db_log
Author: Eduard Erja
Author-email: eduard.erja@gmail.com
License: MIT
Keywords: django_db_log
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: django-apscheduler (==0.2.13)

=============================
Django DB Log
=============================

.. image:: https://badge.fury.io/py/django-db-log-plugin.svg
    :target: https://badge.fury.io/py/django-db-log-plugin

.. image:: https://travis-ci.org/eduarde/django-db-log.svg?branch=master
    :target: https://travis-ci.org/eduarde/django-db-log

.. image:: https://codecov.io/gh/eduarde/django-db-log/branch/master/graph/badge.svg
    :target: https://codecov.io/gh/eduarde/django-db-log

Custom DB Log Handler for Django Projects.

Documentation
-------------

The full documentation is at https://django-db-log.readthedocs.io.

Quickstart
----------

Install Django DB Log::

    pip install django-db-log-plugin

Add it to your `INSTALLED_APPS`:

.. code-block:: python

    INSTALLED_APPS = (
        ...
        'django_db_log',
        ...
    )

Add Django DB Log's URL patterns:

.. code-block:: python

    from django_db_log import urls as django_db_log_urls


    urlpatterns = [
        ...
        url(r'^', include(django_db_log_urls)),
        ...
    ]

Add the LOGGING configuration in the settings.py file.

.. code-block:: python

    LOGGING = {
        'version': 1,
        'disable_existing_loggers': False,
        'formatters': {
            'verbose': {
               'format': '[%(asctime)s] %(levelname)s %(module)s.%(funcName)s %(lineno)d: %(message)s'
            },
            'simple': {
                'format': ' %(levelname)s  %(message)s',
            },
        },
        'handlers': {
            'log_db': {
                'level': 'ERROR',
                'class': 'django_db_log.handlers.DBHandler',
                'model': 'django_db_log.models.ErrorLog',
                'expiry': 86400,
                'formatter': 'simple',
            },
        },
        'loggers': {
            'django': {
                'handlers': ['log_db'],
                'level': 'ERROR',
                'propagate': False,
            },
        },
    }

Add the following constants in your settings file. These will be used to determine the lookup days to delete old logs from db.

.. code-block:: python

    INTERVAL_SCHEDULER_JOB_SECONDS = 43200
    GENERAL_LOGS_DELETE_DAYS = 2
    INFO_LOGS_DELETE_DAYS = 2
    DEBUG_LOGS_DELETE_DAYS = 2
    ERROR_LOGS_DELETE_DAYS = 10

Run migrations

.. code-block:: python

    python manage.py migrate

Running Tests
-------------

Does the code actually work?

::

    source <YOURVIRTUALENV>/bin/activate
    (myenv) $ pip install tox
    (myenv) $ tox

Credits
-------

Tools used in rendering this package:

*  Cookiecutter_
*  `cookiecutter-djangopackage`_

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`cookiecutter-djangopackage`: https://github.com/pydanny/cookiecutter-djangopackage

TO DO
--------

* release on PyPI
* create tags





History
-------

0.1.0 (2018-08-29)
++++++++++++++++++

* First release on PyPI.


