Metadata-Version: 2.4
Name: django-item-messages
Version: 0.2
Summary: Render item specific messages in the changelist view of the Django admin backend.
Home-page: https://github.com/thomst/django-item-messages
Author: Thomas Leichtfuß
Author-email: thomas.leichtfuss@posteo.de
License: BSD License
Platform: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: Framework :: Django :: 3.2
Classifier: Framework :: Django :: 4.0
Classifier: Framework :: Django :: 4.1
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.0
Classifier: Framework :: Django :: 5.1
Classifier: Framework :: Django :: 5.2
Classifier: Framework :: Django :: 6.0
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Description-Content-Type: text/x-rst
License-File: LICENCE
Requires-Dist: Django>=2.2
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: platform
Dynamic: requires-dist
Dynamic: summary

===============================
Welcome to django-item-messages
===============================

.. image:: https://github.com/thomst/django-item-messages/actions/workflows/tests.yml/badge.svg
   :target: https://github.com/thomst/django-item-messages/actions/workflows/tests.yml
   :alt: Run tests for django-item-messages

.. image:: https://coveralls.io/repos/github/thomst/django-item-messages/badge.svg?branch=main
   :target: https://coveralls.io/github/thomst/django-item-messages?branch=main
   :alt: coveralls badge

.. image:: https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue
   :target: https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue
   :alt: python: 3.8, 3.9, 3.10, 3.11, 3.12, 3.13

.. image:: https://img.shields.io/badge/django-2.2%20%7C%203.0%20%7C%203.1%20%7C%203.2%20%7C%204.0%20%7C%204.1%20%7C%204.2%20%7C%205.0%20%7C%205.1%20%7C%205.2%20%7C%206.0-orange
   :target: https://img.shields.io/badge/django-2.2%20%7C%203.0%20%7C%203.1%20%7C%203.2%20%7C%204.0%20%7C%204.1%20%7C%204.2%20%7C%205.0%20%7C%205.1%20%7C%205.2%20%7C%206.0-orange
   :alt: django: 2.2, 3.0, 3.1, 3.2, 4.0, 4.1, 4.2, 5.0, 5.1, 5.2, 6.0


Description
===========
Item-messages allows you to add item specific messages which are rendered
beneath the related item in an admin changelist view.

Item messages are permanent within a session and can be added, updated or
removed. This makes them also useful for long running asynchronious background
processes.


Installation
============
Install from pypi.org::

    pip install django-item-messages


Setup
=====
Add item_messages to your installed apps::

    INSTALLED_APPS = [
        ...
        'item_messages',
        ...
    ]

Add the item_messages' middleware class::

    MIDDLEWARE = [
        ...
        'item_messages.middleware.ItemMessageMiddleware',
        ...
    ]

**Note**: The item-messages middelware class have to be listed after the session's
middelware class.

Add item_messages' context processor::

    TEMPLATES = [
        {
            ...
            'OPTIONS': {
                'context_processors': [
                    ...
                    'item_messages.context_processors.item_messages',
                    ...
                ],
            },
        },
    ]


Usage
=====
TODO
