about summary refs log tree commit diff
path: root/.venv/lib/python3.12/site-packages/test/unit
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
parentcc961e04ba734dd72309fb548a2f97d67d578813 (diff)
downloadgn-ai-master.tar.gz
two version of R2R are here HEAD master
Diffstat (limited to '.venv/lib/python3.12/site-packages/test/unit')
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/__init__.py0
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_app.py22
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_config.py60
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_email.py68
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_eventwebhook.py50
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_inbound_send.py49
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_mail_helpers.py1766
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_parse.py16
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_project.py52
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_sendgrid.py27
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_spam_check.py38
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_stats.py86
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_twilio_email.py37
-rw-r--r--.venv/lib/python3.12/site-packages/test/unit/test_unassigned.py93
14 files changed, 2364 insertions, 0 deletions
diff --git a/.venv/lib/python3.12/site-packages/test/unit/__init__.py b/.venv/lib/python3.12/site-packages/test/unit/__init__.py
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/__init__.py
diff --git a/.venv/lib/python3.12/site-packages/test/unit/test_app.py b/.venv/lib/python3.12/site-packages/test/unit/test_app.py
new file mode 100644
index 00000000..56027d57
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/test_app.py
@@ -0,0 +1,22 @@
+import os
+import unittest
+
+from sendgrid.helpers.inbound.config import Config
+from sendgrid.helpers.inbound.app import app
+
+
+class UnitTests(unittest.TestCase):
+
+    def setUp(self):
+        self.config = Config()
+        app.testing = True
+        self.tester = app.test_client(self)
+
+    def test_up_and_running(self):
+        response = self.tester.get('/')
+        self.assertEqual(response.status_code, 200)
+
+    def test_used_port_true(self):
+        if self.config.debug_mode:
+            port = int(os.environ.get("PORT", self.config.port))
+            self.assertEqual(port, self.config.port)
diff --git a/.venv/lib/python3.12/site-packages/test/unit/test_config.py b/.venv/lib/python3.12/site-packages/test/unit/test_config.py
new file mode 100644
index 00000000..f60306a5
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/test_config.py
@@ -0,0 +1,60 @@
+import os
+import unittest
+
+import sendgrid.helpers.inbound.config
+from sendgrid.helpers.inbound.config import Config
+
+
+class UnitTests(unittest.TestCase):
+
+    def setUp(self):
+        self.config = Config()
+
+    def test_initialization(self):
+        endpoint = '/inbound'
+        port = 5000
+        keys = [
+            'from',
+            'attachments',
+            'headers',
+            'text',
+            'envelope',
+            'to',
+            'html',
+            'sender_ip',
+            'attachment-info',
+            'subject',
+            'dkim',
+            'SPF',
+            'charsets',
+            'content-ids',
+            'spam_report',
+            'spam_score',
+            'email',
+        ]
+        host = 'http://127.0.0.1:5000/inbound'
+
+        self.assertTrue(self.config.debug_mode)
+        self.assertEqual(self.config.endpoint, endpoint)
+        self.assertEqual(self.config.host, host)
+        self.assertEqual(self.config.port, port)
+        for key in keys:
+            self.assertIn(key, self.config.keys)
+
+    def test_init_environment_should_set_env_from_dotenv(self):
+        config_file = sendgrid.helpers.inbound.config.__file__
+        env_file_path = '{0}/.env'.format(os.path.abspath(os.path.dirname(config_file)))
+        with open(env_file_path, 'w') as f:
+            f.write('RANDOM_VARIABLE=RANDOM_VALUE')
+        Config()
+        os.remove(env_file_path)
+        self.assertEqual(os.environ['RANDOM_VARIABLE'], 'RANDOM_VALUE')
+
+    def test_init_environment_should_not_set_env_if_format_is_invalid(self):
+        config_file = sendgrid.helpers.inbound.config.__file__
+        env_file_path = os.path.abspath(os.path.dirname(config_file)) + '/.env'
+        with open(env_file_path, 'w') as f:
+            f.write('RANDOM_VARIABLE=RANDOM_VALUE=ANOTHER_RANDOM_VALUE')
+        Config()
+        os.remove(env_file_path)
+        self.assertIsNone(os.environ.get('RANDOM_VARIABLE'))
diff --git a/.venv/lib/python3.12/site-packages/test/unit/test_email.py b/.venv/lib/python3.12/site-packages/test/unit/test_email.py
new file mode 100644
index 00000000..9db06070
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/test_email.py
@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*-
+import unittest
+
+from sendgrid.helpers.mail import (Email)
+
+
+class TestEmailObject(unittest.TestCase):
+
+    def test_add_email_address(self):
+        address = "test@example.com"
+        email = Email(address)
+
+        self.assertEqual(email.email, "test@example.com")
+
+    def test_add_name(self):
+        name = "SomeName"
+        email = Email(name=name)
+
+        self.assertEqual(email.name, name)
+
+    def test_add_unicode_name(self):
+        name = u"SomeName"
+        email = Email(name=name)
+
+        self.assertEqual(email.name, name)
+
+    def test_add_name_email(self):
+        name = "SomeName"
+        address = "test@example.com"
+        email = Email(email=address, name=name)
+        self.assertEqual(email.name, name)
+        self.assertEqual(email.email, "test@example.com")
+
+    def test_add_unicode_name_email(self):
+        name = u"SomeName"
+        address = u"test@example.com"
+        email = Email(email=address, name=name)
+        self.assertEqual(email.name, name)
+        self.assertEqual(email.email, u"test@example.com")
+
+    def test_add_rfc_function_finds_name_not_email(self):
+        name = "SomeName"
+        email = Email(name)
+
+        self.assertEqual(email.name, name)
+        self.assertIsNone(email.email)
+
+    def test_add_rfc_email(self):
+        name = "SomeName"
+        address = "test@example.com"
+        name_address = "{} <{}>".format(name, address)
+        email = Email(name_address)
+        self.assertEqual(email.name, name)
+        self.assertEqual(email.email, "test@example.com")
+
+    def test_empty_obj_add_name(self):
+        email = Email()
+        name = "SomeName"
+        email.name = name
+
+        self.assertEqual(email.name, name)
+
+    def test_empty_obj_add_email(self):
+        email = Email()
+        address = "test@example.com"
+        email.email = address
+
+        self.assertEqual(email.email, address)
diff --git a/.venv/lib/python3.12/site-packages/test/unit/test_eventwebhook.py b/.venv/lib/python3.12/site-packages/test/unit/test_eventwebhook.py
new file mode 100644
index 00000000..eee1eabf
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/test_eventwebhook.py
@@ -0,0 +1,50 @@
+import json
+import unittest
+
+from sendgrid import EventWebhook
+
+
+class UnitTests(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        cls.PUBLIC_KEY = 'MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE83T4O/n84iotIvIW4mdBgQ/7dAfSmpqIM8kF9mN1flpVKS3GRqe62gw+2fNNRaINXvVpiglSI8eNEc6wEA3F+g=='
+        cls.SIGNATURE = 'MEUCIGHQVtGj+Y3LkG9fLcxf3qfI10QysgDWmMOVmxG0u6ZUAiEAyBiXDWzM+uOe5W0JuG+luQAbPIqHh89M15TluLtEZtM='
+        cls.TIMESTAMP = '1600112502'
+        cls.PAYLOAD = json.dumps(
+            [
+                {
+                    'email': 'hello@world.com',
+                    'event': 'dropped',
+                    'reason': 'Bounced Address',
+                    'sg_event_id': 'ZHJvcC0xMDk5NDkxOS1MUnpYbF9OSFN0T0doUTRrb2ZTbV9BLTA',
+                    'sg_message_id': 'LRzXl_NHStOGhQ4kofSm_A.filterdrecv-p3mdw1-756b745b58-kmzbl-18-5F5FC76C-9.0',
+                    'smtp-id': '<LRzXl_NHStOGhQ4kofSm_A@ismtpd0039p1iad1.sendgrid.net>',
+                    'timestamp': 1600112492,
+                }
+            ], sort_keys=True, separators=(',', ':')
+        ) + '\r\n'  # Be sure to include the trailing carriage return and newline!
+
+    def test_verify_valid_signature(self):
+        ew = EventWebhook()
+        key = ew.convert_public_key_to_ecdsa(self.PUBLIC_KEY)
+        self.assertTrue(ew.verify_signature(self.PAYLOAD, self.SIGNATURE, self.TIMESTAMP, key))
+
+    def test_verify_bad_key(self):
+        ew = EventWebhook('MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEqTxd43gyp8IOEto2LdIfjRQrIbsd4SXZkLW6jDutdhXSJCWHw8REntlo7aNDthvj+y7GjUuFDb/R1NGe1OPzpA==')
+        self.assertFalse(ew.verify_signature(self.PAYLOAD, self.SIGNATURE, self.TIMESTAMP))
+
+    def test_verify_bad_payload(self):
+        ew = EventWebhook(self.PUBLIC_KEY)
+        self.assertFalse(ew.verify_signature('payload', self.SIGNATURE, self.TIMESTAMP))
+
+    def test_verify_bad_signature(self):
+        ew = EventWebhook(self.PUBLIC_KEY)
+        self.assertFalse(ew.verify_signature(
+            self.PAYLOAD,
+            'MEUCIQCtIHJeH93Y+qpYeWrySphQgpNGNr/U+UyUlBkU6n7RAwIgJTz2C+8a8xonZGi6BpSzoQsbVRamr2nlxFDWYNH3j/0=',
+            self.TIMESTAMP
+        ))
+
+    def test_verify_bad_timestamp(self):
+        ew = EventWebhook(self.PUBLIC_KEY)
+        self.assertFalse(ew.verify_signature(self.PAYLOAD, self.SIGNATURE, 'timestamp'))
diff --git a/.venv/lib/python3.12/site-packages/test/unit/test_inbound_send.py b/.venv/lib/python3.12/site-packages/test/unit/test_inbound_send.py
new file mode 100644
index 00000000..19ee5de1
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/test_inbound_send.py
@@ -0,0 +1,49 @@
+import argparse
+import unittest
+
+from sendgrid.helpers.inbound import send
+
+try:
+    import unittest.mock as mock
+except ImportError:
+    import mock
+
+
+class UnitTests(unittest.TestCase):
+    def setUp(self):
+        self.client_mock = mock.patch('sendgrid.helpers.inbound.send.Client')
+        self.open_mock = mock.patch('sendgrid.helpers.inbound.send.open',
+                                    mock.mock_open(), create=True)
+        self.client_mock.start()
+        self.open_mock.start()
+
+    def tearDown(self):
+        self.client_mock.stop()
+        self.open_mock.stop()
+
+    def test_send(self):
+
+        fake_url = 'https://fake_url'
+        x = send.Send(fake_url)
+        x.test_payload(fake_url)
+
+        send.Client.assert_called_once_with(
+            host=fake_url,
+            request_headers={
+                'User-Agent': 'SendGrid-Test',
+                'Content-Type': 'multipart/form-data; boundary=xYzZY'
+            })
+
+    def test_main_call(self):
+        fake_url = 'https://fake_url'
+
+        with mock.patch(
+            'argparse.ArgumentParser.parse_args',
+            return_value=argparse.Namespace(
+                host=fake_url, data='test_file.txt')):
+            send.main()
+            send.Client.assert_called_once_with(
+                host=fake_url,
+                request_headers={
+                    'User-Agent': 'SendGrid-Test',
+                    'Content-Type': 'multipart/form-data; boundary=xYzZY'})
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
+                },
+            },
+        )
diff --git a/.venv/lib/python3.12/site-packages/test/unit/test_parse.py b/.venv/lib/python3.12/site-packages/test/unit/test_parse.py
new file mode 100644
index 00000000..1c899bbb
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/test_parse.py
@@ -0,0 +1,16 @@
+import unittest
+
+from sendgrid.helpers.inbound.config import Config
+from sendgrid.helpers.inbound.app import app
+
+
+class UnitTests(unittest.TestCase):
+
+    def setUp(self):
+        self.config = Config()
+        self.tester = app.test_client(self)
+
+    def test_parse(self):
+        response = self.tester.post(self.config.endpoint,
+                                    data='{"Message:", "Success"}')
+        self.assertEqual(response.status_code, 200)
diff --git a/.venv/lib/python3.12/site-packages/test/unit/test_project.py b/.venv/lib/python3.12/site-packages/test/unit/test_project.py
new file mode 100644
index 00000000..40282bdb
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/test_project.py
@@ -0,0 +1,52 @@
+import os
+import unittest
+
+
+class ProjectTests(unittest.TestCase):
+    # ./.env_sample
+    def test_env(self):
+        self.assertTrue(os.path.isfile('./.env_sample'))
+
+    # ./.gitignore
+    def test_gitignore(self):
+        self.assertTrue(os.path.isfile('./.gitignore'))
+
+    # ./CHANGELOG.md
+    def test_changelog(self):
+        self.assertTrue(os.path.isfile('./CHANGELOG.md'))
+
+    # ./CODE_OF_CONDUCT.md
+    def test_code_of_conduct(self):
+        self.assertTrue(os.path.isfile('./CODE_OF_CONDUCT.md'))
+
+    # ./CONTRIBUTING.md
+    def test_contributing(self):
+        self.assertTrue(os.path.isfile('./CONTRIBUTING.md'))
+
+    # ./LICENSE
+    def test_license(self):
+        self.assertTrue(os.path.isfile('./LICENSE'))
+
+    # ./PULL_REQUEST_TEMPLATE.md
+    def test_pr_template(self):
+        self.assertTrue(os.path.isfile('./PULL_REQUEST_TEMPLATE.md'))
+
+    # ./README.rst
+    def test_readme(self):
+        self.assertTrue(os.path.isfile('./README.rst'))
+
+    # ./TROUBLESHOOTING.md
+    def test_troubleshooting(self):
+        self.assertTrue(os.path.isfile('./TROUBLESHOOTING.md'))
+
+    # ./USAGE.md
+    def test_usage(self):
+        self.assertTrue(os.path.isfile('./USAGE.md'))
+
+    # ./use-cases/README.md
+    def test_use_cases(self):
+        self.assertTrue(os.path.isfile('./use_cases/README.md'))
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/.venv/lib/python3.12/site-packages/test/unit/test_sendgrid.py b/.venv/lib/python3.12/site-packages/test/unit/test_sendgrid.py
new file mode 100644
index 00000000..328d978a
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/test_sendgrid.py
@@ -0,0 +1,27 @@
+import unittest
+import sendgrid
+
+class UnitTests(unittest.TestCase):
+    def test_host_with_no_region(self):
+        sg = sendgrid.SendGridAPIClient(api_key='MY_API_KEY')
+        self.assertEqual("https://api.sendgrid.com",sg.client.host)
+
+    def test_host_with_eu_region(self):
+        sg = sendgrid.SendGridAPIClient(api_key='MY_API_KEY')
+        sg.set_sendgrid_data_residency("eu")
+        self.assertEqual("https://api.eu.sendgrid.com",sg.client.host)
+
+    def test_host_with_global_region(self):
+        sg = sendgrid.SendGridAPIClient(api_key='MY_API_KEY')
+        sg.set_sendgrid_data_residency("global")
+        self.assertEqual("https://api.sendgrid.com",sg.client.host)
+
+    def test_with_region_is_none(self):
+        sg = sendgrid.SendGridAPIClient(api_key='MY_API_KEY')
+        with self.assertRaises(ValueError):
+            sg.set_sendgrid_data_residency(None)
+
+    def test_with_region_is_invalid(self):
+        sg = sendgrid.SendGridAPIClient(api_key='MY_API_KEY')
+        with self.assertRaises(ValueError):
+            sg.set_sendgrid_data_residency("abc")
\ No newline at end of file
diff --git a/.venv/lib/python3.12/site-packages/test/unit/test_spam_check.py b/.venv/lib/python3.12/site-packages/test/unit/test_spam_check.py
new file mode 100644
index 00000000..e532573b
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/test_spam_check.py
@@ -0,0 +1,38 @@
+from sendgrid.helpers.mail.spam_check import SpamCheck
+
+try:
+    import unittest2 as unittest
+except ImportError:
+    import unittest
+
+
+class UnitTests(unittest.TestCase):
+
+    def test_spam_all_values(self):
+        expected = {'enable': True, 'threshold': 5, 'post_to_url': 'https://www.test.com'}
+        spam_check = SpamCheck(enable=True, threshold=5, post_to_url='https://www.test.com')
+        self.assertEqual(spam_check.get(), expected)
+
+    def test_spam_no_url(self):
+        expected = {'enable': True, 'threshold': 10}
+        spam_check = SpamCheck(enable=True, threshold=10)
+        self.assertEqual(spam_check.get(), expected)
+
+    def test_spam_no_threshold(self):
+        expected = {'enable': True}
+        spam_check = SpamCheck(enable=True)
+        self.assertEqual(spam_check.get(), expected)
+
+    def test_has_values_but_not_enabled(self):
+        expected = {'enable': False, 'threshold': 1, 'post_to_url': 'https://www.test.com'}
+        spam_check = SpamCheck(enable=False, threshold=1, post_to_url='https://www.test.com')
+        self.assertEqual(spam_check.get(), expected)
+
+    def test_spam_change_properties(self):
+        """Tests changing the properties of the spam check class"""
+        expected = {'enable': False, 'threshold': 10, 'post_to_url': 'https://www.testing.com'}
+        spam_check = SpamCheck(enable=True, threshold=5, post_to_url='https://www.test.com')
+        spam_check.enable = False
+        spam_check.threshold = 10
+        spam_check.post_to_url = 'https://www.testing.com'
+        self.assertEqual(spam_check.get(), expected)
diff --git a/.venv/lib/python3.12/site-packages/test/unit/test_stats.py b/.venv/lib/python3.12/site-packages/test/unit/test_stats.py
new file mode 100644
index 00000000..c7111739
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/test_stats.py
@@ -0,0 +1,86 @@
+# -*- coding: utf-8 -*-
+import json
+from sendgrid.helpers.stats import *
+
+try:
+    import unittest2 as unittest
+except ImportError:
+    import unittest
+
+
+class UnitTests(unittest.TestCase):
+
+    def test_basicStats(self):
+
+        """Minimum required for stats"""
+        global_stats = Stats(start_date='12-09-2017')
+
+        self.assertEqual(
+            json.dumps(
+                global_stats.get(),
+                sort_keys=True),
+            '{"start_date": "12-09-2017"}'
+        )
+
+        self.assertTrue(isinstance(str(global_stats), str))
+
+    def test_Stats(self):
+
+        all_stats = Stats(start_date='12-09-2017')
+        all_stats.end_date = '12-10-2017'
+        all_stats.aggregated_by = 'day'
+        all_stats._sort_by_direction = 'asc'
+        all_stats.sort_by_metric = 'clicks'
+        all_stats._limit = 100
+        all_stats._offset = 2
+
+        self.assertEqual(
+            json.dumps(
+                all_stats.get(),
+                sort_keys=True),
+            '{"aggregated_by": "day", "end_date": "12-10-2017", '
+            '"limit": 100, "offset": 2, "sort_by_direction": "asc", '
+            '"sort_by_metric": "clicks", "start_date": "12-09-2017"}'
+        )
+
+    def test_categoryStats(self):
+
+        category_stats = CategoryStats(start_date='12-09-2017', categories=['foo', 'bar'])
+        category_stats.add_category(Category('woo'))
+        category_stats.end_date = '12-10-2017'
+        category_stats.aggregated_by = 'day'
+        category_stats._sort_by_direction = 'asc'
+        category_stats.sort_by_metric = 'clicks'
+        category_stats._limit = 100
+        category_stats._offset = 2
+
+        self.assertEqual(
+            json.dumps(
+                category_stats.get(),
+                sort_keys=True),
+            '{"aggregated_by": "day", "categories": ["foo", "bar", "woo"], '
+            '"end_date": "12-10-2017", "limit": 100, "offset": 2, '
+            '"sort_by_direction": "asc", "sort_by_metric": "clicks", '
+            '"start_date": "12-09-2017"}'
+        )
+
+    def test_subuserStats(self):
+
+        subuser_stats = SubuserStats(start_date = '12-09-2017', subusers=['foo', 'bar'])
+        subuser_stats.add_subuser(Subuser('blah'))
+        subuser_stats.end_date = '12-10-2017'
+        subuser_stats.aggregated_by = 'day'
+        subuser_stats._sort_by_direction = 'asc'
+        subuser_stats.sort_by_metric = 'clicks'
+        subuser_stats._limit = 100
+        subuser_stats._offset = 2
+
+        self.assertEqual(
+            json.dumps(
+                subuser_stats.get(),
+                sort_keys=True),
+            '{"aggregated_by": "day", "end_date": "12-10-2017", '
+            '"limit": 100, "offset": 2, "sort_by_direction": "asc", '
+            '"sort_by_metric": "clicks", "start_date": "12-09-2017", '
+            '"subusers": ["foo", "bar", "blah"]}'
+        )
diff --git a/.venv/lib/python3.12/site-packages/test/unit/test_twilio_email.py b/.venv/lib/python3.12/site-packages/test/unit/test_twilio_email.py
new file mode 100644
index 00000000..92269acf
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/test_twilio_email.py
@@ -0,0 +1,37 @@
+import os
+import unittest
+
+from sendgrid import TwilioEmailAPIClient
+
+
+class UnitTests(unittest.TestCase):
+
+    @classmethod
+    def setUpClass(cls):
+        os.environ['TWILIO_API_KEY'] = 'api-key'
+        os.environ['TWILIO_API_SECRET'] = 'api-secret'
+        os.environ['TWILIO_ACCOUNT_SID'] = 'account-sid'
+        os.environ['TWILIO_AUTH_TOKEN'] = 'auth-token'
+
+    def test_init_key_over_token(self):
+        mail_client = TwilioEmailAPIClient()
+
+        self.assertEqual(mail_client.username, 'api-key')
+        self.assertEqual(mail_client.password, 'api-secret')
+        self.assertEqual(mail_client.host, 'https://email.twilio.com')
+
+    def test_init_token(self):
+        del os.environ['TWILIO_API_KEY']
+        del os.environ['TWILIO_API_SECRET']
+
+        mail_client = TwilioEmailAPIClient()
+
+        self.assertEqual(mail_client.username, 'account-sid')
+        self.assertEqual(mail_client.password, 'auth-token')
+
+    def test_init_args(self):
+        mail_client = TwilioEmailAPIClient('username', 'password')
+
+        self.assertEqual(mail_client.username, 'username')
+        self.assertEqual(mail_client.password, 'password')
+        self.assertEqual(mail_client.auth, 'Basic dXNlcm5hbWU6cGFzc3dvcmQ=')
diff --git a/.venv/lib/python3.12/site-packages/test/unit/test_unassigned.py b/.venv/lib/python3.12/site-packages/test/unit/test_unassigned.py
new file mode 100644
index 00000000..08ab943b
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/test/unit/test_unassigned.py
@@ -0,0 +1,93 @@
+import json
+
+from sendgrid.helpers.endpoints.ip.unassigned import unassigned
+
+ret_json = '''[ {
+	"ip": "167.89.21.3",
+        "pools": [
+		"pool1",
+	"pool2"
+	],
+        "whitelabeled": false,
+        "start_date": 1409616000,
+        "subusers": [
+          "tim@sendgrid.net"
+        ],
+        "warmup": false,
+        "assigned_at": 1482883200
+      },
+      {
+        "ip": "192.168.1.1",
+        "pools": [
+          "pool1",
+          "pool2"
+        ],
+        "whitelabeled": false,
+        "start_date": 1409616000,
+        "subusers": [
+          "tim@sendgrid.net"
+        ],
+        "warmup": false,
+        "assigned_at": 1482883200
+      },
+      {
+        "ip": "208.115.214.22",
+        "pools": [],
+        "whitelabeled": true,
+        "rdns": "o1.email.burgermail.com",
+        "start_date": 1409616000,
+        "subusers": [],
+        "warmup": false,
+        "assigned_at": 1482883200
+      },
+      {
+        "ip": "208.115.214.23",
+        "pools": [],
+        "whitelabeled": true,
+        "rdns": "o1.email.burgermail.com",
+        "start_date": 1409616000,
+        "subusers": [],
+        "warmup": false,
+        "assigned_at": 1482883200
+
+      } ]
+      '''
+
+
+def get_all_ip():
+    ret_val = json.loads(ret_json)
+    return ret_val
+
+
+def make_data():
+    data = set()
+    data.add("208.115.214.23")
+    data.add("208.115.214.22")
+    return data
+
+
+def test_unassigned_ip_json():
+    data = make_data()
+
+    as_json = True
+    calculated = unassigned(get_all_ip(), as_json=as_json)
+    calculated = json.loads(calculated)
+
+    for item in calculated:
+        assert item["ip"] in data
+
+
+def test_unassigned_ip_obj():
+    data = make_data()
+
+    as_json = False
+    calculated = unassigned(get_all_ip(), as_json=as_json)
+
+    for item in calculated:
+        assert item["ip"] in data
+
+
+def test_unassigned_baddata():
+    as_json = False
+    calculated = unassigned(dict(), as_json=as_json)
+    assert calculated == []