everestapi 0.2.4__tar.gz → 0.2.6__tar.gz

{everestapi-0.2.4/src/everestapi.egg-info → everestapi-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: everestapi
-Version: 0.2.4
+Version: 0.2.6
 Summary: Python SDK for the Everesteer prediction tournament platform
 Author-email: Everesteer <support@everesteer.ai>
 License-Expression: MIT

{everestapi-0.2.4 → everestapi-0.2.6}/src/everestapi/__init__.py

@@ -1,6 +1,6 @@
 """EverestAPI — Python SDK for the Everesteer prediction tournament platform."""
 
-__version__ = "0.2.4"
+__version__ = "0.2.6"
 
 from everestapi.client import EverestAPI, EverestError
 from everestapi.types import (

{everestapi-0.2.4 → everestapi-0.2.6}/src/everestapi/client.py

@@ -178,6 +178,22 @@ def _check_prediction_range(
         )
 
 
+def _resolve_default_base_url() -> str:
+    """Resolve the default API base URL.
+
+    Honors ``EIQ_BASE_URL`` first (the var the MCP server + onboarding set), then
+    legacy ``EVEREST_API_URL``, then defaults to the API host
+    ``https://app.everesteer.ai``. The apex ``everesteer.ai`` is a marketing site
+    (CloudFront→S3) that serves no ``/api`` — defaulting there returns an S3
+    ``AccessDenied`` for every call, so it is deliberately not the fallback.
+    """
+    return (
+        os.getenv("EIQ_BASE_URL")
+        or os.getenv("EVEREST_API_URL")
+        or "https://app.everesteer.ai"
+    )
+
+
 class EverestAPI:
     """Synchronous client for the Everesteer tournament API.
 
@@ -186,8 +202,11 @@ class EverestAPI:
     api_key : str, optional
         Everesteer API key. Falls back to ``EIQ_API_KEY`` (or legacy ``EVEREST_API_KEY``) env var.
     base_url : str, optional
-        Base URL for the API. Defaults to ``https://everesteer.ai`` (apex
-        domain), overridable via ``EVEREST_API_URL`` env var.
+        Base URL for the API. Defaults to the API host ``https://app.everesteer.ai``;
+        overridable via ``EIQ_BASE_URL`` (preferred — the var the MCP server and
+        onboarding set) or legacy ``EVEREST_API_URL``. The apex ``everesteer.ai``
+        is a marketing site (CloudFront→S3) that serves no ``/api``, so it is NOT
+        the default.
     timeout : float
         HTTP timeout in seconds.
     tournament : str
@@ -200,7 +219,7 @@ class EverestAPI:
         explicitly supplied.
     """
 
-    DEFAULT_BASE_URL = os.getenv("EVEREST_API_URL", "https://everesteer.ai")
+    DEFAULT_BASE_URL = _resolve_default_base_url()
 
     def __init__(
         self,
@@ -561,9 +580,17 @@ class EverestAPI:
 
         Splits: ``train`` / ``validation`` (features + targets), ``live``
         (current round features only).
+
+        Futures is served by the futures endpoint (``version`` is a no-op):
+        it returns the real bregen tree to full-scope keys and the
+        target-stripped hackathon tree to hackathon-scoped keys (EVE-931).
         """
         if output_path is None:
             output_path = f"{universe}_{split}.parquet"
+        # Futures uses the futures endpoint (see docstring); the version route
+        # below is full-scope-only and 403s hackathon-scoped keys.
+        if universe == "futures":
+            return self.download_futures_data(split=split, output_path=output_path)
         if version in (None, "latest", "current"):
             version = self._current_dataset_version(universe) or "v0"
         path = f"/api/v1/data/download/{version}/{universe}/{split}"

{everestapi-0.2.4 → everestapi-0.2.6/src/everestapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: everestapi
-Version: 0.2.4
+Version: 0.2.6
 Summary: Python SDK for the Everesteer prediction tournament platform
 Author-email: Everesteer <support@everesteer.ai>
 License-Expression: MIT

{everestapi-0.2.4 → everestapi-0.2.6}/tests/test_client.py

@@ -49,6 +49,35 @@ def test_get_universe(httpx_mock, api):
     assert result["count"] == 0
 
 
+# --------------------------------------------------------------------------- #
+# Default base URL resolution: EIQ_BASE_URL (ecosystem var) > EVEREST_API_URL >
+# the API host app.everesteer.ai. The apex everesteer.ai is a marketing site
+# that serves no /api, so it must never be the default — that was the CLI 403.
+# --------------------------------------------------------------------------- #
+def test_default_base_url_prefers_eiq_base_url(monkeypatch):
+    from everestapi.client import _resolve_default_base_url
+
+    monkeypatch.setenv("EIQ_BASE_URL", "https://app.everesteer.ai")
+    monkeypatch.setenv("EVEREST_API_URL", "https://legacy.example")
+    assert _resolve_default_base_url() == "https://app.everesteer.ai"
+
+
+def test_default_base_url_falls_back_to_legacy_var(monkeypatch):
+    from everestapi.client import _resolve_default_base_url
+
+    monkeypatch.delenv("EIQ_BASE_URL", raising=False)
+    monkeypatch.setenv("EVEREST_API_URL", "https://legacy.example")
+    assert _resolve_default_base_url() == "https://legacy.example"
+
+
+def test_default_base_url_defaults_to_app_host(monkeypatch):
+    from everestapi.client import _resolve_default_base_url
+
+    monkeypatch.delenv("EIQ_BASE_URL", raising=False)
+    monkeypatch.delenv("EVEREST_API_URL", raising=False)
+    assert _resolve_default_base_url() == "https://app.everesteer.ai"
+
+
 def test_submit_predictions_posts_body(httpx_mock, api):
     httpx_mock.add_response(
         url="http://test/api/v1/predictions",
@@ -92,6 +121,23 @@ def test_safe_output_path_rejects_traversal(api, tmp_path):
     assert _safe_output_path(str(tmp_path / "ok.bin")) == str(tmp_path / "ok.bin")
 
 
+def test_download_dataset_futures_uses_futures_endpoint(httpx_mock, api, tmp_path):
+    # EVE-931: futures must route through the futures endpoint (which serves
+    # hackathon-scoped keys), NOT the full-scope-only version route that 403s
+    # them. version is a no-op for futures.
+    httpx_mock.add_response(
+        url="http://test/api/v1/futures/data/validation", content=b"PARQUET"
+    )
+    out = api.download_dataset(
+        universe="futures", split="validation",
+        output_path=str(tmp_path / "f.parquet"), version="bregen",
+    )
+    assert out == str(tmp_path / "f.parquet")
+    paths = [r.url.path for r in httpx_mock.get_requests()]
+    assert paths == ["/api/v1/futures/data/validation"]
+    assert not any("/data/download" in p or "/data/versions" in p for p in paths)
+
+
 # --- Cloudflare Access service token ---------------------------------------
 # Staging sits behind Cloudflare Access; a service token clears the gate
 # programmatically. Headers ride alongside X-API-Key and stay absent by default.

{everestapi-0.2.4 → everestapi-0.2.6}/tests/test_mcp_and_models.py

@@ -75,18 +75,20 @@ def test_get_models(httpx_mock, api):
 # -- client: versioned dataset download (the #558 fix) -------------------
 
 
+# Non-futures universes still use the version-scoped route (futures bypasses it
+# via the futures endpoint, EVE-931 — see test_client.py).
 def test_download_dataset_uses_versioned_route(httpx_mock, api, tmp_path):
     httpx_mock.add_response(
-        url="http://test/api/v1/data/download/bregen/futures/train",
+        url="http://test/api/v1/data/download/bregen/equities/train",
         content=b"PAR1data",
     )
     out = api.download_dataset(
-        universe="futures",
+        universe="equities",
         split="train",
         version="bregen",
         output_path=str(tmp_path / "t.parquet"),
     )
-    assert httpx_mock.get_request().url.path == "/api/v1/data/download/bregen/futures/train"
+    assert httpx_mock.get_request().url.path == "/api/v1/data/download/bregen/equities/train"
     with open(out, "rb") as f:
         assert f.read() == b"PAR1data"
 
@@ -94,14 +96,14 @@ def test_download_dataset_uses_versioned_route(httpx_mock, api, tmp_path):
 def test_download_dataset_latest_resolves_version(httpx_mock, api, tmp_path):
     httpx_mock.add_response(
         url="http://test/api/v1/data/versions",
-        json={"versions": [{"version": "bregen", "universes": ["futures"]}]},
+        json={"versions": [{"version": "bregen", "universes": ["equities"]}]},
     )
     httpx_mock.add_response(
-        url="http://test/api/v1/data/download/bregen/futures/live",
+        url="http://test/api/v1/data/download/bregen/equities/live",
         content=b"PAR1live",
     )
     out = api.download_dataset(
-        universe="futures",
+        universe="equities",
         split="live",
         version="latest",
         output_path=str(tmp_path / "l.parquet"),