mailerbot 0.1.0__py3-none-any.whl

mailerbot/__init__.py

@@ -0,0 +1,50 @@
+from .client import MailerBot
+from .async_client import AsyncMailerBot
+from .exceptions import (
+    MailerBotError,
+    AuthenticationError,
+    PermissionError,
+    NotFoundError,
+    ValidationError,
+    RateLimitError,
+    ServerError,
+)
+from .models import (
+    Page,
+    Contact, ContactList, AddressValidation, CsvImportResult,
+    Document,
+    Postcard, PostcardTemplate,
+    Mailing, CostCalculation, MailingItemTracking, MailingItemScan,
+    Campaign,
+    DashboardStats, ReportingData,
+    PaymentIntent, SavedCard,
+    QrLink, QrAnalytics,
+    CouponList, CouponCode, CouponImportResult, CouponAvailability,
+    Asset,
+    MergeTag,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    "MailerBot",
+    "AsyncMailerBot",
+    "MailerBotError",
+    "AuthenticationError",
+    "PermissionError",
+    "NotFoundError",
+    "ValidationError",
+    "RateLimitError",
+    "ServerError",
+    "Page",
+    "Contact", "ContactList", "AddressValidation", "CsvImportResult",
+    "Document",
+    "Postcard", "PostcardTemplate",
+    "Mailing", "CostCalculation", "MailingItemTracking", "MailingItemScan",
+    "Campaign",
+    "DashboardStats", "ReportingData",
+    "PaymentIntent", "SavedCard",
+    "QrLink", "QrAnalytics",
+    "CouponList", "CouponCode", "CouponImportResult", "CouponAvailability",
+    "Asset",
+    "MergeTag",
+]

mailerbot/_http.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+import httpx
+from .exceptions import (
+    MailerBotError, AuthenticationError, PermissionError,
+    NotFoundError, ValidationError, RateLimitError, ServerError,
+)
+
+DEFAULT_BASE_URL = "https://api.mailerbot.com/api/v1"
+DEFAULT_TIMEOUT = 30.0
+
+
+def _raise_for_status(response: httpx.Response) -> None:
+    if response.is_success:
+        return
+    try:
+        body = response.json()
+    except Exception:
+        body = {"detail": response.text}
+
+    detail = body.get("detail", str(body))
+    status = response.status_code
+
+    if status == 401:
+        raise AuthenticationError(detail, status_code=status, response=body)
+    if status == 403:
+        raise PermissionError(detail, status_code=status, response=body)
+    if status == 404:
+        raise NotFoundError(detail, status_code=status, response=body)
+    if status == 422:
+        raise ValidationError(detail, status_code=status, response=body)
+    if status == 429:
+        raise RateLimitError(detail, status_code=status, response=body)
+    if status >= 500:
+        raise ServerError(detail, status_code=status, response=body)
+    raise MailerBotError(detail, status_code=status, response=body)
+
+
+def _build_headers(
+    *,
+    api_key: str | None = None,
+    bearer_token: str | None = None,
+) -> dict[str, str]:
+    headers: dict[str, str] = {
+        "Content-Type": "application/json",
+        "Accept": "application/json",
+    }
+    if api_key:
+        headers["X-API-Key"] = api_key
+    elif bearer_token:
+        headers["Authorization"] = f"Bearer {bearer_token}"
+    else:
+        raise ValueError("Either api_key or bearer_token must be provided")
+    return headers

mailerbot/_pagination.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+from typing import Generic, TypeVar, Callable, Iterator, AsyncIterator
+from .models.common import Page
+
+T = TypeVar("T")
+
+
+class PageIterator(Generic[T]):
+    """Sync auto-paginating iterator. Yields individual items across all pages."""
+
+    def __init__(self, fetch: Callable[[int, int], Page[T]], page_size: int = 100):
+        self._fetch = fetch
+        self._page_size = page_size
+
+    def __iter__(self) -> Iterator[T]:
+        page = 1
+        while True:
+            result = self._fetch(page, self._page_size)
+            yield from result.items
+            if page >= result.pages:
+                break
+            page += 1
+
+
+class AsyncPageIterator(Generic[T]):
+    """Async auto-paginating iterator. Yields individual items across all pages."""
+
+    def __init__(self, fetch: Callable[[int, int], object], page_size: int = 100):
+        self._fetch = fetch
+        self._page_size = page_size
+
+    def __aiter__(self) -> AsyncIterator[T]:
+        return self._iterate()
+
+    async def _iterate(self) -> AsyncIterator[T]:
+        page = 1
+        while True:
+            result = await self._fetch(page, self._page_size)
+            for item in result.items:
+                yield item
+            if page >= result.pages:
+                break
+            page += 1