add global sandbox mode

Author: sklarsa

sendgrid_backend/mail.py

@@ -93,10 +93,15 @@ def __init__(self, *args, **kwargs):
         self.sg = SendGridAPIClient(**sg_args)
 
         # Configure sandbox mode based on settings
+        # SENDGRID_SANDBOX_MODE takes precedence and enables sandbox mode unconditionally
+        # SENDGRID_SANDBOX_MODE_IN_DEBUG only enables sandbox mode when DEBUG=True
+        sandbox_mode = get_django_setting("SENDGRID_SANDBOX_MODE", False)
         sandbox_mode_in_debug = get_django_setting(
             "SENDGRID_SANDBOX_MODE_IN_DEBUG", True
         )
-        self.sandbox_mode = bool(settings.DEBUG) and bool(sandbox_mode_in_debug)
+        self.sandbox_mode = bool(sandbox_mode) or (
+            bool(settings.DEBUG) and bool(sandbox_mode_in_debug)
+        )
 
         if self.sandbox_mode:
             warnings.warn(

test/test_sandbox_mode.py

@@ -7,7 +7,60 @@
 
 
 class TestSandboxMode(SimpleTestCase):
-    def test_sandbox_mode(self):
+    def test_sendgrid_sandbox_mode_setting(self):
+        """
+        Tests the SENDGRID_SANDBOX_MODE setting which enables sandbox mode
+        unconditionally, regardless of DEBUG.
+        """
+        msg = EmailMessage(
+            subject="Hello, World!",
+            body="Hello, World!",
+            from_email="Sam Smith <sam.smith@example.com>",
+            to=["John Doe <john.doe@example.com>"],
+        )
+
+        # SENDGRID_SANDBOX_MODE=True should enable sandbox mode even when DEBUG=False
+        with override_settings(DEBUG=False, SENDGRID_SANDBOX_MODE=True):
+            backend = SendgridBackend(api_key="stub")
+            self.assertTrue(backend.sandbox_mode)
+
+            result = backend._build_sg_mail(msg)
+            self.assertIn("mail_settings", result)
+            self.assertIn("sandbox_mode", result["mail_settings"])
+            self.assertTrue(result["mail_settings"]["sandbox_mode"]["enable"])
+
+        # SENDGRID_SANDBOX_MODE=True should enable sandbox mode when DEBUG=True
+        with override_settings(DEBUG=True, SENDGRID_SANDBOX_MODE=True):
+            backend = SendgridBackend(api_key="stub")
+            self.assertTrue(backend.sandbox_mode)
+
+            result = backend._build_sg_mail(msg)
+            self.assertTrue(result["mail_settings"]["sandbox_mode"]["enable"])
+
+        # SENDGRID_SANDBOX_MODE=True takes precedence over SENDGRID_SANDBOX_MODE_IN_DEBUG=False
+        with override_settings(
+            DEBUG=False, SENDGRID_SANDBOX_MODE=True, SENDGRID_SANDBOX_MODE_IN_DEBUG=False
+        ):
+            backend = SendgridBackend(api_key="stub")
+            self.assertTrue(backend.sandbox_mode)
+
+            result = backend._build_sg_mail(msg)
+            self.assertTrue(result["mail_settings"]["sandbox_mode"]["enable"])
+
+        # SENDGRID_SANDBOX_MODE=False should not affect existing behavior
+        with override_settings(DEBUG=False, SENDGRID_SANDBOX_MODE=False):
+            backend = SendgridBackend(api_key="stub")
+            self.assertFalse(backend.sandbox_mode)
+
+            result = backend._build_sg_mail(msg)
+            self.assertFalse(result["mail_settings"]["sandbox_mode"]["enable"])
+
+        # When SENDGRID_SANDBOX_MODE is not set, fall back to existing behavior
+        with override_settings(DEBUG=True, SENDGRID_SANDBOX_MODE_IN_DEBUG=True):
+            backend = SendgridBackend(api_key="stub")
+            self.assertTrue(backend.sandbox_mode)
+
+    def test_sandbox_mode_in_debug(self):
         """
         Tests combinations of DEBUG, SENDGRID_SANDBOX_MODE_IN_DEBUG, and mail_settings to ensure
         that the behavior is as expected.