Metadata-Version: 1.1
Name: django-changes
Version: 0.1
Summary: 
A utility to store and access information about changes on objects in a Django
project.

Home-page: https://bitbucket.org/wearefarm/django-changes
Author: Rick Vause
Author-email: rvause@gmail.com
License: BSD
Description: ==============
        django-changes
        ==============
        
        A utility to store and access information about changes on objects in a Django
        project.
        
        
        Installation
        ============
        
        `pip install django-changes`, add to your Python path or `setup.py install`
        and add `'changes'` to your `INSTALLED_APPS` setting.
        
        
        Usage
        =====
        
        You can use by importing the helper::
        
            from changes import changes
            # ...
            changes.add_change(someobj, who=request.user)
        
        Or by using the object directly::
        
            from changes.models import Change
            # ...
            Change.objects.add_change_for_object(someobj, why='Because')
        
        
        To get a queryset of changes that were added for an objects::
        
            changes.get_changes_for(someobj)
        
        or::
        
            Change.objects.get_changes_for_object(someobj)
        
        
        To get a queryset of changes that were made by a user::
        
            changes.get_changes_by(someuser)
        
        or::
        
            Change.objects.get_changes_by_user(someuser)
        
        
        You can also do things like this::
        
            Change.objects.all().by_user(someuser)
            changes.get_changes_for(someobj).anonymous()
        
        
        Included is a 'Mixin' for your models that you expect to be recording changes
        on a lot that will give you the reverse relation `changes`::
        
            from changes.models import ChangesMixin
            # ...
            class SomeModel(ChangesMixin, models.Model)
        
        
        See the source code for more.
        
        
        Need Help?
        ==========
        
        Email: rvause@gmail.com
        
        Bitbucket: https://bitbucket.org/wearefarm/django-changes
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: License :: OSI Approved :: BSD License
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Framework :: Django
