Module pyatv.exceptions

Local exceptions used by library.

Classes

class AuthenticationError (*args, **kwargs)

Thrown when authentication fails.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class BackOffError (*args, **kwargs)

Thrown when device mandates a backoff period.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class BlockedStateError (*args, **kwargs)

Thrown when calling a blocked method.

Typically, public interface methods (e.g. any method available via the object returned by connect()) becomes blocked after either calling close or because the connection was closed for some other reason.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class CommandError (*args, **kwargs)

Thrown when a command (e.g. play or pause) failed.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class ConnectionFailedError (*args, **kwargs)

Thrown when connection fails, e.g. refused or timed out.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class ConnectionLostError (*args, **kwargs)

Thrown when a connection is lost.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class DeviceIdMissingError (*args, **kwargs)

Thrown when device id is missing.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class HttpError (message: str, status_code: int)

Thrown when a HTTP error occurs.

Initialize a new HttpError.

Ancestors

Instance variables

var status_code -> int

Return status code that triggered the error.

class InvalidConfigError (*args, **kwargs)

Thrown when something is wrong or missing in the config.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class InvalidCredentialsError (*args, **kwargs)

Thrown if credentials are invalid.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class InvalidDmapDataError (*args, **kwargs)

Thrown when invalid DMAP data is parsed.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class InvalidResponseError (*args, **kwargs)

Thrown when a remote sends an invalid response.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class InvalidStateError (*args, **kwargs)

Thrown when trying to perform an action not possible in the current state.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class NoAsyncListenerError (*args, **kwargs)

Thrown when starting AsyncUpdater with no listener.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class NoCredentialsError (*args, **kwargs)

Thrown if credentials are missing.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class NoServiceError (*args, **kwargs)

Thrown when connecting to a device with no usable service.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class NonLocalSubnetError (*args, **kwargs)

Thrown when address it not in any local subnet.

DEPRECATED: Not used since 0.7.1. Will be removed in 0.9.0!

Ancestors

  • builtins.Exception
  • builtins.BaseException
class NotSupportedError (*args, **kwargs)

Thrown when trying to perform an action that is not supported.

Ancestors

  • builtins.NotImplementedError
  • builtins.RuntimeError
  • builtins.Exception
  • builtins.BaseException
class OperationTimeoutError (*args, **kwargs)

Raised when a timeout happens.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class PairingError (*args, **kwargs)

Thrown when pairing fails.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class PlaybackError (*args, **kwargs)

Thrown when media playback failed.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class ProtocolError (*args, **kwargs)

Thrown when a generic protocol error occurs.

Generic protocol errors includes for instance missing fields, incorrect or unexpected types, etc. Any error that can happen when communicating with a device that is not covered by another exception is covered by this exception.

Ancestors

  • builtins.Exception
  • builtins.BaseException

Subclasses

class SettingsError (*args, **kwargs)

Raised when an error related to settings happens.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class UnknownMediaKindError (*args, **kwargs)

Thrown when an unknown media kind is found.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class UnknownPlayStateError (*args, **kwargs)

Thrown when an unknown play state is found.

Ancestors

  • builtins.Exception
  • builtins.BaseException
class UnsupportedProtocolError (*args, **kwargs)

Thrown when an unsupported protocol was requested.

DEPRECATED: Not used since 0.8.0. Will be removed in 0.10.0!

Ancestors

  • builtins.Exception
  • builtins.BaseException