File: README.rst

package info (click to toggle)
django-reversion 1.8.4-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 572 kB
  • ctags: 478
  • sloc: python: 2,765; makefile: 146
file content (82 lines) | stat: -rw-r--r-- 3,014 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
django-reversion
================

**django-reversion** is an extension to the Django web framework that provides
comprehensive version control facilities.

Features
--------

-  Roll back to any point in a model's history - an unlimited undo facility!
-  Recover deleted models - never lose data again!
-  Admin integration for maximum usability.
-  Group related changes into revisions that can be rolled back in a single
   transaction.
-  Automatically save a new version whenever your model changes using Django's
   flexible signalling framework.
-  Automate your revision management with easy-to-use middleware.

**django-reversion** can be easily added to your existing Django project with an
absolute minimum of code changes.


Documentation
-------------

Please read the `Getting Started <http://django-reversion.readthedocs.org/en/latest/>`_
guide for more information.
    
Download instructions, bug reporting and links to full documentation can be
found at the `main project website <http://github.com/etianen/django-reversion>`_.

You can keep up to date with the latest announcements by joining the
`django-reversion discussion group <http://groups.google.com/group/django-reversion>`_.


Upgrading
---------

If you're upgrading your existing installation of django-reversion, please check
the `Schema Migrations <http://django-reversion.readthedocs.org/en/latest/migrations.html>`_
documentation for information on any database changes and how to upgrade. If you're using
South to manage database migrations in your project, then upgrading is as easy as running
a few django management commands.

It's always worth checking the `CHANGELOG <https://github.com/etianen/django-reversion/blob/master/CHANGELOG.rst>`_
before upgrading too, just in case you get caught off-guard by a minor upgrade to the library.


Contributing
------------

Bug reports, bug fixes, and new features are always welcome. Please raise issues on the
`django-reversion project site <http://github.com/etianen/django-reversion>`_, and submit
pull requests for any new code.

You can run the test suite yourself from within a virtual environment with the following
commands:

::

    $ pip install django
    $ pip install -e .
    $ python src/tests/runtests.py

The django-reversion project is built on every push with `Travis CI <https://travis-ci.org/etianen/django-reversion>`_.

.. image:: https://travis-ci.org/etianen/django-reversion.svg?branch=master
    :target: https://travis-ci.org/etianen/django-reversion

    
More information
----------------

The django-reversion project was developed by Dave Hall. You can get the code
from the `django-reversion project site <http://github.com/etianen/django-reversion>`_.
    
Dave Hall is a freelance web developer, based in Cambridge, UK. You can usually
find him on the Internet in a number of different places:

-  `Website <http://www.etianen.com/>`_
-  `Twitter <http://twitter.com/etianen>`_
-  `Google Profile <http://www.google.com/profiles/david.etianen>`_