Metadata-Version: 2.1
Name: django-simple-log-viewer
Version: 1.1.1
Summary: A Django app to view project logs.
Home-page: https://github.com/yusufoguntola/django-simple-log-viewer
Author: Yusuf Oguntola
Author-email: yusuf.oguntola@gmail.com
License: MIT License
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.5
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Python: >=2.6
Description-Content-Type: text/x-rst
License-File: LICENSE

========================
Django simple log viewer
========================

Django simple log viewer is intended to be a simple app for viewing logs generated in a django project in a simple but intuitive way.

It uses default django `LOGGING` `setting <https://docs.djangoproject.com/en/3.2/topics/logging/>`_ to configure and load logs. If you have your settings 
as recommended by django, then you shouldn't have to do anything else.

Log columns are configured using the format setting for each log file, this app simply split up the format setting and use that to create column headers for the view page,
if you'd like to see things differently, then you need to update that setting (but make sure it conforms with what you have in the log files).

**It's recommended that you put the ``message`` attribute last in your format setting.**

Adding it to your project
=========================

1. Install with pip:: ``pip install django-simple-log-viewer``


2. Add ``log_viewer`` to ``INSTALLED_APPS`` in ``settings.py``

3. Add Log viewer to your URL conf:: ``path('log-viewer', include('log_viewer.urls')),`` OR ``url('log-viewer', include('log_viewer.urls'))`` as the case may be

4. Visit the log viewer URL to view your logs

5. Note that only users with ``'superuser'`` permission can view the log page.


SETTINGS
========
1. To change the name displayed on top of the navigation bar, add ``SITE_NAME`` to your ``settings.py`` and give it a string name

2. If you use a different extension (from .log) for your log files, add the setting ``LOG_FILE_EXTENSION`` to ``settings.py`` showing your extension. Default value is ``.log``
NB: Make sure to add a ``.`` before the extension name

3. To change the theme of the view page, extend ``log_viewer/log_home.html`` and set the theme name in the block theme. e.g:
``{% block theme%} green {% endblock %}``. (Options: purple | azure | green | orange | danger)


.. image:: sample_log.jpg
    :width: 600
    :alt: Sample Image

