mirror of
https://github.com/TauricResearch/TradingAgents.git
synced 2026-06-17 05:16:14 +03:00
7df18fc912
Every condition where a vendor cannot return usable data now derives from a single VendorError base (errors.py): NoMarketDataError, VendorRateLimitError, and VendorNotConfiguredError (still a ValueError for back-compat). Vendor-named errors subclass the generic bases, and the router catches the base types, so a new vendor needs no new except clause. Not-configured now has explicit try-next-vendor handling instead of falling through the generic catch-all. The number of error types tracks the number of distinct router reactions, not the number of causes.
56 lines
2.2 KiB
Python
56 lines
2.2 KiB
Python
"""Vendor data-error taxonomy.
|
|
|
|
A single hierarchy so the routing layer reacts by *behavior*, not by vendor:
|
|
every condition where a vendor cannot return usable data derives from
|
|
``VendorError``, and the router catches the base types. A new vendor raises
|
|
these (or a thin vendor-named subclass) and needs no new ``except`` clause.
|
|
|
|
VendorError
|
|
├── NoMarketDataError no usable rows (empty result OR stale data)
|
|
├── VendorRateLimitError transient throttle -> skip to next vendor
|
|
└── VendorNotConfiguredError missing API key/config -> vendor unavailable
|
|
|
|
The number of types is the number of distinct router reactions, not the number
|
|
of human-describable causes: empty and stale data get identical handling, so
|
|
they share ``NoMarketDataError`` and differ only in the free-text ``detail``.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
|
|
class VendorError(Exception):
|
|
"""Base for any condition where a vendor could not return usable data."""
|
|
|
|
|
|
class NoMarketDataError(VendorError):
|
|
"""A vendor returned no usable rows for a symbol (empty result or stale data).
|
|
|
|
Carries both the symbol the user requested and the canonical symbol the
|
|
vendor was actually queried with, plus a free-text ``detail``, so callers
|
|
can build a clear message instead of emitting a vendor-specific empty
|
|
string into the data channel.
|
|
"""
|
|
|
|
def __init__(self, symbol: str, canonical: str | None = None, detail: str = ""):
|
|
self.symbol = symbol
|
|
self.canonical = canonical or symbol
|
|
self.detail = detail
|
|
msg = f"No market data for {symbol!r}"
|
|
if canonical and canonical != symbol:
|
|
msg += f" (queried as {canonical!r})"
|
|
if detail:
|
|
msg += f": {detail}"
|
|
super().__init__(msg)
|
|
|
|
|
|
class VendorRateLimitError(VendorError):
|
|
"""A vendor throttled the request; the router skips to the next vendor."""
|
|
|
|
|
|
class VendorNotConfiguredError(VendorError, ValueError):
|
|
"""A vendor was selected but its API key/configuration is missing.
|
|
|
|
Also a ``ValueError`` so existing callers that catch ``ValueError`` keep
|
|
working while the routing layer can treat it as "vendor unavailable".
|
|
"""
|