aboutsummaryrefslogtreecommitdiff
path: root/.venv/lib/python3.12/site-packages/test/unit/test_mail_helpers.py
diff options
context:
space:
mode:
authorS. Solomon Darnell2025-03-28 21:52:21 -0500
committerS. Solomon Darnell2025-03-28 21:52:21 -0500
commit4a52a71956a8d46fcb7294ac71734504bb09bcc2 (patch)
treeee3dc5af3b6313e921cd920906356f5d4febc4ed /.venv/lib/python3.12/site-packages/test/unit/test_mail_helpers.py
parentcc961e04ba734dd72309fb548a2f97d67d578813 (diff)
downloadgn-ai-master.tar.gz
two version of R2R are hereHEADmaster
Diffstat (limited to '.venv/lib/python3.12/site-packages/test/unit/test_mail_helpers.py')
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_mail_helpers.py1766
1 files changed, 1766 insertions, 0 deletions
diff --git a/.venv/lib/python3.12/site-packages/test/unit/test_mail_helpers.py b/.venv/lib/python3.12/site-packages/test/unit/test_mail_helpers.py
new file mode 100644
index 00000000..c00307d4
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/test_mail_helpers.py
@@ -0,0 +1,1766 @@
+# -*- coding: utf-8 -*-
+import json
+import unittest
+
+try:
+ from email.message import EmailMessage
+except ImportError:
+ # Python2
+ from email import message
+ EmailMessage = message.Message
+
+from sendgrid.helpers.mail import (
+ Asm, Attachment,
+ ClickTracking, Content,
+ DynamicTemplateData, Email, From,
+ Mail, Personalization,
+ Subject, Substitution, To, Cc, Bcc, TrackingSettings
+)
+
+# The below amp html email content is taken from [Google AMP Hello World Email](https://amp.dev/documentation/examples/introduction/hello_world_email/)
+amp_html_content = '''<!doctype html><html amp4email><head><meta charset="utf-8"><script async src="https://cdn.ampproject.org/v0.js"></script><style amp4email-boilerplate>body{visibility:hidden}</style><script async custom-element="amp-carousel" src="https://cdn.ampproject.org/v0/amp-carousel-0.1.js"></script><style amp-custom>.emailbody {padding: 16px;}.helloworld {font-family: Helvetica;color: red;font-size: 24px;padding-bottom: 8px;}.images {max-width: 100%;}</style></head><body><div class="emailbody"><h1 class="helloworld">Hello!</h1><amp-img src="https://amp.dev/static/samples/img/amp.jpg" width="800" height="600" layout="responsive"></amp-img></div></body></html>'''
+
+response_content_with_all_three_mime_contents = json.dumps({
+ "content": [
+ {
+ "type": "text/plain",
+ "value": "and easy to do anywhere, even with Python"
+ },
+ {
+ "type": "text/x-amp-html",
+ "value": amp_html_content
+ },
+ {
+ "type": "text/html",
+ "value": "<strong>and easy to do anywhere, even with Python</strong>"
+ }
+ ],
+ "from": {
+ "email": "test+from@example.com",
+ "name": "Example From Name"
+ },
+ "personalizations": [
+ {
+ "to": [
+ {
+ "email": "test+to@example.com",
+ "name": "Example To Name"
+ }
+ ]
+ }
+ ],
+ "subject": "Sending with SendGrid is Fun"
+})
+
+class UnitTests(unittest.TestCase):
+
+ def test_asm(self):
+ from sendgrid.helpers.mail import (GroupId, GroupsToDisplay)
+ asm1 = Asm(GroupId(1), GroupsToDisplay([1, 2, 3]))
+ asm2 = Asm(1, [1, 2, 3])
+ self.assertEqual(
+ asm1.group_id.get(), asm2.group_id.get())
+ self.assertEqual(
+ asm1.groups_to_display.get(), asm2.groups_to_display.get())
+
+ def test_attachment(self):
+ from sendgrid.helpers.mail import (FileContent, FileType, FileName,
+ Disposition, ContentId)
+ a1 = Attachment(
+ FileContent('Base64EncodedString'),
+ FileName('example.pdf'),
+ FileType('application/pdf'),
+ Disposition('attachment'),
+ ContentId('123')
+ )
+ a2 = Attachment(
+ 'Base64EncodedString',
+ 'example.pdf',
+ 'application/pdf',
+ 'attachment',
+ '123'
+ )
+ self.assertEqual(a1.file_content.get(), a2.file_content.get())
+ self.assertEqual(a1.file_name.get(), a2.file_name.get())
+ self.assertEqual(a1.file_type.get(), a2.file_type.get())
+ self.assertEqual(a1.disposition.get(), a2.disposition.get())
+ self.assertEqual(a1.content_id.get(), a2.content_id.get())
+
+ def test_batch_id(self):
+ from sendgrid.helpers.mail import BatchId
+
+ b1 = BatchId('1')
+ self.assertEqual('1', b1.get())
+
+ # Send a Single Email to a Single Recipient
+ def test_single_email_to_a_single_recipient(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=To('test+to@example.com', 'Example To Name'),
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>'))
+
+ self.assertEqual(
+ message.get(),
+ json.loads(r'''{
+ "content": [
+ {
+ "type": "text/plain",
+ "value": "and easy to do anywhere, even with Python"
+ },
+ {
+ "type": "text/html",
+ "value": "<strong>and easy to do anywhere, even with Python</strong>"
+ }
+ ],
+ "from": {
+ "email": "test+from@example.com",
+ "name": "Example From Name"
+ },
+ "personalizations": [
+ {
+ "to": [
+ {
+ "email": "test+to@example.com",
+ "name": "Example To Name"
+ }
+ ]
+ }
+ ],
+ "subject": "Sending with SendGrid is Fun"
+ }''')
+ )
+
+ def test_single_email_to_a_single_recipient_content_reversed(self):
+ """Tests bug found in Issue-451 with Content ordering causing a crash
+ """
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ message = Mail()
+ message.from_email = From('test+from@example.com', 'Example From Name')
+ message.to = To('test+to@example.com', 'Example To Name')
+ message.subject = Subject('Sending with SendGrid is Fun')
+ message.content = HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>')
+ message.content = PlainTextContent(
+ 'and easy to do anywhere, even with Python')
+
+ self.assertEqual(
+ message.get(),
+ json.loads(r'''{
+ "content": [
+ {
+ "type": "text/plain",
+ "value": "and easy to do anywhere, even with Python"
+ },
+ {
+ "type": "text/html",
+ "value": "<strong>and easy to do anywhere, even with Python</strong>"
+ }
+ ],
+ "from": {
+ "email": "test+from@example.com",
+ "name": "Example From Name"
+ },
+ "personalizations": [
+ {
+ "to": [
+ {
+ "email": "test+to@example.com",
+ "name": "Example To Name"
+ }
+ ]
+ }
+ ],
+ "subject": "Sending with SendGrid is Fun"
+ }''')
+ )
+
+ def test_send_a_single_email_to_multiple_recipients(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ to_emails = [
+ To('test+to0@example.com', 'Example To Name 0'),
+ To('test+to1@example.com', 'Example To Name 1')
+ ]
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=to_emails,
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>'))
+
+ self.assertEqual(
+ message.get(),
+ json.loads(r'''{
+ "content": [
+ {
+ "type": "text/plain",
+ "value": "and easy to do anywhere, even with Python"
+ },
+ {
+ "type": "text/html",
+ "value": "<strong>and easy to do anywhere, even with Python</strong>"
+ }
+ ],
+ "from": {
+ "email": "test+from@example.com",
+ "name": "Example From Name"
+ },
+ "personalizations": [
+ {
+ "to": [
+ {
+ "email": "test+to0@example.com",
+ "name": "Example To Name 0"
+ },
+ {
+ "email": "test+to1@example.com",
+ "name": "Example To Name 1"
+ }
+ ]
+ }
+ ],
+ "subject": "Sending with SendGrid is Fun"
+ }''')
+ )
+
+ def test_send_a_single_email_with_multiple_reply_to_addresses(self):
+ from sendgrid.helpers.mail import (Mail, From, ReplyTo, To, Subject,
+ PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=To('test+to0@example.com', 'Example To Name'),
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent('and easy to do anywhere, even with Python'),
+ html_content=HtmlContent('<strong>and easy to do anywhere, even with Python</strong>'))
+
+ message.reply_to_list = [ReplyTo(email = 'test+reply_to_1@example.com'), ReplyTo(email = 'test+reply_to_2@example.com')]
+
+ self.assertEqual(
+ message.get(),
+ json.loads(r'''{
+ "content": [
+ {
+ "type": "text/plain",
+ "value": "and easy to do anywhere, even with Python"
+ },
+ {
+ "type": "text/html",
+ "value": "<strong>and easy to do anywhere, even with Python</strong>"
+ }
+ ],
+ "from": {
+ "email": "test+from@example.com",
+ "name": "Example From Name"
+ },
+ "personalizations": [
+ {
+ "to": [
+ {
+ "email": "test+to0@example.com",
+ "name": "Example To Name"
+ }
+ ]
+ }
+ ],
+ "reply_to_list": [
+ {
+ "email": "test+reply_to_1@example.com"
+ },
+ {
+ "email": "test+reply_to_2@example.com"
+ }
+ ],
+ "subject": "Sending with SendGrid is Fun"
+ }''')
+ )
+
+ def test_multiple_emails_to_multiple_recipients(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent,
+ Substitution)
+ self.maxDiff = None
+
+ to_emails = [
+ To(email='test+to0@example.com',
+ name='Example Name 0',
+ substitutions=[
+ Substitution('-name-', 'Example Name Substitution 0'),
+ Substitution('-github-', 'https://example.com/test0'),
+ ],
+ subject=Subject('Override Global Subject')),
+ To(email='test+to1@example.com',
+ name='Example Name 1',
+ substitutions=[
+ Substitution('-name-', 'Example Name Substitution 1'),
+ Substitution('-github-', 'https://example.com/test1'),
+ ])
+ ]
+ global_substitutions = Substitution('-time-', '2019-01-01 00:00:00')
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=to_emails,
+ subject=Subject('Hi -name-'),
+ plain_text_content=PlainTextContent(
+ 'Hello -name-, your URL is -github-, email sent at -time-'),
+ html_content=HtmlContent(
+ '<strong>Hello -name-, your URL is <a href=\"-github-\">here</a></strong> email sent at -time-'),
+ global_substitutions=global_substitutions,
+ is_multiple=True)
+
+ self.assertEqual(
+ message.get(),
+ json.loads(r'''{
+ "content": [
+ {
+ "type": "text/plain",
+ "value": "Hello -name-, your URL is -github-, email sent at -time-"
+ },
+ {
+ "type": "text/html",
+ "value": "<strong>Hello -name-, your URL is <a href=\"-github-\">here</a></strong> email sent at -time-"
+ }
+ ],
+ "from": {
+ "email": "test+from@example.com",
+ "name": "Example From Name"
+ },
+ "personalizations": [
+ {
+ "substitutions": {
+ "-github-": "https://example.com/test1",
+ "-name-": "Example Name Substitution 1",
+ "-time-": "2019-01-01 00:00:00"
+ },
+ "to": [
+ {
+ "email": "test+to1@example.com",
+ "name": "Example Name 1"
+ }
+ ]
+ },
+ {
+ "subject": "Override Global Subject",
+ "substitutions": {
+ "-github-": "https://example.com/test0",
+ "-name-": "Example Name Substitution 0",
+ "-time-": "2019-01-01 00:00:00"
+ },
+ "to": [
+ {
+ "email": "test+to0@example.com",
+ "name": "Example Name 0"
+ }
+ ]
+ }
+ ],
+ "subject": "Hi -name-"
+ }''')
+ )
+
+ def test_single_email_with_all_three_email_contents_to_single_recipient(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent, AmpHtmlContent)
+ self.maxDiff = None
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=To('test+to@example.com', 'Example To Name'),
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ amp_html_content=AmpHtmlContent(amp_html_content),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>')
+ )
+
+ self.assertEqual(
+ message.get(),
+ json.loads(response_content_with_all_three_mime_contents)
+ )
+
+ def test_single_email_with_amp_and_html_contents_to_single_recipient(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent, AmpHtmlContent)
+ self.maxDiff = None
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=To('test+to@example.com', 'Example To Name'),
+ subject=Subject('Sending with SendGrid is Fun'),
+ amp_html_content=AmpHtmlContent(amp_html_content),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>')
+ )
+
+ response_content = json.dumps({
+ "content": [
+ {
+ "type": "text/x-amp-html",
+ "value": amp_html_content
+ },
+ {
+ "type": "text/html",
+ "value": "<strong>and easy to do anywhere, even with Python</strong>"
+ }
+ ],
+ "from": {
+ "email": "test+from@example.com",
+ "name": "Example From Name"
+ },
+ "personalizations": [
+ {
+ "to": [
+ {
+ "email": "test+to@example.com",
+ "name": "Example To Name"
+ }
+ ]
+ }
+ ],
+ "subject": "Sending with SendGrid is Fun"
+ })
+ self.assertEqual(
+ message.get(),
+ json.loads(response_content)
+ )
+
+ def test_single_email_with_amp_and_plain_contents_to_single_recipient(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent, AmpHtmlContent)
+ self.maxDiff = None
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=To('test+to@example.com', 'Example To Name'),
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ amp_html_content=AmpHtmlContent(amp_html_content)
+ )
+
+ response_content = json.dumps({
+ "content": [
+ {
+ "type": "text/plain",
+ "value": "and easy to do anywhere, even with Python"
+ },
+ {
+ "type": "text/x-amp-html",
+ "value": amp_html_content
+ }
+ ],
+ "from": {
+ "email": "test+from@example.com",
+ "name": "Example From Name"
+ },
+ "personalizations": [
+ {
+ "to": [
+ {
+ "email": "test+to@example.com",
+ "name": "Example To Name"
+ }
+ ]
+ }
+ ],
+ "subject": "Sending with SendGrid is Fun"
+ })
+ self.assertEqual(
+ message.get(),
+ json.loads(response_content)
+ )
+
+ ## Check ordering of MIME types in different variants - start
+ def test_single_email_with_all_three_contents_in_collapsed_order_of_plain_amp_html_content_single_recipient(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent, AmpHtmlContent)
+ self.maxDiff = None
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=To('test+to@example.com', 'Example To Name'),
+ subject=Subject('Sending with SendGrid is Fun')
+ )
+ message.content = PlainTextContent(
+ 'and easy to do anywhere, even with Python')
+ message.content = AmpHtmlContent(amp_html_content)
+ message.content = HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>')
+
+ self.assertEqual(
+ message.get(),
+ json.loads(response_content_with_all_three_mime_contents)
+ )
+
+ def test_single_email_with_all_three_contents_in_collapsed_order_of_plain_html_amp_content_single_recipient(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent, AmpHtmlContent)
+ self.maxDiff = None
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=To('test+to@example.com', 'Example To Name'),
+ subject=Subject('Sending with SendGrid is Fun')
+ )
+ message.content = PlainTextContent(
+ 'and easy to do anywhere, even with Python')
+ message.content = HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>')
+ message.content = AmpHtmlContent(amp_html_content)
+
+ self.assertEqual(
+ message.get(),
+ json.loads(response_content_with_all_three_mime_contents)
+ )
+
+ def test_single_email_with_all_three_contents_in_collapsed_order_of_html_plain_amp_content_single_recipient(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent, AmpHtmlContent)
+ self.maxDiff = None
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=To('test+to@example.com', 'Example To Name'),
+ subject=Subject('Sending with SendGrid is Fun')
+ )
+ message.content = HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>')
+ message.content = PlainTextContent(
+ 'and easy to do anywhere, even with Python')
+ message.content = AmpHtmlContent(amp_html_content)
+
+ self.assertEqual(
+ message.get(),
+ json.loads(response_content_with_all_three_mime_contents)
+ )
+
+ def test_single_email_with_all_three_contents_in_collapsed_order_of_html_amp_plain_content_single_recipient(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent, AmpHtmlContent)
+ self.maxDiff = None
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=To('test+to@example.com', 'Example To Name'),
+ subject=Subject('Sending with SendGrid is Fun')
+ )
+ message.content = HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>')
+ message.content = AmpHtmlContent(amp_html_content)
+ message.content = PlainTextContent(
+ 'and easy to do anywhere, even with Python')
+
+ self.assertEqual(
+ message.get(),
+ json.loads(response_content_with_all_three_mime_contents)
+ )
+
+ def test_single_email_with_all_three_contents_in_collapsed_order_of_amp_html_plain_content_single_recipient(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent, AmpHtmlContent)
+ self.maxDiff = None
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=To('test+to@example.com', 'Example To Name'),
+ subject=Subject('Sending with SendGrid is Fun')
+ )
+ message.content = AmpHtmlContent(amp_html_content)
+ message.content = HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>')
+ message.content = PlainTextContent(
+ 'and easy to do anywhere, even with Python')
+
+ self.assertEqual(
+ message.get(),
+ json.loads(response_content_with_all_three_mime_contents)
+ )
+
+ def test_single_email_with_all_three_contents_in_collapsed_order_of_amp_plain_html_content_single_recipient(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent, AmpHtmlContent)
+ self.maxDiff = None
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=To('test+to@example.com', 'Example To Name'),
+ subject=Subject('Sending with SendGrid is Fun')
+ )
+ message.content = AmpHtmlContent(amp_html_content)
+ message.content = PlainTextContent(
+ 'and easy to do anywhere, even with Python')
+ message.content = HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>')
+
+ self.assertEqual(
+ message.get(),
+ json.loads(response_content_with_all_three_mime_contents)
+ )
+
+ ## end
+
+ def test_value_error_is_raised_on_to_emails_set_to_list_of_lists(self):
+ from sendgrid.helpers.mail import (PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ to_emails = [
+ ['test+to0@example.com', 'Example To Name 0'],
+ ['test+to1@example.com', 'Example To Name 1']
+ ]
+
+ with self.assertRaises(ValueError):
+ Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=to_emails,
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>'))
+
+ def test_value_error_is_raised_on_to_emails_set_to_reply_to_list_of_strs(self):
+ from sendgrid.helpers.mail import (PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ to_emails = [
+ ('test+to0@example.com', 'Example To Name 0'),
+ ('test+to1@example.com', 'Example To Name 1')
+ ]
+
+ mail = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=to_emails,
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>'))
+ with self.assertRaises(ValueError):
+ mail.reply_to_list = ['test+reply_to0@example.com', 'test+reply_to1@example.com']
+
+ def test_value_error_is_raised_on_to_emails_set_to_reply_to_list_of_tuples(self):
+ from sendgrid.helpers.mail import (PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ to_emails = [
+ ('test+to0@example.com', 'Example To Name 0'),
+ ('test+to1@example.com', 'Example To Name 1')
+ ]
+
+ mail = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=to_emails,
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>'))
+ with self.assertRaises(ValueError):
+ mail.reply_to_list = [('test+reply_to@example.com', 'Test Name')]
+
+ def test_error_is_not_raised_on_to_emails_set_to_list_of_tuples(self):
+ from sendgrid.helpers.mail import (PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ to_emails = [
+ ('test+to0@example.com', 'Example To Name 0'),
+ ('test+to1@example.com', 'Example To Name 1')
+ ]
+
+ Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=to_emails,
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>'))
+
+ def test_error_is_not_raised_on_to_emails_set_to_list_of_strs(self):
+ from sendgrid.helpers.mail import (PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ to_emails = ['test+to0@example.com', 'test+to1@example.com']
+
+ Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=to_emails,
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>'))
+
+ def test_error_is_not_raised_on_to_emails_set_to_a_str(self):
+ from sendgrid.helpers.mail import (PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ to_emails = 'test+to0@example.com'
+
+ Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=to_emails,
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>'))
+
+ def test_error_is_not_raised_on_to_emails_set_to_a_tuple(self):
+ from sendgrid.helpers.mail import (PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ to_emails = ('test+to0@example.com', 'Example To Name 0')
+
+ Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=to_emails,
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>'))
+
+ def test_error_is_not_raised_on_to_emails_includes_bcc_cc(self):
+ from sendgrid.helpers.mail import (PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ to_emails = [
+ To('test+to0@example.com', 'Example To Name 0'),
+ Bcc('test+bcc@example.com', 'Example Bcc Name 1'),
+ Cc('test+cc@example.com', 'Example Cc Name 2')
+ ]
+
+ Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=to_emails,
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>'))
+
+ def test_personalization_add_email_filters_out_duplicate_to_emails(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ to_email = To('test+to0@example.com', 'Example To Name 0')
+ p.add_email(to_email)
+ p.add_email(to_email)
+
+ self.assertEqual([to_email.get()], p.tos)
+
+ def test_personalization_add_email_filters_out_duplicate_to_emails_ignoring_case(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ to_email = To('test+to0@example.com', 'Example To Name 0')
+ to_email_with_caps = To('test+TO0@example.com', 'Example To Name 0')
+ p.add_email(to_email)
+ p.add_email(to_email_with_caps)
+
+ self.assertEqual([to_email.get()], p.tos)
+
+ def test_personalization_set_from_email(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ from_email = From('test+from@example.com', 'Example From')
+ p.set_from(from_email)
+
+ self.assertEqual(from_email.get(), p.from_email)
+
+ def test_personalization_filters_out_duplicate_cc_emails(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ cc_email = Cc('test+cc0@example.com', 'Example Cc Name 0')
+ p.add_email(cc_email)
+ p.add_email(cc_email)
+
+ self.assertEqual([cc_email.get()], p.ccs)
+
+ def test_personalization_filters_out_duplicate_cc_emails_ignoring_case(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ cc_email = Cc('test+cc0@example.com', 'Example Cc Name 0')
+ cc_email_with_caps = Cc('test+CC0@example.com', 'Example Cc Name 0')
+ p.add_email(cc_email)
+ p.add_email(cc_email_with_caps)
+
+ self.assertEqual([cc_email.get()], p.ccs)
+
+ def test_personalization_filters_out_duplicate_bcc_emails(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ bcc_email = Bcc('test+bcc0@example.com', 'Example Bcc Name 0')
+ p.add_email(bcc_email)
+ p.add_email(bcc_email)
+
+ self.assertEqual([bcc_email.get()], p.bccs)
+
+ def test_personalization_filters_out_duplicate_bcc_emails_ignoring_case(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ bcc_email = Bcc('test+bcc0@example.com', 'Example Bcc Name 0')
+ bcc_email_with_caps = Bcc('test+BCC0@example.com', 'Example Bcc Name 0')
+ p.add_email(bcc_email)
+ p.add_email(bcc_email_with_caps)
+
+ self.assertEqual([bcc_email.get()], p.bccs)
+
+ def test_personalization_tos_setter_filters_out_duplicate_dict_emails(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ to_emails = [{ 'email': 'test+to0@example.com', 'name': 'Example To Name 0' }] * 2
+ p.tos = to_emails
+
+ self.assertEqual([to_emails[0]], p.tos)
+
+ def test_personalization_tos_setter_filters_out_duplicate_dict_emails_ignoring_case(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ to_email = { 'email': 'test+to0@example.com', 'name': 'Example To Name 0' }
+ to_email_with_caps = { 'email': 'test+TO0@example.com', 'name': 'Example To Name 0' }
+ to_emails = [to_email, to_email_with_caps]
+ p.tos = to_emails
+
+ self.assertEqual([to_email], p.tos)
+
+ def test_personalization_tos_setter_filters_out_duplicate_to_emails(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ to_emails = [To('test+to0@example.com', 'Example To Name 0')] * 2
+ p.tos = to_emails
+
+ self.assertEqual([to_emails[0].get()], p.tos)
+
+
+ def test_personalization_tos_setter_filters_out_duplicate_to_emails_ignoring_case(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ to_email = To('test+to0@example.com', 'Example To Name 0')
+ to_email_with_caps = To('test+TO0@example.com', 'Example To Name 0')
+ to_emails = [to_email, to_email_with_caps]
+ p.tos = to_emails
+
+ self.assertEqual([to_email.get()], p.tos)
+
+ def test_personalization_ccs_setter_filters_out_duplicate_dict_emails(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ cc_emails = [{ 'email': 'test+cc0@example.com', 'name': 'Example Cc Name 0' }] * 2
+ p.ccs = cc_emails
+
+ self.assertEqual([cc_emails[0]], p.ccs)
+
+ def test_personalization_ccs_setter_filters_out_duplicate_dict_emails_ignoring_case(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ cc_email = { 'email': 'test+cc0@example.com', 'name': 'Example Cc Name 0' }
+ cc_email_with_caps = { 'email': 'test+CC0@example.com', 'name': 'Example Cc Name 0' }
+ cc_emails = [cc_email, cc_email_with_caps]
+ p.ccs = cc_emails
+
+ self.assertEqual([cc_email], p.ccs)
+
+ def test_personalization_ccs_setter_filters_out_duplicate_cc_emails(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ cc_emails = [Cc('test+cc0@example.com', 'Example Cc Name 0')] * 2
+ p.ccs = cc_emails
+
+ self.assertEqual([cc_emails[0].get()], p.ccs)
+
+ def test_personalization_ccs_setter_filters_out_duplicate_cc_emails_ignoring_case(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ cc_email = Cc('test+cc0@example.com', 'Example Cc Name 0')
+ cc_email_with_caps = Cc('test+CC0@example.com', 'Example Cc Name 0')
+ p.ccs = [cc_email, cc_email_with_caps]
+
+ self.assertEqual([cc_email.get()], p.ccs)
+
+ def test_personalization_bccs_setter_filters_out_duplicate_dict_emails(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ bcc_emails = [{ 'email': 'test+bcc0@example.com', 'name': 'Example Bcc Name 0' }] * 2
+ p.bccs = bcc_emails
+
+ self.assertEqual([bcc_emails[0]], p.bccs)
+
+ def test_personalization_bccs_setter_filters_out_duplicate_dict_emails_ignoring_case(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ bcc_email = { 'email': 'test+bcc0@example.com', 'name': 'Example Bcc Name 0' }
+ bcc_email_with_caps = { 'email': 'test+BCC0@example.com', 'name': 'Example Bcc Name 0' }
+ bcc_emails = [bcc_email, bcc_email_with_caps]
+ p.bccs = bcc_emails
+
+ self.assertEqual([bcc_email], p.bccs)
+
+ def test_personalization_bccs_setter_filters_out_duplicate_bcc_emails(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ bcc_emails = [Bcc('test+bcc0@example.com', 'Example Bcc Name 0')] * 2
+ p.bccs = bcc_emails
+
+ self.assertEqual([bcc_emails[0].get()], p.bccs)
+
+ def test_personalization_bccs_setter_filters_out_duplicate_bcc_emails_ignoring_case(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ bcc_email = Bcc('test+bcc0@example.com', 'Example Bcc Name 0')
+ bcc_email_with_caps = Bcc('test+BCC0@example.com', 'Example Bcc Name 0')
+ p.bccs = [bcc_email, bcc_email_with_caps]
+
+ self.assertEqual([bcc_email.get()], p.bccs)
+
+ def test_personalization_add_to_filters_out_duplicate_to_emails(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ to_email = To('test+to0@example.com', 'Example To Name 0')
+ p.add_to(to_email)
+ p.add_to(to_email)
+
+ expected = [to_email.get()]
+
+ self.assertEqual(expected, p.tos)
+
+ def test_personalization_add_bcc_filters_out_duplicate_bcc_emails(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ bcc_email = Bcc('test+to0@example.com', 'Example To Name 0')
+ p.add_bcc(bcc_email)
+ p.add_bcc(bcc_email)
+
+ expected = [bcc_email.get()]
+
+ self.assertEqual(expected, p.bccs)
+
+ def test_personalization_add_cc_filters_out_duplicate_cc_emails(self):
+ self.maxDiff = None
+
+ p = Personalization()
+ cc_email = Cc('test+to0@example.com', 'Example To Name 0')
+ p.add_cc(cc_email)
+ p.add_cc(cc_email)
+
+ expected = [cc_email.get()]
+
+ self.assertEqual(expected, p.ccs)
+
+ def test_dynamic_template_data(self):
+ self.maxDiff = None
+
+ to_emails = [
+ To(email='test+to+0@example.com',
+ name='Example To 0 Name',
+ dynamic_template_data=DynamicTemplateData({'name': 'Example 0 Name'})),
+ To(email='test+to+1@example.com',
+ name='Example To 1 Name',
+ dynamic_template_data={'name': 'Example 1 Name'})
+ ]
+ message = Mail(
+ from_email=From('test@example.com', 'Example From Name'),
+ to_emails=to_emails,
+ subject=Subject('Hi!'),
+ plain_text_content='Hello!',
+ html_content='<strong>Hello!</strong>',
+ is_multiple=True)
+
+ self.assertEqual(
+ message.get(),
+ json.loads(r'''{
+ "content": [
+ {
+ "type": "text/plain",
+ "value": "Hello!"
+ },
+ {
+ "type": "text/html",
+ "value": "<strong>Hello!</strong>"
+ }
+ ],
+ "from": {
+ "email": "test@example.com",
+ "name": "Example From Name"
+ },
+ "personalizations": [
+ {
+ "dynamic_template_data": {
+ "name": "Example 1 Name"
+ },
+ "to": [
+ {
+ "email": "test+to+1@example.com",
+ "name": "Example To 1 Name"
+ }
+ ]
+ },
+ {
+ "dynamic_template_data": {
+ "name": "Example 0 Name"
+ },
+ "to": [
+ {
+ "email": "test+to+0@example.com",
+ "name": "Example To 0 Name"
+ }
+ ]
+ }
+ ],
+ "subject": "Hi!"
+ }''')
+ )
+
+ def test_kitchen_sink(self):
+ from sendgrid.helpers.mail import (
+ Mail, From, To, Cc, Bcc, Subject, Substitution, Header,
+ CustomArg, SendAt, Content, MimeType, Attachment, FileName,
+ FileContent, FileType, Disposition, ContentId, TemplateId,
+ Section, ReplyTo, Category, BatchId, Asm, GroupId, GroupsToDisplay,
+ IpPoolName, MailSettings, BccSettings, BccSettingsEmail,
+ BypassBounceManagement, BypassListManagement, BypassSpamManagement,
+ BypassUnsubscribeManagement, FooterSettings, FooterText,
+ FooterHtml, SandBoxMode, SpamCheck, SpamThreshold, SpamUrl,
+ TrackingSettings, ClickTracking, SubscriptionTracking,
+ SubscriptionText, SubscriptionHtml, SubscriptionSubstitutionTag,
+ OpenTracking, OpenTrackingSubstitutionTag, Ganalytics,
+ UtmSource, UtmMedium, UtmTerm, UtmContent, UtmCampaign)
+
+ self.maxDiff = None
+
+ message = Mail()
+
+ # Define Personalizations
+
+ message.to = To('test1@example.com', 'Example User1', p=0)
+ message.to = [
+ To('test2@example.com', 'Example User2', p=0),
+ To('test3@example.com', 'Example User3', p=0)
+ ]
+
+ message.cc = Cc('test4@example.com', 'Example User4', p=0)
+ message.cc = [
+ Cc('test5@example.com', 'Example User5', p=0),
+ Cc('test6@example.com', 'Example User6', p=0)
+ ]
+
+ message.bcc = Bcc('test7@example.com', 'Example User7', p=0)
+ message.bcc = [
+ Bcc('test8@example.com', 'Example User8', p=0),
+ Bcc('test9@example.com', 'Example User9', p=0)
+ ]
+
+ message.subject = Subject('Sending with SendGrid is Fun 0', p=0)
+
+ message.header = Header('X-Test1', 'Test1', p=0)
+ message.header = Header('X-Test2', 'Test2', p=0)
+ message.header = [
+ Header('X-Test3', 'Test3', p=0),
+ Header('X-Test4', 'Test4', p=0)
+ ]
+
+ message.substitution = Substitution('%name1%', 'Example Name 1', p=0)
+ message.substitution = Substitution('%city1%', 'Example City 1', p=0)
+ message.substitution = [
+ Substitution('%name2%', 'Example Name 2', p=0),
+ Substitution('%city2%', 'Example City 2', p=0)
+ ]
+
+ message.custom_arg = CustomArg('marketing1', 'true', p=0)
+ message.custom_arg = CustomArg('transactional1', 'false', p=0)
+ message.custom_arg = [
+ CustomArg('marketing2', 'false', p=0),
+ CustomArg('transactional2', 'true', p=0)
+ ]
+
+ message.send_at = SendAt(1461775051, p=0)
+
+ message.to = To('test10@example.com', 'Example User10', p=1)
+ message.to = [
+ To('test11@example.com', 'Example User11', p=1),
+ To('test12@example.com', 'Example User12', p=1)
+ ]
+
+ message.cc = Cc('test13@example.com', 'Example User13', p=1)
+ message.cc = [
+ Cc('test14@example.com', 'Example User14', p=1),
+ Cc('test15@example.com', 'Example User15', p=1)
+ ]
+
+ message.bcc = Bcc('test16@example.com', 'Example User16', p=1)
+ message.bcc = [
+ Bcc('test17@example.com', 'Example User17', p=1),
+ Bcc('test18@example.com', 'Example User18', p=1)
+ ]
+
+ message.header = Header('X-Test5', 'Test5', p=1)
+ message.header = Header('X-Test6', 'Test6', p=1)
+ message.header = [
+ Header('X-Test7', 'Test7', p=1),
+ Header('X-Test8', 'Test8', p=1)
+ ]
+
+ message.substitution = Substitution('%name3%', 'Example Name 3', p=1)
+ message.substitution = Substitution('%city3%', 'Example City 3', p=1)
+ message.substitution = [
+ Substitution('%name4%', 'Example Name 4', p=1),
+ Substitution('%city4%', 'Example City 4', p=1)
+ ]
+
+ message.custom_arg = CustomArg('marketing3', 'true', p=1)
+ message.custom_arg = CustomArg('transactional3', 'false', p=1)
+ message.custom_arg = [
+ CustomArg('marketing4', 'false', p=1),
+ CustomArg('transactional4', 'true', p=1)
+ ]
+
+ message.send_at = SendAt(1461775052, p=1)
+
+ message.subject = Subject('Sending with SendGrid is Fun 1', p=1)
+
+ # The values below this comment are global to entire message
+
+ message.from_email = From('help@twilio.com', 'Twilio SendGrid')
+
+ message.reply_to = ReplyTo('help_reply@twilio.com', 'Twilio SendGrid Reply')
+
+ message.subject = Subject('Sending with SendGrid is Fun 2')
+
+ message.content = Content(
+ MimeType.text,
+ 'and easy to do anywhere, even with Python')
+ message.content = Content(
+ MimeType.html,
+ '<strong>and easy to do anywhere, even with Python</strong>')
+ message.content = [
+ Content('text/calendar', 'Party Time!!'),
+ Content('text/custom', 'Party Time 2!!')
+ ]
+
+ message.attachment = Attachment(
+ FileContent('base64 encoded content 1'),
+ FileName('balance_001.pdf'),
+ FileType('application/pdf'),
+ Disposition('attachment'),
+ ContentId('Content ID 1'))
+ message.attachment = [
+ Attachment(
+ FileContent('base64 encoded content 2'),
+ FileName('banner.png'),
+ FileType('image/png'),
+ Disposition('inline'),
+ ContentId('Content ID 2')),
+ Attachment(
+ FileContent('base64 encoded content 3'),
+ FileName('banner2.png'),
+ FileType('image/png'),
+ Disposition('inline'),
+ ContentId('Content ID 3'))
+ ]
+
+ message.template_id = TemplateId(
+ '13b8f94f-bcae-4ec6-b752-70d6cb59f932')
+
+ message.section = Section(
+ '%section1%', 'Substitution for Section 1 Tag')
+ message.section = [
+ Section('%section2%', 'Substitution for Section 2 Tag'),
+ Section('%section3%', 'Substitution for Section 3 Tag')
+ ]
+
+ message.header = Header('X-Test9', 'Test9')
+ message.header = Header('X-Test10', 'Test10')
+ message.header = [
+ Header('X-Test11', 'Test11'),
+ Header('X-Test12', 'Test12')
+ ]
+
+ message.category = Category('Category 1')
+ message.category = Category('Category 2')
+ message.category = [
+ Category('Category 1'),
+ Category('Category 2')
+ ]
+
+ message.custom_arg = CustomArg('marketing5', 'false')
+ message.custom_arg = CustomArg('transactional5', 'true')
+ message.custom_arg = [
+ CustomArg('marketing6', 'true'),
+ CustomArg('transactional6', 'false')
+ ]
+
+ message.send_at = SendAt(1461775053)
+
+ message.batch_id = BatchId("HkJ5yLYULb7Rj8GKSx7u025ouWVlMgAi")
+
+ message.asm = Asm(GroupId(1), GroupsToDisplay([1, 2, 3, 4]))
+
+ message.ip_pool_name = IpPoolName("IP Pool Name")
+
+ mail_settings = MailSettings()
+ mail_settings.bcc_settings = BccSettings(
+ False, BccSettingsEmail("bcc@twilio.com"))
+ mail_settings.bypass_bounce_management = BypassBounceManagement(False)
+ mail_settings.bypass_list_management = BypassListManagement(False)
+ mail_settings.bypass_spam_management = BypassSpamManagement(False)
+ mail_settings.bypass_unsubscribe_management = BypassUnsubscribeManagement(False)
+ mail_settings.footer_settings = FooterSettings(
+ True, FooterText("w00t"), FooterHtml("<string>w00t!<strong>"))
+ mail_settings.sandbox_mode = SandBoxMode(True)
+ mail_settings.spam_check = SpamCheck(
+ True, SpamThreshold(5), SpamUrl("https://example.com"))
+ message.mail_settings = mail_settings
+
+ tracking_settings = TrackingSettings()
+ tracking_settings.click_tracking = ClickTracking(True, False)
+ tracking_settings.open_tracking = OpenTracking(
+ True, OpenTrackingSubstitutionTag("open_tracking"))
+ tracking_settings.subscription_tracking = SubscriptionTracking(
+ True,
+ SubscriptionText("Goodbye"),
+ SubscriptionHtml("<strong>Goodbye!</strong>"),
+ SubscriptionSubstitutionTag("unsubscribe"))
+ tracking_settings.ganalytics = Ganalytics(
+ True,
+ UtmSource("utm_source"),
+ UtmMedium("utm_medium"),
+ UtmTerm("utm_term"),
+ UtmContent("utm_content"),
+ UtmCampaign("utm_campaign"))
+ message.tracking_settings = tracking_settings
+ self.assertEqual(
+ message.get(),
+ json.loads(r'''{
+ "asm": {
+ "group_id": 1,
+ "groups_to_display": [
+ 1,
+ 2,
+ 3,
+ 4
+ ]
+ },
+ "attachments": [
+ {
+ "content": "base64 encoded content 3",
+ "content_id": "Content ID 3",
+ "disposition": "inline",
+ "filename": "banner2.png",
+ "type": "image/png"
+ },
+ {
+ "content": "base64 encoded content 2",
+ "content_id": "Content ID 2",
+ "disposition": "inline",
+ "filename": "banner.png",
+ "type": "image/png"
+ },
+ {
+ "content": "base64 encoded content 1",
+ "content_id": "Content ID 1",
+ "disposition": "attachment",
+ "filename": "balance_001.pdf",
+ "type": "application/pdf"
+ }
+ ],
+ "batch_id": "HkJ5yLYULb7Rj8GKSx7u025ouWVlMgAi",
+ "categories": [
+ "Category 2",
+ "Category 1",
+ "Category 2",
+ "Category 1"
+ ],
+ "content": [
+ {
+ "type": "text/plain",
+ "value": "and easy to do anywhere, even with Python"
+ },
+ {
+ "type": "text/html",
+ "value": "<strong>and easy to do anywhere, even with Python</strong>"
+ },
+ {
+ "type": "text/calendar",
+ "value": "Party Time!!"
+ },
+ {
+ "type": "text/custom",
+ "value": "Party Time 2!!"
+ }
+ ],
+ "custom_args": {
+ "marketing5": "false",
+ "marketing6": "true",
+ "transactional5": "true",
+ "transactional6": "false"
+ },
+ "from": {
+ "email": "help@twilio.com",
+ "name": "Twilio SendGrid"
+ },
+ "headers": {
+ "X-Test10": "Test10",
+ "X-Test11": "Test11",
+ "X-Test12": "Test12",
+ "X-Test9": "Test9"
+ },
+ "ip_pool_name": "IP Pool Name",
+ "mail_settings": {
+ "bcc": {
+ "email": "bcc@twilio.com",
+ "enable": false
+ },
+ "bypass_bounce_management": {
+ "enable": false
+ },
+ "bypass_list_management": {
+ "enable": false
+ },
+ "bypass_spam_management": {
+ "enable": false
+ },
+ "bypass_unsubscribe_management": {
+ "enable": false
+ },
+ "footer": {
+ "enable": true,
+ "html": "<string>w00t!<strong>",
+ "text": "w00t"
+ },
+ "sandbox_mode": {
+ "enable": true
+ },
+ "spam_check": {
+ "enable": true,
+ "post_to_url": "https://example.com",
+ "threshold": 5
+ }
+ },
+ "personalizations": [
+ {
+ "bcc": [
+ {
+ "email": "test7@example.com",
+ "name": "Example User7"
+ },
+ {
+ "email": "test8@example.com",
+ "name": "Example User8"
+ },
+ {
+ "email": "test9@example.com",
+ "name": "Example User9"
+ }
+ ],
+ "cc": [
+ {
+ "email": "test4@example.com",
+ "name": "Example User4"
+ },
+ {
+ "email": "test5@example.com",
+ "name": "Example User5"
+ },
+ {
+ "email": "test6@example.com",
+ "name": "Example User6"
+ }
+ ],
+ "custom_args": {
+ "marketing1": "true",
+ "marketing2": "false",
+ "transactional1": "false",
+ "transactional2": "true"
+ },
+ "headers": {
+ "X-Test1": "Test1",
+ "X-Test2": "Test2",
+ "X-Test3": "Test3",
+ "X-Test4": "Test4"
+ },
+ "send_at": 1461775051,
+ "subject": "Sending with SendGrid is Fun 0",
+ "substitutions": {
+ "%city1%": "Example City 1",
+ "%city2%": "Example City 2",
+ "%name1%": "Example Name 1",
+ "%name2%": "Example Name 2"
+ },
+ "to": [
+ {
+ "email": "test1@example.com",
+ "name": "Example User1"
+ },
+ {
+ "email": "test2@example.com",
+ "name": "Example User2"
+ },
+ {
+ "email": "test3@example.com",
+ "name": "Example User3"
+ }
+ ]
+ },
+ {
+ "bcc": [
+ {
+ "email": "test16@example.com",
+ "name": "Example User16"
+ },
+ {
+ "email": "test17@example.com",
+ "name": "Example User17"
+ },
+ {
+ "email": "test18@example.com",
+ "name": "Example User18"
+ }
+ ],
+ "cc": [
+ {
+ "email": "test13@example.com",
+ "name": "Example User13"
+ },
+ {
+ "email": "test14@example.com",
+ "name": "Example User14"
+ },
+ {
+ "email": "test15@example.com",
+ "name": "Example User15"
+ }
+ ],
+ "custom_args": {
+ "marketing3": "true",
+ "marketing4": "false",
+ "transactional3": "false",
+ "transactional4": "true"
+ },
+ "headers": {
+ "X-Test5": "Test5",
+ "X-Test6": "Test6",
+ "X-Test7": "Test7",
+ "X-Test8": "Test8"
+ },
+ "send_at": 1461775052,
+ "subject": "Sending with SendGrid is Fun 1",
+ "substitutions": {
+ "%city3%": "Example City 3",
+ "%city4%": "Example City 4",
+ "%name3%": "Example Name 3",
+ "%name4%": "Example Name 4"
+ },
+ "to": [
+ {
+ "email": "test10@example.com",
+ "name": "Example User10"
+ },
+ {
+ "email": "test11@example.com",
+ "name": "Example User11"
+ },
+ {
+ "email": "test12@example.com",
+ "name": "Example User12"
+ }
+ ]
+ }
+ ],
+ "reply_to": {
+ "email": "help_reply@twilio.com",
+ "name": "Twilio SendGrid Reply"
+ },
+ "sections": {
+ "%section1%": "Substitution for Section 1 Tag",
+ "%section2%": "Substitution for Section 2 Tag",
+ "%section3%": "Substitution for Section 3 Tag"
+ },
+ "send_at": 1461775053,
+ "subject": "Sending with SendGrid is Fun 2",
+ "template_id": "13b8f94f-bcae-4ec6-b752-70d6cb59f932",
+ "tracking_settings": {
+ "click_tracking": {
+ "enable": true,
+ "enable_text": false
+ },
+ "ganalytics": {
+ "enable": true,
+ "utm_campaign": "utm_campaign",
+ "utm_content": "utm_content",
+ "utm_medium": "utm_medium",
+ "utm_source": "utm_source",
+ "utm_term": "utm_term"
+ },
+ "open_tracking": {
+ "enable": true,
+ "substitution_tag": "open_tracking"
+ },
+ "subscription_tracking": {
+ "enable": true,
+ "html": "<strong>Goodbye!</strong>",
+ "substitution_tag": "unsubscribe",
+ "text": "Goodbye"
+ }
+ }
+ }''')
+ )
+
+ # Send a Single Email to a Single Recipient with a Dynamic Template
+ def test_single_email_to_a_single_recipient_with_dynamic_templates(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=To('test+to@example.com', 'Example To Name'),
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>'))
+ message.dynamic_template_data = DynamicTemplateData({
+ "total": "$ 239.85",
+ "items": [
+ {
+ "text": "New Line Sneakers",
+ "image": "https://marketing-image-production.s3.amazonaws.com/uploads/8dda1131320a6d978b515cc04ed479df259a458d5d45d58b6b381cae0bf9588113e80ef912f69e8c4cc1ef1a0297e8eefdb7b270064cc046b79a44e21b811802.png",
+ "price": "$ 79.95"
+ },
+ {
+ "text": "Old Line Sneakers",
+ "image": "https://marketing-image-production.s3.amazonaws.com/uploads/3629f54390ead663d4eb7c53702e492de63299d7c5f7239efdc693b09b9b28c82c924225dcd8dcb65732d5ca7b7b753c5f17e056405bbd4596e4e63a96ae5018.png",
+ "price": "$ 79.95"
+ },
+ {
+ "text": "Blue Line Sneakers",
+ "image": "https://marketing-image-production.s3.amazonaws.com/uploads/00731ed18eff0ad5da890d876c456c3124a4e44cb48196533e9b95fb2b959b7194c2dc7637b788341d1ff4f88d1dc88e23f7e3704726d313c57f350911dd2bd0.png",
+ "price": "$ 79.95"
+ }
+ ],
+ "receipt": True,
+ "name": "Sample Name",
+ "address01": "1234 Fake St.",
+ "address02": "Apt. 123",
+ "city": "Place",
+ "state": "CO",
+ "zip": "80202"
+ })
+ self.assertEqual(
+ message.get(),
+ json.loads(r'''{
+ "content": [
+ {
+ "type": "text/plain",
+ "value": "and easy to do anywhere, even with Python"
+ },
+ {
+ "type": "text/html",
+ "value": "<strong>and easy to do anywhere, even with Python</strong>"
+ }
+ ],
+ "from": {
+ "email": "test+from@example.com",
+ "name": "Example From Name"
+ },
+ "personalizations": [
+ {
+ "dynamic_template_data": {
+ "address01": "1234 Fake St.",
+ "address02": "Apt. 123",
+ "city": "Place",
+ "items": [
+ {
+ "image": "https://marketing-image-production.s3.amazonaws.com/uploads/8dda1131320a6d978b515cc04ed479df259a458d5d45d58b6b381cae0bf9588113e80ef912f69e8c4cc1ef1a0297e8eefdb7b270064cc046b79a44e21b811802.png",
+ "price": "$ 79.95",
+ "text": "New Line Sneakers"
+ },
+ {
+ "image": "https://marketing-image-production.s3.amazonaws.com/uploads/3629f54390ead663d4eb7c53702e492de63299d7c5f7239efdc693b09b9b28c82c924225dcd8dcb65732d5ca7b7b753c5f17e056405bbd4596e4e63a96ae5018.png",
+ "price": "$ 79.95",
+ "text": "Old Line Sneakers"
+ },
+ {
+ "image": "https://marketing-image-production.s3.amazonaws.com/uploads/00731ed18eff0ad5da890d876c456c3124a4e44cb48196533e9b95fb2b959b7194c2dc7637b788341d1ff4f88d1dc88e23f7e3704726d313c57f350911dd2bd0.png",
+ "price": "$ 79.95",
+ "text": "Blue Line Sneakers"
+ }
+ ],
+ "name": "Sample Name",
+ "receipt": true,
+ "state": "CO",
+ "total": "$ 239.85",
+ "zip": "80202"
+ },
+ "to": [
+ {
+ "email": "test+to@example.com",
+ "name": "Example To Name"
+ }
+ ]
+ }
+ ],
+ "subject": "Sending with SendGrid is Fun"
+ }''')
+ )
+
+ def test_sendgrid_api_key(self):
+ """Tests if including SendGrid API will throw an Exception"""
+
+ # Minimum required to send an email
+ self.max_diff = None
+ mail = Mail()
+
+ mail.from_email = Email("test@example.com")
+
+ mail.subject = "Hello World from the SendGrid Python Library"
+
+ personalization = Personalization()
+ personalization.add_to(Email("test@example.com"))
+ mail.add_personalization(personalization)
+
+ # Try to include SendGrid API key
+ try:
+ mail.add_content(
+ Content(
+ "text/plain",
+ "some SG.2123b1B.1212lBaC here"))
+ mail.add_content(
+ Content(
+ "text/html",
+ "<html><body>some SG.Ba2BlJSDba.232Ln2 here</body></html>"))
+
+ self.assertEqual(
+ json.dumps(
+ mail.get(),
+ sort_keys=True),
+ '{"content": [{"type": "text/plain", "value": "some text here"}, '
+ '{"type": "text/html", '
+ '"value": "<html><body>some text here</body></html>"}], '
+ '"from": {"email": "test@example.com"}, "personalizations": '
+ '[{"to": [{"email": "test@example.com"}]}], '
+ '"subject": "Hello World from the SendGrid Python Library"}'
+ )
+
+ # Exception should be thrown
+ except Exception:
+ pass
+
+ # Exception not thrown
+ else:
+ self.fail("Should have failed as SendGrid API key included")
+
+ def test_unicode_values_in_substitutions_helper(self):
+ from sendgrid.helpers.mail import (Mail, From, To, Subject,
+ PlainTextContent, HtmlContent)
+ self.maxDiff = None
+ message = Mail(
+ from_email=From('test+from@example.com', 'Example From Name'),
+ to_emails=To('test+to@example.com', 'Example To Name'),
+ subject=Subject('Sending with SendGrid is Fun'),
+ plain_text_content=PlainTextContent(
+ 'and easy to do anywhere, even with Python'),
+ html_content=HtmlContent(
+ '<strong>and easy to do anywhere, even with Python</strong>'))
+ message.substitution = Substitution('%city%', u'Αθήνα', p=1)
+ self.assertEqual(
+ message.get(),
+ json.loads(r'''{
+ "content": [
+ {
+ "type": "text/plain",
+ "value": "and easy to do anywhere, even with Python"
+ },
+ {
+ "type": "text/html",
+ "value": "<strong>and easy to do anywhere, even with Python</strong>"
+ }
+ ],
+ "from": {
+ "email": "test+from@example.com",
+ "name": "Example From Name"
+ },
+ "personalizations": [
+ {
+ "to": [
+ {
+ "email": "test+to@example.com",
+ "name": "Example To Name"
+ }
+ ]
+ },
+ {
+ "substitutions": {
+ "%city%": "Αθήνα"
+ }
+ }
+ ],
+ "subject": "Sending with SendGrid is Fun"
+ }''')
+ )
+
+ def test_asm_display_group_limit(self):
+ self.assertRaises(ValueError, Asm, 1, list(range(26)))
+
+ def test_disable_tracking(self):
+ tracking_settings = TrackingSettings()
+ tracking_settings.click_tracking = ClickTracking(False, False)
+
+ self.assertEqual(
+ tracking_settings.get(),
+ {'click_tracking': {'enable': False, 'enable_text': False}}
+ )
+
+ def test_bypass_list_management(self):
+ from sendgrid.helpers.mail import (MailSettings, BypassListManagement)
+ mail_settings = MailSettings()
+ mail_settings.bypass_list_management = BypassListManagement(True)
+
+ self.assertEqual(
+ mail_settings.get(),
+ {
+ "bypass_list_management": {
+ "enable": True
+ },
+ },
+ )
+
+ def test_v3_bypass_filters(self):
+ from sendgrid.helpers.mail import (
+ MailSettings, BypassBounceManagement,
+ BypassSpamManagement, BypassUnsubscribeManagement
+ )
+ mail_settings = MailSettings()
+ mail_settings.bypass_bounce_management = BypassBounceManagement(True)
+ mail_settings.bypass_spam_management = BypassSpamManagement(True)
+ mail_settings.bypass_unsubscribe_management = BypassUnsubscribeManagement(True)
+
+ self.assertEqual(
+ mail_settings.get(),
+ {
+ "bypass_bounce_management": {
+ "enable": True
+ },
+ "bypass_spam_management": {
+ "enable": True
+ },
+ "bypass_unsubscribe_management": {
+ "enable": True
+ },
+ },
+ )