Errors¶

Custom exception types for the Stash GraphQL client.

Stash GraphQL Client exceptions.

This module provides exception classes for Stash client operations: - StashError: Base exception for all Stash-related errors - StashGraphQLError: GraphQL query/validation errors - StashConnectionError: Network/connection errors - StashServerError: Server-side errors (500, 503, etc.) - StashIntegrationError: Data integration/transformation errors - StashSystemNotReadyError: System not ready (SETUP/NEEDS_MIGRATION)

Classes¶

StashError ¶

StashError(*args: Any)

Bases: RuntimeError

Base exception for Stash-related errors.

This error is raised when communication with a Stash server fails or when Stash API operations encounter errors.

StashGraphQLError ¶

StashGraphQLError(*args: Any)

Bases: StashError

Raised when a GraphQL query fails validation or execution.

This may be caused by: - Invalid GraphQL query syntax - Querying non-existent fields - GraphQL validation errors - Query execution errors

StashConnectionError ¶

StashConnectionError(*args: Any)

Bases: StashError

Raised when connection to Stash server fails.

This may be caused by: - Network connectivity issues - Invalid Stash URL - Stash server not running - Authentication failures

StashServerError ¶

StashServerError(*args: Any)

Bases: StashError

Raised when Stash server returns an error response.

This may be caused by: - Internal server errors (500) - Service unavailable (503) - Other server-side issues

StashIntegrationError ¶

StashIntegrationError(*args: Any)

Bases: StashError

Raised when data integration or transformation fails.

This may be caused by: - Invalid data format from Stash API - Type conversion errors - Missing required fields - Schema version mismatches

StashSystemNotReadyError ¶

StashSystemNotReadyError(*args: Any)

Bases: StashError

Raised when Stash system is not ready for operations.

This occurs when the system status is: - SETUP: Initial setup required - NEEDS_MIGRATION: Database migration required

StashCleanupWarning ¶

Bases: UserWarning

Warning emitted when Stash cleanup tracker encounters errors during cleanup.