alterlab 2.3.0__tar.gz → 2.4.2__tar.gz

{alterlab-2.3.0 → alterlab-2.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alterlab
-Version: 2.3.0
+Version: 2.4.2
 Summary: AlterLab Python SDK
 Author: AlterLab
 Author-email: dev@alterlab.io
@@ -13,6 +13,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Requires-Dist: httpx (>=0.25.2,<0.26.0)
 Requires-Dist: pydantic (>=2.5.0,<3.0.0)
 Requires-Dist: typing_extensions (>=3.7.4)

{alterlab-2.3.0 → alterlab-2.4.2}/alterlab/__init__.py

@@ -33,8 +33,17 @@ For synchronous usage:
     with AlterLabSync(api_key="sk_test_...") as client:
         result = client.scrape("https://example.com")
         print(result['content'])
+
+For a drop-in ``requests`` replacement (zero setup beyond an env var):
+    from alterlab import requests
+
+    response = requests.get("https://example.com")
+    print(response.status_code, response.text)
 """
 
+from alterlab import actions as _actions
+from alterlab import requests_compat as requests
+from alterlab.actions import *  # noqa: F401,F403  (names listed in actions.__all__)
 from alterlab.client import (
     AdvancedOptions,
     AlterLab,
@@ -43,9 +52,23 @@ from alterlab.client import (
     AlterLabSync,
     AlterLabTimeoutError,
     AlterLabValidationError,
+    AuthenticationError,
     CostControls,
+    ForcedRenderHint,
+    InsufficientFundsError,
     JobExpiredError,
+    JobFailedError,
+    RateLimitError,
+    get_error_hint,
+)
+from alterlab import document_types
+from alterlab.document_types import (
+    DocumentBlock,
+    DocumentLink,
+    DocumentMedia,
+    DocumentV1,
 )
+from alterlab.requests_compat import AlterLabHTTPError
 from alterlab.types import (
     ContentImage,
     ContentLink,
@@ -56,7 +79,7 @@ from alterlab.types import (
     SessionValidation,
 )
 
-__version__ = "2.2.0"
+__version__ = "2.4.2"
 __all__ = [
     "AlterLab",
     "AlterLabSync",
@@ -64,9 +87,16 @@ __all__ = [
     "CostControls",
     "AlterLabError",
     "AlterLabAPIError",
+    "AlterLabHTTPError",
     "AlterLabTimeoutError",
     "AlterLabValidationError",
+    "AuthenticationError",
+    "InsufficientFundsError",
+    "RateLimitError",
     "JobExpiredError",
+    "JobFailedError",
+    "ForcedRenderHint",
+    "get_error_hint",
     "SessionIntegration",
     "SessionListResponse",
     "SessionValidation",
@@ -74,4 +104,11 @@ __all__ = [
     "ContentImage",
     "ContentLink",
     "ExtractionMetadata",
+    "document_types",
+    "DocumentV1",
+    "DocumentBlock",
+    "DocumentLink",
+    "DocumentMedia",
+    "requests",
 ]
+__all__ += _actions.__all__

alterlab-2.4.2/alterlab/_failure_backoff.py

@@ -0,0 +1,30 @@
+"""Parsing for the repeat-failure back-off 429 (``error: "repeat_failure_backoff"``).
+
+The API returns this uncharged 429 when the same request failed the same way
+several times in a row. Its ``detail`` extends the canonical rate-limit detail
+with ``consecutive_failures``, ``outcome_class``, ``failure_code`` and ``hint``.
+"""
+
+from typing import Any, Optional, Tuple
+
+
+def parse_failure_backoff_detail(
+    detail: Any,
+) -> Tuple[Optional[int], Optional[str], Optional[str]]:
+    """Return ``(consecutive_failures, outcome_class, failure_code)`` from ``detail``.
+
+    Each value is ``None`` when ``detail`` is not a dict or the field is
+    missing or of the wrong type.
+    """
+    if not isinstance(detail, dict):
+        return None, None, None
+    count = detail.get("consecutive_failures")
+    if not isinstance(count, int) or isinstance(count, bool):
+        count = None
+    outcome_class = detail.get("outcome_class")
+    if not isinstance(outcome_class, str):
+        outcome_class = None
+    failure_code = detail.get("failure_code")
+    if not isinstance(failure_code, str):
+        failure_code = None
+    return count, outcome_class, failure_code