qemu.aqmp.error module

AQMP Error Classes

This package seeks to provide semantic error classes that are intended to be used directly by clients when they would like to handle particular semantic failures (e.g. “failed to connect”) without needing to know the enumeration of possible reasons for that failure.

AQMPError serves as the ancestor for all exceptions raised by this package, and is suitable for use in handling semantic errors from this library. In most cases, individual public methods will attempt to catch and re-encapsulate various exceptions to provide a semantic error-handling interface.

AQMP Exception Hierarchy Reference

Exception

+– AQMPError

+– ConnectError

+– StateError

+– ExecInterruptedError

+– ExecuteError

+– ListenerError

+– ProtocolError

+– DeserializationError

+– UnexpectedTypeError

+– ServerParseError

+– BadReplyError

+– GreetingError

+– NegotiationError

exception qemu.aqmp.error.AQMPError

Bases: Exception

Abstract error class for all errors originating from this package.

exception qemu.aqmp.error.ProtocolError(error_message: str)

Bases: qemu.aqmp.error.AQMPError

Abstract error class for protocol failures.

Semantically, these errors are generally the fault of either the protocol server or as a result of a bug in this library.

Parameters

error_message – Human-readable string describing the error.

error_message: str

Human-readable error message, without any prefix.