Source code for hand_tracking_sdk.exceptions

"""Custom exception hierarchy for SDK parsing and runtime errors."""


[docs]
class HTSError(Exception):
    """Base exception for SDK errors."""




[docs]
class ParseError(HTSError):
    """Raised when incoming HTS lines cannot be parsed."""




[docs]
class TransportError(HTSError):
    """Base exception for transport-level errors."""




[docs]
class TransportClosedError(TransportError):
    """Raised when operating on a transport receiver that is not open."""




[docs]
class TransportTimeoutError(TransportError):
    """Raised when waiting for network I/O exceeds configured timeout."""




[docs]
class TransportDisconnectedError(TransportError):
    """Raised when a connected TCP peer disconnects."""




[docs]
class ClientError(HTSError):
    """Base exception for high-level client errors."""




[docs]
class ClientConfigurationError(ClientError):
    """Raised when high-level client configuration is invalid."""




[docs]
class ClientCallbackError(ClientError):
    """Raised when a user callback invoked by the client fails."""




[docs]
class VisualizationError(HTSError):
    """Base exception for visualization-layer errors."""




[docs]
class VisualizationDependencyError(VisualizationError):
    """Raised when an optional visualization dependency is not installed."""