Metadata-Version: 2.1
Name: django-permanent-helpers
Version: 1.0.1
Summary: django admin helper classes for django-permanent models
Home-page: https://github.com/bashu/django-permanent-helpers
Author: Basil Shubin
Author-email: basil.shubin@gmail.com
License: MIT License
Download-URL: https://github.com/bashu/django-permanent-helpers/zipball/master
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: Framework :: Django :: 3.2
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS

django-permanent-helpers
========================

.. image:: https://img.shields.io/pypi/v/django-permanent-helpers.svg
    :target: https://pypi.python.org/pypi/django-permanent-helpers/

.. image:: https://img.shields.io/pypi/dm/django-permanent-helpers.svg
    :target: https://pypi.python.org/pypi/django-permanent-helpers/

.. image:: https://img.shields.io/github/license/bashu/django-permanent-helpers.svg
    :target: https://pypi.python.org/pypi/django-permanent-helpers/

Django admin helper classes for django-permanent_ models.

Authored by `Basil Shubin <http://github.com/bashu>`_, inspired by django-taggit-helpers_

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

First install the module, preferably in a virtual environment. It can be installed from PyPI:

.. code-block:: shell

    pip install django-permanent-helpers

Setup
-----

First make sure the project is configured for django-permanent_.

Then add the following settings:

.. code-block:: python

    INSTALLED_APPS += (
        'django_permanent_helpers',
    )


Usage
-----

PermanentModelAdmin
~~~~~~~~~~~~~~~~~~~

An abstract ModelAdmin which will include deleted objects in its listing and enable un-deleting feature.

.. code-block:: python

    from django_permanent_helpers.admin import PermanentModelAdmin

    class MyModelAdmin(PermanentModelAdmin):
        pass

PermanentModelListFilter
~~~~~~~~~~~~~~~~~~~~~~~~

Filter records by their ``PERMANENT_FIELD`` value, use together with ``PermanentModelAdmin`` class.

.. code-block:: python

    from django_permanent_helpers.admin import PermanentModelAdmin, PermanentModelListFilter

    class MyModelAdmin(PermanentModelAdmin):
        list_filter = [PermanentModelListFilter]

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

If you like this module, forked it, or would like to improve it, please let us know!
Pull requests are welcome too. :-)

License
-------

``django-permanent-helpers`` is released under the MIT license.

.. _django-permanent: https://github.com/meteozond/django-permanent
.. _django-taggit-helpers: https://github.com/mfcovington/django-taggit-helpers

Changes
-------

1.0.1 (2021-11-29)
~~~~~~~~~~~~~~~~~~

* Updated ru translation.

1.0.0 (2021-11-29)
~~~~~~~~~~~~~~~~~~

* Added Django 3+ support.
* Dropped Python 2.7 support.
* Dropped Django 1.10 / 1.11 support.


