svc-infra 0.1.706__py3-none-any.whl → 1.1.0__py3-none-any.whl

svc_infra/webhooks/add.py

@@ -19,7 +19,7 @@ import json
 import logging
 import os
 from collections.abc import Callable, Iterable, Mapping
-from datetime import datetime, timezone
+from datetime import UTC, datetime
 from typing import Any, Protocol, TypeGuard, TypeVar, cast
 
 from fastapi import FastAPI
@@ -59,7 +59,7 @@ class RedisOutboxStore(OutboxStore):
     for environments where a fully fledged SQL implementation is unavailable.
     """
 
-    def __init__(self, client: "Redis", *, prefix: str = "webhooks:outbox"):
+    def __init__(self, client: Redis, *, prefix: str = "webhooks:outbox"):
         if Redis is None:  # pragma: no cover - defensive guard
             raise RuntimeError("redis-py is required for RedisOutboxStore")
         self._client = client
@@ -79,13 +79,13 @@ class RedisOutboxStore(OutboxStore):
 
     # Protocol methods --------------------------------------------------
     def enqueue(self, topic: str, payload: dict[str, Any]) -> OutboxMessage:
-        incr_result = cast(Any, self._client.incr(self._seq_key))
+        incr_result = cast("Any", self._client.incr(self._seq_key))
         # Redis incr always returns an int for the sync client. Be defensive for mocks.
         try:
             msg_id = int(incr_result)
         except (TypeError, ValueError):
             msg_id = 0
-        created_at = datetime.now(timezone.utc)
+        created_at = datetime.now(UTC)
         record: dict[str, str] = {
             "id": str(msg_id),
             "topic": topic,
@@ -96,29 +96,21 @@ class RedisOutboxStore(OutboxStore):
         }
         self._client.hset(self._msg_key(msg_id), mapping=record)
         self._client.rpush(self._queue_key, msg_id)
-        return OutboxMessage(
-            id=msg_id, topic=topic, payload=payload, created_at=created_at
-        )
+        return OutboxMessage(id=msg_id, topic=topic, payload=payload, created_at=created_at)
 
     def fetch_next(self, topics: Iterable[str] | None = None) -> OutboxMessage | None:
         allowed = set(topics) if topics else None
-        ids = cast(list[Any], self._client.lrange(self._queue_key, 0, -1))
+        ids = cast("list[Any]", self._client.lrange(self._queue_key, 0, -1))
         for raw_id in ids:
-            raw_id_str = (
-                raw_id.decode()
-                if isinstance(raw_id, (bytes, bytearray))
-                else str(raw_id)
-            )
+            raw_id_str = raw_id.decode() if isinstance(raw_id, (bytes, bytearray)) else str(raw_id)
             msg_id = int(raw_id_str)
-            msg = cast(dict[Any, Any], self._client.hgetall(self._msg_key(msg_id)))
+            msg = cast("dict[Any, Any]", self._client.hgetall(self._msg_key(msg_id)))
             if not msg:
                 continue
             topic = msg.get(b"topic")
             if topic is None:
                 continue
-            topic_str = (
-                topic.decode() if isinstance(topic, (bytes, bytearray)) else str(topic)
-            )
+            topic_str = topic.decode() if isinstance(topic, (bytes, bytearray)) else str(topic)
             if allowed is not None and topic_str not in allowed:
                 continue
             attempts = int(msg.get(b"attempts", 0))
@@ -142,7 +134,7 @@ class RedisOutboxStore(OutboxStore):
                     else str(created_raw)
                 )
                 if created_raw
-                else datetime.now(timezone.utc)
+                else datetime.now(UTC)
             )
             return OutboxMessage(
                 id=msg_id,
@@ -157,7 +149,7 @@ class RedisOutboxStore(OutboxStore):
         key = self._msg_key(msg_id)
         if not self._client.exists(key):
             return
-        self._client.hset(key, "processed_at", datetime.now(timezone.utc).isoformat())
+        self._client.hset(key, "processed_at", datetime.now(UTC).isoformat())
 
     def mark_failed(self, msg_id: int) -> None:
         key = self._msg_key(msg_id)
@@ -167,7 +159,7 @@ class RedisOutboxStore(OutboxStore):
 class RedisInboxStore(InboxStore):
     """Lightweight Redis dedupe store for webhook deliveries."""
 
-    def __init__(self, client: "Redis", *, prefix: str = "webhooks:inbox"):
+    def __init__(self, client: Redis, *, prefix: str = "webhooks:inbox"):
         if Redis is None:  # pragma: no cover - defensive guard
             raise RuntimeError("redis-py is required for RedisInboxStore")
         self._client = client
@@ -191,17 +183,15 @@ def _is_factory(obj: Any) -> TypeGuard[Callable[[], Any]]:
     return callable(obj) and not isinstance(obj, (str, bytes, bytearray))
 
 
-def _resolve_value(
-    value: T_co | _Factory[T_co] | None, default_factory: _Factory[T_co]
-) -> T_co:
+def _resolve_value(value: T_co | _Factory[T_co] | None, default_factory: _Factory[T_co]) -> T_co:
     if value is None:
         return default_factory()
     if _is_factory(value):
-        return cast(T_co, value())
-    return cast(T_co, value)
+        return cast("T_co", value())
+    return cast("T_co", value)
 
 
-def _build_redis_client(env: Mapping[str, str]) -> "Redis" | None:
+def _build_redis_client(env: Mapping[str, str]) -> Redis | None:
     if Redis is None:
         logger.warning(
             "Redis backend requested but redis-py is not installed; falling back to in-memory stores"
@@ -331,9 +321,7 @@ def add_webhooks(
         )
         app.state.webhooks_delivery_handler = handler
     elif scheduler is not None and schedule_tick:
-        logger.warning(
-            "Scheduler provided without queue; skipping outbox tick registration"
-        )
+        logger.warning("Scheduler provided without queue; skipping outbox tick registration")
 
 
 __all__ = ["add_webhooks"]

svc_infra/webhooks/encryption.py

@@ -75,7 +75,7 @@ def encrypt_secret(plaintext: str) -> str:
         return plaintext
 
     encrypted = fernet.encrypt(plaintext.encode())
-    return _ENCRYPTED_PREFIX + cast(str, encrypted.decode())
+    return _ENCRYPTED_PREFIX + cast("str", encrypted.decode())
 
 
 def decrypt_secret(ciphertext: str) -> str:
@@ -107,7 +107,7 @@ def decrypt_secret(ciphertext: str) -> str:
         return ciphertext
 
     encrypted = ciphertext[len(_ENCRYPTED_PREFIX) :].encode()
-    return cast(str, fernet.decrypt(encrypted).decode())
+    return cast("str", fernet.decrypt(encrypted).decode())
 
 
 def is_encrypted(value: str) -> bool:

svc_infra/webhooks/fastapi.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import Callable, Sequence
+from collections.abc import Callable, Sequence
 
 from fastapi import HTTPException, Request, status
 
@@ -21,9 +21,7 @@ def require_signature(
         try:
             body = await request.json()
         except Exception:
-            raise HTTPException(
-                status_code=status.HTTP_400_BAD_REQUEST, detail="invalid JSON body"
-            )
+            raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="invalid JSON body")
         secrets = secrets_provider()
         ok = False
         if isinstance(secrets, str):

svc_infra/webhooks/router.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import Any, Dict
+from typing import Any
 
 from fastapi import APIRouter, Depends, HTTPException
 
@@ -30,7 +30,7 @@ def get_service(
 
 @router.post("/subscriptions")
 def add_subscription(
-    body: Dict[str, Any],
+    body: dict[str, Any],
     subs: InMemoryWebhookSubscriptions = Depends(get_subs),
 ):
     topic = body.get("topic")
@@ -44,7 +44,7 @@ def add_subscription(
 
 @router.post("/test-fire")
 def test_fire(
-    body: Dict[str, Any],
+    body: dict[str, Any],
     svc: WebhookService = Depends(get_service),
 ):
     topic = body.get("topic")

svc_infra/webhooks/service.py

@@ -1,8 +1,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass, field
-from datetime import datetime, timezone
-from typing import Dict, List
+from datetime import UTC, datetime
 from uuid import uuid4
 
 from svc_infra.db.outbox import OutboxStore
@@ -19,7 +18,7 @@ class WebhookSubscription:
 
 class InMemoryWebhookSubscriptions:
     def __init__(self):
-        self._subs: Dict[str, List[WebhookSubscription]] = {}
+        self._subs: dict[str, list[WebhookSubscription]] = {}
 
     def add(self, topic: str, url: str, secret: str) -> None:
         # Upsert semantics per (topic, url): if a subscription already exists
@@ -33,7 +32,7 @@ class InMemoryWebhookSubscriptions:
                 return
         lst.append(WebhookSubscription(topic, url, secret))
 
-    def get_for_topic(self, topic: str) -> List[WebhookSubscription]:
+    def get_for_topic(self, topic: str) -> list[WebhookSubscription]:
         return list(self._subs.get(topic, []))
 
 
@@ -42,8 +41,8 @@ class WebhookService:
         self._outbox = outbox
         self._subs = subs
 
-    def publish(self, topic: str, payload: Dict, *, version: int = 1) -> int:
-        created_at = datetime.now(timezone.utc).isoformat()
+    def publish(self, topic: str, payload: dict, *, version: int = 1) -> int:
+        created_at = datetime.now(UTC).isoformat()
         base_event = {
             "topic": topic,
             "payload": payload,

svc_infra/webhooks/signing.py

@@ -4,21 +4,21 @@ import hashlib
 import hmac
 import json
 import logging
-from typing import Dict, Iterable
+from collections.abc import Iterable
 
 logger = logging.getLogger(__name__)
 
 
-def canonical_body(payload: Dict) -> bytes:
+def canonical_body(payload: dict) -> bytes:
     return json.dumps(payload, separators=(",", ":"), sort_keys=True).encode()
 
 
-def sign(secret: str, payload: Dict) -> str:
+def sign(secret: str, payload: dict) -> str:
     body = canonical_body(payload)
     return hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
 
 
-def verify(secret: str, payload: Dict, signature: str) -> bool:
+def verify(secret: str, payload: dict, signature: str) -> bool:
     expected = sign(secret, payload)
     try:
         return hmac.compare_digest(expected, signature)
@@ -27,7 +27,7 @@ def verify(secret: str, payload: Dict, signature: str) -> bool:
         return False
 
 
-def verify_any(secrets: Iterable[str], payload: Dict, signature: str) -> bool:
+def verify_any(secrets: Iterable[str], payload: dict, signature: str) -> bool:
     for s in secrets:
         if verify(s, payload, signature):
             return True

svc_infra/websocket/add.py

@@ -116,10 +116,9 @@ def get_ws_manager(app_or_request: FastAPI | Request) -> ConnectionManager:
     manager = getattr(app.state, _WS_MANAGER_ATTR, None)
     if manager is None:
         raise RuntimeError(
-            "WebSocket manager not found. "
-            "Did you forget to call add_websocket_manager(app)?"
+            "WebSocket manager not found. Did you forget to call add_websocket_manager(app)?"
         )
-    return cast(ConnectionManager, manager)
+    return cast("ConnectionManager", manager)
 
 
 def get_ws_manager_dependency(request: Request) -> ConnectionManager:

svc_infra/websocket/client.py

@@ -18,8 +18,9 @@ from __future__ import annotations
 
 import json
 import logging
+from collections.abc import AsyncIterator
 from contextlib import asynccontextmanager
-from typing import TYPE_CHECKING, Any, AsyncIterator
+from typing import TYPE_CHECKING, Any
 
 from websockets.asyncio.client import connect
 from websockets.exceptions import ConnectionClosed, ConnectionClosedOK
@@ -73,7 +74,7 @@ class WebSocketClient:
         self._connection: ClientConnection | None = None
         self._closed = False
 
-    async def __aenter__(self) -> "WebSocketClient":
+    async def __aenter__(self) -> WebSocketClient:
         await self.connect()
         return self
 

svc_infra/websocket/config.py

@@ -27,20 +27,14 @@ class WebSocketConfig(BaseSettings):
     model_config = SettingsConfigDict(env_prefix="WS_")
 
     # Connection settings
-    open_timeout: float = Field(
-        default=10.0, description="Connection timeout in seconds"
-    )
-    close_timeout: float = Field(
-        default=10.0, description="Close handshake timeout in seconds"
-    )
+    open_timeout: float = Field(default=10.0, description="Connection timeout in seconds")
+    close_timeout: float = Field(default=10.0, description="Close handshake timeout in seconds")
 
     # Keepalive (ping/pong)
     ping_interval: float | None = Field(
         default=20.0, description="Ping interval in seconds (None to disable)"
     )
-    ping_timeout: float | None = Field(
-        default=20.0, description="Pong response timeout in seconds"
-    )
+    ping_timeout: float | None = Field(default=20.0, description="Pong response timeout in seconds")
 
     # Message limits
     max_message_size: int = Field(
@@ -49,18 +43,12 @@ class WebSocketConfig(BaseSettings):
     max_queue_size: int = Field(default=16, description="Max queued messages")
 
     # Reconnection policy
-    reconnect_enabled: bool = Field(
-        default=True, description="Enable auto-reconnection"
-    )
+    reconnect_enabled: bool = Field(default=True, description="Enable auto-reconnection")
     reconnect_max_attempts: int = Field(
         default=5, description="Max reconnect attempts (0=infinite)"
     )
-    reconnect_backoff_base: float = Field(
-        default=1.0, description="Base backoff in seconds"
-    )
-    reconnect_backoff_max: float = Field(
-        default=60.0, description="Max backoff in seconds"
-    )
+    reconnect_backoff_base: float = Field(default=1.0, description="Base backoff in seconds")
+    reconnect_backoff_max: float = Field(default=60.0, description="Max backoff in seconds")
     reconnect_jitter: float = Field(default=0.1, description="Jitter factor (0-1)")
 
 

svc_infra/websocket/manager.py

@@ -27,8 +27,9 @@ import asyncio
 import logging
 import uuid
 from collections import defaultdict
-from datetime import datetime, timezone
-from typing import TYPE_CHECKING, Any, Awaitable, Callable
+from collections.abc import Awaitable, Callable
+from datetime import UTC, datetime
+from typing import TYPE_CHECKING, Any
 
 from .models import ConnectionInfo
 
@@ -64,8 +65,8 @@ class ConnectionManager:
     def __init__(self) -> None:
         self._lock = asyncio.Lock()
         # user_id -> list of (connection_id, WebSocket, ConnectionInfo)
-        self._connections: dict[str, list[tuple[str, WebSocket, ConnectionInfo]]] = (
-            defaultdict(list)
+        self._connections: dict[str, list[tuple[str, WebSocket, ConnectionInfo]]] = defaultdict(
+            list
         )
         # room -> set of user_ids
         self._rooms: dict[str, set[str]] = defaultdict(set)
@@ -97,7 +98,7 @@ class ConnectionManager:
             await websocket.accept()
 
         connection_id = str(uuid.uuid4())
-        now = datetime.now(timezone.utc)
+        now = datetime.now(UTC)
         info = ConnectionInfo(
             user_id=user_id,
             connection_id=connection_id,
@@ -121,9 +122,7 @@ class ConnectionManager:
 
         return connection_id
 
-    async def disconnect(
-        self, user_id: str, websocket: WebSocket | None = None
-    ) -> None:
+    async def disconnect(self, user_id: str, websocket: WebSocket | None = None) -> None:
         """
         Remove connection(s) for a user.
 
@@ -186,7 +185,7 @@ class ConnectionManager:
             try:
                 await self._send_message(ws, message)
                 # Update last activity
-                info.last_activity = datetime.now(timezone.utc)
+                info.last_activity = datetime.now(UTC)
                 sent += 1
             except Exception as e:
                 logger.debug("Failed to send to user %s: %s", user_id, e)
@@ -216,7 +215,7 @@ class ConnectionManager:
         for uid, ws, info in all_connections:
             try:
                 await self._send_message(ws, message)
-                info.last_activity = datetime.now(timezone.utc)
+                info.last_activity = datetime.now(UTC)
                 sent += 1
             except Exception as e:
                 logger.debug("Failed to broadcast to user %s: %s", uid, e)

{svc_infra-0.1.706.dist-info → svc_infra-1.1.0.dist-info}/METADATA

@@ -1,13 +1,13 @@
 Metadata-Version: 2.3
 Name: svc-infra
-Version: 0.1.706
+Version: 1.1.0
 Summary: Infrastructure for building and deploying prod-ready services
 License: MIT
 Keywords: fastapi,sqlalchemy,alembic,auth,infra,async,pydantic
 Author: Ali Khatami
 Author-email: aliikhatami94@gmail.com
 Requires-Python: >=3.11,<4.0
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Framework :: FastAPI
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -86,13 +86,19 @@ Description-Content-Type: text/markdown
 
 # svc-infra
 
-### Production-ready FastAPI infrastructure in one import
+[![v1.0.0](https://img.shields.io/badge/version-1.0.0-green.svg)](CHANGELOG.md)
+[![CI](https://github.com/nfraxlab/svc-infra/actions/workflows/ci.yml/badge.svg)](https://github.com/nfraxlab/svc-infra/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/svc-infra.svg)](https://pypi.org/project/svc-infra/)
+[![Python](https://img.shields.io/pypi/pyversions/svc-infra.svg)](https://pypi.org/project/svc-infra/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Downloads](https://img.shields.io/pypi/dm/svc-infra.svg)](https://pypi.org/project/svc-infra/)
+[![codecov](https://codecov.io/gh/nfraxlab/svc-infra/branch/main/graph/badge.svg)](https://codecov.io/gh/nfraxlab/svc-infra)
 
-[![PyPI](https://img.shields.io/pypi/v/svc-infra.svg)](https://pypi.org/project/svc-infra/) [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Downloads](https://static.pepy.tech/badge/svc-infra/month)](https://pepy.tech/project/svc-infra)
+### Production-ready FastAPI infrastructure in one import
 
 **Stop rebuilding auth, billing, webhooks, and background jobs for every project.**
 
-[Documentation](docs/) · [Examples](examples/) · [PyPI](https://pypi.org/project/svc-infra/)
+[Documentation](docs/) · [Examples](examples/) · [PyPI](https://pypi.org/project/svc-infra/) · [Changelog](CHANGELOG.md)
 
 </div>