Metadata-Version: 2.1
Name: django-extended-history
Version: 1.0.0
Summary: Drop-in replacement for default Django history
Home-page: https://github.com/HealthyFridge/django-extended-history
Author: Rob Aben
Author-email: rob@healthyfridge.nl
License: BSD-3-Clause
Project-URL: Bug Tracker, https://github.com/HealthyFridge/django-extended-history/issues
Project-URL: repository, https://github.com/HealthyFridge/django-extended-history
Classifier: Programming Language :: Python :: 3
Classifier: Framework :: Django :: 4
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/x-rst
License-File: LICENSE

django-extended-history
========================

**django-extended-history** is (IMHO) the simplest way to record all changes made in admin-screens.

=============
Requirements
=============

- Django 4.x

=============
Features
=============

-  Drop-in extension for Django history. No changes in any model, hence no migrations.
-  Records all changes in JSON format, extending what Django stores by default.
-  Adds a view 'Log entries' under 'Administration', showing all content types for which a user has permissions.
-  Safe to remove. Django will ignore all extra recorded information and revert to it's default history. So give it a spin!

=============


------------
Installation
------------

.. code-block::

    pip install django-extended-history

------------
Setup
------------

Add **django_extended_history** to **INSTALLED_APPS** setting like this:

.. code-block:: python

    INSTALLED_APPS = [
    ...,
    'django_extended_history',
    ]

Done!

------------
Usage
------------

Apply the **DjangoExtendedHistory** mixin to all applicable admin-views:

.. code-block:: python
    
    from django.contrib import admin
    from .models import MyModel
    from django_extended_history.admin import DjangoExtendedHistory
    
    @admin.register(MyModel)
    class MyModelAdmin(DjangoExtendedHistory, admin.ModelAdmin):
        ...

------------
Misc
------------

Django extended history is released under the BSD-3 license, like Django. If you like it, please consider contributing.
