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

sharpapi/__init__.py

@@ -51,7 +51,7 @@ from .models import (
 from .streaming import EventStream
 from ._utils import american_to_decimal, american_to_probability, decimal_to_american
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 
 __all__ = [
     # Clients

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()
@@ -442,11 +461,6 @@ class _AsyncEventsResource:
         raw = data.get("data", data)
         return Event.model_validate(raw)
 
-    async def search(self, query: str) -> APIResponse[list[Event]]:
-        """Search events by name."""
-        data = await self._client._get("/events/search", {"q": query})
-        return parse_response(data, Event)
-
 
 class _AsyncAccountResource:
     def __init__(self, client: AsyncSharpAPI):

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()
@@ -555,11 +574,6 @@ class _EventsResource:
         raw = data.get("data", data)
         return Event.model_validate(raw)
 
-    def search(self, query: str) -> APIResponse[list[Event]]:
-        """Search events by name."""
-        data = self._client._get("/events/search", {"q": query})
-        return _parse_response(data, Event)
-
 
 class _AccountResource:
     def __init__(self, client: SharpAPI):

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sharpapi
-Version: 0.2.0
+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
@@ -118,7 +117,6 @@ client.sports.list()
 client.leagues.list(sport="basketball")
 client.sportsbooks.list()
 client.events.list(league="nba", live=True)
-client.events.search("Lakers")
 
 # Account
 client.account.me()       # Tier, limits, features

sharpapi-0.2.2.dist-info/RECORD

@@ -0,0 +1,12 @@
+sharpapi/__init__.py,sha256=dCb0vGKwVAMd8nCaLTfo_m5IyV_yymY4N9bjTborKLU,1974
+sharpapi/_base.py,sha256=lSV5MiGI02rB_fMX3oXlbqrckwkFyRbwecX7NyAep7A,4045
+sharpapi/_utils.py,sha256=nQU1gNkzepAIr93HDYX455aRO2yhc6BeBbaWDnpI5lw,1143
+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.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,,

sharpapi-0.2.0.dist-info/RECORD

@@ -1,12 +0,0 @@
-sharpapi/__init__.py,sha256=thLONzlOusuGL1M7NiE7PVzO_nQgI-ZGAIx59mxE5oE,1974
-sharpapi/_base.py,sha256=roQjRMVz0NxTZGc303tkQs5iWwcGyg-LUppdIC1p0eI,3348
-sharpapi/_utils.py,sha256=nQU1gNkzepAIr93HDYX455aRO2yhc6BeBbaWDnpI5lw,1143
-sharpapi/async_client.py,sha256=MrNM01ZTUcnSSoeJpw6Z_77-5iWi1kNHyIW58wJvPZc,15370
-sharpapi/client.py,sha256=V80lCdTQvN-yt-RdRfeT0VQGxtf9NqJpFCejLRksHp4,22519
-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.0.dist-info/METADATA,sha256=N_CF_re06FgeeqmNPFDtbcC9azO_iB9MOzD0XWo9-wE,5795
-sharpapi-0.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sharpapi-0.2.0.dist-info/RECORD,,