sharpapi 0.2.1__py3-none-any.whl → 0.2.2__py3-none-any.whl

sharpapi/_base.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+import random
+
 import httpx
 
 from .exceptions import (
@@ -15,7 +17,25 @@ from .models import APIResponse, RateLimitInfo, ResponseMeta
 
 DEFAULT_BASE_URL = "https://api.sharpapi.io"
 DEFAULT_TIMEOUT = 30.0
-USER_AGENT = "sharpapi-python/0.2.0"
+USER_AGENT = "sharpapi-python/0.2.2"
+
+RETRY_STATUSES = frozenset({502, 503, 504})
+RETRY_MAX_ATTEMPTS = 3
+RETRY_BASE_DELAY = 0.5
+RETRY_MAX_DELAY = 4.0
+
+
+def should_retry(response: httpx.Response | None, exc: Exception | None) -> bool:
+    """True for transient upstream failures worth retrying."""
+    if exc is not None:
+        return isinstance(exc, (httpx.ConnectError, httpx.ReadError, httpx.RemoteProtocolError))
+    return response is not None and response.status_code in RETRY_STATUSES
+
+
+def retry_delay(attempt: int) -> float:
+    """Exponential backoff with full jitter. attempt is 1-indexed."""
+    ceiling = min(RETRY_BASE_DELAY * (2 ** (attempt - 1)), RETRY_MAX_DELAY)
+    return random.uniform(0, ceiling)
 
 
 def parse_response(raw: dict, model_class: type) -> APIResponse:

sharpapi/async_client.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import asyncio
 from typing import Any, Optional, Union
 
 import httpx
@@ -9,10 +10,13 @@ import httpx
 from ._base import (
     DEFAULT_BASE_URL,
     DEFAULT_TIMEOUT,
+    RETRY_MAX_ATTEMPTS,
     handle_errors,
     make_headers,
     parse_rate_limit,
     parse_response,
+    retry_delay,
+    should_retry,
 )
 from ._utils import _clean_params
 from .models import (
@@ -89,11 +93,26 @@ class AsyncSharpAPI:
         return self._last_rate_limit
 
     async def _request(self, method: str, path: str, params: dict | None = None, **kwargs) -> Any:
-        """Make an async API request and return parsed JSON."""
+        """Make an async API request and return parsed JSON. Retries 502/503/504 with jittered backoff."""
         if params:
             params = _clean_params(params)
 
-        response = await self._http.request(method, path, params=params, **kwargs)
+        response: httpx.Response | None = None
+        for attempt in range(1, RETRY_MAX_ATTEMPTS + 1):
+            exc: Exception | None = None
+            try:
+                response = await self._http.request(method, path, params=params, **kwargs)
+            except (httpx.ConnectError, httpx.ReadError, httpx.RemoteProtocolError) as e:
+                exc = e
+
+            if attempt < RETRY_MAX_ATTEMPTS and should_retry(response, exc):
+                await asyncio.sleep(retry_delay(attempt))
+                continue
+            if exc is not None:
+                raise exc
+            break
+
+        assert response is not None
         self._last_rate_limit = parse_rate_limit(response)
         handle_errors(response)
         return response.json()

sharpapi/client.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import time
 from typing import Any, Optional, Union
 
 import httpx
@@ -9,10 +10,13 @@ import httpx
 from ._base import (
     DEFAULT_BASE_URL,
     DEFAULT_TIMEOUT,
+    RETRY_MAX_ATTEMPTS,
     handle_errors,
     make_headers,
     parse_rate_limit,
     parse_response,
+    retry_delay,
+    should_retry,
 )
 from ._utils import _clean_params
 from .models import (
@@ -99,11 +103,26 @@ class SharpAPI:
         return self._last_rate_limit
 
     def _request(self, method: str, path: str, params: dict | None = None, **kwargs) -> Any:
-        """Make an API request and return parsed JSON."""
+        """Make an API request and return parsed JSON. Retries 502/503/504 with jittered backoff."""
         if params:
             params = _clean_params(params)
 
-        response = self._http.request(method, path, params=params, **kwargs)
+        response: httpx.Response | None = None
+        for attempt in range(1, RETRY_MAX_ATTEMPTS + 1):
+            exc: Exception | None = None
+            try:
+                response = self._http.request(method, path, params=params, **kwargs)
+            except (httpx.ConnectError, httpx.ReadError, httpx.RemoteProtocolError) as e:
+                exc = e
+
+            if attempt < RETRY_MAX_ATTEMPTS and should_retry(response, exc):
+                time.sleep(retry_delay(attempt))
+                continue
+            if exc is not None:
+                raise exc
+            break
+
+        assert response is not None
         self._last_rate_limit = parse_rate_limit(response)
         handle_errors(response)
         return response.json()

{sharpapi-0.2.1.dist-info → sharpapi-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sharpapi
-Version: 0.2.1
+Version: 0.2.2
 Summary: Official Python SDK for the SharpAPI real-time sports betting odds API
 Project-URL: Homepage, https://sharpapi.io
 Project-URL: Documentation, https://docs.sharpapi.io/sdks/python
@@ -13,14 +13,13 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Requires-Dist: httpx>=0.25.0
 Requires-Dist: pydantic>=2.0.0
 Provides-Extra: pandas

{sharpapi-0.2.1.dist-info → sharpapi-0.2.2.dist-info}/RECORD

@@ -1,12 +1,12 @@
 sharpapi/__init__.py,sha256=dCb0vGKwVAMd8nCaLTfo_m5IyV_yymY4N9bjTborKLU,1974
-sharpapi/_base.py,sha256=roQjRMVz0NxTZGc303tkQs5iWwcGyg-LUppdIC1p0eI,3348
+sharpapi/_base.py,sha256=lSV5MiGI02rB_fMX3oXlbqrckwkFyRbwecX7NyAep7A,4045
 sharpapi/_utils.py,sha256=nQU1gNkzepAIr93HDYX455aRO2yhc6BeBbaWDnpI5lw,1143
-sharpapi/async_client.py,sha256=P4qWY7VSEXjP5TUmpoxZggdQuu2SHiENhwzGmXaDBoU,15150
-sharpapi/client.py,sha256=nPgzhgXX2Em_4cu0f-txuagjKxn1TEWa56zZM1bhOAM,22310
+sharpapi/async_client.py,sha256=yT45nbCWMxkMba11AtLM8gbst55JDM99ooEGhYQkl10,15825
+sharpapi/client.py,sha256=f_PTMUBy8bFs_Q-PKDRIe-CfmfHOMG9Ln4HdLmwExaU,22973
 sharpapi/exceptions.py,sha256=nseJ4BboGjSWIfDtMYQpXPIaOUxbPAJLsxUPbERZqpY,1272
 sharpapi/models.py,sha256=z9IIQd2dQKeEQTzZ8-qF8J5_L0GwT-8k2r3Y3ozXJ0U,12951
 sharpapi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sharpapi/streaming.py,sha256=smQi9F-m7ET7s7V_psdg3S-butiuG_bIq3CnOE1zG8M,6971
-sharpapi-0.2.1.dist-info/METADATA,sha256=TvHNOVs-f6uCkTuo3B8nS9U6yEtc176VvaMCjzc8fzQ,5764
-sharpapi-0.2.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sharpapi-0.2.1.dist-info/RECORD,,
+sharpapi-0.2.2.dist-info/METADATA,sha256=YuRZC64xa9GMLLaE4-qL-QbqerLNwrAMD2aU78ODwpQ,5715
+sharpapi-0.2.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sharpapi-0.2.2.dist-info/RECORD,,