Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mkalioby/ModelTracker
Track a model object over time and blame users
https://github.com/mkalioby/ModelTracker
django django-models django-models-track middleware
Last synced: 3 months ago
JSON representation
Track a model object over time and blame users
- Host: GitHub
- URL: https://github.com/mkalioby/ModelTracker
- Owner: mkalioby
- License: mit
- Created: 2016-05-26T12:27:54.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-07-30T08:16:34.000Z (4 months ago)
- Last Synced: 2024-07-30T14:23:48.053Z (4 months ago)
- Topics: django, django-models, django-models-track, middleware
- Language: Python
- Size: 109 KB
- Stars: 6
- Watchers: 4
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - mkalioby/ModelTracker - Track a model object over time and blame users (Python)
README
# django-model-tracker
Track model object changes over time so that you know who done what.
[](https://badge.fury.io/py/django-model-tracker)
[](https://pepy.tech/project/django-model-tracker)
## Installation
* Install the package
* For Django<4.0
```sh
pip install 'django-model-tracker jsonfield'
```
* For Django>=4.0
```sh
pip install 'django-model-tracker'
```
* Add Application to your project's INSTALLED_APPs
```python
INSTALLED_APPS = (
'....',
'ModelTracker',
)
```
* Add the following line to your urls.py
```python
import ModelTracker
urlpatterns = patterns('',
...
url(r'^track/', include('ModelTracker.urls')),
...
)
```
* Run Migrations
```sh
python manage.py migrate ModelTracker
```
* Add the following line to your models.py file
```python
from ModelTracker import Tracker
```
* Convert each Model you want to track to inhert from `Tracker.ModelTracker` instead of `models.Model`
**Old Code**
```python
class Employee(models.Model):
name=models.CharField(max_length=255)
address=models.CharField(max_length=255)
age=models.IntegerField()
```
**New Code**
```python
class Employee(Tracker.ModelTracker):
name=models.CharField(max_length=255)
address=models.CharField(max_length=255)
age=models.IntegerField()
```
* For each save() call, add the user the username
* Old Code
```python
emp=Employee()
emp.save()
```
* New Code
```python
emp=Employee()
emp.save(request.user.username)
```
* Starting from version of 0.5, you can pass a event_name parameter to mark change as an event
* New Code
```python
emp=Employee()
emp.save(request.user.username,event_name="Created the user")
```
# Using The Middleware
You can add `ModelTracker.middleware.ModelTrackerMiddleware` to your Middleware classes to get the username automatically from the request.
```python
MIDDLEWARE_CLASSES = (
'....',
'ModelTracker.middleware.ModelTrackerMiddleware',
)
```
**Note:** If you pass username as `None` then the change won't be saved.
# Showing Record History
There are 3 ways to see the history of a record
1. go to `ModelTracker` url and select `Table` and enter `id`.
2. call `showModelChanges` by POST and send `csrftokenmiddleware` to return history as html.
3. call `getModelChanges` which returns history as Json.
# Django Admin
There is 2 ways to update an object by django admin
1. Handle save and delete in ModelAdmin as follows
```python
def save_model(self, request, obj, form, change):
obj.save(request.user.username,"Editing From admin interface")
def delete_model(self, request, obj):
obj.delete(username=request.user.username, event_name="Deleting From admin interface")
```
2. Inhert from TrackerAdmin rather ModelAdmin
```python
from ModelTracker.Tracker import TrackerAdmin
admin.site.register(employee, TrackerAdmin)
```