exceptions

GPIBLibraryError

GPIBLibraryError(
    *,
    message: str,
    name: str = "",
    ibsta: int = 0,
    iberr: int = 0
)

Bases: OSError

Exception from the GPIB library.

Parameters:

Name	Type	Description	Default
message	str	The error message.	required
name	str	The GPIB function name.	''
ibsta	int	The status value.	0
iberr	int	The error code.	0

Source code in src/msl/equipment/interfaces/gpib.py

def __init__(self, *, message: str, name: str = "", ibsta: int = 0, iberr: int = 0) -> None:
    """Exception from the GPIB library.

    Args:
        message: The error message.
        name: The GPIB function name.
        ibsta: The status value.
        iberr: The error code.
    """
    msg = message if not name else f"{message} [{name}(), ibsta:{hex(ibsta)}, iberr:{hex(iberr)}]"
    super().__init__(msg)

MSLConnectionError

MSLConnectionError(interface: Interface, message: str)

Bases: OSError

Base class for connection-related exceptions.

Parameters:

Name	Type	Description	Default
interface	Interface	An interface subclass.	required
message	str	A message to append to the generic error message.	required

Source code in src/msl/equipment/interfaces/message_based.py

def __init__(self, interface: Interface, message: str) -> None:
    """Base class for connection-related exceptions.

    Args:
        interface: An interface subclass.
        message: A message to append to the generic error message.
    """
    logger.error("%r %s", interface, message)
    super().__init__(f"{interface!r}\n{message}")

MSLTimeoutError

MSLTimeoutError(interface: MessageBased, message: str = '')

Bases: TimeoutError

A timeout exception for I/O operations.

Parameters:

Name	Type	Description	Default
interface	MessageBased	A message-based interface subclass.	required
message	str	An optional message to append to the generic timeout error message.	''

Source code in src/msl/equipment/interfaces/message_based.py

def __init__(self, interface: MessageBased, message: str = "") -> None:
    """A timeout exception for I/O operations.

    Args:
        interface: A message-based interface subclass.
        message: An optional message to append to the generic timeout error message.
    """
    msg = f"Timeout occurred after {interface.timeout} second(s). {message}"
    logger.error("%r %s", interface, msg)
    super().__init__(f"{interface!r}\n{msg}")