academy.exception

academy/exception.py

ActionCancelledError

ActionCancelledError(name: str)

Bases: Exception

Action was cancelled by the agent.

This often happens when an agent is shutdown mid-action execution and configured to cancel running actions.

Source code in academy/exception.py

def __init__(self, name: str) -> None:
    super().__init__(f'Action "{name}" was cancelled by the agent.')

AgentNotInitializedError

AgentNotInitializedError()

Bases: Exception

Agent runtime context has not been initialized.

This error is typically raised when accessing the runtime context for an agent before the agent has been executed.

Source code in academy/exception.py

def __init__(self) -> None:
    super().__init__(
        'Agent runtime context has not been initialized. '
        'Has the agent been started?',
    )

ExchangeError

Bases: Exception

Base type for exchange related errors.

BadEntityIdError

BadEntityIdError(uid: EntityId)

Bases: ExchangeError

Entity associated with the identifier is unknown.

Source code in academy/exception.py

def __init__(self, uid: EntityId) -> None:
    super().__init__(f'Unknown identifier {uid}.')

ForbiddenError

Bases: ExchangeError

Exchange client does not have permission to access resources.

MessageTooLargeError

MessageTooLargeError(size: int, limit: int)

Bases: ExchangeError

Message payload is too large for exchange.

If encountering this error, consider using the ProxyStoreExchangeTransport class an way to by-pass the exchange for large data.

Source code in academy/exception.py

def __init__(self, size: int, limit: int) -> None:
    self.size = size
    self.limit = limit

    super().__init__(
        f'Message of size {size} bytes is larger than limit {limit}.',
    )

MailboxTerminatedError

MailboxTerminatedError(uid: EntityId)

Bases: ExchangeError

Entity mailbox is terminated and cannot send or receive messages.

Constructing this error type implicitly returns one of the derived types, AgentTerminatedError or UserTerminatedError, based on the entity type.

Source code in academy/exception.py

def __init__(self, uid: EntityId) -> None:
    super().__init__(f'Mailbox for {uid} has been terminated.')
    self.uid = uid

AgentTerminatedError

AgentTerminatedError(uid: AgentId[Any])

Bases: MailboxTerminatedError

Agent mailbox is terminated and cannot send or receive messages.

Source code in academy/exception.py

def __init__(self, uid: AgentId[Any]) -> None:
    super().__init__(uid)

UserTerminatedError

UserTerminatedError(uid: UserId)

Bases: MailboxTerminatedError

User mailbox is terminated and cannot send or receive messages.

Source code in academy/exception.py

def __init__(self, uid: UserId) -> None:
    super().__init__(uid)

UnauthorizedError

Bases: ExchangeError

Exchange client has not provided valid authentication credentials.

ExchangeClientNotFoundError

ExchangeClientNotFoundError(aid: AgentId[Any])

Bases: Exception

Handle to agent can not find an exchange client to use.

A Handle is initialized with a target agent ID is not used in a context where an exchange client could be inferred. Typically this can be resolved by using a ExchangeClient or Manager as a context manager. If this error happens within an agent, it likely means the agent was not started.

Source code in academy/exception.py

def __init__(self, aid: AgentId[Any]) -> None:
    super().__init__(
        f'Handle to {aid} can not find an exchange client to use. See the '
        'exception docstring for troubleshooting.',
    )

raise_exceptions

raise_exceptions(
    exceptions: Iterable[BaseException],
    *,
    message: str | None = None
) -> None

Raise exceptions as a group.

Raises a set of exceptions as an ExceptionGroup in Python 3.11 and later. If only one exception is provided, it is raised directly. In Python 3.10 and older, only one exception is raised.

This is a no-op if the size of exceptions is zero.

Parameters:

• exceptions (Iterable[BaseException]) –

  An iterable of exceptions to raise.

• message (str | None, default: None ) –

  Custom error message for the exception group.

Source code in academy/exception.py

def raise_exceptions(
    exceptions: Iterable[BaseException],
    *,
    message: str | None = None,
) -> None:
    """Raise exceptions as a group.

    Raises a set of exceptions as an [`ExceptionGroup`][ExceptionGroup]
    in Python 3.11 and later. If only one exception is provided, it is raised
    directly. In Python 3.10 and older, only one exception is raised.

    This is a no-op if the size of `exceptions` is zero.

    Args:
        exceptions: An iterable of exceptions to raise.
        message: Custom error message for the exception group.
    """
    excs = tuple(exceptions)
    if len(excs) == 0:
        return

    if sys.version_info >= (3, 11) and len(excs) > 1:  # pragma: >=3.11 cover
        message = (
            message if message is not None else 'Caught multiple exceptions!'
        )
        # Note that BaseExceptionGroup will return ExceptionGroup if all
        # of the errors are Exception, rather than BaseException, so that this
        # can be caught by "except Exception".
        raise BaseExceptionGroup(message, excs)  # noqa: F821
    else:  # pragma: <3.11 cover
        raise excs[0]