enconvert 0.0.1__py3-none-any.whl

enconvert/__init__.py

@@ -0,0 +1,143 @@
+"""Enconvert — Python SDK for the Enconvert file conversion API."""
+
+from __future__ import annotations
+
+from .client import Enconvert
+from .errors import (
+    APIError,
+    AuthenticationError,
+    EnconvertError,
+    QuotaError,
+    RateLimitError,
+)
+from .formats import IMPLEMENTED_CONVERSIONS, valid_outputs_for
+from .types import (
+    BatchItem,
+    BatchStatus,
+    BatchStatusValue,
+    BatchSubmission,
+    BrowserCookie,
+    ConversionResult,
+    CrawlMode,
+    CssField,
+    CssFieldType,
+    CssSchema,
+    DiscoverMode,
+    DiscoverResult,
+    DistillDiscoverFrom,
+    DistillExtractionTier,
+    DistillItem,
+    DistillResult,
+    FileData,
+    FileInput,
+    HttpBasicAuth,
+    IngestChunkOptions,
+    IngestJob,
+    IngestJobList,
+    IngestJobSummary,
+    IngestMode,
+    IngestStatus,
+    JobStatus,
+    JobStatusValue,
+    LookupCategory,
+    LookupItem,
+    LookupResult,
+    LookupTimeFilter,
+    PdfHeaderFooter,
+    PdfMargins,
+    PdfOptions,
+    PerceiveBatchOutputMode,
+    PerceiveBatchResult,
+    PerceiveBatchStatus,
+    PerceiveCacheMode,
+    PerceiveExtractName,
+    PerceiveExtractionTier,
+    PerceiveOutputName,
+    PerceiveResourceType,
+    PerceiveResult,
+    PerceiveStatus,
+    PerceiveViewport,
+    V2OutputArtifact,
+    V2Tokens,
+    WatchDiffMode,
+    Watcher,
+    WatcherList,
+    WatcherSnapshot,
+    WatcherSnapshotList,
+    WatcherStatus,
+    WatcherSummary,
+    WebhookRetryResult,
+    WebhookSecret,
+)
+from .v2 import EnconvertV2
+
+__version__ = "0.0.1"
+
+__all__ = [
+    "Enconvert",
+    "EnconvertV2",
+    "EnconvertError",
+    "APIError",
+    "AuthenticationError",
+    "QuotaError",
+    "RateLimitError",
+    "IMPLEMENTED_CONVERSIONS",
+    "valid_outputs_for",
+    "BatchItem",
+    "BatchStatus",
+    "BatchStatusValue",
+    "BatchSubmission",
+    "BrowserCookie",
+    "ConversionResult",
+    "CrawlMode",
+    "CssField",
+    "CssFieldType",
+    "CssSchema",
+    "DiscoverMode",
+    "DiscoverResult",
+    "DistillDiscoverFrom",
+    "DistillExtractionTier",
+    "DistillItem",
+    "DistillResult",
+    "FileData",
+    "FileInput",
+    "HttpBasicAuth",
+    "IngestChunkOptions",
+    "IngestJob",
+    "IngestJobList",
+    "IngestJobSummary",
+    "IngestMode",
+    "IngestStatus",
+    "JobStatus",
+    "JobStatusValue",
+    "LookupCategory",
+    "LookupItem",
+    "LookupResult",
+    "LookupTimeFilter",
+    "PdfHeaderFooter",
+    "PdfMargins",
+    "PdfOptions",
+    "PerceiveBatchOutputMode",
+    "PerceiveBatchResult",
+    "PerceiveBatchStatus",
+    "PerceiveCacheMode",
+    "PerceiveExtractName",
+    "PerceiveExtractionTier",
+    "PerceiveOutputName",
+    "PerceiveResourceType",
+    "PerceiveResult",
+    "PerceiveStatus",
+    "PerceiveViewport",
+    "V2OutputArtifact",
+    "V2Tokens",
+    "WatchDiffMode",
+    "Watcher",
+    "WatcherList",
+    "WatcherSnapshot",
+    "WatcherSnapshotList",
+    "WatcherStatus",
+    "WatcherSummary",
+    "WebhookRetryResult",
+    "WebhookSecret",
+    "__version__",
+]

enconvert/_internal.py

@@ -0,0 +1,127 @@
+"""Shared internal helpers used by both the V1 client and the V2 namespace."""
+
+from __future__ import annotations
+
+import uuid
+from typing import Any, Dict, Optional, Protocol
+
+import requests
+
+from .errors import APIError, AuthenticationError, QuotaError, RateLimitError
+from .types import BrowserCookie, HttpBasicAuth, PdfHeaderFooter, PdfMargins, PdfOptions
+
+
+class RequestFunc(Protocol):
+    """Authenticated, timeout-wrapped request bound to the client's base URL."""
+
+    def __call__(
+        self,
+        path: str,
+        method: str,
+        *,
+        json_body: Optional[Dict[str, Any]] = None,
+        data: Optional[Dict[str, Any]] = None,
+        files: Optional[Dict[str, Any]] = None,
+    ) -> requests.Response: ...
+
+
+def raise_for_status(resp: requests.Response) -> None:
+    """Translate an HTTP error response into the SDK's exception hierarchy."""
+    if resp.status_code < 400:
+        return
+    message: str
+    try:
+        body = resp.json()
+        message = (
+            (body.get("detail") if isinstance(body, dict) else None)
+            or (body.get("error") if isinstance(body, dict) else None)
+            or str(body)
+        )
+    except ValueError:
+        message = resp.text or f"HTTP {resp.status_code}"
+    if resp.status_code in (401, 403):
+        raise AuthenticationError(message)
+    if resp.status_code == 402:
+        raise QuotaError(message)
+    if resp.status_code == 429:
+        raise RateLimitError(message)
+    raise APIError(resp.status_code, message)
+
+
+def new_job_id() -> str:
+    """A UUID4 hex string with dashes removed (32 hex chars)."""
+    return uuid.uuid4().hex
+
+
+def serialize_pdf_options(o: PdfOptions) -> Dict[str, Any]:
+    out: Dict[str, Any] = {}
+    if o.page_size is not None:
+        out["page_size"] = o.page_size
+    if o.page_width is not None:
+        out["page_width"] = o.page_width
+    if o.page_height is not None:
+        out["page_height"] = o.page_height
+    if o.orientation is not None:
+        out["orientation"] = o.orientation
+    if o.margins is not None:
+        out["margins"] = serialize_pdf_margins(o.margins)
+    if o.scale is not None:
+        out["scale"] = o.scale
+    if o.grayscale is not None:
+        out["grayscale"] = o.grayscale
+    if o.header is not None:
+        out["header"] = serialize_pdf_header_footer(o.header)
+    if o.footer is not None:
+        out["footer"] = serialize_pdf_header_footer(o.footer)
+    return out
+
+
+def serialize_pdf_margins(m: PdfMargins) -> Dict[str, Any]:
+    out: Dict[str, Any] = {}
+    if m.top is not None:
+        out["top"] = m.top
+    if m.bottom is not None:
+        out["bottom"] = m.bottom
+    if m.left is not None:
+        out["left"] = m.left
+    if m.right is not None:
+        out["right"] = m.right
+    return out
+
+
+def serialize_pdf_header_footer(hf: PdfHeaderFooter) -> Dict[str, Any]:
+    out: Dict[str, Any] = {}
+    if hf.content is not None:
+        out["content"] = hf.content
+    if hf.height is not None:
+        out["height"] = hf.height
+    return out
+
+
+def serialize_http_basic_auth(a: HttpBasicAuth) -> Dict[str, Any]:
+    return {"username": a.username, "password": a.password}
+
+
+def serialize_cookie(c: BrowserCookie) -> Dict[str, Any]:
+    """
+    Serialize a BrowserCookie to the wire shape. Field names here mirror
+    Playwright's cookie schema (which the gateway forwards these to
+    verbatim), so `http_only`/`same_site` map to the camelCase wire keys
+    `httpOnly`/`sameSite` while every other key stays as-is.
+    """
+    out: Dict[str, Any] = {"name": c.name, "value": c.value}
+    if c.domain is not None:
+        out["domain"] = c.domain
+    if c.url is not None:
+        out["url"] = c.url
+    if c.path is not None:
+        out["path"] = c.path
+    if c.expires is not None:
+        out["expires"] = c.expires
+    if c.http_only is not None:
+        out["httpOnly"] = c.http_only
+    if c.secure is not None:
+        out["secure"] = c.secure
+    if c.same_site is not None:
+        out["sameSite"] = c.same_site
+    return out