Metadata-Version: 2.1
Name: django-loggable-util
Version: 0.0.4
Summary: Separate logging from class based view business code
Home-page: https://github.com/Ruhshan/django-loggable-util
Author: Ruhshan Ahmed Abir
Author-email: ruhshan.ahmed@gmail.com
License: MIT
Keywords: Django,Loggable,Wrapper,Generic view,Class based view
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: License :: OSI Approved :: MIT License
Classifier: Framework :: Django
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown

# Django loggable util

An utility to create logs for request and response while keeping business code clean for class based views. 

### Motivation
By using generic view, we can write a view as concise as this:

```python
class SomeModelCreateView(LoginRequiredMixin, CreateView):
    model = SomeModel
```
As we can see there is no place where we can write `logger.info(...)`. It won't be pretty to override some methods in the view just for printing logs.
It would make sense if there is already some overridden method in the view, then we could've put the logger 
method there. That's why this package is created to quickly enable request and response logs for class based views.



### Installation

```shell script
pip install djang-loggable-util
```

### Example usage

Import the `Loggable` class in your urls.py
```python
from django_loggable_util import Loggable
```

Now write url configuration as this:

```python
urlpatterns=[
...
path('someurl', Loggable(SomeCBView).as_view(),name='some-url-name'),
...
]
```

You can pass usual parameters like `template_name` etc, in `as_view()` function.

This will result in logs like this for every request response cycle:

```text
INFO | 2020-08-17 09:10:12.764 | {'request': {'method': 'GET', 'path': '/someurl', 'username': 'someuser', 'params': <QueryDict: {'somekey':'someval'}>}}
INFO | 2020-08-17 09:10:12.777 | {'response': {'username': 'someuser', 'status_code': 200, 'template': ['sometemplate.html']}}
```

A default configuration is embedded with this package:
```python
default_log_config = {
    'version': 1,
    'disable_existing_loggers': False,
    'formatters': {
        'request_response_formatter': {
            'format': '%(levelname)s | %(asctime)s.%(msecs)03d | %(message)s',
            'datefmt': "%Y-%m-%d %H:%M:%S",
        }
    },
    'handlers': {
        'request_response_console': {
            'level': 'INFO',
            'class': 'logging.StreamHandler',
            'formatter': 'request_response_formatter'
        }

    },
    'loggers': {
        'request_response': {
            'handlers': ['request_response_console'],
            'level': 'INFO',
            'propagate': False
        }
    }
}
```
This configuration streams logs to console. When it is needed to stream logs to files or any other service, 
you can add that logging configuration in `settings.py` and provide logger name to use for this library like this:

```python
LOGGABLE_LOGGER='your_logger_name'
```

### Todos
 - Write Tests
 - Support DRF
 - Support FBV

License
----

MIT

**Free Software, Hell Yeah!**

