Exceptions¶
Catch the narrowest exception that matches an application's recovery path. See Handle errors for practical patterns.
persistra.errors
¶
Public Persistra exceptions.
__all__ = ['AnalysisError', 'AuthenticationError', 'CacheError', 'DataValidationError', 'EntitlementError', 'NoDataError', 'PersistraError', 'ProjectError', 'ProviderError', 'RateLimitError', 'ResponseError', 'StoreError', 'TransportError']
module-attribute
¶
PersistraError
¶
Bases: Exception
Base class for Persistra failures.
DataValidationError
¶
Bases: PersistraError, ValueError
Raised when normalized data violates its contract.
ProviderError
¶
Bases: PersistraError
Base class for provider failures.
AuthenticationError
¶
Bases: ProviderError
Raised when provider credentials are invalid or absent.
EntitlementError
¶
Bases: ProviderError
Raised when an account cannot access requested data.
RateLimitError
¶
Bases: ProviderError
Raised when provider rate limiting exhausts all retries.
ResponseError
¶
Bases: ProviderError
Raised when a provider response is invalid.
TransportError
¶
Bases: ProviderError
Raised when transport retries are exhausted.
NoDataError
¶
Bases: ProviderError
Raised for an unambiguous provider no-data response.
CacheError
¶
Bases: PersistraError
Raised when a raw cache operation fails.
StoreError
¶
Bases: PersistraError
Raised when a normalized store operation fails.
ProjectError
¶
Bases: PersistraError, ValueError
Raised when a project manifest or layout operation fails.
AnalysisError
¶
Bases: PersistraError, ValueError
Raised when data violates a mathematical assumption.