lex-api-mx-client 0.2.0__tar.gz → 0.3.0__tar.gz

{lex_api_mx_client-0.2.0 → lex_api_mx_client-0.3.0}/.gitignore

@@ -90,6 +90,8 @@ supabase/.branches/
 # ----------------------------------------------------------------------
 .vscode/
 .idea/
+# Capturas y registros del plugin de Playwright de Claude Code
+.playwright-mcp/
 *.swp
 *.swo
 .DS_Store

{lex_api_mx_client-0.2.0 → lex_api_mx_client-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: lex-api-mx-client
-Version: 0.2.0
+Version: 0.3.0
 Summary: Cliente Python de Lex API MX: legislación federal mexicana vigente con fuente, checksum y vigencia
 Project-URL: Homepage, https://lexapi.mx
 Project-URL: Documentation, https://lexapi.mx/docs
@@ -50,7 +50,14 @@ with LexApiClient(base_url="https://api.lexapi.mx", api_key="tu_clave") as lex:
 
 `resolve` y `map` aceptan `idempotency_key`: un reintento con la misma clave no
 se cobra dos veces. Los errores HTTP se lanzan como `LexApiError` con
-`status_code`, `detail`, `request_id` y `body`; `402` significa saldo agotado.
+`status_code`, `detail`, `request_id`, `body` y `retry_after`; `402` significa
+saldo agotado.
+
+Un `429` (límite de peticiones) no se cobra: el cliente espera los segundos de
+`Retry-After` y reintenta solo, hasta `max_retries=2` veces, cuando la espera no
+pasa de `max_retry_wait=30.0` segundos. Una espera mayor, como el límite diario
+del plan gratuito, se lanza enseguida como `LexApiError` con `retry_after`.
+`LexApiClient(..., max_retries=0)` desactiva los reintentos.
 
 Para obtener una clave, crea tu cuenta en
 [lexapi.mx/#cuenta](https://lexapi.mx/#cuenta). Referencia de la API:

{lex_api_mx_client-0.2.0 → lex_api_mx_client-0.3.0}/README.md

@@ -26,7 +26,14 @@ with LexApiClient(base_url="https://api.lexapi.mx", api_key="tu_clave") as lex:
 
 `resolve` y `map` aceptan `idempotency_key`: un reintento con la misma clave no
 se cobra dos veces. Los errores HTTP se lanzan como `LexApiError` con
-`status_code`, `detail`, `request_id` y `body`; `402` significa saldo agotado.
+`status_code`, `detail`, `request_id`, `body` y `retry_after`; `402` significa
+saldo agotado.
+
+Un `429` (límite de peticiones) no se cobra: el cliente espera los segundos de
+`Retry-After` y reintenta solo, hasta `max_retries=2` veces, cuando la espera no
+pasa de `max_retry_wait=30.0` segundos. Una espera mayor, como el límite diario
+del plan gratuito, se lanza enseguida como `LexApiError` con `retry_after`.
+`LexApiClient(..., max_retries=0)` desactiva los reintentos.
 
 Para obtener una clave, crea tu cuenta en
 [lexapi.mx/#cuenta](https://lexapi.mx/#cuenta). Referencia de la API:

{lex_api_mx_client-0.2.0 → lex_api_mx_client-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lex-api-mx-client"
-version = "0.2.0"
+version = "0.3.0"
 description = "Cliente Python de Lex API MX: legislación federal mexicana vigente con fuente, checksum y vigencia"
 readme = "README.md"
 license = "MIT"

{lex_api_mx_client-0.2.0 → lex_api_mx_client-0.3.0}/src/lex_api_mx/__init__.py

@@ -1,4 +1,4 @@
 from .client import LexApiClient, LexApiError
 
 __all__ = ["LexApiClient", "LexApiError"]
-__version__ = "0.2.0"
+__version__ = "0.3.0"

{lex_api_mx_client-0.2.0 → lex_api_mx_client-0.3.0}/src/lex_api_mx/client.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import time
 from datetime import date
 from typing import Any
 from urllib.parse import quote
@@ -14,17 +15,34 @@ class LexApiError(RuntimeError):
         message: str,
         request_id: str | None = None,
         body: Any = None,
+        retry_after: float | None = None,
     ):
         self.status_code = status_code
         self.request_id = request_id
         self.detail = message
         self.body = body
+        self.retry_after = retry_after
         suffix = f" request_id={request_id}" if request_id else ""
         super().__init__(f"Lex API MX returned {status_code}: {message}{suffix}")
 
 
+def _retry_after_seconds(response: httpx.Response) -> float | None:
+    """Segundos de `Retry-After`; la API los envía en cada 429 (no usa fechas HTTP)."""
+    try:
+        seconds = float(response.headers.get("Retry-After", ""))
+    except ValueError:
+        return None
+    return seconds if seconds >= 0 else None
+
+
 class LexApiClient:
-    """Synchronous client for the stable Lex API MX integration surface."""
+    """Synchronous client for the stable Lex API MX integration surface.
+
+    Un 429 con `Retry-After` de hasta `max_retry_wait` segundos se reintenta solo, hasta
+    `max_retries` veces: la API rechaza la petición antes de procesarla y no la cobra. Una
+    espera mayor (el límite diario del plan gratuito) se lanza enseguida como `LexApiError`
+    con `retry_after`.
+    """
 
     def __init__(
         self,
@@ -34,11 +52,17 @@ class LexApiClient:
         timeout: float = 30.0,
         transport: httpx.BaseTransport | None = None,
         user_agent: str | None = None,
+        max_retries: int = 2,
+        max_retry_wait: float = 30.0,
     ) -> None:
         if not base_url.strip():
             raise ValueError("base_url is required")
         if not api_key.strip():
             raise ValueError("api_key is required")
+        if max_retries < 0:
+            raise ValueError("max_retries must be >= 0")
+        self._max_retries = max_retries
+        self._max_retry_wait = max_retry_wait
         if user_agent is None:
             from . import __version__  # importación tardía: el paquete importa este módulo
 
@@ -171,12 +195,28 @@ class LexApiClient:
         idempotency_key: str | None = None,
     ) -> dict[str, Any]:
         headers = {"Idempotency-Key": idempotency_key} if idempotency_key else None
-        response = self._client.request(method, path, json=json, params=params, headers=headers)
+        retries = 0
+        while True:
+            response = self._client.request(method, path, json=json, params=params, headers=headers)
+            retry_after = _retry_after_seconds(response) if response.status_code == 429 else None
+            if (
+                retry_after is None
+                or retries >= self._max_retries
+                or retry_after > self._max_retry_wait
+            ):
+                break
+            retries += 1
+            time.sleep(retry_after)
         if response.is_error:
             body: Any = None
             try:
                 body = response.json()
-                message = str(body.get("detail", body)) if isinstance(body, dict) else str(body)
+                detail = body.get("detail", body) if isinstance(body, dict) else body
+                # Los 402 y 403 de plan traen {"code", "message", "upgrade_url"}.
+                if isinstance(detail, dict) and detail.get("message"):
+                    message = str(detail["message"])
+                else:
+                    message = str(detail)
             except ValueError:
                 message = response.text or response.reason_phrase
             raise LexApiError(
@@ -184,6 +224,7 @@ class LexApiClient:
                 message,
                 response.headers.get("X-Request-ID"),
                 body,
+                retry_after,
             )
         try:
             value = response.json()