Metadata-Version: 2.1
Name: django-modelformhistory
Version: 1.0.4
Summary: UNKNOWN
Home-page: https://github.com/EngageSports/django-modelformhistory
Author: Martyn CLEMENT
Author-email: martyn.clement@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown

Django ModelForm History
========================

[![Build Status](https://travis-ci.org/martync/django-modelformhistory.svg?branch=master)](https://travis-ci.org/martync/django-modelformhistory)
[![Coverage Status](https://coveralls.io/repos/github/martync/django-modelformhistory/badge.svg?branch=master)](https://coveralls.io/github/martync/django-modelformhistory?branch=master)

django-modelformhistory will save your modelform updates and store the human-readable values. The main goal is only to show the users what has been updated on a modelForms. If you search for a more lowlevel history app, consider using django-reversion or django-simple-history


Warning
-------

This package is under developpement. It has poor features and may be unstable. Don't use it in production yet. 


Requirements
------------

 - Django 1.10.* / Django 1.11.*
 - Tested under python 2.7 and 3.6


Install
-------

```
pip install django-modelformhistory
```


Then, add `modelformhistory` to INSTALLED_APPS


Usage
-----

Inherit your ModelForm with `HistoryModelFormMixin`

```python
from modelformhistory.forms import HistoryModelFormMixin

class MyModelForm(HistoryModelFormMixin, forms.ModelForm):
    pass
```

You can get the user that has made the change by : 

* Either pass the `request` on the form init
* or implement a `get_history_user` method on your ModelForm that will return a `auth.User` object


TODO
----

 * ~~Querying models history easily~~
 * Provide generic views to see history by object, user & both
 * Add more support and tests for filefield, boolean
 * ~~FR translation~~



ChangeLog
=========


1.0.4 2019-06-17
--------------

- Added support for BooleanField and FileField


1.0.3 2019-06-17
--------------

- Added more coverage
- Added FR translation
- Added HistoryBaseModel


1.0 2019-06-14
--------------

- Initial Release




