lixinger-python 0.3.13__py3-none-any.whl → 0.3.14__py3-none-any.whl

lixinger/api/base.py

@@ -15,6 +15,12 @@ _global_rate_limiter = AsyncRateLimiter(max_requests=1000)
 # Lazy initialization of global http client to avoid issues with proxy/config changes
 _global_http_client: httpx.AsyncClient | None = None
 
+# Fallback delay in seconds when a 429 response omits Retry-After. The Lixinger
+# rate-limit window is 60s, so short exponential backoff (1/2/4s) almost always
+# fires inside the same window and gets 429ed again. 15s gives the window room
+# to age and burns fewer retry attempts on doomed requests.
+DEFAULT_RATE_LIMIT_RETRY_AFTER = 15.0
+
 
 def get_global_client() -> httpx.AsyncClient:
     """Get or create the global HTTP client."""
@@ -113,6 +119,10 @@ class BaseAPI:
 
         if response.status_code == 429:
             retry_after = _parse_retry_after(response.headers.get("Retry-After"))
+            # Server didn't tell us how long to wait — pick a delay long enough
+            # for the 60s rate-limit window to actually age.
+            if retry_after is None:
+                retry_after = DEFAULT_RATE_LIMIT_RETRY_AFTER
             raise RateLimitError(
                 "Rate limit exceeded",
                 status_code=429,
@@ -133,7 +143,15 @@ class BaseAPI:
         code = data.get("code")
         message = data.get("message")
 
-        if code != 1 or message != "success":
+        # code is the machine-readable success signal; message is human text.
+        # Lixinger returns code=1 for success even when there's no data
+        # (e.g. message="no data" on non-trading days or empty ranges) —
+        # treat any code=1 as success and normalize a missing/null payload
+        # to [] so downstream iteration and get_response_df both work.
+        if code != 1:
             raise APIError(f"API returned error code {code}: {message}")
 
-        return data.get("data")
+        payload = data.get("data")
+        if payload is None:
+            return []
+        return payload

lixinger/utils/retry.py

@@ -1,6 +1,7 @@
 import asyncio
 from collections.abc import Awaitable, Callable
 from functools import wraps
+import random
 from typing import Any, TypeVar
 
 T = TypeVar("T")
@@ -11,8 +12,9 @@ def async_retry_on_failure(
     backoff: float = 1.0,
     retry_on: tuple[type[Exception], ...] = (Exception,),
     no_retry_on: tuple[type[Exception], ...] = (),
+    jitter: float = 0.2,
 ) -> Callable[[Callable[..., Awaitable[T]]], Callable[..., Awaitable[T]]]:
-    """Retry failed async requests with exponential backoff.
+    """Retry failed async requests with exponential backoff and jitter.
 
     Args:
         max_retries: Maximum number of retry attempts (total attempts = max_retries + 1).
@@ -21,6 +23,11 @@ def async_retry_on_failure(
         no_retry_on: Exception types that must NOT be retried even if matched by
             ``retry_on``. Use this to short-circuit on non-transient errors such
             as authentication failures.
+        jitter: Multiplicative jitter fraction applied to every sleep. The actual
+            sleep is drawn from ``uniform(base * (1 - jitter), base * (1 + jitter))``
+            where ``base`` is either the ``retry_after`` hint or the exponential
+            backoff. Pass ``0`` to disable (mostly useful in tests). Values are
+            clamped so the sleep never goes negative.
 
     If the caught exception exposes a ``retry_after`` attribute (float seconds,
     typically parsed from a ``Retry-After`` HTTP header on 429 responses), that
@@ -41,9 +48,13 @@ def async_retry_on_failure(
                         raise
                     # Prefer server-provided retry hint when available.
                     hint = getattr(e, "retry_after", None)
-                    wait_time = (
-                        float(hint) if isinstance(hint, int | float) and hint > 0 else backoff * (2**attempt)
-                    )
+                    base = float(hint) if isinstance(hint, int | float) and hint > 0 else backoff * (2**attempt)
+                    if jitter > 0:
+                        low = max(0.0, base * (1.0 - jitter))
+                        high = base * (1.0 + jitter)
+                        wait_time = random.uniform(low, high)  # noqa: S311 (non-crypto jitter)
+                    else:
+                        wait_time = base
                     await asyncio.sleep(wait_time)
             raise RuntimeError("Unreachable")
 

{lixinger_python-0.3.13.dist-info → lixinger_python-0.3.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lixinger-python
-Version: 0.3.13
+Version: 0.3.14
 Summary: Python SDK for Lixinger Financial Data API
 Project-URL: Homepage, https://www.lixinger.com
 Project-URL: Documentation, https://www.lixinger.com/open/api/doc

{lixinger_python-0.3.13.dist-info → lixinger_python-0.3.14.dist-info}/RECORD

@@ -4,7 +4,7 @@ lixinger/config.py,sha256=JPz8EOrf1kP4Do-Z5-MsnOM0pMrNE1ZsP-Qoarh9y4c,2008
 lixinger/exceptions.py,sha256=Gkv1z-LC09paYGVs430-gDgDs43dLyRHbglB3Frehd4,1069
 lixinger/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lixinger/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lixinger/api/base.py,sha256=oMXwauTncyd_anFS_2A642lH7NjUsp6uGtntVY4KoeE,4684
+lixinger/api/base.py,sha256=6YQK-2oPFTPeLzw8WaaG-rajFL1Vv8dxrpS1jkxF2ew,5685
 lixinger/api/cn/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lixinger/api/cn/company/__init__.py,sha256=K8aNp2gGj4iQOvc8KjXA5668QUAhwyTfMBPhP3tgtMg,961
 lixinger/api/cn/company/announcement.py,sha256=lYt4AWOV5b9OTKfvJ7ZOqWP61pcPcyIQzb5N2DqFT6k,1920
@@ -120,8 +120,8 @@ lixinger/utils/api.py,sha256=BktR40JtKCMe9excFWo4ujsq3GiQK4ypJLG3MpJgo2s,402
 lixinger/utils/dataframe.py,sha256=tYBrNdmJ4poyuwD-9XgzHt3A_A8bBo0cdHiu8Yy9e9A,2208
 lixinger/utils/dict.py,sha256=yvbUtv8QpRmy0d_o_7gCuEwwiEfBji5_xB490ANxilw,589
 lixinger/utils/rate_limiter.py,sha256=ZHlRTTL60L62uRA_f--LD26qkAfk-pHBllRqPapAXQM,1141
-lixinger/utils/retry.py,sha256=erwB-wc9PA85vEoJD7yQFZTipDTFgsABD4QEOG7c_VM,2169
-lixinger_python-0.3.13.dist-info/METADATA,sha256=5i65s2BVbG3ArH0Yzrf_95Uiue20D4Y2z5u8SHVdQIk,9207
-lixinger_python-0.3.13.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-lixinger_python-0.3.13.dist-info/licenses/LICENSE,sha256=5oOwRq1lHSOScbNGCHr2feuNnhNYdGcArj6fSUfsC5U,1064
-lixinger_python-0.3.13.dist-info/RECORD,,
+lixinger/utils/retry.py,sha256=C9QBcrpD7WYAuT8R4SJfWNUZFj1mZsv-qyTRIFQDmwc,2862
+lixinger_python-0.3.14.dist-info/METADATA,sha256=mXD9Q3vhJMy-p0Exnj0knq71zUNpengedXCygEMcHyg,9207
+lixinger_python-0.3.14.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+lixinger_python-0.3.14.dist-info/licenses/LICENSE,sha256=5oOwRq1lHSOScbNGCHr2feuNnhNYdGcArj6fSUfsC5U,1064
+lixinger_python-0.3.14.dist-info/RECORD,,