async-notifications 0.0.6

Email async notifications with celery.

Async notifications

Email notification with celery and administrative view for send email with delay e.g daily

Features

• Celery integration

• Administrative view

• Enqueued mail system and instantly send

• Problems notification

• User filter email

• Template system with template context

• Send to User, Group or external email

• Django cms integration (djcms_async_notifications) and standalone.

Installation

1. Install from pip

   $ pip install async_notifications

2. Insert async_notifications in your settings INSTALLED_APPS

3. It’s really important set CELERY_MODULE pointing to your project celery file, because it’s needed for assing task to the current project, and configure some default celery options

           from __future__ import absolute_import
   
   CELERY_MODULE = "demo.celery"
   CELERY_TIMEZONE = TIME_ZONE
   CELERY_ACCEPT_CONTENT = ['pickle', 'json']
   
   from celery.schedules import crontab
   
   CELERYBEAT_SCHEDULE = {
       # execute 12:30 pm
       'send_daily_emails': {
           'task': 'async_notifications.tasks.send_daily',
           'schedule': crontab(minute=30, hour=0),
       },
   }

4. Configure your email settings, e.g for development

   DEFAULT_FROM_EMAIL="[e-mail]"
   EMAIL_HOST="localhost"
   EMAIL_PORT="1025"

5. Run migrations

   $ python manage.py migrate

Runing the project

You need to run 3 subsystems for run this app so you need 3 xterm, for this explanation I will use the demo project

1. Run smtp debug client

   $ python -m smtpd -n -c DebuggingServer localhost:1025

2. Run celery, if you aren’t setup celery yet see celery documentation.

   $ celery -A demo worker -l info -B

3. Run django

   $ python manage.py runserver