Merge branch 'main' of https://github.com/resend/resend-python into feat/headers-all-responses

drish · drish · commit c8835aed561a · 2026-02-16T12:04:25.000-03:00
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
@@ -9,7 +9,7 @@ jobs:
       matrix:
         python-version: ["3.8", "3.9", "3.10", "3.11"]
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v6
         with:
@@ -28,7 +28,7 @@ jobs:
         os: [ubuntu-latest]
         python-version: ["3.8", "3.9", "3.10", "3.11"]
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v6
         with:
diff --git a/Dockerfile b/Dockerfile
@@ -1,4 +1,4 @@
-FROM python:3.13.7
+FROM python:3.14.3
 
 RUN pip install --upgrade pip
 
diff --git a/resend/broadcasts/_broadcasts.py b/resend/broadcasts/_broadcasts.py
@@ -40,6 +40,8 @@ class CreateParams(_CreateParamsFrom):
             html (NotRequired[str]): The HTML version of the message.
             text (NotRequired[str]): The text version of the message.
             name (NotRequired[str]): The friendly name of the broadcast. Only used for internal reference.
+            send (NotRequired[bool]): When true, the broadcast will be sent immediately after creation.
+            scheduled_at (NotRequired[str]): Schedule the broadcast to be sent later. Only valid when send is true.
         """
 
         segment_id: NotRequired[str]
@@ -73,6 +75,17 @@ class CreateParams(_CreateParamsFrom):
         """
         The friendly name of the broadcast. Only used for internal reference.
         """
+        send: NotRequired[bool]
+        """
+        When set to true, the broadcast will be sent immediately after creation.
+        If false or not provided, the broadcast will be created as a draft.
+        """
+        scheduled_at: NotRequired[str]
+        """
+        Schedule the broadcast to be sent later.
+        Only valid when send is set to true.
+        The date should be in natural language (e.g.: in 1 min) or ISO 8601 format (e.g: 2024-08-05T11:52:01.858Z).
+        """
 
     class UpdateParams(_UpdateParamsFrom):
         """UpdateParams is the class that wraps the parameters for the update method.
diff --git a/resend/request.py b/resend/request.py
@@ -6,6 +6,7 @@
 import resend
 from resend.exceptions import (NoContentError, ResendError,
                                raise_for_code_and_type)
+from resend.response import ResponseDict
 from resend.version import get_version
 
 RequestVerb = Literal["get", "post", "put", "patch", "delete"]
@@ -39,6 +40,8 @@ def perform(self) -> Union[T, None]:
                 error_type=data.get("name", "InternalServerError"),
             )
 
+        if isinstance(data, dict):
+            data = ResponseDict(data)
         return cast(T, data)
 
     def perform_with_content(self) -> T:
diff --git a/resend/response.py b/resend/response.py
@@ -0,0 +1,18 @@
+from typing import Any, Dict
+
+
+class ResponseDict(Dict[str, Any]):
+    """Dict subclass that supports attribute-style access.
+
+    This allows SDK responses to be accessed using either dict syntax
+    (response['data']) or attribute syntax (response.data), providing
+    consistency with other Resend SDKs (e.g., Node.js).
+    """
+
+    def __getattr__(self, name: str) -> Any:
+        try:
+            return self[name]
+        except KeyError:
+            raise AttributeError(
+                f"'{type(self).__name__}' object has no attribute '{name}'"
+            )
diff --git a/resend/version.py b/resend/version.py
@@ -1,4 +1,4 @@
-__version__ = "2.20.0"
+__version__ = "2.22.0"
 
 
 def get_version() -> str:
diff --git a/tests/broadcasts_test.py b/tests/broadcasts_test.py
@@ -74,6 +74,33 @@ def test_broadcasts_send(self) -> None:
         broadcast = resend.Broadcasts.send(params)
         assert broadcast["id"] == "49a3999c-0ce1-4ea6-ab68-afcd6dc2e791"
 
+    def test_broadcasts_create_and_send(self) -> None:
+        self.set_mock_json({"id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794"})
+
+        params: resend.Broadcasts.CreateParams = {
+            "audience_id": "78b8d3bc-a55a-45a3-aee6-6ec0a5e13d7e",
+            "from": "hi@example.com",
+            "subject": "Hello, world!",
+            "name": "Python SDK Broadcast",
+            "send": True,
+        }
+        broadcast: resend.Broadcasts.CreateResponse = resend.Broadcasts.create(params)
+        assert broadcast["id"] == "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794"
+
+    def test_broadcasts_create_and_schedule(self) -> None:
+        self.set_mock_json({"id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794"})
+
+        params: resend.Broadcasts.CreateParams = {
+            "audience_id": "78b8d3bc-a55a-45a3-aee6-6ec0a5e13d7e",
+            "from": "hi@example.com",
+            "subject": "Hello, world!",
+            "name": "Python SDK Broadcast",
+            "send": True,
+            "scheduled_at": "2024-12-21T19:32:22.980Z",
+        }
+        broadcast: resend.Broadcasts.CreateResponse = resend.Broadcasts.create(params)
+        assert broadcast["id"] == "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794"
+
     def test_broadcasts_remove(self) -> None:
         self.set_mock_json(
             {
diff --git a/tests/response_test.py b/tests/response_test.py
@@ -0,0 +1,89 @@
+import resend
+from tests.conftest import ResendBaseTest
+
+# flake8: noqa
+
+
+class TestResponseDict(ResendBaseTest):
+
+    def test_list_response_supports_dict_access(self) -> None:
+        self.set_mock_json(
+            {
+                "object": "list",
+                "has_more": False,
+                "data": [
+                    {
+                        "id": "att-1",
+                        "filename": "avatar.png",
+                        "content_type": "image/png",
+                        "content_disposition": "inline",
+                        "size": 1024,
+                    },
+                ],
+            }
+        )
+
+        attachments = resend.Emails.Receiving.Attachments.list(
+            email_id="test-email-id"
+        )
+        assert attachments["object"] == "list"
+        assert attachments["has_more"] is False
+        assert len(attachments["data"]) == 1
+        assert attachments["data"][0]["id"] == "att-1"
+
+    def test_list_response_supports_attribute_access(self) -> None:
+        self.set_mock_json(
+            {
+                "object": "list",
+                "has_more": False,
+                "data": [
+                    {
+                        "id": "att-1",
+                        "filename": "avatar.png",
+                        "content_type": "image/png",
+                        "content_disposition": "inline",
+                        "size": 1024,
+                    },
+                ],
+            }
+        )
+
+        attachments = resend.Emails.Receiving.Attachments.list(
+            email_id="test-email-id"
+        )
+        assert attachments.object == "list"  # type: ignore[attr-defined]
+        assert attachments.has_more is False  # type: ignore[attr-defined]
+        assert len(attachments.data) == 1  # type: ignore[attr-defined]
+        assert attachments.data[0]["id"] == "att-1"  # type: ignore[attr-defined]
+
+    def test_attribute_access_raises_for_missing_key(self) -> None:
+        self.set_mock_json(
+            {
+                "object": "list",
+                "has_more": False,
+                "data": [],
+            }
+        )
+
+        attachments = resend.Emails.Receiving.Attachments.list(
+            email_id="test-email-id"
+        )
+        with self.assertRaises(AttributeError):
+            _ = attachments.nonexistent  # type: ignore[attr-defined]
+
+    def test_single_response_supports_attribute_access(self) -> None:
+        self.set_mock_json(
+            {
+                "id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794",
+            }
+        )
+
+        params: resend.Emails.SendParams = {
+            "from": "from@email.io",
+            "to": ["to@email.io"],
+            "subject": "subject",
+            "html": "<p>Hello</p>",
+        }
+        email = resend.Emails.send(params)
+        assert email["id"] == "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794"
+        assert email.id == "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794"  # type: ignore[attr-defined]

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-FROM python:3.13.7`
	`1`	`+FROM python:3.14.3`
`2`	`2`
`3`	`3`	`RUN pip install --upgrade pip`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-__version__ = "2.20.0"`
	`1`	`+__version__ = "2.22.0"`
`2`	`2`
`3`	`3`
`4`	`4`	`def get_version() -> str:`