django-simple-history
=====================
.. image:: https://github.com/jazzband/django-simple-history/actions/workflows/test.yml/badge.svg
:target: https://github.com/jazzband/django-simple-history/actions/workflows/test.yml
:alt: Build Status
.. image:: https://readthedocs.org/projects/django-simple-history/badge/?version=latest
:target: https://django-simple-history.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. image:: https://img.shields.io/codecov/c/github/jazzband/django-simple-history/master.svg
:target: https://app.codecov.io/github/jazzband/django-simple-history?branch=master
:alt: Test Coverage
.. image:: https://img.shields.io/pypi/v/django-simple-history.svg
:target: https://pypi.org/project/django-simple-history/
:alt: PyPI Version
.. image:: https://api.codeclimate.com/v1/badges/66cfd94e2db991f2d28a/maintainability
:target: https://codeclimate.com/github/jazzband/django-simple-history/maintainability
:alt: Maintainability
.. image:: https://static.pepy.tech/badge/django-simple-history
:target: https://pepy.tech/project/django-simple-history
:alt: Downloads
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/psf/black
:alt: Code Style
.. image:: https://jazzband.co/static/img/badge.svg
:target: https://jazzband.co/
:alt: Jazzband
django-simple-history stores Django model state on every create/update/delete.
This app supports the following combinations of Django and Python:
========== ========================
Django Python
========== ========================
3.2 3.8, 3.9, 3.10
4.2 3.8, 3.9, 3.10, 3.11, 3.12, 3.13-dev
5.0 3.10, 3.11, 3.12, 3.13-dev
main 3.10, 3.11, 3.12, 3.13-dev
========== ========================
Getting Help
------------
Documentation is available at https://django-simple-history.readthedocs.io/
Pull requests are welcome. Read the `CONTRIBUTING`_ file for tips on
submitting a pull request.
.. _CONTRIBUTING: https://github.com/jazzband/django-simple-history/blob/master/CONTRIBUTING.rst
License
-------
This project is licensed under the
`BSD 3-Clause license <https://choosealicense.com/licenses/bsd-3-clause/>`_.
Changes
=======
Unreleased
----------
3.5.0 (2024-02-19)
------------------
- Fixed ``FieldError`` when creating historical records for many-to-many fields with
``to="self"`` (gh-1218)
- Allow ``HistoricalRecords.m2m_fields`` as str (gh-1243)
- Fixed ``HistoryRequestMiddleware`` deleting non-existent
``HistoricalRecords.context.request`` in very specific circumstances (gh-1256)
- Added ``custom_historical_attrs`` to ``bulk_create_with_history()`` and
``bulk_update_with_history()`` for setting additional fields on custom history models
(gh-1248)
- Passing an empty list as the ``fields`` argument to ``bulk_update_with_history()`` is
now allowed; history records will still be created (gh-1248)
- Added temporary requirement on ``asgiref>=3.6`` while the minimum required Django
version is lower than 4.2 (gh-1261)
- Small performance optimization of the ``clean-duplicate_history`` command (gh-1015)
- Support Simplified Chinese translation (gh-1281)
- Added support for Django 5.0 (gh-1283)
- Added support for Python 3.13 (gh-1289)
3.4.0 (2023-08-18)
------------------
- Fixed typos in the docs
- Added feature to evaluate ``history`` model permissions explicitly when
``SIMPLE_HISTORY_ENFORCE_HISTORY_MODEL_PERMISSIONS`` is set to ``True``
in ``settings`` (gh-1017).
- Fixed ``SimpleHistoryAdmin`` not properly integrating with custom user models (gh-1177)
- Support Indonesian translation (gh-1198)
- Support Urdu translation (gh-1199)
- Support Norwegian Bokmål translation (gh-1210)
- Dropped support for Python 3.7, which reached end-of-life on 2023-06-27 (gh-1202)
- Dropped support for Django 4.0, which reached end-of-life on 2023-04-01 (gh-1202)
- Added support for Django 4.2 (gh-1202)
- Made ``bulk_update_with_history()`` return the number of model rows updated (gh-1206)
- Fixed ``HistoryRequestMiddleware`` not cleaning up after itself (i.e. deleting
``HistoricalRecords.context.request``) under some circumstances (gh-1188)
- Made ``HistoryRequestMiddleware`` async-capable (gh-1209)
- Fixed error when setting ``table_name`` with ``inherit=True`` (gh-1195)
3.3.0 (2023-03-08)
------------------
- Made it possible to use the new ``m2m_fields`` with model inheritance (gh-1042)
- Added two signals: ``pre_create_historical_m2m_records`` and ``post_create_historical_m2m_records`` (gh-1042)
- Added ``tracked_fields`` attribute to historical models (gh-1038)
- Fixed ``KeyError`` when running ``clean_duplicate_history`` on models with ``excluded_fields`` (gh-1038)
- Added support for Python 3.11 (gh-1053)
- Added Arabic translations (gh-1056)
- Fixed a code example under "Tracking many to many relationships" (gh-1069)
- Added a ``--base-manager`` option to the ``clean_duplicate_history`` management command (gh-1115)
3.2.0 (2022-09-28)
------------------
- Fixed typos in the docs
- Removed n+1 query from ``bulk_create_with_history`` utility (gh-975)
- Started using ``exists`` query instead of ``count`` in ``populate_history`` command (gh-982)
- Add basic support for many-to-many fields (gh-399)
- Added support for Django 4.1 (gh-1021)
3.1.1 (2022-04-23)
------------------
Full list of changes:
- Fix py36 references in pyproject.toml (gh-960)
- Fix local setup.py install versioning issue (gh-960)
- Remove py2 universal wheel cfg - only py3 needed now (gh-960)
3.1.0 (2022-04-09)
------------------
Breaking Changes:
- Dropped support for Django 2.2 (gh-968)
- Dropped support for Django 3.1 (gh-952)
- Dropped support for Python 3.6, which reached end-of-life on 2021-12-23 (gh-946)
Upgrade Implications:
- Run `makemigrations` after upgrading to realize the benefit of indexing changes.
Full list of changes:
- Added queryset-based filtering with ``as_of`` (gh-397)
- Added index on `history_date` column; opt-out with setting `SIMPLE_HISTORY_DATE_INDEX` (gh-565)
- RecordModels now support a ``no_db_index`` setting, to drop indices in historical models,
default stays the same (gh-720)
- Support ``included_fields`` for ``history.diff_against`` (gh-776)
- Improve performance of ``history.diff_against`` by reducing number of queries to 0 in most cases (gh-776)
- Fixed ``prev_record`` and ``next_record`` performance when using ``excluded_fields`` (gh-791)
- Fixed `update_change_reason` in pk (gh-806)
- Fixed bug where serializer of djangorestframework crashed if used with ``OrderingFilter`` (gh-821)
- Fixed `make format` so it works by using tox (gh-859)
- Fixed bug where latest() is not idempotent for identical ``history_date`` records (gh-861)
- Added ``excluded_field_kwargs`` to support custom ``OneToOneField`` that have
additional arguments that don't exist on ``ForeignKey``. (gh-870)
- Added Czech translations (gh-885)
- Added ability to break into debugger on unit test failure (gh-890)
- Added pre-commit for better commit quality (gh-896)
- Russian translations update (gh-897)
- Added support for Django 4.0 (gh-898)
- Added Python 3.10 to test matrix (gh-899)
- Fix bug with ``history.diff_against`` with non-editable fields (gh-923)
- Added HistoricForeignKey (gh-940)
- Support change reason formula feature. Change reason formula can be defined by overriding
``get_change_reason_for_object`` method after subclassing ``HistoricalRecords`` (gh-962)
3.0.0 (2021-04-16)
------------------
Breaking changes:
- Removed support for Django 3.0
- Removed `changeReason` in favor of `_change_reason` (see 2.10.0)
Full list of changes:
- Removed support for Django versions prior to 2.2 (gh-652)
- Migrate from TravisCI to Github Actions (gh-739)
- Add Python 3.9 support (gh-745)
- Support ``ignore_conflicts`` in ``bulk_create_with_history`` (gh-733)
- Use ``asgiref`` when available instead of thread locals (gh-747)
- Sort imports with isort (gh-751)
- Queryset ``history.as_of`` speed improvements by calculating in the DB (gh-758)
- Increase `black` and `isort` python version to 3.6 (gh-817)
- Remove Django 3.0 support (gh-817)
- Add Django 3.2 support (gh-817)
- Improve French translations (gh-811)
- Remove support for changeReason (gh-819)
2.12.0 (2020-10-14)
-------------------
- Add default date to ``bulk_create_with_history`` and ``bulk_update_with_history`` (gh-687)
- Exclude ManyToManyFields when using ``bulk_create_with_history`` (gh-699)
- Added ``--excluded_fields`` argument to ``clean_duplicate_history`` command (gh-674)
- Exclude ManyToManyFields when fetching excluded fields (gh-707)
- Use default model manager for ``bulk_create_with_history`` and
``bulk_update_with_history`` instead of ``objects`` (gh-703)
- Add optional ``manager`` argument to ``bulk_update_with_history`` to use instead of
the default manager (gh-703)
- Add support for Django 3.1 (gh-713)
- Fix a bug with ``clean_old_history`` command's `--days` argument (gh-722)
\* NOTE: This will be the last minor release before 3.0.0.
2.11.0 (2020-06-20)
-------------------
- Added ``clean_old_history`` management command (gh-675)
- Added ``user_db_constraint`` param to history to avoid circular reference on delete (gh-676)
- Leverages ``get_user`` from ``HistoricalRecords`` in order to set a fallback user on
bulk update and bulk create (gh-677)
2.10.0 (2020-04-27)
-------------------
- Added ``bulk_update_with_history`` utility function (gh-650)
- Add default user and default change reason to ``bulk_create_with_history`` and ``bulk_update_with_history`` (gh-653)
- Add french translation (gh-654)
- Start using ``_change_reason`` instead of ``changeReason`` to add change reasons to historical
objects. ``changeReason`` is deprecated and will be removed in version ``3.0.0`` (gh-655)
2.9.0 (2020-04-23)
------------------
- Add simple filtering if provided a minutes argument in ``clean_duplicate_history`` (gh-606)
- Add setting to convert ``FileField`` to ``CharField`` instead of ``TextField`` (gh-625)
- Added notes on BitBucket Pipelines (gh-627)
- import model ``ContentType`` in ``SimpleHistoryAdmin`` using ``django_apps.get_model``
to avoid possible ``AppRegistryNotReady`` exception (gh-630)
- Fix ``utils.update_change_reason`` when user specifies excluded_fields (gh-637)
- Changed how ``now`` is imported from ``timezone`` (``timezone`` module is imported now) (gh-643)
- ``settings.SIMPLE_HISTORY_REVERT_DISABLED`` if True removes the Revert
button from the history form for all historical models (gh-632))
2.8.0 (2019-12-02)
------------------
- Fixed ``bulk_create_with_history support`` for HistoryRecords with ``relation_name`` attribute (gh-591)
- Added support for ``bulk_create_with_history`` for databases different from PostgreSQL (gh-577)
- Fixed ``DoesNotExist`` error when trying to get instance if object is deleted (gh-571)
- Fix ``model_to_dict`` to detect changes in a parent model when using
``inherit=True`` (backwards-incompatible for users who were directly
using previous version) (gh-576)
- Use an iterator for ``clean_duplicate_history`` (gh-604)
- Add support for Python 3.8 and Django 3.0 (gh-610)
2.7.3 (2019-07-15)
------------------
- Fixed ``BigAutoField`` not mirrored as ``BigInt`` (gh-556)
- Fixed ``most_recent()`` bug with ``excluded_fields`` (gh-561)
- Added official Django 2.2 support (gh-555)
2.7.2 (2019-04-17)
------------------
- Fixed ModuleNotFound issue for ``six`` (gh-553)
2.7.1 (2019-04-16)
------------------
- Added the possibility to create a relation to the original model (gh-536)
- Fix router backward-compatibility issue with 2.7.0 (gh-539, gh-547)
- Fix hardcoded history manager (gh-542)
- Replace deprecated ``django.utils.six`` with ``six`` (gh-526)
- Allow ``custom_model_name`` parameter to be a callable (gh-489)
2.7.0 (2019-01-16)
------------------
- \* Add support for ``using`` chained manager method and save/delete keyword argument (gh-507)
- Added management command ``clean_duplicate_history`` to remove duplicate history entries (gh-483)
- Updated most_recent to work with excluded_fields (gh-477)
- Fixed bug that prevented self-referential foreign key from using ``'self'`` (gh-513)
- Added ability to track custom user with explicit custom ``history_user_id_field`` (gh-511)
- Don't resolve relationships for history objects (gh-479)
- Reorganization of docs (gh-510)
\* NOTE: This change was not backward compatible for users using routers to write
history tables to a separate database from their base tables. This issue is fixed in
2.7.1.
2.6.0 (2018-12-12)
------------------
- Add ``app`` parameter to the constructor of ``HistoricalRecords`` (gh-486)
- Add ``custom_model_name`` parameter to the constructor of ``HistoricalRecords`` (gh-451)
- Fix header on history pages when custom site_header is used (gh-448)
- Modify ``pre_create_historical_record`` to pass ``history_instance`` for ease of customization (gh-421)
- Raise warning if ``HistoricalRecords(inherit=False)`` is in an abstract model (gh-341)
- Ensure custom arguments for fields are included in historical models' fields (gh-431)
- Add german translations (gh-484)
- Add ``extra_context`` parameter to history_form_view (gh-467)
- Fixed bug that prevented ``next_record`` and ``prev_record`` to work with custom manager names (gh-501)
2.5.1 (2018-10-19)
------------------
- Add ``'+'`` as the ``history_type`` for each instance in ``bulk_history_create`` (gh-449)
- Add support for ``history_change_reason`` for each instance in ``bulk_history_create`` (gh-449)
- Add ``history_change_reason`` in the history list view under the ``Change reason`` display name (gh-458)
- Fix bug that caused failures when using a custom user model (gh-459)
2.5.0 (2018-10-18)
------------------
- Add ability to cascade delete historical records when master record is deleted (gh-440)
- Added Russian localization (gh-441)
2.4.0 (2018-09-20)
------------------
- Add pre and post create_historical_record signals (gh-426)
- Remove support for ``django_mongodb_engine`` when converting AutoFields (gh-432)
- Add support for Django 2.1 (gh-418)
2.3.0 (2018-07-19)
------------------
- Add ability to diff ``HistoricalRecords`` (gh-244)
2.2.0 (2018-07-02)
------------------
- Add ability to specify alternative user_model for tracking (gh-371)
- Add util function ``bulk_create_with_history`` to allow bulk_create with history saved (gh-412)
2.1.1 (2018-06-15)
------------------
- Fixed out-of-memory exception when running populate_history management command (gh-408)
- Fix TypeError on populate_history if excluded_fields are specified (gh-410)
2.1.0 (2018-06-04)
------------------
- Add ability to specify custom ``history_reason`` field (gh-379)
- Add ability to specify custom ``history_id`` field (gh-368)
- Add HistoricalRecord instance properties ``prev_record`` and ``next_record`` (gh-365)
- Can set admin methods as attributes on object history change list template (gh-390)
- Fixed compatibility of >= 2.0 versions with old-style middleware (gh-369)
2.0 (2018-04-05)
----------------
- Added Django 2.0 support (gh-330)
- Dropped support for Django<=1.10 (gh-356)
- Fix bug where ``history_view`` ignored user permissions (gh-361)
- Fixed ``HistoryRequestMiddleware`` which hadn't been working for Django>1.9 (gh-364)
1.9.1 (2018-03-30)
------------------
- Use ``get_queryset`` rather ``than model.objects`` in ``history_view``. (gh-303)
- Change ugettext calls in models.py to ugettext_lazy
- Resolve issue where model references itself (gh-278)
- Fix issue with tracking an inherited model (abstract class) (gh-269)
- Fix history detail view on django-admin for abstract models (gh-308)
- Dropped support for Django<=1.6 and Python 3.3 (gh-292)
1.9.0 (2017-06-11)
------------------
- Add ``--batchsize`` option to the ``populate_history`` management command. (gh-231)
- Add ability to show specific attributes in admin history list view. (gh-256)
- Add Brazilian Portuguese translation file. (gh-279)
- Fix locale file packaging issue. (gh-280)
- Add ability to specify reason for history change. (gh-275)
- Test against Django 1.11 and Python 3.6. (gh-276)
- Add ``excluded_fields`` option to exclude fields from history. (gh-274)
1.8.2 (2017-01-19)
------------------
- Add Polish locale.
- Add Django 1.10 support.
1.8.1 (2016-03-19)
------------------
- Clear the threadlocal request object when processing the response to prevent test interactions. (gh-213)
1.8.0 (2016-02-02)
------------------
- History tracking can be inherited by passing ``inherit=True``. (gh-63)
1.7.0 (2015-12-02)
------------------
- Add ability to list history in admin when the object instance is deleted. (gh-72)
- Add ability to change history through the admin. (Enabled with the ``SIMPLE_HISTORY_EDIT`` setting.)
- Add Django 1.9 support.
- Support for custom tables names. (gh-196)
1.6.3 (2015-07-30)
------------------
- Respect ``to_field`` and ``db_column`` parameters (gh-182)
1.6.2 (2015-07-04)
------------------
- Use app loading system and fix deprecation warnings on Django 1.8 (gh-172)
- Update Landscape configuration
1.6.1 (2015-04-21)
------------------
- Fix OneToOneField transformation for historical models (gh-166)
- Disable cascading deletes from related models to historical models
- Fix restoring historical instances with missing one-to-one relations (gh-162)
1.6.0 (2015-04-16)
------------------
- Add support for Django 1.8+
- Deprecated use of ``CustomForeignKeyField`` (to be removed)
- Remove default reverse accessor to ``auth.User`` for historical models (gh-121)
1.5.4 (2015-01-03)
------------------
- Fix a bug when models have a ``ForeignKey`` with ``primary_key=True``
- Do NOT delete the history elements when a user is deleted.
- Add support for ``latest``
- Allow setting a reason for change. [using option changeReason]
1.5.3 (2014-11-18)
------------------
- Fix migrations while using ``order_with_respsect_to`` (gh-140)
- Fix migrations using south
- Allow history accessor class to be overridden in ``register()``
1.5.2 (2014-10-15)
------------------
- Additional fix for migrations (gh-128)
1.5.1 (2014-10-13)
------------------
- Removed some incompatibilities with non-default admin sites (gh-92)
- Fixed error caused by ``HistoryRequestMiddleware`` during anonymous requests (gh-115 fixes gh-114)
- Added workaround for clashing related historical accessors on User (gh-121)
- Added support for MongoDB AutoField (gh-125)
- Fixed CustomForeignKeyField errors with 1.7 migrations (gh-126 fixes gh-124)
1.5.0 (2014-08-17)
------------------
- Extended availability of the ``as_of`` method to models as well as instances.
- Allow ``history_user`` on historical objects to be set by middleware.
- Fixed error that occurs when a foreign key is designated using just the name of the model.
- Drop Django 1.3 support
1.4.0 (2014-06-29)
------------------
- Fixed error that occurs when models have a foreign key pointing to a one to one field.
- Fix bug when model verbose_name uses unicode (gh-76)
- Allow non-integer foreign keys
- Allow foreign keys referencing the name of the model as a string
- Added the ability to specify a custom ``history_date``
- Note that ``simple_history`` should be added to ``INSTALLED_APPS`` (gh-94 fixes gh-69)
- Properly handle primary key escaping in admin URLs (gh-96 fixes gh-81)
- Add support for new app loading (Django 1.7+)
- Allow specifying custom base classes for historical models (gh-98)
1.3.0 (2013-05-17)
------------------
- Fixed bug when using ``django-simple-history`` on nested models package
- Allow history table to be formatted correctly with ``django-admin-bootstrap``
- Disallow calling ``simple_history.register`` twice on the same model
- Added Python 3 support
- Added support for custom user model (Django 1.5+)
1.2.3 (2013-04-22)
------------------
- Fixed packaging bug: added admin template files to PyPI package
1.2.1 (2013-04-22)
------------------
- Added tests
- Added history view/revert feature in admin interface
- Various fixes and improvements
Oct 22, 2010
------------
- Merged setup.py from Klaas van Schelven - Thanks!
Feb 21, 2010
------------
- Initial project creation, with changes to support ForeignKey relations.
Raw data
{
"_id": null,
"home_page": "https://github.com/jazzband/django-simple-history",
"name": "django-simple-history",
"maintainer": "Trey Hunner",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "Corey Bertram",
"author_email": "corey@qr7.com",
"download_url": "https://files.pythonhosted.org/packages/cf/f2/31e587ad8ce0c67234d45cc9c4ef921655bbaea0600e012e970fe9ae4623/django-simple-history-3.5.0.tar.gz",
"platform": null,
"description": "django-simple-history\n=====================\n\n.. image:: https://github.com/jazzband/django-simple-history/actions/workflows/test.yml/badge.svg\n :target: https://github.com/jazzband/django-simple-history/actions/workflows/test.yml\n :alt: Build Status\n\n.. image:: https://readthedocs.org/projects/django-simple-history/badge/?version=latest\n :target: https://django-simple-history.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n.. image:: https://img.shields.io/codecov/c/github/jazzband/django-simple-history/master.svg\n :target: https://app.codecov.io/github/jazzband/django-simple-history?branch=master\n :alt: Test Coverage\n\n.. image:: https://img.shields.io/pypi/v/django-simple-history.svg\n :target: https://pypi.org/project/django-simple-history/\n :alt: PyPI Version\n\n.. image:: https://api.codeclimate.com/v1/badges/66cfd94e2db991f2d28a/maintainability\n :target: https://codeclimate.com/github/jazzband/django-simple-history/maintainability\n :alt: Maintainability\n\n.. image:: https://static.pepy.tech/badge/django-simple-history\n :target: https://pepy.tech/project/django-simple-history\n :alt: Downloads\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :target: https://github.com/psf/black\n :alt: Code Style\n\n.. image:: https://jazzband.co/static/img/badge.svg\n :target: https://jazzband.co/\n :alt: Jazzband\n\n\ndjango-simple-history stores Django model state on every create/update/delete.\n\nThis app supports the following combinations of Django and Python:\n\n========== ========================\n Django Python\n========== ========================\n3.2 3.8, 3.9, 3.10\n4.2 3.8, 3.9, 3.10, 3.11, 3.12, 3.13-dev\n5.0 3.10, 3.11, 3.12, 3.13-dev\nmain 3.10, 3.11, 3.12, 3.13-dev\n========== ========================\n\nGetting Help\n------------\n\nDocumentation is available at https://django-simple-history.readthedocs.io/\n\nPull requests are welcome. Read the `CONTRIBUTING`_ file for tips on\nsubmitting a pull request.\n\n.. _CONTRIBUTING: https://github.com/jazzband/django-simple-history/blob/master/CONTRIBUTING.rst\n\nLicense\n-------\n\nThis project is licensed under the\n`BSD 3-Clause license <https://choosealicense.com/licenses/bsd-3-clause/>`_.\n\nChanges\n=======\n\nUnreleased\n----------\n\n\n3.5.0 (2024-02-19)\n------------------\n\n- Fixed ``FieldError`` when creating historical records for many-to-many fields with\n ``to=\"self\"`` (gh-1218)\n- Allow ``HistoricalRecords.m2m_fields`` as str (gh-1243)\n- Fixed ``HistoryRequestMiddleware`` deleting non-existent\n ``HistoricalRecords.context.request`` in very specific circumstances (gh-1256)\n- Added ``custom_historical_attrs`` to ``bulk_create_with_history()`` and\n ``bulk_update_with_history()`` for setting additional fields on custom history models\n (gh-1248)\n- Passing an empty list as the ``fields`` argument to ``bulk_update_with_history()`` is\n now allowed; history records will still be created (gh-1248)\n- Added temporary requirement on ``asgiref>=3.6`` while the minimum required Django\n version is lower than 4.2 (gh-1261)\n- Small performance optimization of the ``clean-duplicate_history`` command (gh-1015)\n- Support Simplified Chinese translation (gh-1281)\n- Added support for Django 5.0 (gh-1283)\n- Added support for Python 3.13 (gh-1289)\n\n3.4.0 (2023-08-18)\n------------------\n\n- Fixed typos in the docs\n- Added feature to evaluate ``history`` model permissions explicitly when\n ``SIMPLE_HISTORY_ENFORCE_HISTORY_MODEL_PERMISSIONS`` is set to ``True``\n in ``settings`` (gh-1017).\n- Fixed ``SimpleHistoryAdmin`` not properly integrating with custom user models (gh-1177)\n- Support Indonesian translation (gh-1198)\n- Support Urdu translation (gh-1199)\n- Support Norwegian Bokm\u00e5l translation (gh-1210)\n- Dropped support for Python 3.7, which reached end-of-life on 2023-06-27 (gh-1202)\n- Dropped support for Django 4.0, which reached end-of-life on 2023-04-01 (gh-1202)\n- Added support for Django 4.2 (gh-1202)\n- Made ``bulk_update_with_history()`` return the number of model rows updated (gh-1206)\n- Fixed ``HistoryRequestMiddleware`` not cleaning up after itself (i.e. deleting\n ``HistoricalRecords.context.request``) under some circumstances (gh-1188)\n- Made ``HistoryRequestMiddleware`` async-capable (gh-1209)\n- Fixed error when setting ``table_name`` with ``inherit=True`` (gh-1195)\n\n3.3.0 (2023-03-08)\n------------------\n\n- Made it possible to use the new ``m2m_fields`` with model inheritance (gh-1042)\n- Added two signals: ``pre_create_historical_m2m_records`` and ``post_create_historical_m2m_records`` (gh-1042)\n- Added ``tracked_fields`` attribute to historical models (gh-1038)\n- Fixed ``KeyError`` when running ``clean_duplicate_history`` on models with ``excluded_fields`` (gh-1038)\n- Added support for Python 3.11 (gh-1053)\n- Added Arabic translations (gh-1056)\n- Fixed a code example under \"Tracking many to many relationships\" (gh-1069)\n- Added a ``--base-manager`` option to the ``clean_duplicate_history`` management command (gh-1115)\n\n3.2.0 (2022-09-28)\n------------------\n\n- Fixed typos in the docs\n- Removed n+1 query from ``bulk_create_with_history`` utility (gh-975)\n- Started using ``exists`` query instead of ``count`` in ``populate_history`` command (gh-982)\n- Add basic support for many-to-many fields (gh-399)\n- Added support for Django 4.1 (gh-1021)\n\n3.1.1 (2022-04-23)\n------------------\n\nFull list of changes:\n\n- Fix py36 references in pyproject.toml (gh-960)\n- Fix local setup.py install versioning issue (gh-960)\n- Remove py2 universal wheel cfg - only py3 needed now (gh-960)\n\n\n3.1.0 (2022-04-09)\n------------------\n\nBreaking Changes:\n\n- Dropped support for Django 2.2 (gh-968)\n- Dropped support for Django 3.1 (gh-952)\n- Dropped support for Python 3.6, which reached end-of-life on 2021-12-23 (gh-946)\n\nUpgrade Implications:\n\n- Run `makemigrations` after upgrading to realize the benefit of indexing changes.\n\nFull list of changes:\n\n- Added queryset-based filtering with ``as_of`` (gh-397)\n- Added index on `history_date` column; opt-out with setting `SIMPLE_HISTORY_DATE_INDEX` (gh-565)\n- RecordModels now support a ``no_db_index`` setting, to drop indices in historical models,\n default stays the same (gh-720)\n- Support ``included_fields`` for ``history.diff_against`` (gh-776)\n- Improve performance of ``history.diff_against`` by reducing number of queries to 0 in most cases (gh-776)\n- Fixed ``prev_record`` and ``next_record`` performance when using ``excluded_fields`` (gh-791)\n- Fixed `update_change_reason` in pk (gh-806)\n- Fixed bug where serializer of djangorestframework crashed if used with ``OrderingFilter`` (gh-821)\n- Fixed `make format` so it works by using tox (gh-859)\n- Fixed bug where latest() is not idempotent for identical ``history_date`` records (gh-861)\n- Added ``excluded_field_kwargs`` to support custom ``OneToOneField`` that have\n additional arguments that don't exist on ``ForeignKey``. (gh-870)\n- Added Czech translations (gh-885)\n- Added ability to break into debugger on unit test failure (gh-890)\n- Added pre-commit for better commit quality (gh-896)\n- Russian translations update (gh-897)\n- Added support for Django 4.0 (gh-898)\n- Added Python 3.10 to test matrix (gh-899)\n- Fix bug with ``history.diff_against`` with non-editable fields (gh-923)\n- Added HistoricForeignKey (gh-940)\n- Support change reason formula feature. Change reason formula can be defined by overriding\n ``get_change_reason_for_object`` method after subclassing ``HistoricalRecords`` (gh-962)\n\n\n3.0.0 (2021-04-16)\n------------------\n\nBreaking changes:\n\n- Removed support for Django 3.0\n- Removed `changeReason` in favor of `_change_reason` (see 2.10.0)\n\nFull list of changes:\n\n- Removed support for Django versions prior to 2.2 (gh-652)\n- Migrate from TravisCI to Github Actions (gh-739)\n- Add Python 3.9 support (gh-745)\n- Support ``ignore_conflicts`` in ``bulk_create_with_history`` (gh-733)\n- Use ``asgiref`` when available instead of thread locals (gh-747)\n- Sort imports with isort (gh-751)\n- Queryset ``history.as_of`` speed improvements by calculating in the DB (gh-758)\n- Increase `black` and `isort` python version to 3.6 (gh-817)\n- Remove Django 3.0 support (gh-817)\n- Add Django 3.2 support (gh-817)\n- Improve French translations (gh-811)\n- Remove support for changeReason (gh-819)\n\n2.12.0 (2020-10-14)\n-------------------\n- Add default date to ``bulk_create_with_history`` and ``bulk_update_with_history`` (gh-687)\n- Exclude ManyToManyFields when using ``bulk_create_with_history`` (gh-699)\n- Added ``--excluded_fields`` argument to ``clean_duplicate_history`` command (gh-674)\n- Exclude ManyToManyFields when fetching excluded fields (gh-707)\n- Use default model manager for ``bulk_create_with_history`` and\n ``bulk_update_with_history`` instead of ``objects`` (gh-703)\n- Add optional ``manager`` argument to ``bulk_update_with_history`` to use instead of\n the default manager (gh-703)\n- Add support for Django 3.1 (gh-713)\n- Fix a bug with ``clean_old_history`` command's `--days` argument (gh-722)\n\n\\* NOTE: This will be the last minor release before 3.0.0.\n\n2.11.0 (2020-06-20)\n-------------------\n- Added ``clean_old_history`` management command (gh-675)\n- Added ``user_db_constraint`` param to history to avoid circular reference on delete (gh-676)\n- Leverages ``get_user`` from ``HistoricalRecords`` in order to set a fallback user on\n bulk update and bulk create (gh-677)\n\n2.10.0 (2020-04-27)\n-------------------\n- Added ``bulk_update_with_history`` utility function (gh-650)\n- Add default user and default change reason to ``bulk_create_with_history`` and ``bulk_update_with_history`` (gh-653)\n- Add french translation (gh-654)\n- Start using ``_change_reason`` instead of ``changeReason`` to add change reasons to historical\n objects. ``changeReason`` is deprecated and will be removed in version ``3.0.0`` (gh-655)\n\n2.9.0 (2020-04-23)\n------------------\n- Add simple filtering if provided a minutes argument in ``clean_duplicate_history`` (gh-606)\n- Add setting to convert ``FileField`` to ``CharField`` instead of ``TextField`` (gh-625)\n- Added notes on BitBucket Pipelines (gh-627)\n- import model ``ContentType`` in ``SimpleHistoryAdmin`` using ``django_apps.get_model``\n to avoid possible ``AppRegistryNotReady`` exception (gh-630)\n- Fix ``utils.update_change_reason`` when user specifies excluded_fields (gh-637)\n- Changed how ``now`` is imported from ``timezone`` (``timezone`` module is imported now) (gh-643)\n- ``settings.SIMPLE_HISTORY_REVERT_DISABLED`` if True removes the Revert\n button from the history form for all historical models (gh-632))\n\n2.8.0 (2019-12-02)\n------------------\n- Fixed ``bulk_create_with_history support`` for HistoryRecords with ``relation_name`` attribute (gh-591)\n- Added support for ``bulk_create_with_history`` for databases different from PostgreSQL (gh-577)\n- Fixed ``DoesNotExist`` error when trying to get instance if object is deleted (gh-571)\n- Fix ``model_to_dict`` to detect changes in a parent model when using\n ``inherit=True`` (backwards-incompatible for users who were directly\n using previous version) (gh-576)\n- Use an iterator for ``clean_duplicate_history`` (gh-604)\n- Add support for Python 3.8 and Django 3.0 (gh-610)\n\n2.7.3 (2019-07-15)\n------------------\n- Fixed ``BigAutoField`` not mirrored as ``BigInt`` (gh-556)\n- Fixed ``most_recent()`` bug with ``excluded_fields`` (gh-561)\n- Added official Django 2.2 support (gh-555)\n\n2.7.2 (2019-04-17)\n------------------\n- Fixed ModuleNotFound issue for ``six`` (gh-553)\n\n2.7.1 (2019-04-16)\n------------------\n- Added the possibility to create a relation to the original model (gh-536)\n- Fix router backward-compatibility issue with 2.7.0 (gh-539, gh-547)\n- Fix hardcoded history manager (gh-542)\n- Replace deprecated ``django.utils.six`` with ``six`` (gh-526)\n- Allow ``custom_model_name`` parameter to be a callable (gh-489)\n\n2.7.0 (2019-01-16)\n------------------\n- \\* Add support for ``using`` chained manager method and save/delete keyword argument (gh-507)\n- Added management command ``clean_duplicate_history`` to remove duplicate history entries (gh-483)\n- Updated most_recent to work with excluded_fields (gh-477)\n- Fixed bug that prevented self-referential foreign key from using ``'self'`` (gh-513)\n- Added ability to track custom user with explicit custom ``history_user_id_field`` (gh-511)\n- Don't resolve relationships for history objects (gh-479)\n- Reorganization of docs (gh-510)\n\n\\* NOTE: This change was not backward compatible for users using routers to write\nhistory tables to a separate database from their base tables. This issue is fixed in\n2.7.1.\n\n2.6.0 (2018-12-12)\n------------------\n- Add ``app`` parameter to the constructor of ``HistoricalRecords`` (gh-486)\n- Add ``custom_model_name`` parameter to the constructor of ``HistoricalRecords`` (gh-451)\n- Fix header on history pages when custom site_header is used (gh-448)\n- Modify ``pre_create_historical_record`` to pass ``history_instance`` for ease of customization (gh-421)\n- Raise warning if ``HistoricalRecords(inherit=False)`` is in an abstract model (gh-341)\n- Ensure custom arguments for fields are included in historical models' fields (gh-431)\n- Add german translations (gh-484)\n- Add ``extra_context`` parameter to history_form_view (gh-467)\n- Fixed bug that prevented ``next_record`` and ``prev_record`` to work with custom manager names (gh-501)\n\n2.5.1 (2018-10-19)\n------------------\n- Add ``'+'`` as the ``history_type`` for each instance in ``bulk_history_create`` (gh-449)\n- Add support for ``history_change_reason`` for each instance in ``bulk_history_create`` (gh-449)\n- Add ``history_change_reason`` in the history list view under the ``Change reason`` display name (gh-458)\n- Fix bug that caused failures when using a custom user model (gh-459)\n\n2.5.0 (2018-10-18)\n------------------\n- Add ability to cascade delete historical records when master record is deleted (gh-440)\n- Added Russian localization (gh-441)\n\n2.4.0 (2018-09-20)\n------------------\n- Add pre and post create_historical_record signals (gh-426)\n- Remove support for ``django_mongodb_engine`` when converting AutoFields (gh-432)\n- Add support for Django 2.1 (gh-418)\n\n2.3.0 (2018-07-19)\n------------------\n- Add ability to diff ``HistoricalRecords`` (gh-244)\n\n2.2.0 (2018-07-02)\n------------------\n- Add ability to specify alternative user_model for tracking (gh-371)\n- Add util function ``bulk_create_with_history`` to allow bulk_create with history saved (gh-412)\n\n2.1.1 (2018-06-15)\n------------------\n- Fixed out-of-memory exception when running populate_history management command (gh-408)\n- Fix TypeError on populate_history if excluded_fields are specified (gh-410)\n\n2.1.0 (2018-06-04)\n------------------\n- Add ability to specify custom ``history_reason`` field (gh-379)\n- Add ability to specify custom ``history_id`` field (gh-368)\n- Add HistoricalRecord instance properties ``prev_record`` and ``next_record`` (gh-365)\n- Can set admin methods as attributes on object history change list template (gh-390)\n- Fixed compatibility of >= 2.0 versions with old-style middleware (gh-369)\n\n2.0 (2018-04-05)\n----------------\n- Added Django 2.0 support (gh-330)\n- Dropped support for Django<=1.10 (gh-356)\n- Fix bug where ``history_view`` ignored user permissions (gh-361)\n- Fixed ``HistoryRequestMiddleware`` which hadn't been working for Django>1.9 (gh-364)\n\n1.9.1 (2018-03-30)\n------------------\n- Use ``get_queryset`` rather ``than model.objects`` in ``history_view``. (gh-303)\n- Change ugettext calls in models.py to ugettext_lazy\n- Resolve issue where model references itself (gh-278)\n- Fix issue with tracking an inherited model (abstract class) (gh-269)\n- Fix history detail view on django-admin for abstract models (gh-308)\n- Dropped support for Django<=1.6 and Python 3.3 (gh-292)\n\n1.9.0 (2017-06-11)\n------------------\n- Add ``--batchsize`` option to the ``populate_history`` management command. (gh-231)\n- Add ability to show specific attributes in admin history list view. (gh-256)\n- Add Brazilian Portuguese translation file. (gh-279)\n- Fix locale file packaging issue. (gh-280)\n- Add ability to specify reason for history change. (gh-275)\n- Test against Django 1.11 and Python 3.6. (gh-276)\n- Add ``excluded_fields`` option to exclude fields from history. (gh-274)\n\n1.8.2 (2017-01-19)\n------------------\n- Add Polish locale.\n- Add Django 1.10 support.\n\n1.8.1 (2016-03-19)\n------------------\n- Clear the threadlocal request object when processing the response to prevent test interactions. (gh-213)\n\n1.8.0 (2016-02-02)\n------------------\n- History tracking can be inherited by passing ``inherit=True``. (gh-63)\n\n1.7.0 (2015-12-02)\n------------------\n- Add ability to list history in admin when the object instance is deleted. (gh-72)\n- Add ability to change history through the admin. (Enabled with the ``SIMPLE_HISTORY_EDIT`` setting.)\n- Add Django 1.9 support.\n- Support for custom tables names. (gh-196)\n\n1.6.3 (2015-07-30)\n------------------\n- Respect ``to_field`` and ``db_column`` parameters (gh-182)\n\n1.6.2 (2015-07-04)\n------------------\n- Use app loading system and fix deprecation warnings on Django 1.8 (gh-172)\n- Update Landscape configuration\n\n1.6.1 (2015-04-21)\n------------------\n- Fix OneToOneField transformation for historical models (gh-166)\n- Disable cascading deletes from related models to historical models\n- Fix restoring historical instances with missing one-to-one relations (gh-162)\n\n1.6.0 (2015-04-16)\n------------------\n- Add support for Django 1.8+\n- Deprecated use of ``CustomForeignKeyField`` (to be removed)\n- Remove default reverse accessor to ``auth.User`` for historical models (gh-121)\n\n1.5.4 (2015-01-03)\n------------------\n- Fix a bug when models have a ``ForeignKey`` with ``primary_key=True``\n- Do NOT delete the history elements when a user is deleted.\n- Add support for ``latest``\n- Allow setting a reason for change. [using option changeReason]\n\n1.5.3 (2014-11-18)\n------------------\n- Fix migrations while using ``order_with_respsect_to`` (gh-140)\n- Fix migrations using south\n- Allow history accessor class to be overridden in ``register()``\n\n1.5.2 (2014-10-15)\n------------------\n- Additional fix for migrations (gh-128)\n\n1.5.1 (2014-10-13)\n------------------\n- Removed some incompatibilities with non-default admin sites (gh-92)\n- Fixed error caused by ``HistoryRequestMiddleware`` during anonymous requests (gh-115 fixes gh-114)\n- Added workaround for clashing related historical accessors on User (gh-121)\n- Added support for MongoDB AutoField (gh-125)\n- Fixed CustomForeignKeyField errors with 1.7 migrations (gh-126 fixes gh-124)\n\n1.5.0 (2014-08-17)\n------------------\n- Extended availability of the ``as_of`` method to models as well as instances.\n- Allow ``history_user`` on historical objects to be set by middleware.\n- Fixed error that occurs when a foreign key is designated using just the name of the model.\n- Drop Django 1.3 support\n\n1.4.0 (2014-06-29)\n------------------\n- Fixed error that occurs when models have a foreign key pointing to a one to one field.\n- Fix bug when model verbose_name uses unicode (gh-76)\n- Allow non-integer foreign keys\n- Allow foreign keys referencing the name of the model as a string\n- Added the ability to specify a custom ``history_date``\n- Note that ``simple_history`` should be added to ``INSTALLED_APPS`` (gh-94 fixes gh-69)\n- Properly handle primary key escaping in admin URLs (gh-96 fixes gh-81)\n- Add support for new app loading (Django 1.7+)\n- Allow specifying custom base classes for historical models (gh-98)\n\n1.3.0 (2013-05-17)\n------------------\n\n- Fixed bug when using ``django-simple-history`` on nested models package\n- Allow history table to be formatted correctly with ``django-admin-bootstrap``\n- Disallow calling ``simple_history.register`` twice on the same model\n- Added Python 3 support\n- Added support for custom user model (Django 1.5+)\n\n1.2.3 (2013-04-22)\n------------------\n\n- Fixed packaging bug: added admin template files to PyPI package\n\n1.2.1 (2013-04-22)\n------------------\n\n- Added tests\n- Added history view/revert feature in admin interface\n- Various fixes and improvements\n\nOct 22, 2010\n------------\n\n- Merged setup.py from Klaas van Schelven - Thanks!\n\nFeb 21, 2010\n------------\n\n- Initial project creation, with changes to support ForeignKey relations.\n",
"bugtrack_url": null,
"license": "",
"summary": "Store model history and view/revert changes from admin site.",
"version": "3.5.0",
"project_urls": {
"Changelog": "https://github.com/jazzband/django-simple-history/blob/master/CHANGES.rst",
"Documentation": "https://django-simple-history.readthedocs.io/",
"Homepage": "https://github.com/jazzband/django-simple-history",
"Source": "https://github.com/jazzband/django-simple-history",
"Tracker": "https://github.com/jazzband/django-simple-history/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3ea2c4fa2fe83e32237c2232fff6b6f4eec548473e8d119ad9f71d5030818ed8",
"md5": "6cc84ee2d6cbb959a38beab430774ae4",
"sha256": "0030b3bb5ed219d6453320213e75cfa00dab7a381946124df9411729101c8874"
},
"downloads": -1,
"filename": "django_simple_history-3.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6cc84ee2d6cbb959a38beab430774ae4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 125537,
"upload_time": "2024-02-23T22:12:23",
"upload_time_iso_8601": "2024-02-23T22:12:23.636190Z",
"url": "https://files.pythonhosted.org/packages/3e/a2/c4fa2fe83e32237c2232fff6b6f4eec548473e8d119ad9f71d5030818ed8/django_simple_history-3.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cff231e587ad8ce0c67234d45cc9c4ef921655bbaea0600e012e970fe9ae4623",
"md5": "c802bef0514831575ab2922ab3b0dcef",
"sha256": "eef2943d7c846270f11c8136f38a3ba00de2bebd7b1b89037de5d9b148ed677a"
},
"downloads": -1,
"filename": "django-simple-history-3.5.0.tar.gz",
"has_sig": false,
"md5_digest": "c802bef0514831575ab2922ab3b0dcef",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 569458,
"upload_time": "2024-02-23T22:10:18",
"upload_time_iso_8601": "2024-02-23T22:10:18.635585Z",
"url": "https://files.pythonhosted.org/packages/cf/f2/31e587ad8ce0c67234d45cc9c4ef921655bbaea0600e012e970fe9ae4623/django-simple-history-3.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-23 22:10:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jazzband",
"github_project": "django-simple-history",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "django-simple-history"
}
JSON
