547ebb0bf0912612c98639b8a257e6c30a5d1d0a
[cyril.git] / Apps / django_history_tables / LISEZMOI
1 AUF - django_history_tables v0.1
2
3 Cyril Robert <cyril.robert@auf.org>, 2010-01-20
4
5
6
7 Introduction
8 ===============================================================================
9 Application Django permettant de stocker les anciennes versions d'une instance
10 dans une table d'historique separee.
11 Projet original: http://code.google.com/p/django-history-tables/
12
13
14 Dependances
15 ===============================================================================
16 Python, Django
17
18
19 Installation
20 ===============================================================================
21 Faire et installer un package:
22     auf-make-deb django_history_tables
23     sudo dpkg -i django-history-tables*.deb
24
25
26 Utilisation
27 ===============================================================================
28 1. Ajouter "django_history_tables" dans INSTALLED_APPS
29 2. Dans models.py, ajouter
30     from django_history_tables.models import *
31 3. Pour chaque modele dont on veut un historique:
32
33     class Blabla (models.Model):
34         ...
35     class BlablaHistory(HistoryModel):
36         eggs = "eggs"
37         class History:
38             model = Blabla
39
40     def blablahistory_save (sender, instance, signal, *args, **kwargs):
41         history_model = BlablaHistory
42         history_save(sender, instance, signal, history_model, *args, **kwargs)
43
44     from django.db.models.signals import pre_save
45     pre_save.connect(blablahistory_save, sender=Blabla)
46 4. Dans django_history_tables.views, il y a une methode instance_diff, qui 
47    permet de comparer 2 instances, elle n'est pas encore testee.
48
49
50 Problemes connus
51 ===============================================================================
52
53
54 Revisions
55 ===============================================================================
56
57 Voir changelog.txt