chore(deps-dev): bump sphinx from 7.1.2 to 8.0.2

faster_sam/dependencies/events.py

@@ -1,8 +1,13 @@
+import hashlib
 from datetime import datetime, timezone
-from typing import Any, Dict
+from typing import Any, Callable, Dict, Type
 from uuid import uuid4
+import uuid
 
 from fastapi import Request
+from pydantic import BaseModel
+
+from faster_sam.protocols import IntoSQSInfo
 
 
 async def apigateway_proxy(request: Request) -> Dict[str, Any]:
@@ -31,3 +36,34 @@ async def apigateway_proxy(request: Request) -> Dict[str, Any]:
         },
     }
     return event
+
+
+def sqs(schema: Type[BaseModel]) -> Callable[[BaseModel], Dict[str, Any]]:
+    def dep(message: schema) -> Dict[str, Any]:
+        assert isinstance(message, IntoSQSInfo)
+
+        info = message.into()
+        event = {
+            "Records": [
+                {
+                    "messageId": info.id,
+                    "receiptHandle": str(uuid.uuid4()),
+                    "body": info.body,
+                    "attributes": {
+                        "ApproximateReceiveCount": info.receive_count,
+                        "SentTimestamp": info.sent_timestamp,
+                        "SenderId": str(uuid.uuid4()),
+                        "ApproximateFirstReceiveTimestamp": info.sent_timestamp,
+                    },
+                    "messageAttributes": info.message_attributes,
+                    "md5OfBody": hashlib.md5(info.body.encode()).hexdigest(),
+                    "eventSource": "aws:sqs",
+                    "eventSourceARN": info.source_arn,
+                    "awsRegion": None,
+                },
+            ]
+        }
+
+        return event
+
+    return dep

faster_sam/protocols.py

@@ -0,0 +1,8 @@
+from typing import Protocol, runtime_checkable
+
+from faster_sam.schemas import SQSInfo
+
+
+@runtime_checkable
+class IntoSQSInfo(Protocol):
+    def into(self) -> SQSInfo: ...

faster_sam/schemas.py

@@ -0,0 +1,41 @@
+from datetime import datetime
+from typing import Dict, Optional
+from pydantic import BaseModel, Base64UrlStr, Field
+
+
+class SQSInfo(BaseModel):
+    id: str
+    body: str
+    receive_count: int
+    sent_timestamp: int
+    source_arn: str
+    message_attributes: Optional[Dict[str, str]] = Field(default=None)
+
+
+class PubSubMessage(BaseModel):
+    data: Base64UrlStr
+    messageId: str
+    publishTime: datetime
+    attributes: Optional[Dict[str, str]] = Field(default=None)
+
+
+class PubSubEnvelope(BaseModel):
+    message: PubSubMessage
+    subscription: str
+    deliveryAttempt: int
+
+    def into(self) -> SQSInfo:
+        milliseconds = 1000
+
+        publish_time = int(self.message.publishTime.timestamp() * milliseconds)
+
+        topic_name = self.subscription.rsplit("/", maxsplit=1)[-1]
+        source_arn = f"arn:aws:sqs:::{topic_name}"
+        return SQSInfo(
+            id=self.message.messageId,
+            body=self.message.data,
+            receive_count=self.deliveryAttempt,
+            sent_timestamp=publish_time,
+            message_attributes=self.message.attributes,
+            source_arn=source_arn,
+        )

requirements-dev.txt

@@ -3,7 +3,7 @@ black==24.4.2
 flake8==7.1.0
 build==1.2.1
 twine==5.1.1
-sphinx==7.1.2
+sphinx==8.0.2
 boto3==1.34.144
 requests==2.32.3
 redis==5.0.7

tests/test_dependencies_events.py

@@ -1,8 +1,13 @@
+import hashlib
 import unittest
+from datetime import datetime, timezone
+from unittest.mock import patch
+import uuid
 
 from fastapi import FastAPI, Request
 
 from faster_sam.dependencies import events
+from faster_sam.schemas import PubSubEnvelope
 
 
 def build_request():
@@ -50,3 +55,49 @@ async def test_event(self):
         self.assertEqual(event["requestContext"]["path"], "/ping/pong")
         self.assertEqual(event["requestContext"]["httpMethod"], "GET")
         self.assertEqual(event["requestContext"]["protocol"], "HTTP/1.1")
+
+
+class TestSQS(unittest.IsolatedAsyncioTestCase):
+    @patch("uuid.uuid4", return_value=uuid.UUID("12345678123456781234567812345678"))
+    async def test_event(self, mock_uuid):
+        data = {
+            "message": {
+                "data": "aGVsbG8=",
+                "attributes": {"foo": "bar"},
+                "messageId": "10519041647717348",
+                "publishTime": "2024-02-22T15:45:31.346Z",
+            },
+            "subscription": "projects/foo/subscriptions/bar",
+            "deliveryAttempt": 1,
+        }
+
+        pubsub_envelope = PubSubEnvelope(**data)
+
+        SQSEvent = events.sqs(PubSubEnvelope)
+        event = SQSEvent(pubsub_envelope)
+
+        parsed_datetime = datetime.strptime("2024-02-22T15:45:31.346Z", "%Y-%m-%dT%H:%M:%S.%fZ")
+        parsed_datetime_utc = parsed_datetime.replace(tzinfo=timezone.utc)
+        timestamp_milliseconds = int(parsed_datetime_utc.timestamp() * 1000)
+
+        self.assertIsInstance(event, dict)
+        record = event["Records"][0]
+        self.assertEqual(record["messageId"], "10519041647717348")
+        self.assertEqual(record["body"], "hello")
+        self.assertEqual(record["attributes"]["ApproximateReceiveCount"], 1)
+        self.assertEqual(
+            record["attributes"]["SentTimestamp"],
+            timestamp_milliseconds,
+        )
+        self.assertEqual(record["attributes"]["SenderId"], "12345678-1234-5678-1234-567812345678")
+        self.assertEqual(
+            record["attributes"]["ApproximateFirstReceiveTimestamp"],
+            timestamp_milliseconds,
+        )
+        self.assertEqual(record["messageAttributes"], {"foo": "bar"})
+        self.assertEqual(
+            record["md5OfBody"],
+            hashlib.md5("hello".encode("utf-8")).hexdigest(),
+        )
+        self.assertEqual(record["eventSource"], "aws:sqs")
+        self.assertEqual(record["eventSourceARN"], "arn:aws:sqs:::bar")