def test_send_a_single_email_to_multiple_recipients(self):
from sowemail.helpers.mail import (Mail, From, To, Subject,
PlainTextContent, HtmlContent)
self.maxDiff = None
to_emails = [
To('*****@*****.**', 'Example To Name 0'),
To('*****@*****.**', 'Example To Name 1')
]
message = Mail(
from_email=From('*****@*****.**', 'Example From Name'),
to_emails=to_emails,
subject=Subject('Hello from SoWeMail'),
plain_text_content=PlainTextContent(
'Simple email sending example using python\'s sowerest library'
),
html_content=HtmlContent(
'<strong>Simple email sending example using python\'s sowerest library</strong>'
))
self.assertEqual(
message.get(),
json.loads(r'''{
"content": [
{
"type": "text/plain",
"value": "Simple email sending example using python's sowerest library"
},
{
"type": "text/html",
"value": "<strong>Simple email sending example using python's sowerest library</strong>"
}
],
"from": {
"email": "*****@*****.**",
"name": "Example From Name"
},
"personalizations": [
{
"to": [
{
"email": "*****@*****.**",
"name": "Example To Name 0"
},
{
"email": "*****@*****.**",
"name": "Example To Name 1"
}
]
}
],
"subject": "Hello from SoWeMail"
}'''))
def test_unicode_values_in_substitutions_helper(self):
from sowemail.helpers.mail import (Mail, From, To, Subject,
PlainTextContent, HtmlContent)
self.maxDiff = None
message = Mail(
from_email=From('*****@*****.**', 'Example From Name'),
to_emails=To('*****@*****.**', 'Example To Name'),
subject=Subject('Hello from SoWeMail'),
plain_text_content=PlainTextContent(
'Simple email sending example using python\'s sowerest library'
),
html_content=HtmlContent(
'<strong>Simple email sending example using python\'s sowerest library</strong>'
))
message.substitution = Substitution('%city%', u'Αθήνα', p=1)
self.assertEqual(
message.get(),
json.loads(r'''{
"content": [
{
"type": "text/plain",
"value": "Simple email sending example using python's sowerest library"
},
{
"type": "text/html",
"value": "<strong>Simple email sending example using python's sowerest library</strong>"
}
],
"from": {
"email": "*****@*****.**",
"name": "Example From Name"
},
"personalizations": [
{
"to": [
{
"email": "*****@*****.**",
"name": "Example To Name"
}
]
},
{
"substitutions": {
"%city%": "Αθήνα"
}
}
],
"subject": "Hello from SoWeMail"
}'''))
def test_single_email_to_a_single_recipient_content_reversed(self):
"""Tests bug found in Issue-451 with Content ordering causing a crash
"""
from sowemail.helpers.mail import (Mail, From, To, Subject,
PlainTextContent, HtmlContent)
self.maxDiff = None
message = Mail()
message.from_email = From('*****@*****.**', 'Example From Name')
message.to = To('*****@*****.**', 'Example To Name')
message.subject = Subject('Hello from SoWeMail')
message.content = HtmlContent(
'<strong>Simple email sending example using python\'s sowerest library</strong>'
)
message.content = PlainTextContent(
'Simple email sending example using python\'s sowerest library')
self.assertEqual(
message.get(),
json.loads(r'''{
"content": [
{
"type": "text/plain",
"value": "Simple email sending example using python's sowerest library"
},
{
"type": "text/html",
"value": "<strong>Simple email sending example using python's sowerest library</strong>"
}
],
"from": {
"email": "*****@*****.**",
"name": "Example From Name"
},
"personalizations": [
{
"to": [
{
"email": "*****@*****.**",
"name": "Example To Name"
}
]
}
],
"subject": "Hello from SoWeMail"
}'''))
def test_sowemail_api_key(self):
"""Tests if including SoWeMail API will throw an Exception"""
# Minimum required to send an email
self.max_diff = None
mail = Mail()
mail.from_email = Email("*****@*****.**")
mail.subject = "Hello World from the SoWeMail Python Library"
personalization = Personalization()
personalization.add_to(Email("*****@*****.**"))
mail.add_personalization(personalization)
# Try to include SoWeMail 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": "*****@*****.**"}, "personalizations": '
'[{"to": [{"email": "*****@*****.**"}]}], '
'"subject": "Hello World from the SoWeMail Python Library"}'
)
# Exception should be thrown
except Exception:
pass
# Exception not thrown
else:
self.fail("Should have failed as SoWeMail API key included")
def test_single_email_to_a_single_recipient_with_dynamic_templates(self):
from sowemail.helpers.mail import (Mail, From, To, Subject,
PlainTextContent, HtmlContent)
self.maxDiff = None
message = Mail(
from_email=From('*****@*****.**', 'Example From Name'),
to_emails=To('*****@*****.**', 'Example To Name'),
subject=Subject('Hello from SoWeMail'),
plain_text_content=PlainTextContent(
'Simple email sending example using python\'s sowerest library'
),
html_content=HtmlContent(
'<strong>Simple email sending example using python\'s sowerest library</strong>'
))
message.dynamic_template_data = DynamicTemplateData({
"total":
"$ 239.85",
"items": [{
"text": "New Line Sneakers",
"image":
"https://marketing-image-production.s3.amazonaws.com/uploads/8dd.png",
"price": "$ 79.95"
}, {
"text": "Old Line Sneakers",
"image":
"https://marketing-image-production.s3.amazonaws.com/uploads/362.png",
"price": "$ 79.95"
}, {
"text": "Blue Line Sneakers",
"image":
"https://marketing-image-production.s3.amazonaws.com/uploads/007.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": "Simple email sending example using python's sowerest library"
},
{
"type": "text/html",
"value": "<strong>Simple email sending example using python's sowerest library</strong>"
}
],
"from": {
"email": "*****@*****.**",
"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/8dd.png",
"price": "$ 79.95",
"text": "New Line Sneakers"
},
{
"image": "https://marketing-image-production.s3.amazonaws.com/uploads/362.png",
"price": "$ 79.95",
"text": "Old Line Sneakers"
},
{
"image": "https://marketing-image-production.s3.amazonaws.com/uploads/007.png",
"price": "$ 79.95",
"text": "Blue Line Sneakers"
}
],
"name": "Sample Name",
"receipt": true,
"state": "CO",
"total": "$ 239.85",
"zip": "80202"
},
"to": [
{
"email": "*****@*****.**",
"name": "Example To Name"
}
]
}
],
"subject": "Hello from SoWeMail"
}'''))
def test_kitchen_sink(self):
from sowemail.helpers.mail import (
Mail, From, To, Cc, Bcc, Subject, Content, MimeType, Attachment,
FileName, FileContent, FileType, Disposition, ContentId,
TemplateId, Substitution, Header, CustomArg, SendAt, Section,
ReplyTo, MailSettings, BccSettings, BccSettingsEmail,
FooterSettings, FooterText, FooterHtml, SandBoxMode,
TrackingSettings, ClickTracking, OpenTracking,
OpenTrackingSubstitutionTag, Ganalytics, UtmSource, UtmMedium,
UtmTerm, UtmContent, UtmCampaign)
self.maxDiff = None
message = Mail()
# Define Personalizations
message.to = To('*****@*****.**', 'Example User1', p=0)
message.to = [
To('*****@*****.**', 'Example User2', p=0),
To('*****@*****.**', 'Example User3', p=0)
]
message.cc = Cc('*****@*****.**', 'Example User4', p=0)
message.cc = [
Cc('*****@*****.**', 'Example User5', p=0),
Cc('*****@*****.**', 'Example User6', p=0)
]
message.bcc = Bcc('*****@*****.**', 'Example User7', p=0)
message.bcc = [
Bcc('*****@*****.**', 'Example User8', p=0),
Bcc('*****@*****.**', 'Example User9', p=0)
]
message.subject = Subject('Hello from SoWeMail 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('*****@*****.**', 'Example User10', p=1)
message.to = [
To('*****@*****.**', 'Example User11', p=1),
To('*****@*****.**', 'Example User12', p=1)
]
message.cc = Cc('*****@*****.**', 'Example User13', p=1)
message.cc = [
Cc('*****@*****.**', 'Example User14', p=1),
Cc('*****@*****.**', 'Example User15', p=1)
]
message.bcc = Bcc('*****@*****.**', 'Example User16', p=1)
message.bcc = [
Bcc('*****@*****.**', 'Example User17', p=1),
Bcc('*****@*****.**', '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('Hello from SoWeMail 1', p=1)
# The values below this comment are global to entire message
message.from_email = From('*****@*****.**', 'SoWeMail')
message.reply_to = ReplyTo('*****@*****.**', 'SoWeMail Reply')
message.subject = Subject('Hello from SoWeMail 2')
message.content = Content(
MimeType.text,
'Simple email sending example using python\'s sowerest library')
message.content = Content(
MimeType.html,
'<strong>Simple email sending example using python\'s sowerest library</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.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)
mail_settings = MailSettings()
mail_settings.bcc_settings = BccSettings(
False, BccSettingsEmail("*****@*****.**"))
mail_settings.footer_settings = FooterSettings(
True, FooterText("w00t"), FooterHtml("<string>w00t!<strong>"))
mail_settings.sandbox_mode = SandBoxMode(True)
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.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'''{
"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"
}
],
"content": [
{
"type": "text/plain",
"value": "Simple email sending example using python's sowerest library"
},
{
"type": "text/html",
"value": "<strong>Simple email sending example using python's sowerest library</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": "*****@*****.**",
"name": "SoWeMail"
},
"headers": {
"X-Test10": "Test10",
"X-Test11": "Test11",
"X-Test12": "Test12",
"X-Test9": "Test9"
},
"mail_settings": {
"bcc": {
"email": "*****@*****.**",
"enable": false
},
"footer": {
"enable": true,
"html": "<string>w00t!<strong>",
"text": "w00t"
},
"sandbox_mode": {
"enable": true
}
},
"personalizations": [
{
"bcc": [
{
"email": "*****@*****.**",
"name": "Example User7"
},
{
"email": "*****@*****.**",
"name": "Example User8"
},
{
"email": "*****@*****.**",
"name": "Example User9"
}
],
"cc": [
{
"email": "*****@*****.**",
"name": "Example User4"
},
{
"email": "*****@*****.**",
"name": "Example User5"
},
{
"email": "*****@*****.**",
"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": "Hello from SoWeMail 0",
"substitutions": {
"%city1%": "Example City 1",
"%city2%": "Example City 2",
"%name1%": "Example Name 1",
"%name2%": "Example Name 2"
},
"to": [
{
"email": "*****@*****.**",
"name": "Example User1"
},
{
"email": "*****@*****.**",
"name": "Example User2"
},
{
"email": "*****@*****.**",
"name": "Example User3"
}
]
},
{
"bcc": [
{
"email": "*****@*****.**",
"name": "Example User16"
},
{
"email": "*****@*****.**",
"name": "Example User17"
},
{
"email": "*****@*****.**",
"name": "Example User18"
}
],
"cc": [
{
"email": "*****@*****.**",
"name": "Example User13"
},
{
"email": "*****@*****.**",
"name": "Example User14"
},
{
"email": "*****@*****.**",
"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": "Hello from SoWeMail 1",
"substitutions": {
"%city3%": "Example City 3",
"%city4%": "Example City 4",
"%name3%": "Example Name 3",
"%name4%": "Example Name 4"
},
"to": [
{
"email": "*****@*****.**",
"name": "Example User10"
},
{
"email": "*****@*****.**",
"name": "Example User11"
},
{
"email": "*****@*****.**",
"name": "Example User12"
}
]
}
],
"reply_to": {
"email": "*****@*****.**",
"name": "SoWeMail Reply"
},
"sections": {
"%section1%": "Substitution for Section 1 Tag",
"%section2%": "Substitution for Section 2 Tag",
"%section3%": "Substitution for Section 3 Tag"
},
"send_at": 1461775053,
"subject": "Hello from SoWeMail 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"
}
}
}'''))
def test_dynamic_template_data(self):
self.maxDiff = None
to_emails = [
To(email='*****@*****.**',
name='Example To 0 Name',
dynamic_template_data=DynamicTemplateData(
{'name': 'Example 0 Name'})),
To(email='*****@*****.**',
name='Example To 1 Name',
dynamic_template_data={'name': 'Example 1 Name'})
]
message = Mail(from_email=From('*****@*****.**',
'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": "*****@*****.**",
"name": "Example From Name"
},
"personalizations": [
{
"dynamic_template_data": {
"name": "Example 1 Name"
},
"to": [
{
"email": "*****@*****.**",
"name": "Example To 1 Name"
}
]
},
{
"dynamic_template_data": {
"name": "Example 0 Name"
},
"to": [
{
"email": "*****@*****.**",
"name": "Example To 0 Name"
}
]
}
],
"subject": "Hi!"
}'''))
def test_multiple_emails_to_multiple_recipients(self):
from sowemail.helpers.mail import (Mail, From, To, Subject,
PlainTextContent, HtmlContent,
Substitution)
self.maxDiff = None
to_emails = [
To(email='*****@*****.**',
name='Example Name 0',
substitutions=[
Substitution('-name-', 'Example Name Substitution 0'),
Substitution('-github-', 'https://example.com/test0'),
],
subject=Subject('Override Global Subject')),
To(email='*****@*****.**',
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('*****@*****.**', 'Example From Name'),
to_emails=to_emails,
subject=Subject('Hi -name-'),
plain_text_content=PlainTextContent(
'Hi -name-, your URL -github-, email at -time-'),
html_content=HtmlContent(
'<strong>Hi -name-, your URL <a href=\"-github-\">here</a></strong> email at -time-'
),
global_substitutions=global_substitutions,
is_multiple=True)
self.assertEqual(
message.get(),
json.loads(r'''{
"content": [
{
"type": "text/plain",
"value": "Hi -name-, your URL -github-, email at -time-"
},
{
"type": "text/html",
"value": "<strong>Hi -name-, your URL <a href=\"-github-\">here</a></strong> email at -time-"
}
],
"from": {
"email": "*****@*****.**",
"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": "*****@*****.**",
"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": "*****@*****.**",
"name": "Example Name 0"
}
]
}
],
"subject": "Hi -name-"
}'''))