# -*- 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
},
},
)
