python: Add list_by_msg_deprecated and `list_by_endpoint_deprecated…

…` methods to `MessageAttempt(A)sync`

Not sure why these _new_ methods have deprecated in their name

python/svix/api/message_attempt.py

@@ -4,7 +4,7 @@
 
 from deprecated import deprecated
 
-from .common import ApiBase, BaseOptions
+from .common import ApiBase, BaseOptions, serialize_params
 from ..internal.openapi_client import models
 
 
@@ -16,7 +16,6 @@
     v1_message_attempt_expunge_content,
     v1_message_attempt_list_attempted_destinations,
     v1_message_attempt_resend,
-    v1_message_attempt_list_by_endpoint_deprecated,
 )
 
 from ..internal.openapi_client.models.list_response_message_attempt_out import (
@@ -108,6 +107,46 @@ class MessageAttemptListAttemptedMessagesOptions(BaseOptions):
     event_types: t.Optional[t.Set[str]] = None
 
 
+@dataclass
+class MessageAttemptListByMsgDeprecatedOptions(BaseOptions):
+    # Limit the number of returned items
+    limit: t.Optional[int] = None
+    # The iterator returned from a prior invocation
+    iterator: t.Optional[str] = None
+    # Filter the attempts based on the attempted endpoint
+    endpoint_id: t.Optional[str] = None
+    # Filter response based on the channel
+    channel: t.Optional[str] = None
+    # Filter response based on the tag
+    tag: t.Optional[str] = None
+    # Filter response based on the status of the attempt: Success (0), Pending (1), Failed (2), or Sending (3)
+    status: t.Optional[models.MessageStatus] = None
+    # Only include items created before a certain date
+    before: t.Optional[datetime] = None
+    # Only include items created after a certain date
+    after: t.Optional[datetime] = None
+    # Filter response based on the HTTP status code
+    status_code_class: t.Optional[models.StatusCodeClass] = None
+    # Filter response based on the event type
+    event_types: t.Optional[t.Set[str]] = None
+
+    def _query_params(self) -> t.Dict[str, str]:
+        return serialize_params(
+            {
+                "limit": self.limit,
+                "iterator": self.iterator,
+                "endpoint_id": self.endpoint_id,
+                "channel": self.channel,
+                "tag": self.tag,
+                "status": self.status,
+                "before": self.before,
+                "after": self.after,
+                "status_code_class": self.status_code_class,
+                "event_types": self.event_types,
+            }
+        )
+
+
 @dataclass
 class MessageAttemptListAttemptedDestinationsOptions(BaseOptions):
     # Limit the number of returned items
@@ -116,6 +155,40 @@ class MessageAttemptListAttemptedDestinationsOptions(BaseOptions):
     iterator: t.Optional[str] = None
 
 
+@dataclass
+class MessageAttemptListByEndpointDeprecatedOptions(BaseOptions):
+    # Limit the number of returned items
+    limit: t.Optional[int] = None
+    # The iterator returned from a prior invocation
+    iterator: t.Optional[str] = None
+    # Filter response based on the channel
+    channel: t.Optional[str] = None
+    # Filter response based on the tag
+    tag: t.Optional[str] = None
+    # Filter response based on the status of the attempt: Success (0), Pending (1), Failed (2), or Sending (3)
+    status: t.Optional[models.MessageStatus] = None
+    # Only include items created before a certain date
+    before: t.Optional[datetime] = None
+    # Only include items created after a certain date
+    after: t.Optional[datetime] = None
+    # Filter response based on the event type
+    event_types: t.Optional[t.Set[str]] = None
+
+    def _query_params(self) -> t.Dict[str, str]:
+        return serialize_params(
+            {
+                "limit": self.limit,
+                "iterator": self.iterator,
+                "channel": self.channel,
+                "tag": self.tag,
+                "status": self.status,
+                "before": self.before,
+                "after": self.after,
+                "event_types": self.event_types,
+            }
+        )
+
+
 @dataclass
 class MessageAttemptResendOptions(BaseOptions):
     idempotency_key: t.Optional[str] = None
@@ -190,6 +263,34 @@ async def list_attempted_messages(
             **options.to_dict(),
         )
 
+    @deprecated
+    async def list_by_msg_deprecated(
+        self,
+        app_id: str,
+        msg_id: str,
+        options: MessageAttemptListByMsgDeprecatedOptions = MessageAttemptListByMsgDeprecatedOptions(),
+    ) -> ListResponseMessageAttemptOut:
+        """Deprecated: Please use "List Attempts by Endpoint" and "List Attempts by Msg" instead.
+
+        Note that by default this endpoint is limited to retrieving 90 days' worth of data
+        relative to now or, if an iterator is provided, 90 days before/after the time indicated
+        by the iterator ID. If you require data beyond those time ranges, you will need to explicitly
+        set the `before` or `after` parameter as appropriate.
+
+        `msg_id`: Use a message id or a message `eventId`"""
+        # ruff: noqa: F841
+        response = await self._request_asyncio(
+            method="get",
+            path="/api/v1/app/{app_id}/msg/{msg_id}/attempt",
+            path_params={
+                "app_id": app_id,
+                "msg_id": msg_id,
+            },
+            query_params=options._query_params(),
+            header_params=options._header_params(),
+        )
+        return ListResponseMessageAttemptOut.from_dict(response.json())
+
     async def get(self, app_id: str, msg_id: str, attempt_id: str) -> MessageAttemptOut:
         """`msg_id`: Use a message id or a message `eventId`"""
         return await v1_message_attempt_get.request_asyncio(
@@ -219,6 +320,41 @@ async def list_attempted_destinations(
             client=self._client, app_id=app_id, msg_id=msg_id, **options.to_dict()
         )
 
+    @deprecated
+    async def list_by_endpoint_deprecated(
+        self,
+        app_id: str,
+        msg_id: str,
+        endpoint_id: str,
+        options: MessageAttemptListByEndpointDeprecatedOptions = MessageAttemptListByEndpointDeprecatedOptions(),
+    ) -> ListResponseMessageAttemptEndpointOut:
+        """DEPRECATED: please use list_attempts with endpoint_id as a query parameter instead.
+
+        List the message attempts for a particular endpoint.
+
+        Returning the endpoint.
+
+        The `before` parameter lets you filter all items created before a certain date and is ignored if an iterator is passed.
+
+        Note that by default this endpoint is limited to retrieving 90 days' worth of data
+        relative to now or, if an iterator is provided, 90 days before/after the time indicated
+        by the iterator ID. If you require data beyond those time ranges, you will need to explicitly
+        set the `before` or `after` parameter as appropriate.
+        """
+        # ruff: noqa: F841
+        response = await self._request_asyncio(
+            method="get",
+            path="/api/v1/app/{app_id}/msg/{msg_id}/endpoint/{endpoint_id}/attempt",
+            path_params={
+                "app_id": app_id,
+                "msg_id": msg_id,
+                "endpoint_id": endpoint_id,
+            },
+            query_params=options._query_params(),
+            header_params=options._header_params(),
+        )
+        return ListResponseMessageAttemptEndpointOut.from_dict(response.json())
+
     async def resend(
         self,
         app_id: str,
@@ -295,6 +431,34 @@ def list_attempted_messages(
             **options.to_dict(),
         )
 
+    @deprecated
+    def list_by_msg_deprecated(
+        self,
+        app_id: str,
+        msg_id: str,
+        options: MessageAttemptListByMsgDeprecatedOptions = MessageAttemptListByMsgDeprecatedOptions(),
+    ) -> ListResponseMessageAttemptOut:
+        """Deprecated: Please use "List Attempts by Endpoint" and "List Attempts by Msg" instead.
+
+        Note that by default this endpoint is limited to retrieving 90 days' worth of data
+        relative to now or, if an iterator is provided, 90 days before/after the time indicated
+        by the iterator ID. If you require data beyond those time ranges, you will need to explicitly
+        set the `before` or `after` parameter as appropriate.
+
+        `msg_id`: Use a message id or a message `eventId`"""
+        # ruff: noqa: F841
+        response = self._request_sync(
+            method="get",
+            path="/api/v1/app/{app_id}/msg/{msg_id}/attempt",
+            path_params={
+                "app_id": app_id,
+                "msg_id": msg_id,
+            },
+            query_params=options._query_params(),
+            header_params=options._header_params(),
+        )
+        return ListResponseMessageAttemptOut.from_dict(response.json())
+
     def get(self, app_id: str, msg_id: str, attempt_id: str) -> MessageAttemptOut:
         """`msg_id`: Use a message id or a message `eventId`"""
         return v1_message_attempt_get.request_sync(
@@ -324,6 +488,41 @@ def list_attempted_destinations(
             client=self._client, app_id=app_id, msg_id=msg_id, **options.to_dict()
         )
 
+    @deprecated
+    def list_by_endpoint_deprecated(
+        self,
+        app_id: str,
+        msg_id: str,
+        endpoint_id: str,
+        options: MessageAttemptListByEndpointDeprecatedOptions = MessageAttemptListByEndpointDeprecatedOptions(),
+    ) -> ListResponseMessageAttemptEndpointOut:
+        """DEPRECATED: please use list_attempts with endpoint_id as a query parameter instead.
+
+        List the message attempts for a particular endpoint.
+
+        Returning the endpoint.
+
+        The `before` parameter lets you filter all items created before a certain date and is ignored if an iterator is passed.
+
+        Note that by default this endpoint is limited to retrieving 90 days' worth of data
+        relative to now or, if an iterator is provided, 90 days before/after the time indicated
+        by the iterator ID. If you require data beyond those time ranges, you will need to explicitly
+        set the `before` or `after` parameter as appropriate.
+        """
+        # ruff: noqa: F841
+        response = self._request_sync(
+            method="get",
+            path="/api/v1/app/{app_id}/msg/{msg_id}/endpoint/{endpoint_id}/attempt",
+            path_params={
+                "app_id": app_id,
+                "msg_id": msg_id,
+                "endpoint_id": endpoint_id,
+            },
+            query_params=options._query_params(),
+            header_params=options._header_params(),
+        )
+        return ListResponseMessageAttemptEndpointOut.from_dict(response.json())
+
     def resend(
         self,
         app_id: str,