bluez_peripheral.error module

exception bluez_peripheral.error.AlreadyExistsError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Raised when the object already exists.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.AlreadyExists'

exception bluez_peripheral.error.BluezDBusErrorBase(text=None, *, error=None)

Bases: DBusError

Base class for typed bluez dbus errors. Subclasses must define ERROR_TYPE.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str

exception bluez_peripheral.error.BluezNotAvailableError(message)

Bases: RuntimeError

Raised when org.bluez is not present on the dbus. This is normally because the bluetooth service is not running.

Parameters:

message (str)

exception bluez_peripheral.error.DoesNotExistError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Raised when the object does not exist.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.DoesNotExist'

exception bluez_peripheral.error.FailedError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Raised when an operation failed.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.Failed'

exception bluez_peripheral.error.InProgressError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Raised when an operation is already in progress.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.InProgress'

exception bluez_peripheral.error.InvalidArgumentsError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Indicates that an object has invalid or conflicting properties.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.InvalidArguments'

exception bluez_peripheral.error.InvalidOffsetError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Raised when an illegal offset is provided.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.InvalidOffset'

exception bluez_peripheral.error.InvalidValueLengthError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Raised when a written value was an illegal length.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.InvalidValueLength'

exception bluez_peripheral.error.NotAuthorizedError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Raised when the requester is not authorized for the operation.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.NotAuthorized'

exception bluez_peripheral.error.NotAvailableError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Raised when the requested resource is not available.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.NotAvailable'

exception bluez_peripheral.error.NotConnectedError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Raised when the target device is not connected.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.NotConnected'

exception bluez_peripheral.error.NotPermittedError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Raised when a requested operation is not permitted.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.NotPermitted'

exception bluez_peripheral.error.NotReadyError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Raised when the adapter or device is not ready.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.NotReady'

exception bluez_peripheral.error.NotSupportedError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Raised when the requested operation is not supported.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.NotSupported'

exception bluez_peripheral.error.RejectedError(text=None, *, error=None)

Bases: BluezDBusErrorBase

Raised when the pairing or operation was rejected.

Parameters:

• text (str | None)

• error (DBusError | None)

ERROR_TYPE: str = 'org.bluez.Error.Rejected'

class bluez_peripheral.error.bluez_error_wrapper

Bases: AbstractAsyncContextManager[None]

Translates DBusErrors into typed error classes (where supported)

Usage:

async with bluez_error_handler():

await adapter.start_discovery()

bluez_peripheral.error.translate_bluez_error(err)

Translate a raw DBusError into a typed error class if supported. Returns the original error if no mapping exists.

Parameters:

err (DBusError)

Return type:

DBusError