Skip to main content

Django contrib.messages on steroids

Project description

https://badge.fury.io/py/django-stored-messages.png https://travis-ci.org/evonove/django-stored-messages.png?branch=master https://coveralls.io/repos/evonove/django-stored-messages/badge.png

Django contrib.messages on steroids

The app integrates smoothly with Django’s messages framework (django.contrib.messages), but users can decide which messages have to be stored on the database backend and kept available over sessions.

Features

  • Seamless integration with django.contrib.messages

  • All the features are in a mixin you can attach to your existing storage

  • Stored messages are archived in the database or in a Redis instance

  • Users can configure which message levels have to be persisted

  • REST api to retrieve and mark messages as read (needs djangorestframework)

  • Signalling api to perform actions in response to messages activity

Compatibility table

  • Python 2.7, 3.4, 3.5

  • Django 1.8, 1.9

  • Django Rest Framework >= 3.3 (only if you want to use REST endpoints)

Do you use an earlier version of Django or Django Rest Framework? An old version of stored_messages is available even if it’s not supported anymore. Anyway, plan a migration to a newer version.

Documentation

The full documentation is at http://django-stored-messages.rtfd.org. It includes migration instructions if you’re migrating from an earlier version of stored_messages.

Quickstart

Follow instruction for firing up django.contrib.messages, then install the app:

$ pip install django-stored-messages

Add it to the installed apps:

INSTALLED_APPS = (
    # ...
    'stored_messages',
)

In the settings, tell Django which is the message storage:

MESSAGE_STORAGE = 'stored_messages.storage.PersistentStorage'

As last step, don’t forget to run Django migrations:

$ python manage.py migrate

Then use it in a project through the django.contrib.messages api. The app provides for convenience some message levels which are persisted by default:

import stored_messages

from django.contrib import messages

# standard message
messages.add_message(request, messages.INFO, 'Hello world.')
# this will be persisted and marked as 'unread'
messages.add_message(request, stored_messages.STORED_INFO, 'Hello world, to the database!')

stored_messages expose the same api as well, so one can do:

import stored_messages
stored_messages.add_message(request, stored_messages.INFO, 'Hello!')

If you want to use standard message levels but persist the messages, just add something like this to the settings:

from django.contrib import messages

STORED_MESSAGES = {
    # persist standard infos and standard errors
    'STORE_LEVELS': (messages.INFO, messages.ERROR,),
}

Iterating the messages will automatically mark them as read (but still persisted):

storage = messages.get_messages(request)
for unread_message in storage:
    # unread_message could be a stored message or a "standard" Django message
    do_something_with(unread_message)

…unless you mark the storage as not used:

storage.used = False

You can mark a stored message as read at any time:

stored_messages.mark_read(request.user, message)

Want to store your messages on Redis instead of your database? Here you go:

STORED_MESSAGES = {
    'STORAGE_BACKEND': 'stored_messages.backends.RedisBackend',
    'REDIS_URL': 'redis://localhost:6379/0',
}

Examples

GitHub-like notifications with Stored Messages and AngularJS

History

1.0.1 (2014-04-17)

  • Major bug fixed on inbox_get() backend api

  • Fixed InboxSerializer for redis backend messages

  • Enhanced testsuite

  • Added MessageDoesNotExist descriptions and return 404

1.0.0 (2014-04-01)

  • New backend architecture with Redis support

  • Support for broadcast messages

0.2.1 (2013-12-23)

  • Added stored_messages_count template tag and tests

0.2.0 (2013-10-22)

  • Added stored_messages_archive template tag

  • Extended REST api

0.1.2 (2013-10-13)

  • Added specific template tags for stored messages

0.1.1 (2013-10-10)

  • Fixed setup.py

0.1.0 (2013-10-08)

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-stored-messages-1.4.0.tar.gz (20.5 kB view details)

Uploaded Source

File details

Details for the file django-stored-messages-1.4.0.tar.gz.

File metadata

File hashes

Hashes for django-stored-messages-1.4.0.tar.gz
Algorithm Hash digest
SHA256 00ded1c9ca5544325201fe2e8d7a4c5d97f3ba3dc07ec05312607d297df5031b
MD5 67534f213afc2101f6b6bad3e0545eef
BLAKE2b-256 d409459ec52edc6d32f242fe975d139598224c83e2fcc96c658931ea154321f3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page