150342bb9e
- Extract helpers to reduce function sizes (listing_tasks, app.py, query.py, listing_fetcher) - Replace nonlocal mutations with _PipelineState dataclass in listing_tasks - Fix bugs: isinstance→equality check in repository, verify_exp for OIDC tokens - Consolidate duplicate filter methods in listing_repository - Move hardcoded config to env vars with backward-compatible defaults - Simplify CLI decorator to auto-build QueryParameters - Add deprecation docstring to data_access.py - Test count: 158 → 387 (all passing)
85 lines
1.8 KiB
Python
85 lines
1.8 KiB
Python
"""Custom exceptions for Rightmove API errors."""
|
|
|
|
|
|
class RightmoveAPIError(Exception):
|
|
"""Base exception for all Rightmove API errors."""
|
|
|
|
pass
|
|
|
|
|
|
class ThrottlingError(RightmoveAPIError):
|
|
"""Base exception for throttling-related errors.
|
|
|
|
Indicates that Rightmove is limiting our requests and we should back off.
|
|
"""
|
|
|
|
pass
|
|
|
|
|
|
class RateLimitError(ThrottlingError):
|
|
"""HTTP 429 - Too Many Requests.
|
|
|
|
Rightmove is explicitly rate limiting our requests.
|
|
"""
|
|
|
|
pass
|
|
|
|
|
|
class ServiceUnavailableError(ThrottlingError):
|
|
"""HTTP 503 - Service Unavailable.
|
|
|
|
Rightmove's service is temporarily unavailable, possibly due to overload.
|
|
"""
|
|
|
|
pass
|
|
|
|
|
|
class IPBlockedError(ThrottlingError):
|
|
"""HTTP 403 - Forbidden (IP blocked).
|
|
|
|
Our IP may be blocked or blacklisted by Rightmove.
|
|
"""
|
|
|
|
pass
|
|
|
|
|
|
class SlowResponseError(ThrottlingError):
|
|
"""Response time exceeded threshold.
|
|
|
|
API is responding very slowly, indicating potential throttling or overload.
|
|
"""
|
|
|
|
pass
|
|
|
|
|
|
class UnexpectedEmptyResponseError(RightmoveAPIError):
|
|
"""Empty response received when data was expected."""
|
|
|
|
pass
|
|
|
|
|
|
class InvalidResponseError(RightmoveAPIError):
|
|
"""Response contains error messages or invalid data."""
|
|
|
|
pass
|
|
|
|
|
|
class CircuitBreakerOpenError(RightmoveAPIError):
|
|
"""Circuit breaker is open, requests are being blocked.
|
|
|
|
The circuit breaker has detected too many failures and is preventing
|
|
further requests to allow the service to recover.
|
|
"""
|
|
|
|
pass
|
|
|
|
|
|
class RoutingApiError(Exception):
|
|
"""Error from the Google Routes API."""
|
|
|
|
def __init__(self, status_code: int, response_body: dict):
|
|
self.status_code = status_code
|
|
self.response_body = response_body
|
|
super().__init__(
|
|
f"Routes API returned status {status_code}: {response_body}"
|
|
)
|