pyrox-client 0.0.1__py3-none-any.whl

pyrox/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.1"

pyrox/client.py

@@ -0,0 +1,49 @@
+import pandas as pd
+import io, json, requests
+from dataclasses import dataclass
+
+CDN_BASE = "https://<your-cloudfront-domain>/<prefix>"
+
+
+@dataclass(frozen=True)
+class EventRef:
+    season: int
+    event_id: str
+    race: str
+    key: str  # "season=7/Cardiff_2025__LR3MS4JIB56.parquet"
+
+
+def _manifest():
+    url = f"{CDN_BASE}/catalog/manifest-v1.json"
+    r = requests.get(url, timeout=20)
+    r.raise_for_status()
+    return r.json()
+
+
+def list_seasons() -> list[int]:
+    return _manifest()["seasons"]
+
+
+def list_events(season: int | None = None) -> list[EventRef]:
+    m = _manifest()["events"]
+    if season is not None:
+        m = [e for e in m if e["season"] == season]
+    return [EventRef(**{k: e[k] for k in ("season", "event_id", "race", "key")}) for e in m]
+
+
+def get_race(*, season: int | None = None, location: str | None = None, event_id: str | None = None) -> pd.DataFrame:
+    events = list_events(season)
+    if event_id:
+        ev = next(e for e in events if e.event_id == event_id)
+    elif location:
+        # naive match; you can add fuzzy/normalized matching later
+        cand = [e for e in events if location.lower() in e.race.lower()]
+        if not cand:
+            raise ValueError(f"No event matching {location!r}")
+        ev = cand[0]
+    else:
+        raise ValueError("Provide event_id or location (optionally season).")
+    url = f"{CDN_BASE}/{ev.key}"
+    resp = requests.get(url, timeout=60)
+    resp.raise_for_status()
+    return pd.read_parquet(io.BytesIO(resp.content))

pyrox_client-0.0.1.dist-info/METADATA

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: pyrox-client
+Version: 0.0.1
+Summary: HYROX race data client - retrieve full race results via Python
+Project-URL: homepage, https://github.com/<you>/pyrox
+Author: Vlad Matei
+License: MIT
+Requires-Python: >=3.9
+Requires-Dist: fastparquet>=15
+Requires-Dist: pandas>=2.0
+Requires-Dist: requests>=2.31
+Provides-Extra: duckdb
+Requires-Dist: duckdb>=1.0.0; extra == 'duckdb'
+Description-Content-Type: text/markdown
+
+Package to retrieve Hyrox race data programatically.
+

pyrox_client-0.0.1.dist-info/RECORD

@@ -0,0 +1,5 @@
+pyrox/__init__.py,sha256=sXLh7g3KC4QCFxcZGBTpG2scR7hmmBsMjq6LqRptkRg,22
+pyrox/client.py,sha256=SknlWuPYm-uDkfZ1sYQhAU3zrdG2dVkGrVpHUkM1Q0U,1514
+pyrox_client-0.0.1.dist-info/METADATA,sha256=JF8gP7qqc0c24IJgwyGJbCu76RMMSdbylUk86KJjCtU,491
+pyrox_client-0.0.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pyrox_client-0.0.1.dist-info/RECORD,,

pyrox_client-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any