This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

AS OF 2015-01-01 THIS PACKAGE IS NO LONGER SUPPORTED!

Easy sending of mixed content (html + plain) emails for Django.

Prerequisites

  • Django 1.5.+
  • Python 2.7.+, 3.3.+

Installation

  1. Install in your virtual environment:

    $ pip install django-lime

  2. Add lime to your INSTALLED_APPS of your Django settings module:

>>> INSTALLED_APPS = (
>>>     # ...
>>>     'lime',
>>>     # ...
>>> )
>>>
>>> LIME_SITE_LOGO = 'img/logo.png' # Relative path to logo
>>> LIME_SITE_TEAM = ugettext("Example site team") # Team name (see the base email template)
  1. Copy the templates from lime to your main templates directory.
  2. Define LIME_SITE_LOGO and LIME_SITE_TEAM variables in your settings module.
  3. Make sure your django.contrib.sites.models.Site has data that makes sense, as site_name and domain values will be taken from there. Alternatively, you can define (override) those by defining the following variables in your settings module.
    • LIME_SITE_NAME
    • LIME_SITE_DOMAIN

Usage examples

Inherit your app templates from lime base templates or your own copy of the lime templates (copied to templates directory). By default the following parameters are passed to your template:

  • site_name: Taken from your django.contrib.sites.models.Site.
  • domain: Taken from your django.contrib.sites.models.Site
  • site_team: Site team name.
  • site_logo: Relative URL to site logo.

Sending of a mixed content e-mail is as simple as follows.

  • subject (str): E-mail subject.
  • from_email (str): From e-mail.
  • to (str or list): E-mail or a list of e-mails to send the e-mail to.
  • context (dict): Variables you want to have accessible in your e-mail templates.
  • plain_template (str): Plain template name.
  • html_template (str): HTML template name.
  • bcc (str or list): E-mail or a list of e-mails to send the e-mail to (as BCC).
>>> from lime import send_email
>>>
>>> send_email(
>>>     subject = _("You've got mail"),
>>>     from_email = 'ramzes.4@example.come', # From
>>>     to = 'someone.else@example.com', # To
>>>     context = {
>>>         'date_submitted': datetime.datetime.now().strftime("%Y-%m-%dT%H:%M:%S"),
>>>         'url': 'http://example.com/check-this-fantastic-link.html',
>>>         'full_name': 'John Doe',
>>>         'from_name': 'Ramzes the 4th',
>>>     },
>>>     plain_template = 'foo/emails/foo_test.txt', # Text template
>>>     html_template = 'foo/emails/foo_test.html' # HTML tempalte
>>> )

Running example project

For a working example (including set-up Django environment) check the https://bitbucket.org/barseghyanartur/django-lime (example directory).

  1. Go to example/example directory

    $ cd example/example

  2. Install requirements (in your virtual environment)

    $ pip install -r requirements.txt

  3. Copy local_settings.example to local_settings.py

    $ cp local_settings.example local_settings.py

  4. Create the database

    $ ./manage.py syncdb

  5. Run the project

    $ ./manage.py runserver

License

GPL 2.0/LGPL 2.1

Support

For any issues contact me at the e-mail given in the Author section.

Author

Artur Barseghyan <artur.barseghyan@gmail.com>

Release History

Release History

0.3

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-lime-0.3.tar.gz (5.2 kB) Copy SHA256 Checksum SHA256 Source Sep 10, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting