Metadata-Version: 1.1
Name: django-dbmessages
Version: 0.2.0a
Summary: Request-independent messaging for Django on top of contrib.messages
Home-page: UNKNOWN
Author: Anton Strogonoff
Author-email: anton@strogonoff.name
License: BSD License
Download-URL: http://github.com/strogonoff/django-dbmessages
Description: django-dbmessages
        =================
        
        It's almost like django.contrib.messages, but it doesn't need request to message a user.
        
        Implementation-wise, it's a layer on top of Django's ``contrib.messages``.
        
        To message a user you'll simply create and save an instance
        of dbmessages' ``Message`` model via shell, Django admin, or some other means.
        
        ``Message`` model has, as fields, the attributes you'd normally pass
        to ``contrib.messages`` (level, message, extra_tags) plus a ForeignKey link to User model.
        
        You'll have to supply the addressee user yourself, this app doesn't do any magic
        in that regard.
        
        The next time given user appears on the site, middleware provided by dbmessages
        checks if user has any messages for them, and adds them to request using regular
        ``contrib.messages`` API. Then it deletes those messages from the DB.
        Simple as that.
        
        
        Quick start
        -----------
        
        0. Make sure to enable Django's ``contrib.messages`` in your project
           (`check the docs <https://docs.djangoproject.com/en/1.4/ref/contrib/messages/#enabling-messages>`_).
        
        1. Install ``django-dbmessages`` (it's on PyPI).
        
        2. Add ``'dbmessages'`` to your INSTALLED_APPS
           and ``'dbmessages.middleware.DBMessageMiddleware'`` to MIDDLEWARE_CLASSES.
        
        3. Synchronize (or migrate) the DB.
        
        Now you can get into shell and address a message to yourself:
        
            >>> from dbmessages.models import Message
            >>> from django.contrib import messages
            >>> Message.objects.create(to_user=your_user, level=messages.INFO, message="Ahoy there")
        
        Provided your front-end is integrated with Django's ``contrib.messages``,
        you should see the "Ahoy there" message the next time you log in
        under your account.
        
        
        Changelog
        ---------
        
        **0.2.0**
        
        - Added Django-style initial migration, to support Django >=1.7.
        - Corrected check for Django version when choosing user model reference.
        
        **0.1.1**
        
        First stable release.
        
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
