Transaction Error

transaction_error

Application-layer transaction boundary error.

Defines TransactionError, raised when a transaction boundary operation
in the application layer fails — covering failures during transaction
begin, commit, or rollback.

Extends RuntimeErrorMixin so it is catchable as RuntimeError.

TransactionError

Bases: RuntimeErrorMixin, Error[MetadataValueType]

Raised when a transaction boundary operation fails.

Covers failures during transaction begin, commit, or rollback.
Extends RuntimeErrorMixin so it is catchable as
RuntimeError.

Example

error = TransactionError.from_string("Transaction commit failed")

Source code in src/forging_blocks/application/errors/transaction_error.py

class TransactionError[MetadataValueType = object](RuntimeErrorMixin, Error[MetadataValueType]):
    """Raised when a transaction boundary operation fails.

    Covers failures during transaction begin, commit, or rollback.
    Extends ``RuntimeErrorMixin`` so it is catchable as
    ``RuntimeError``.

    Example:
        ```python
        error = TransactionError.from_string("Transaction commit failed")
        ```

    """