pyrox-client 0.0.1__tar.gz → 0.0.2__tar.gz

{pyrox_client-0.0.1 → pyrox_client-0.0.2}/PKG-INFO

@@ -1,14 +1,16 @@
 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
+Version: 0.0.2
+Summary: HYROX race data client – retrieve full race results via Python
 Author: Vlad Matei
 License: MIT
 Requires-Python: >=3.9
-Requires-Dist: fastparquet>=15
-Requires-Dist: pandas>=2.0
+Requires-Dist: fastparquet>=2024.5.0
+Requires-Dist: fsspec>=2024.2.0
+Requires-Dist: pandas>=2.2
+Requires-Dist: platformdirs>=4.2.0
 Requires-Dist: requests>=2.31
+Requires-Dist: s3fs>=2024.2.0
 Provides-Extra: duckdb
 Requires-Dist: duckdb>=1.0.0; extra == 'duckdb'
 Description-Content-Type: text/markdown

pyrox_client-0.0.2/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["hatchling>=1.20"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pyrox-client"
+version = "0.0.2"
+description = "HYROX race data client – retrieve full race results via Python"
+authors = [{ name = "Vlad Matei" }]
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+dependencies = [
+    "pandas>=2.2",
+    "fastparquet>=2024.5.0",
+    "fsspec>=2024.2.0",
+    "s3fs>=2024.2.0",
+    "requests>=2.31",
+    "platformdirs>=4.2.0",
+]
+
+[project.optional-dependencies]
+duckdb = ["duckdb>=1.0.0"]
+
+
+# You’re using a src/ layout. This tells Hatch which package to build.
+[tool.hatch.build.targets.wheel]
+packages = ["src/pyrox"]
+
+# Ensure sdist includes your source + docs
+[tool.hatch.build.targets.sdist]
+include = [
+  "src/pyrox",
+  "README.md",
+  "pyproject.toml"
+]

pyrox_client-0.0.2/src/pyrox/__init__.py

@@ -0,0 +1,5 @@
+from .core import get_race, list_races
+from .config import set_bucket, set_manifest_path, get_config
+
+__all__ = ["get_race", "list_races", "set_bucket", "set_manifest_path", "get_config"]
+__version__ = "0.0.2"

pyrox_client-0.0.2/src/pyrox/config.py

@@ -0,0 +1,31 @@
+from dataclasses import dataclass
+from platformdirs import user_cache_dir
+from pathlib import Path
+import os
+
+APP_NAME = "pyrox"
+APP_AUTHOR = "pyrox"
+
+_DEFAULT_BUCKET = os.getenv("PYROX_BUCKET", "s3://hyrox-results")
+_DEFAULT_MANIFEST = os.getenv("PYROX_MANIFEST_PATH", "processed/manifest/latest.csv")
+
+@dataclass
+class PyroxConfig:
+    bucket: str = _DEFAULT_BUCKET
+    manifest_path: str = _DEFAULT_MANIFEST
+    cache_dir:Path = Path(user_cache_dir(APP_NAME, APP_AUTHOR))
+
+_config = PyroxConfig()
+
+
+def set_bucket(uri:str) -> None:
+    _config.bucket = uri.rsplit("/")
+
+
+def set_manifest_path(path: str) -> None:
+    _config.manifest_path = path
+
+
+def get_config() -> PyroxConfig:
+    _config.cache_dir.mkdir(parents=True, exist_ok=True)
+    return _config

pyrox_client-0.0.2/src/pyrox/core.py

@@ -0,0 +1,102 @@
+from __future__ import annotations
+
+import io
+from pathlib import Path
+import pandas as pd
+
+from .manifest import load_manifest, _s3_open   # re-use your manifest loader + fsspec opener
+from .config import get_config
+from .errors import RaceNotFound, ParquetReadError
+
+
+def list_races(season: int | None = None) -> pd.DataFrame:
+    """
+    Return available (season, location) pairs from the manifest.
+    """
+    df = load_manifest(refresh=True)
+    if season is not None:
+        try:
+            df = df[df["season"] == int(season)]
+        except ValueError as e:
+            raise (ValueError(f"Input {season} is not of expected type. Please make sure you request an integer."))
+    return (
+        df[["season", "location"]]
+        .drop_duplicates()
+        .sort_values(["season", "location"])
+        .reset_index(drop=True)
+    )
+
+
+def _local_parquet_cache_path(s3_key: str) -> Path:
+    """
+    Map an S3 key to a deterministic local cache path under ~/.cache/pyrox/parquet/.
+    """
+    cfg = get_config()
+    p = cfg.cache_dir / "parquet" / s3_key.replace("/", "__")
+    p.parent.mkdir(parents=True, exist_ok=True)
+    return p
+
+
+def _read_parquet_from_s3(s3_uri: str) -> pd.DataFrame:
+    """
+    Download the parquet bytes anonymously from S3 and read with fastparquet.
+    """
+    try:
+        with _s3_open(s3_uri, "rb", anon=True) as f:
+            data = f.read()
+        return pd.read_parquet(io.BytesIO(data), engine="fastparquet")
+    except Exception as e:
+        raise ParquetReadError(f"Failed to read parquet from {s3_uri}: {e}")
+# core.py
+def _to_s3_uri(bucket: str, key: str) -> str:
+    """Join bucket + key safely. If key is already a full s3:// URI, use it as-is."""
+    key = key.strip()
+    if key.startswith("s3://"):
+        return key
+    # allow bucket to be "s3://bucket" or just "bucket"
+    if not bucket.startswith("s3://"):
+        bucket = f"s3://{bucket}"
+    return f"{bucket.rstrip('/')}/{key.lstrip('/')}"
+
+
+def get_race(*, season: int, location: str) -> pd.DataFrame:
+    """
+    Resolve (season, location) -> s3_key via the manifest, then return the race DataFrame.
+
+    Uses a simple local file cache. If the cached parquet fails to read,
+    it is discarded and we re-fetch from S3.
+    """
+    manifest = load_manifest(refresh=True)
+
+    # case-insensitive match on location
+    row = manifest[
+        (manifest["season"] == int(season)) &
+        (manifest["location"].str.casefold() == location.casefold())
+    ]
+
+    if row.empty:
+        raise RaceNotFound(f"No race found for season={season}, location='{location}'. "
+                           f"Try: pyrox.list_races({season})")
+
+    s3_key = row.iloc[0]["path"]
+    cfg = get_config()
+    s3_uri = _to_s3_uri(cfg.bucket, s3_key)
+
+    # check local cache first
+    local_path = _local_parquet_cache_path(s3_key)
+    if local_path.exists():
+        try:
+            return pd.read_parquet(local_path, engine="fastparquet")
+        except Exception:
+            local_path.unlink(missing_ok=True)  # bad cache → remove and refetch
+
+    # fetch from S3 and cache
+    df = _read_parquet_from_s3(s3_uri)
+    try:
+        df.to_parquet(local_path, index=False, engine="fastparquet")
+    except Exception:
+        # cache failures should not fail the API
+        pass
+    return df
+
+breakheere = 0

pyrox_client-0.0.2/src/pyrox/errors.py

@@ -0,0 +1,60 @@
+"""
+Custom exceptions for the pyrox client.
+
+Expose a small, predictable hierarchy so users can:
+- catch a broad PyroxError for any client-side issue, or
+- catch specific errors for targeted handling (e.g., missing race).
+"""
+
+from __future__ import annotations
+
+
+__all__ = [
+    "PyroxError",
+    "ConfigError",
+    "ManifestUnavailable",
+    "RaceNotFound",
+    "ParquetReadError",
+]
+
+
+class PyroxError(Exception):
+    """Base class for all pyrox-specific errors."""
+    pass
+
+
+class ConfigError(PyroxError):
+    """
+    Raised when the client configuration is invalid or incomplete.
+    Example: bucket URI not set or malformed.
+    """
+    pass
+
+
+class ManifestUnavailable(PyroxError):
+    """
+    Raised when the manifest cannot be retrieved or parsed.
+
+    Typical reasons:
+      - Network/S3 access problems
+      - File missing or not public
+      - CSV missing required columns (season, location, s3_key)
+    """
+    pass
+
+
+class RaceNotFound(PyroxError, LookupError):
+    """
+    Raised when (season, location) is not present in the manifest.
+
+    Inherit from LookupError to feel natural in 'lookup' code paths.
+    """
+    pass
+
+
+class ParquetReadError(PyroxError, IOError):
+    """
+    Raised when the parquet for a race cannot be read (S3 read failure,
+    corrupted object, incompatible parquet version, etc.).
+    """
+    pass

pyrox_client-0.0.2/src/pyrox/manifest.py

@@ -0,0 +1,174 @@
+from __future__ import annotations
+
+import io
+from typing import Optional, Tuple
+from pathlib import Path
+
+import fsspec
+import pandas as pd
+
+from .config import get_config
+from .errors import ManifestUnavailable
+
+
+def _s3_open(path: str, mode: str = "rb", anon: bool = True):
+    """
+    Unified opener for S3 (via fsspec/s3fs).
+
+    Parameters
+    ----------
+    path : str
+        Full fsspec path, e.g. "s3://my-bucket/processed/manifest/latest.csv"
+    mode : str
+        File mode, usually "rb" for binary reads.
+    anon : bool
+        True => anonymous/public read (no AWS creds required).
+
+    Returns
+    -------
+    contextmanager
+        Use with 'with _s3_open(...) as f: data = f.read()'
+    """
+    # s3fs accepts the 'anon' kw to do public/unsigned requests
+    return fsspec.open(path, mode=mode, **({"anon": True} if anon else {}))
+
+
+def _cache_paths(name: str) -> Tuple[Path, Path]:
+    """
+    Compute cache locations for the manifest CSV and its ETag sidecar.
+
+    We cache:
+      - the CSV bytes as ~/.cache/pyrox/manifest.latest.csv
+      - the ETag string as ~/.cache/pyrox/manifest.latest.csv.etag
+    """
+    cfg = get_config()
+    cache_file = cfg.cache_dir / name
+    meta_file = cfg.cache_dir / f"{name}.etag"
+    return cache_file, meta_file
+
+
+def _read_etag(meta_file: Path) -> Optional[str]:
+    """Read the cached ETag string (if any)."""
+    if meta_file.exists():
+        try:
+            etag = meta_file.read_text().strip()
+            return etag or None
+        except Exception:
+            return None
+    return None
+
+
+def _head_s3(path: str) -> dict:
+    """
+    Fetch object metadata from S3 (cheap 'HEAD').
+
+    Returns a dict similar to:
+      {
+        "ETag": "\"5d41402abc...\"",
+        "LastModified": datetime,
+        "Size": int,
+        ...
+      }
+
+    Notes
+    -----
+    - We obtain the filesystem object from an open file handle (fo.fs),
+      then call fs.info(path).
+    - Not all gateways populate all keys—but ETag is common for S3.
+    """
+    # Open briefly to access underlying filesystem handle
+    with fsspec.open(path, mode="rb", anon=True) as fo:
+        fs = fo.fs  # type: ignore[attr-defined]
+    return fs.info(path)
+
+
+def load_manifest(refresh: bool = True) -> pd.DataFrame:
+    """
+    Load the manifest CSV as a pandas DataFrame with required columns:
+      ['season', 'location', 's3_key']
+
+    Caching strategy
+    ----------------
+    - Store the last-downloaded manifest under ~/.cache/pyrox.
+    - On each call (when refresh=True), perform a HEAD request to get the
+      current ETag. If it matches the cached ETag -> use cached CSV.
+      Otherwise, re-download and update the cache.
+
+    Parameters
+    ----------
+    refresh : bool
+        If False, skip HEAD check and use cached file if present.
+        If True (default), validate with ETag before deciding.
+
+    Raises
+    ------
+    ManifestUnavailable
+        If we cannot fetch or parse the manifest, and there is no usable cache.
+
+    Returns
+    -------
+    pd.DataFrame
+        Normalized manifest DataFrame.
+    """
+    cfg = get_config()
+    s3_manifest_uri = f"{cfg.bucket}/{cfg.manifest_path}"
+    cache_file, meta_file = _cache_paths("manifest.latest.csv")
+
+    # 1) Try to fetch latest ETag (safe to fail; we'll fall back).
+    current_etag: Optional[str] = None
+    if refresh:
+        try:
+            info = _head_s3(s3_manifest_uri)
+            # Some backends wrap ETag in quotes; we keep it as-is because
+            # we compare exact strings on both sides.
+            current_etag = info.get("ETag")
+        except Exception:
+            # HEAD can fail (e.g., transient network); we'll fall back to cache or GET.
+            current_etag = None
+
+    # 2) If we have a cached file and either:
+    #    - HEAD failed (no current_etag), or
+    #    - ETag matches the cached one,
+    #   then load cached CSV immediately.
+    cached_etag = _read_etag(meta_file)
+    if cache_file.exists() and (current_etag is None or cached_etag == current_etag):
+        try:
+            return pd.read_csv(cache_file)
+        except Exception:
+            # Corrupted cache? Continue to re-download below.
+            pass
+
+    # 3) Re-download from S3 and update cache.
+    try:
+        with _s3_open(s3_manifest_uri, "rb", anon=True) as f:
+            data = f.read()
+
+        # Parse CSV from bytes buffer
+        df = pd.read_csv(io.BytesIO(data))
+
+        # Persist cache on success
+        cache_file.write_bytes(data)
+        if current_etag:
+            meta_file.write_text(current_etag)
+
+        # Basic schema checks
+        for col in ("season", "location", "s3_key"):
+            if col not in df.columns:
+                raise ManifestUnavailable(f"Manifest missing required column: {col}")
+
+        # Normalize dtypes; keeps downstream filters predictable
+        df["season"] = df["season"].astype(int)
+        df["location"] = df["location"].astype(str)
+        df["s3_key"] = df["s3_key"].astype(str)
+
+        return df
+
+    except Exception as e:
+        # 4) If network failed, try to limp with the existing cache (even if ETag mismatch).
+        if cache_file.exists():
+            try:
+                return pd.read_csv(cache_file)
+            except Exception:
+                pass
+        # No working cache → bail with a clear error
+        raise ManifestUnavailable(f"Could not load manifest from {s3_manifest_uri}: {e}")

pyrox_client-0.0.1/.idea/.gitignore

@@ -1,3 +0,0 @@
-# Default ignored files
-/shelf/
-/workspace.xml

pyrox_client-0.0.1/.idea/.name

@@ -1 +0,0 @@
-pyrox-client

pyrox_client-0.0.1/.idea/inspectionProfiles/Project_Default.xml

@@ -1,392 +0,0 @@
-<component name="InspectionProjectProfileManager">
-  <profile version="1.0">
-    <option name="myName" value="Project Default" />
-    <inspection_tool class="PyPackageRequirementsInspection" enabled="true" level="WARNING" enabled_by_default="true">
-      <option name="ignoredPackages">
-        <value>
-          <list size="1">
-            <item index="0" class="java.lang.String" itemvalue="lxml" />
-          </list>
-        </value>
-      </option>
-    </inspection_tool>
-    <inspection_tool class="PyPep8Inspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
-      <option name="ignoredErrors">
-        <list>
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-          <option value="W29" />
-          <option value="E501" />
-        </list>
-      </option>
-    </inspection_tool>
-    <inspection_tool class="PyPep8NamingInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
-      <option name="ignoredErrors">
-        <list>
-          <option value="N806" />
-          <option value="N802" />
-        </list>
-      </option>
-    </inspection_tool>
-  </profile>
-</component>

pyrox_client-0.0.1/.idea/inspectionProfiles/profiles_settings.xml

@@ -1,6 +0,0 @@
-<component name="InspectionProjectProfileManager">
-  <settings>
-    <option name="USE_PROJECT_PROFILE" value="false" />
-    <version value="1.0" />
-  </settings>
-</component>

pyrox_client-0.0.1/.idea/misc.xml

@@ -1,4 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.10 (pyrox)" project-jdk-type="Python SDK" />
-</project>

pyrox_client-0.0.1/.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/../pyrox-client/.idea/pyrox-client.iml" filepath="$PROJECT_DIR$/../pyrox-client/.idea/pyrox-client.iml" />
-    </modules>
-  </component>
-</project>

pyrox_client-0.0.1/.idea/pyrox-client.iml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="PYTHON_MODULE" version="4">
-  <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$" />
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-</module>

pyrox_client-0.0.1/.idea/workspace.xml

@@ -1,191 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="AutoImportSettings">
-    <option name="autoReloadType" value="SELECTIVE" />
-  </component>
-  <component name="ChangeListManager">
-    <list default="true" id="697e0274-d3c5-4401-be7b-acf1d10d3541" name="Changes" comment="" />
-    <option name="SHOW_DIALOG" value="false" />
-    <option name="HIGHLIGHT_CONFLICTS" value="true" />
-    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
-    <option name="LAST_RESOLUTION" value="IGNORE" />
-  </component>
-  <component name="MarkdownSettingsMigration">
-    <option name="stateVersion" value="1" />
-  </component>
-  <component name="ProjectId" id="31jilXllIHNRHUAEcZyhAlo8CE8" />
-  <component name="ProjectViewState">
-    <option name="hideEmptyMiddlePackages" value="true" />
-    <option name="showLibraryContents" value="true" />
-  </component>
-  <component name="PropertiesComponent"><![CDATA[{
-  "keyToString": {
-    "RunOnceActivity.OpenProjectViewOnStart": "true",
-    "RunOnceActivity.ShowReadmeOnStart": "true",
-    "last_opened_file_path": "/Users/vladmatei"
-  }
-}]]></component>
-  <component name="RunManager">
-    <configuration default="true" type="PythonConfigurationType" factoryName="Python">
-      <module name="pyrox-client" />
-      <option name="INTERPRETER_OPTIONS" value="" />
-      <option name="PARENT_ENVS" value="true" />
-      <envs>
-        <env name="PYTHONUNBUFFERED" value="1" />
-      </envs>
-      <option name="SDK_HOME" value="" />
-      <option name="WORKING_DIRECTORY" value="" />
-      <option name="IS_MODULE_SDK" value="false" />
-      <option name="ADD_CONTENT_ROOTS" value="true" />
-      <option name="ADD_SOURCE_ROOTS" value="true" />
-      <option name="SCRIPT_NAME" value="" />
-      <option name="PARAMETERS" value="" />
-      <option name="SHOW_COMMAND_LINE" value="false" />
-      <option name="EMULATE_TERMINAL" value="false" />
-      <option name="MODULE_MODE" value="false" />
-      <option name="REDIRECT_INPUT" value="false" />
-      <option name="INPUT_FILE" value="" />
-      <method v="2" />
-    </configuration>
-    <configuration name="main" type="PythonConfigurationType" factoryName="Python" nameIsGenerated="true">
-      <module name="pyrox-client" />
-      <option name="INTERPRETER_OPTIONS" value="" />
-      <option name="PARENT_ENVS" value="true" />
-      <envs>
-        <env name="PYTHONUNBUFFERED" value="1" />
-      </envs>
-      <option name="SDK_HOME" value="" />
-      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
-      <option name="IS_MODULE_SDK" value="true" />
-      <option name="ADD_CONTENT_ROOTS" value="true" />
-      <option name="ADD_SOURCE_ROOTS" value="true" />
-      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/main.py" />
-      <option name="PARAMETERS" value="" />
-      <option name="SHOW_COMMAND_LINE" value="false" />
-      <option name="EMULATE_TERMINAL" value="false" />
-      <option name="MODULE_MODE" value="false" />
-      <option name="REDIRECT_INPUT" value="false" />
-      <option name="INPUT_FILE" value="" />
-      <method v="2" />
-    </configuration>
-    <configuration default="true" type="Tox" factoryName="Tox">
-      <module name="pyrox-client" />
-      <option name="INTERPRETER_OPTIONS" value="" />
-      <option name="PARENT_ENVS" value="true" />
-      <option name="SDK_HOME" value="" />
-      <option name="WORKING_DIRECTORY" value="" />
-      <option name="IS_MODULE_SDK" value="false" />
-      <option name="ADD_CONTENT_ROOTS" value="true" />
-      <option name="ADD_SOURCE_ROOTS" value="true" />
-      <method v="2" />
-    </configuration>
-    <configuration default="true" type="ccruntests" factoryName="Run Study Tests">
-      <module name="pyrox-client" />
-      <option name="INTERPRETER_OPTIONS" value="" />
-      <option name="PARENT_ENVS" value="true" />
-      <envs>
-        <env name="PYTHONUNBUFFERED" value="1" />
-      </envs>
-      <option name="SDK_HOME" value="" />
-      <option name="WORKING_DIRECTORY" value="" />
-      <option name="IS_MODULE_SDK" value="false" />
-      <option name="ADD_CONTENT_ROOTS" value="true" />
-      <option name="ADD_SOURCE_ROOTS" value="true" />
-      <option name="SCRIPT_NAME" value="" />
-      <option name="PARAMETERS" value="" />
-      <option name="SHOW_COMMAND_LINE" value="false" />
-      <option name="EMULATE_TERMINAL" value="false" />
-      <option name="MODULE_MODE" value="false" />
-      <option name="REDIRECT_INPUT" value="false" />
-      <option name="INPUT_FILE" value="" />
-      <option name="studyTest" value="" />
-      <method v="2" />
-    </configuration>
-    <configuration default="true" type="docs" factoryName="Docutils task">
-      <module name="pyrox-client" />
-      <option name="INTERPRETER_OPTIONS" value="" />
-      <option name="PARENT_ENVS" value="true" />
-      <option name="SDK_HOME" value="" />
-      <option name="WORKING_DIRECTORY" value="" />
-      <option name="IS_MODULE_SDK" value="false" />
-      <option name="ADD_CONTENT_ROOTS" value="true" />
-      <option name="ADD_SOURCE_ROOTS" value="true" />
-      <option name="docutils_input_file" value="" />
-      <option name="docutils_output_file" value="" />
-      <option name="docutils_params" value="" />
-      <option name="docutils_task" value="" />
-      <option name="docutils_open_in_browser" value="false" />
-      <method v="2" />
-    </configuration>
-    <configuration default="true" type="docs" factoryName="Sphinx task">
-      <module name="pyrox-client" />
-      <option name="INTERPRETER_OPTIONS" value="" />
-      <option name="PARENT_ENVS" value="true" />
-      <option name="SDK_HOME" value="" />
-      <option name="WORKING_DIRECTORY" value="" />
-      <option name="IS_MODULE_SDK" value="false" />
-      <option name="ADD_CONTENT_ROOTS" value="true" />
-      <option name="ADD_SOURCE_ROOTS" value="true" />
-      <option name="docutils_input_file" value="" />
-      <option name="docutils_output_file" value="" />
-      <option name="docutils_params" value="" />
-      <option name="docutils_task" value="" />
-      <option name="docutils_open_in_browser" value="false" />
-      <method v="2" />
-    </configuration>
-    <configuration default="true" type="tests" factoryName="Autodetect">
-      <module name="pyrox-client" />
-      <option name="INTERPRETER_OPTIONS" value="" />
-      <option name="PARENT_ENVS" value="true" />
-      <option name="SDK_HOME" value="" />
-      <option name="WORKING_DIRECTORY" value="" />
-      <option name="IS_MODULE_SDK" value="false" />
-      <option name="ADD_CONTENT_ROOTS" value="true" />
-      <option name="ADD_SOURCE_ROOTS" value="true" />
-      <option name="_new_additionalArguments" value="&quot;&quot;" />
-      <option name="_new_target" value="&quot;&quot;" />
-      <option name="_new_targetType" value="&quot;PATH&quot;" />
-      <method v="2" />
-    </configuration>
-    <configuration default="true" type="tests" factoryName="Doctests">
-      <module name="pyrox-client" />
-      <option name="INTERPRETER_OPTIONS" value="" />
-      <option name="PARENT_ENVS" value="true" />
-      <option name="SDK_HOME" value="" />
-      <option name="WORKING_DIRECTORY" value="" />
-      <option name="IS_MODULE_SDK" value="false" />
-      <option name="ADD_CONTENT_ROOTS" value="true" />
-      <option name="ADD_SOURCE_ROOTS" value="true" />
-      <option name="SCRIPT_NAME" value="" />
-      <option name="CLASS_NAME" value="" />
-      <option name="METHOD_NAME" value="" />
-      <option name="FOLDER_NAME" value="" />
-      <option name="TEST_TYPE" value="TEST_SCRIPT" />
-      <option name="PATTERN" value="" />
-      <option name="USE_PATTERN" value="false" />
-      <method v="2" />
-    </configuration>
-  </component>
-  <component name="SpellCheckerSettings" RuntimeDictionaries="0" Folders="0" CustomDictionaries="0" DefaultDictionary="application-level" UseSingleDictionary="true" transferred="true" />
-  <component name="TaskManager">
-    <task active="true" id="Default" summary="Default task">
-      <changelist id="697e0274-d3c5-4401-be7b-acf1d10d3541" name="Changes" comment="" />
-      <created>1756044033429</created>
-      <option name="number" value="Default" />
-      <option name="presentableId" value="Default" />
-      <updated>1756044033429</updated>
-    </task>
-    <servers />
-  </component>
-  <component name="XDebuggerManager">
-    <breakpoint-manager>
-      <breakpoints>
-        <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
-          <url>file://$PROJECT_DIR$/../pyrox-client/main.py</url>
-          <line>8</line>
-          <option name="timeStamp" value="1" />
-        </line-breakpoint>
-      </breakpoints>
-    </breakpoint-manager>
-  </component>
-</project>

pyrox_client-0.0.1/main.py

@@ -1,16 +0,0 @@
-# This is a sample Python script.
-
-# Press ⌃R to execute it or replace it with your code.
-# Press Double ⇧ to search everywhere for classes, files, tool windows, actions, and settings.
-
-
-def print_hi(name):
-    # Use a breakpoint in the code line below to debug your script.
-    print(f'Hi, {name}')  # Press ⌘F8 to toggle the breakpoint.
-
-
-# Press the green button in the gutter to run the script.
-if __name__ == '__main__':
-    print_hi('PyCharm')
-
-# See PyCharm help at https://www.jetbrains.com/help/pycharm/

pyrox_client-0.0.1/pyproject.toml

@@ -1,23 +0,0 @@
-[build-system]
-requires = ["hatchling>=1.20"]
-build-backend = "hatchling.build"
-
-[project]
-name = "pyrox-client"
-version = "0.0.1"
-description = "HYROX race data client - retrieve full race results via Python"
-authors = [{name="Vlad Matei"}]
-readme = "README.md"
-license = {text = "MIT"}
-requires-python = ">=3.9"
-dependencies = ["pandas>=2.0", "fastparquet>=15", "requests>=2.31"]
-
-[project.optional-dependencies]
-duckdb = ["duckdb>=1.0.0"]
-
-[project.urls]
-homepage = "https://github.com/<you>/pyrox"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/pyrox"]           # import package path
-

pyrox_client-0.0.1/src/dist/.gitignore

@@ -1 +0,0 @@
-*

pyrox_client-0.0.1/src/pyrox/__init__.py

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

pyrox_client-0.0.1/src/pyrox/client.py

@@ -1,49 +0,0 @@
-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))