Added in ability to add sections to a django email

README.rst

@@ -66,6 +66,43 @@ Example
 
     mail.send()
 
+Example of section usage
+------------------------
+
+.. code:: python
+
+
+    mail = EmailMultiAlternatives(
+      subject="A Subject",
+      body="This is a simple text email body.",
+      from_email="Some Person <hello@example.com>",
+      to=["another_person@example.com"],
+      headers={"Reply-To": "support@sendgrid.com"}
+    )
+    # Add template
+    mail.template_id = 'YOUR TEMPLATE ID FROM SENDGRID ADMIN'
+
+    html_content = "<b>%subst-1%</b> and %subst-2%"
+    mail.attach_alternative(html_content, 'text/html', )
+
+    # Section substitutions you specify here will be used when the template is rendered
+    # See the 'section' docs @ sendgrid
+    mail.substitutions = {
+      '%subst-1%': 'Lets put %section-1%',
+      '%subst-2%': '%section-2%'
+    }
+    mail.sections = {
+      '%section-1%': 'some interesting content here',
+      '%section-2%': '(more interesting content, up to 10k bytes)',
+    }
+
+    mail.send()
+
+
+Section usage result
+----------
+    **Lets put some interesting content here**. Here is something else: (more interesting content, up to 10k bytes)
+
 
 License
 -------

sgbackend/mail.py

@@ -6,7 +6,7 @@
 
 try:
     from urllib.error import HTTPError  # pragma: no cover
-except ImportError: # pragma: no cover
+except ImportError:  # pragma: no cover
     from urllib2 import HTTPError  # pragma: no cover
 
 try:
@@ -27,14 +27,15 @@
     Email,
     Mail,
     Personalization,
-    Substitution
-)
+    Substitution,
+    Section)
 
 
 class SendGridBackend(BaseEmailBackend):
     '''
     SendGrid Web API Backend
     '''
+
     def __init__(self, fail_silently=False, **kwargs):
         super(SendGridBackend, self).__init__(
             fail_silently=fail_silently, **kwargs)
@@ -104,6 +105,10 @@ def _build_sg_mail(self, email):
                 for k, v in email.substitutions.items():
                     personalization.add_substitution(Substitution(k, v))
 
+        if hasattr(email, 'sections'):
+            for k, v in email.sections.items():
+                mail.add_section(Section(k, v))
+
         for k, v in email.extra_headers.items():
             mail.add_header({k: v})
 

tests/test_mail.py

@@ -130,6 +130,20 @@ def test_build_sg_email_w_substitutions(self):
                  'subject': ''}
             )
 
+    def test_build_sg_email_w_sections(self):
+        msg = EmailMessage()
+        msg.sections = {'foo': 'bar'}
+        with self.settings(SENDGRID_API_KEY='test_key'):
+            mail = SendGridBackend()._build_sg_mail(msg)
+            self.assertEqual(
+                mail,
+                {'content': [{'type': 'text/plain', 'value': ''}],
+                 'from': {'email': 'webmaster@localhost'},
+                 'personalizations': [{'subject': ''}],
+                 'sections': {'foo': 'bar'},
+                 'subject': ''}
+            )
+
     def test_build_sg_email_w_extra_headers(self):
         msg = EmailMessage()
         msg.extra_headers = {'EXTRA_HEADER': 'VALUE'}