# django-datalogger

**Repository Path**: pylixm/django-datalogger

## Basic Information

- **Project Name**: django-datalogger
- **Description**: Datalogger is a simple Django app to record data changer.
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2017-11-23
- **Last Updated**: 2022-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


Datalogger
=====

[![ENV](https://img.shields.io/badge/release-v0.1.1-blue.svg)](https://github.com/pylixm/django-datalogger)
[![ENV](https://img.shields.io/badge/python-2.7-green.svg)](https://github.com/pylixm/django-datalogger)
[![ENV](https://img.shields.io/badge/django-1.7+-green.svg)](https://github.com/pylixm/django-datalogger)
[![LICENSE](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/pylixm/django-datalogger/master/LICENSE.txt)

Datalogger is a simple Django app to record data changes.

- [中文说明](docs/README_zh.md)
- [聊天室](https://gitter.im/django-datalogger/Lobby)



Quick start
-----------

- Installation.
```bash
    pip install django-datalogger
```
- Add `django-datalogger` to your INSTALLED_APPS setting like this::
```python
    INSTALLED_APPS = [
        ...
        'django-datalogger',
    ]
```
- Add `datalogger.middleware.common.DataUpadataDeleteMiddleware` to your MIDDLEWARE_CLASSES setting like this::
```python
    MIDDLEWARE_CLASSES = (
    ...
    'datalogger.middleware.common.DataUpadataDeleteMiddleware',
    )
```
- Run `python manage.py makemigrations` and `python manage.py migrate` to create the `django-datalogger` models.

- Start your models inherit `LogOnUpdateDeleteModel` abstract model like this:
```python
class TestA(LogOnUpdateDeleteModel):
    name = models.CharField( max_length=128, blank=True)
    memo = models.TextField()
    create_at = models.DateTimeField(blank=True, auto_now_add=True)
    update_at = models.DateTimeField(blank=True, auto_now=True)
```
- Change the test model data by the model api.

- You will find the data change log in datalogger models.You can visit http://127.0.0.1:8000/admin/
   to see these changer.


Reference
---------

- [django-globals](https://github.com/svetlyak40wt/django-globals)

- [The answer of ivanperelivskiy in stackoverflow](http://stackoverflow.com/questions/1355150/django-when-saving-how-can-you-check-if-a-field-has-changed)