Skip to content

Ethereum Test Exceptions package

Exceptions for invalid execution.

EngineAPIError

Bases: IntEnum

List of Engine API errors.

Source code in packages/testing/src/execution_testing/exceptions/engine_api.py 
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
class EngineAPIError(IntEnum):
    """List of Engine API errors."""

    ParseError = -32700
    InvalidRequest = -32600
    MethodNotFound = -32601
    InvalidParams = -32602
    InternalError = -32603
    ServerError = -32000
    UnknownPayload = -38001
    InvalidForkchoiceState = -38002
    InvalidPayloadAttributes = -38003
    TooLargeRequest = -38004
    UnsupportedFork = -38005

ExceptionMapper

Bases: ABC

Translate between EEST exceptions and error strings returned by client's t8n or other tools.

Source code in packages/testing/src/execution_testing/exceptions/exception_mapper.py 
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
class ExceptionMapper(ABC):
    """
    Translate between EEST exceptions and error strings returned by client's
    t8n or other tools.
    """

    mapper_name: str
    _mapping_compiled_regex: Dict[ExceptionBase, re.Pattern]

    mapping_substring: ClassVar[Dict[ExceptionBase, str]]
    """
    Mapping of exception to substring that should be present in the error
    message.

    Items in this mapping are used for substring matching (`substring in
    message`).
    """

    mapping_regex: ClassVar[Dict[ExceptionBase, str]]
    """
    Mapping of exception to regex that should be present in the error message.

    Items in this mapping are compiled into regex patterns for faster matching,
    and then used for regex matching (`pattern.search(message)`).
    """
    reliable: ClassVar[bool] = True
    """
    Whether the exceptions returned by the tool are reliable and can be
    accurately mapped to the exceptions in this class.
    """

    def __init__(self) -> None:
        """Initialize the exception mapper."""
        # Ensure that the subclass has properly defined mapping_substring
        # before accessing it
        assert self.mapping_substring is not None, (
            "mapping_substring must be defined in subclass"
        )
        assert self.mapping_regex is not None, (
            "mapping_regex must be defined in subclass"
        )
        self.mapper_name = self.__class__.__name__
        self._mapping_compiled_regex = {
            exception: re.compile(message)
            for exception, message in self.mapping_regex.items()
        }

    def message_to_exception(
        self, exception_string: str
    ) -> List[ExceptionBase] | UndefinedException:
        """Match a formatted string to an exception."""
        exceptions: List[ExceptionBase] = []
        for exception, substring in self.mapping_substring.items():
            if substring in exception_string:
                exceptions.append(exception)
        for exception, pattern in self._mapping_compiled_regex.items():
            if pattern.search(exception_string):
                exceptions.append(exception)
        if exceptions:
            return exceptions
        return UndefinedException(
            exception_string, mapper_name=self.mapper_name
        )

mapping_substring class-attribute

Mapping of exception to substring that should be present in the error message.

Items in this mapping are used for substring matching (substring in message).

mapping_regex class-attribute

Mapping of exception to regex that should be present in the error message.

Items in this mapping are compiled into regex patterns for faster matching, and then used for regex matching (pattern.search(message)).

reliable = True class-attribute

Whether the exceptions returned by the tool are reliable and can be accurately mapped to the exceptions in this class.

__init__()

Initialize the exception mapper.

Source code in packages/testing/src/execution_testing/exceptions/exception_mapper.py 
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
def __init__(self) -> None:
    """Initialize the exception mapper."""
    # Ensure that the subclass has properly defined mapping_substring
    # before accessing it
    assert self.mapping_substring is not None, (
        "mapping_substring must be defined in subclass"
    )
    assert self.mapping_regex is not None, (
        "mapping_regex must be defined in subclass"
    )
    self.mapper_name = self.__class__.__name__
    self._mapping_compiled_regex = {
        exception: re.compile(message)
        for exception, message in self.mapping_regex.items()
    }

message_to_exception(exception_string)

Match a formatted string to an exception.

Source code in packages/testing/src/execution_testing/exceptions/exception_mapper.py 
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
def message_to_exception(
    self, exception_string: str
) -> List[ExceptionBase] | UndefinedException:
    """Match a formatted string to an exception."""
    exceptions: List[ExceptionBase] = []
    for exception, substring in self.mapping_substring.items():
        if substring in exception_string:
            exceptions.append(exception)
    for exception, pattern in self._mapping_compiled_regex.items():
        if pattern.search(exception_string):
            exceptions.append(exception)
    if exceptions:
        return exceptions
    return UndefinedException(
        exception_string, mapper_name=self.mapper_name
    )

ExceptionMapperValidator = BeforeValidator(mapper_validator) module-attribute

Validator that can be used to annotate a pydantic field in a model that is meant to be parsed from an external tool or client.

The annotated type must be an union that can include None, UndefinedException and a custom model as: 

class BlockExceptionWithMessage(ExceptionWithMessage[BlockException]):
    pass
where BlockException can be any derivation of ExceptionBase.

The message attribute is the verbatim message received from the external tool or client, and can be used to be printed for extra context information in case of failures.

ExceptionWithMessage

Bases: BaseModel, Generic[ExceptionBoundTypeVar]

Class that contains the exception along with the verbatim message from the external tool/client.

Source code in packages/testing/src/execution_testing/exceptions/exception_mapper.py 
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
class ExceptionWithMessage(BaseModel, Generic[ExceptionBoundTypeVar]):
    """
    Class that contains the exception along with the verbatim message from the
    external tool/client.
    """

    exceptions: List[ExceptionBoundTypeVar]
    message: str

    def __contains__(self, item: Any) -> bool:
        """Check if the item is in the exceptions list."""
        if isinstance(item, list):
            return any(exception in self.exceptions for exception in item)
        return item in self.exceptions

    def __str__(self) -> str:
        """Return the string representation of the exception message."""
        return (
            f"[{' | '.join(str(e) for e in self.exceptions)}] {self.message}"
        )

__contains__(item)

Check if the item is in the exceptions list.

Source code in packages/testing/src/execution_testing/exceptions/exception_mapper.py 
90
91
92
93
94
def __contains__(self, item: Any) -> bool:
    """Check if the item is in the exceptions list."""
    if isinstance(item, list):
        return any(exception in self.exceptions for exception in item)
    return item in self.exceptions

__str__()

Return the string representation of the exception message.

Source code in packages/testing/src/execution_testing/exceptions/exception_mapper.py 
 96
 97
 98
 99
100
def __str__(self) -> str:
    """Return the string representation of the exception message."""
    return (
        f"[{' | '.join(str(e) for e in self.exceptions)}] {self.message}"
    )

BlockException

Bases: ExceptionBase

Exception raised when a block is invalid, but not due to a transaction.

E.g. all transactions in the block are valid, and can be applied to the state, but the block header contains an invalid field.

Source code in packages/testing/src/execution_testing/exceptions/exceptions/block.py 
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
@unique
class BlockException(ExceptionBase):
    """
    Exception raised when a block is invalid, but not due to a transaction.

    E.g. all transactions in the block are valid, and can be applied to the
    state, but the block header contains an invalid field.
    """

    TOO_MANY_UNCLES = auto()
    """Block declares too many uncles over the allowed limit."""
    UNCLE_IN_CHAIN = auto()
    """Block declares uncle header that is already imported into chain."""
    UNCLE_IS_ANCESTOR = auto()
    """Block declares uncle header that is directly a parent of this block."""
    UNCLE_IS_BROTHER = auto()
    """Block declares two similar uncle headers."""
    UNCLE_PARENT_INCORRECT = auto()
    """Block declares uncle header that is an outdated block to be an uncle."""
    EXTRA_DATA_TOO_BIG = auto()
    """Block header's extra data >32 bytes."""
    EXTRA_DATA_INVALID_DAO = auto()
    """
    Block header's extra data after dao fork must be a fixed pre defined hash.
    """
    UNKNOWN_PARENT = auto()
    """
    Block header's parent hash does not correspond to any of existing blocks on
    chain.
    """
    UNCLE_UNKNOWN_PARENT = auto()
    """
    Uncle header's parent hash does not correspond to any of existing blocks on
    chain.
    """
    UNKNOWN_PARENT_ZERO = auto()
    """Block header's parent hash is zero hash."""
    GASLIMIT_TOO_BIG = auto()
    """Block header's gas limit > 0x7fffffffffffffff."""
    INVALID_BLOCK_NUMBER = auto()
    """Block header's number != parent header's number + 1."""
    INVALID_BLOCK_TIMESTAMP_OLDER_THAN_PARENT = auto()
    """Block header's timestamp <= parent header's timestamp."""
    INVALID_DIFFICULTY = auto()
    """
    Block header's difficulty does not match the difficulty formula calculated
    from previous block.
    """
    INVALID_LOG_BLOOM = auto()
    """
    Block header's logs bloom hash does not match the actually computed log
    bloom.
    """
    INVALID_STATE_ROOT = auto()
    """
    Block header's state root hash does not match the actually computed hash of
    the state.
    """
    INVALID_RECEIPTS_ROOT = auto()
    """
    Block header's receipts root hash does not match the actually computed hash
    of receipts.
    """
    INVALID_TRANSACTIONS_ROOT = auto()
    """
    Block header's transactions root hash does not match the actually computed
    hash of tx tree.
    """
    INVALID_UNCLES_HASH = auto()
    """
    Block header's uncle hash does not match the actually computed hash of
    block's uncles.
    """
    GAS_USED_OVERFLOW = auto()
    """Block transactions consume more gas than block header allow."""
    INVALID_GASLIMIT = auto()
    """
    Block header's gas limit does not match the gas limit formula calculated
    from previous block.
    """
    INVALID_BASEFEE_PER_GAS = auto()
    """Block header's base_fee_per_gas field is calculated incorrectly."""
    INVALID_GAS_USED = auto()
    """
    Block header's actual gas used does not match the provided header's value
    """
    INVALID_GAS_USED_ABOVE_LIMIT = auto()
    """Block header's gas used value is above the gas limit field's value."""
    INVALID_WITHDRAWALS_ROOT = auto()
    """
    Block header's withdrawals root does not match calculated withdrawals root.
    """
    INCORRECT_BLOCK_FORMAT = auto()
    """
    Block's format is incorrect, contains invalid fields, is missing fields, or
    contains fields of a fork that is not active yet.
    """
    BLOB_GAS_USED_ABOVE_LIMIT = auto()
    """Block's blob gas used in header is above the limit."""
    INCORRECT_BLOB_GAS_USED = auto()
    """Block's blob gas used in header is incorrect."""
    INCORRECT_EXCESS_BLOB_GAS = auto()
    """Block's excess blob gas in header is incorrect."""
    INVALID_VERSIONED_HASHES = auto()
    """Incorrect number of versioned hashes in a payload."""
    RLP_STRUCTURES_ENCODING = auto()
    """
    Block's rlp encoding is valid but ethereum structures in it are invalid.
    """
    RLP_WITHDRAWALS_NOT_READ = auto()
    """Block's rlp encoding is missing withdrawals."""
    RLP_INVALID_FIELD_OVERFLOW_64 = auto()
    """One of block's fields rlp is overflow 2**64 value."""
    RLP_INVALID_ADDRESS = auto()
    """Block withdrawals address is rlp of invalid address != 20 bytes."""
    RLP_BLOCK_LIMIT_EXCEEDED = auto()
    """Block's rlp encoding is larger than the allowed limit."""
    INVALID_REQUESTS = auto()
    """Block's requests are invalid."""
    IMPORT_IMPOSSIBLE_LEGACY = auto()
    """Legacy block import is impossible in this chain configuration."""
    IMPORT_IMPOSSIBLE_LEGACY_WRONG_PARENT = auto()
    """
    Legacy block import is impossible, trying to import on top of a block that
    is not legacy.
    """
    IMPORT_IMPOSSIBLE_LONDON_WRONG_PARENT = auto()
    """
    Trying to import london (basefee) block on top of block that is not 1559.
    """
    IMPORT_IMPOSSIBLE_PARIS_WRONG_POW = auto()
    """Trying to import paris(merge) block with PoW enabled."""
    IMPORT_IMPOSSIBLE_PARIS_WRONG_POS = auto()
    """
    Trying to import paris(merge) block with PoS enabled before TTD is reached.
    """
    IMPORT_IMPOSSIBLE_LONDON_OVER_PARIS = auto()
    """Trying to import london looking block over paris network (POS)."""
    IMPORT_IMPOSSIBLE_PARIS_OVER_SHANGHAI = auto()
    """Trying to import paris block on top of shanghai block."""
    IMPORT_IMPOSSIBLE_SHANGHAI = auto()
    """Shanghai block import is impossible in this chain configuration."""
    IMPORT_IMPOSSIBLE_UNCLES_OVER_PARIS = auto()
    """
    Trying to import a block after paris fork that has not empty uncles hash.
    """
    IMPORT_IMPOSSIBLE_DIFFICULTY_OVER_PARIS = auto()
    """Trying to import a block after paris fork that has difficulty != 0."""
    SYSTEM_CONTRACT_EMPTY = auto()
    """
    A system contract address contains no code at the end of fork activation
    block.
    """
    SYSTEM_CONTRACT_CALL_FAILED = auto()
    """
    A system contract call at the end of block execution (from the system
    address) fails.
    """
    INVALID_BLOCK_HASH = auto()
    """
    Block header's hash does not match the actually computed hash of the block.
    """
    INVALID_DEPOSIT_EVENT_LAYOUT = auto()
    """
    Transaction emits a `DepositEvent` in the deposit contract (EIP-6110), but
    the layout of the event does not match the required layout.
    """
    # --- Block-Level Access Lists (EIP-7928) --- #
    INVALID_BLOCK_ACCESS_LIST = auto()
    """Block's access list is invalid."""
    INVALID_BAL_HASH = auto()
    """Block header's BAL hash does not match the computed BAL hash."""
    BLOCK_ACCESS_LIST_GAS_LIMIT_EXCEEDED = auto()
    """
    Block access list exceeds the gas limit constraint (EIP-7928).
    """

TOO_MANY_UNCLES = auto() class-attribute instance-attribute

Block declares too many uncles over the allowed limit.

UNCLE_IN_CHAIN = auto() class-attribute instance-attribute

Block declares uncle header that is already imported into chain.

UNCLE_IS_ANCESTOR = auto() class-attribute instance-attribute

Block declares uncle header that is directly a parent of this block.

UNCLE_IS_BROTHER = auto() class-attribute instance-attribute

Block declares two similar uncle headers.

UNCLE_PARENT_INCORRECT = auto() class-attribute instance-attribute

Block declares uncle header that is an outdated block to be an uncle.

EXTRA_DATA_TOO_BIG = auto() class-attribute instance-attribute

Block header's extra data >32 bytes.

EXTRA_DATA_INVALID_DAO = auto() class-attribute instance-attribute

Block header's extra data after dao fork must be a fixed pre defined hash.

UNKNOWN_PARENT = auto() class-attribute instance-attribute

Block header's parent hash does not correspond to any of existing blocks on chain.

UNCLE_UNKNOWN_PARENT = auto() class-attribute instance-attribute

Uncle header's parent hash does not correspond to any of existing blocks on chain.

UNKNOWN_PARENT_ZERO = auto() class-attribute instance-attribute

Block header's parent hash is zero hash.

GASLIMIT_TOO_BIG = auto() class-attribute instance-attribute

Block header's gas limit > 0x7fffffffffffffff.

INVALID_BLOCK_NUMBER = auto() class-attribute instance-attribute

Block header's number != parent header's number + 1.

INVALID_BLOCK_TIMESTAMP_OLDER_THAN_PARENT = auto() class-attribute instance-attribute

Block header's timestamp <= parent header's timestamp.

INVALID_DIFFICULTY = auto() class-attribute instance-attribute

Block header's difficulty does not match the difficulty formula calculated from previous block.

INVALID_LOG_BLOOM = auto() class-attribute instance-attribute

Block header's logs bloom hash does not match the actually computed log bloom.

INVALID_STATE_ROOT = auto() class-attribute instance-attribute

Block header's state root hash does not match the actually computed hash of the state.

INVALID_RECEIPTS_ROOT = auto() class-attribute instance-attribute

Block header's receipts root hash does not match the actually computed hash of receipts.

INVALID_TRANSACTIONS_ROOT = auto() class-attribute instance-attribute

Block header's transactions root hash does not match the actually computed hash of tx tree.

INVALID_UNCLES_HASH = auto() class-attribute instance-attribute

Block header's uncle hash does not match the actually computed hash of block's uncles.

GAS_USED_OVERFLOW = auto() class-attribute instance-attribute

Block transactions consume more gas than block header allow.

INVALID_GASLIMIT = auto() class-attribute instance-attribute

Block header's gas limit does not match the gas limit formula calculated from previous block.

INVALID_BASEFEE_PER_GAS = auto() class-attribute instance-attribute

Block header's base_fee_per_gas field is calculated incorrectly.

INVALID_GAS_USED = auto() class-attribute instance-attribute

Block header's actual gas used does not match the provided header's value

INVALID_GAS_USED_ABOVE_LIMIT = auto() class-attribute instance-attribute

Block header's gas used value is above the gas limit field's value.

INVALID_WITHDRAWALS_ROOT = auto() class-attribute instance-attribute

Block header's withdrawals root does not match calculated withdrawals root.

INCORRECT_BLOCK_FORMAT = auto() class-attribute instance-attribute

Block's format is incorrect, contains invalid fields, is missing fields, or contains fields of a fork that is not active yet.

BLOB_GAS_USED_ABOVE_LIMIT = auto() class-attribute instance-attribute

Block's blob gas used in header is above the limit.

INCORRECT_BLOB_GAS_USED = auto() class-attribute instance-attribute

Block's blob gas used in header is incorrect.

INCORRECT_EXCESS_BLOB_GAS = auto() class-attribute instance-attribute

Block's excess blob gas in header is incorrect.

INVALID_VERSIONED_HASHES = auto() class-attribute instance-attribute

Incorrect number of versioned hashes in a payload.

RLP_STRUCTURES_ENCODING = auto() class-attribute instance-attribute

Block's rlp encoding is valid but ethereum structures in it are invalid.

RLP_WITHDRAWALS_NOT_READ = auto() class-attribute instance-attribute

Block's rlp encoding is missing withdrawals.

RLP_INVALID_FIELD_OVERFLOW_64 = auto() class-attribute instance-attribute

One of block's fields rlp is overflow 2**64 value.

RLP_INVALID_ADDRESS = auto() class-attribute instance-attribute

Block withdrawals address is rlp of invalid address != 20 bytes.

RLP_BLOCK_LIMIT_EXCEEDED = auto() class-attribute instance-attribute

Block's rlp encoding is larger than the allowed limit.

INVALID_REQUESTS = auto() class-attribute instance-attribute

Block's requests are invalid.

IMPORT_IMPOSSIBLE_LEGACY = auto() class-attribute instance-attribute

Legacy block import is impossible in this chain configuration.

IMPORT_IMPOSSIBLE_LEGACY_WRONG_PARENT = auto() class-attribute instance-attribute

Legacy block import is impossible, trying to import on top of a block that is not legacy.

IMPORT_IMPOSSIBLE_LONDON_WRONG_PARENT = auto() class-attribute instance-attribute

Trying to import london (basefee) block on top of block that is not 1559.

IMPORT_IMPOSSIBLE_PARIS_WRONG_POW = auto() class-attribute instance-attribute

Trying to import paris(merge) block with PoW enabled.

IMPORT_IMPOSSIBLE_PARIS_WRONG_POS = auto() class-attribute instance-attribute

Trying to import paris(merge) block with PoS enabled before TTD is reached.

IMPORT_IMPOSSIBLE_LONDON_OVER_PARIS = auto() class-attribute instance-attribute

Trying to import london looking block over paris network (POS).

IMPORT_IMPOSSIBLE_PARIS_OVER_SHANGHAI = auto() class-attribute instance-attribute

Trying to import paris block on top of shanghai block.

IMPORT_IMPOSSIBLE_SHANGHAI = auto() class-attribute instance-attribute

Shanghai block import is impossible in this chain configuration.

IMPORT_IMPOSSIBLE_UNCLES_OVER_PARIS = auto() class-attribute instance-attribute

Trying to import a block after paris fork that has not empty uncles hash.

IMPORT_IMPOSSIBLE_DIFFICULTY_OVER_PARIS = auto() class-attribute instance-attribute

Trying to import a block after paris fork that has difficulty != 0.

SYSTEM_CONTRACT_EMPTY = auto() class-attribute instance-attribute

A system contract address contains no code at the end of fork activation block.

SYSTEM_CONTRACT_CALL_FAILED = auto() class-attribute instance-attribute

A system contract call at the end of block execution (from the system address) fails.

INVALID_BLOCK_HASH = auto() class-attribute instance-attribute

Block header's hash does not match the actually computed hash of the block.

INVALID_DEPOSIT_EVENT_LAYOUT = auto() class-attribute instance-attribute

Transaction emits a DepositEvent in the deposit contract (EIP-6110), but the layout of the event does not match the required layout.

INVALID_BLOCK_ACCESS_LIST = auto() class-attribute instance-attribute

Block's access list is invalid.

INVALID_BAL_HASH = auto() class-attribute instance-attribute

Block header's BAL hash does not match the computed BAL hash.

BLOCK_ACCESS_LIST_GAS_LIMIT_EXCEEDED = auto() class-attribute instance-attribute

Block access list exceeds the gas limit constraint (EIP-7928).

ExceptionBase

Bases: Enum

Base class for exceptions.

Source code in packages/testing/src/execution_testing/exceptions/exceptions/base.py 
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
class ExceptionBase(Enum):
    """Base class for exceptions."""

    def __init_subclass__(cls) -> None:
        """Register the exception class."""
        super().__init_subclass__()
        _exception_classes[cls.__name__] = cls

    @classmethod
    def __get_pydantic_core_schema__(
        cls, source_type: Any, handler: GetCoreSchemaHandler
    ) -> PlainValidatorFunctionSchema:
        """
        Call class constructor without info and appends the serialization
        schema.
        """
        return no_info_plain_validator_function(
            cls.from_str,
            serialization=to_string_ser_schema(),
        )

    @classmethod
    def from_str(cls, value: "str | ExceptionBase") -> "ExceptionBase":
        """Return ContainerKind enum value from a string."""
        if isinstance(value, ExceptionBase):
            return value

        class_name, enum_name = value.split(".")

        if cls == ExceptionBase:
            # Exception base automatically resolves the class
            assert class_name in _exception_classes, (
                f"No such exception class: {class_name}"
            )
            exception_class = _exception_classes[class_name]
        else:
            # Otherwise, use the class that the method is called on
            assert cls.__name__ == class_name, (
                f"Unexpected exception type: {class_name}, "
                f"expected {cls.__name__}"
            )
            exception_class = cls

        exception = getattr(exception_class, enum_name, None)
        if exception is not None:
            return exception
        raise ValueError(f"No such exception in {class_name}: {value}")

    def __contains__(self, exception: "ExceptionBase") -> bool:
        """Check if provided exception is equal to this."""
        return self == exception

    def __str__(self) -> str:
        """Return string representation of the exception."""
        return f"{self.__class__.__name__}.{self.name}"

__init_subclass__()

Register the exception class.

Source code in packages/testing/src/execution_testing/exceptions/exceptions/base.py 
19
20
21
22
def __init_subclass__(cls) -> None:
    """Register the exception class."""
    super().__init_subclass__()
    _exception_classes[cls.__name__] = cls

__get_pydantic_core_schema__(source_type, handler) classmethod

Call class constructor without info and appends the serialization schema.

Source code in packages/testing/src/execution_testing/exceptions/exceptions/base.py 
24
25
26
27
28
29
30
31
32
33
34
35
@classmethod
def __get_pydantic_core_schema__(
    cls, source_type: Any, handler: GetCoreSchemaHandler
) -> PlainValidatorFunctionSchema:
    """
    Call class constructor without info and appends the serialization
    schema.
    """
    return no_info_plain_validator_function(
        cls.from_str,
        serialization=to_string_ser_schema(),
    )

from_str(value) classmethod

Return ContainerKind enum value from a string.

Source code in packages/testing/src/execution_testing/exceptions/exceptions/base.py 
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
@classmethod
def from_str(cls, value: "str | ExceptionBase") -> "ExceptionBase":
    """Return ContainerKind enum value from a string."""
    if isinstance(value, ExceptionBase):
        return value

    class_name, enum_name = value.split(".")

    if cls == ExceptionBase:
        # Exception base automatically resolves the class
        assert class_name in _exception_classes, (
            f"No such exception class: {class_name}"
        )
        exception_class = _exception_classes[class_name]
    else:
        # Otherwise, use the class that the method is called on
        assert cls.__name__ == class_name, (
            f"Unexpected exception type: {class_name}, "
            f"expected {cls.__name__}"
        )
        exception_class = cls

    exception = getattr(exception_class, enum_name, None)
    if exception is not None:
        return exception
    raise ValueError(f"No such exception in {class_name}: {value}")

__contains__(exception)

Check if provided exception is equal to this.

Source code in packages/testing/src/execution_testing/exceptions/exceptions/base.py 
64
65
66
def __contains__(self, exception: "ExceptionBase") -> bool:
    """Check if provided exception is equal to this."""
    return self == exception

__str__()

Return string representation of the exception.

Source code in packages/testing/src/execution_testing/exceptions/exceptions/base.py 
68
69
70
def __str__(self) -> str:
    """Return string representation of the exception."""
    return f"{self.__class__.__name__}.{self.name}"

TransactionException

Bases: ExceptionBase

Exception raised when a transaction is invalid, and thus cannot be executed.

If a transaction with any of these exceptions is included in a block, the block is invalid.

Source code in packages/testing/src/execution_testing/exceptions/exceptions/transaction.py 
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
@unique
class TransactionException(ExceptionBase):
    """
    Exception raised when a transaction is invalid, and thus cannot be
    executed.

    If a transaction with any of these exceptions is included in a block, the
    block is invalid.
    """

    TYPE_NOT_SUPPORTED = auto()
    """Transaction type is not supported on this chain configuration."""
    SENDER_NOT_EOA = auto()
    """Transaction is coming from address that is not exist anymore."""
    ADDRESS_TOO_SHORT = auto()
    """Transaction `to` is not allowed to be less than 20 bytes."""
    ADDRESS_TOO_LONG = auto()
    """Transaction `to` is not allowed to be more than 20 bytes."""
    NONCE_MISMATCH_TOO_HIGH = auto()
    """Transaction nonce > sender.nonce."""
    NONCE_MISMATCH_TOO_LOW = auto()
    """Transaction nonce < sender.nonce."""
    NONCE_TOO_BIG = auto()
    """
    Transaction `nonce` is not allowed to be max_uint64 - 1 (this is probably
    TransactionTest).
    """
    NONCE_IS_MAX = auto()
    """
    Transaction `nonce` is not allowed to be max_uint64 - 1 (this is
    StateTests).
    """
    NONCE_OVERFLOW = auto()
    """Transaction `nonce` is not allowed to be more than uint64."""
    GASLIMIT_OVERFLOW = auto()
    """Transaction gaslimit exceeds 2^64-1 maximum value."""
    VALUE_OVERFLOW = auto()
    """Transaction value exceeds 2^256-1 maximum value."""
    GASPRICE_OVERFLOW = auto()
    """Transaction gasPrice exceeds 2^256-1 maximum value."""
    GASLIMIT_PRICE_PRODUCT_OVERFLOW = auto()
    """Transaction gasPrice * gasLimit exceeds 2^256-1 maximum value."""
    INVALID_SIGNATURE_VRS = auto()
    """Invalid transaction v, r, s values."""
    RLP_INVALID_SIGNATURE_R = auto()
    """Error reading transaction signature R value."""
    RLP_INVALID_SIGNATURE_S = auto()
    """Error reading transaction signature S value."""
    RLP_LEADING_ZEROS_GASLIMIT = auto()
    """Error reading transaction gaslimit field RLP."""
    RLP_LEADING_ZEROS_GASPRICE = auto()
    """Error reading transaction gasprice field RLP."""
    RLP_LEADING_ZEROS_VALUE = auto()
    """Error reading transaction value field RLP."""
    RLP_LEADING_ZEROS_NONCE = auto()
    """Error reading transaction nonce field RLP."""
    RLP_LEADING_ZEROS_R = auto()
    """Error reading transaction signature R field RLP."""
    RLP_LEADING_ZEROS_S = auto()
    """Error reading transaction signature S field RLP."""
    RLP_LEADING_ZEROS_V = auto()
    """Error reading transaction signature V field RLP."""
    RLP_LEADING_ZEROS_BASEFEE = auto()
    """Error reading transaction basefee field RLP."""
    RLP_LEADING_ZEROS_PRIORITY_FEE = auto()
    """Error reading transaction priority fee field RLP."""
    RLP_LEADING_ZEROS_DATA_SIZE = auto()
    """
    Error reading transaction data field RLP, (rlp field length has leading
    zeros).
    """
    RLP_LEADING_ZEROS_NONCE_SIZE = auto()
    """
    Error reading transaction nonce field RLP, (rlp field length has leading
    zeros).
    """
    RLP_TOO_FEW_ELEMENTS = auto()
    """
    Error reading transaction RLP, structure has too few elements than
    expected.
    """
    RLP_TOO_MANY_ELEMENTS = auto()
    """
    Error reading transaction RLP, structure has too many elements than
    expected.
    """
    RLP_ERROR_EOF = auto()
    """Error reading transaction RLP, rlp stream unexpectedly finished."""
    RLP_ERROR_SIZE = auto()
    """Error reading transaction RLP, rlp size is invalid."""
    RLP_ERROR_SIZE_LEADING_ZEROS = auto()
    """Error reading transaction RLP, field size has leading zeros."""
    INVALID_CHAINID = auto()
    """Transaction chain id encoding is incorrect."""
    RLP_INVALID_DATA = auto()
    """Transaction data field is invalid rlp."""
    RLP_INVALID_GASLIMIT = auto()
    """Transaction gaslimit field is invalid rlp."""
    RLP_INVALID_NONCE = auto()
    """Transaction nonce field is invalid rlp."""
    RLP_INVALID_TO = auto()
    """Transaction to field is invalid rlp."""
    RLP_INVALID_ACCESS_LIST_ADDRESS_TOO_LONG = auto()
    """Transaction access list address is > 20 bytes."""
    RLP_INVALID_ACCESS_LIST_ADDRESS_TOO_SHORT = auto()
    """Transaction access list address is < 20 bytes."""
    RLP_INVALID_ACCESS_LIST_STORAGE_TOO_LONG = auto()
    """Transaction access list storage hash > 32 bytes."""
    RLP_INVALID_ACCESS_LIST_STORAGE_TOO_SHORT = auto()
    """Transaction access list storage hash < 32 bytes."""
    RLP_INVALID_HEADER = auto()
    """Transaction failed to read from RLP as rlp header is invalid."""
    RLP_INVALID_VALUE = auto()
    """Transaction value field is invalid rlp/structure."""
    EC_RECOVERY_FAIL = auto()
    """Transaction has correct signature, but ec recovery failed."""
    INSUFFICIENT_ACCOUNT_FUNDS = auto()
    """
    Transaction's sender does not have enough funds to pay for the transaction.
    """
    INSUFFICIENT_MAX_FEE_PER_GAS = auto()
    """Transaction's max-fee-per-gas is lower than the block base-fee."""
    PRIORITY_OVERFLOW = auto()
    """
    Transaction's max-priority-fee-per-gas exceeds 2^256-1 maximum value.
    """
    PRIORITY_GREATER_THAN_MAX_FEE_PER_GAS = auto()
    """
    Transaction's max-priority-fee-per-gas is greater than the max-fee-per-gas.
    """
    PRIORITY_GREATER_THAN_MAX_FEE_PER_GAS_2 = auto()
    """
    Transaction's max-priority-fee-per-gas is greater than the max-fee-per-gas
    (TransactionTests).
    """
    INSUFFICIENT_MAX_FEE_PER_BLOB_GAS = auto()
    """
    Transaction's max-fee-per-blob-gas is lower than the block's blob-gas
    price.
    """
    INTRINSIC_GAS_TOO_LOW = auto()
    """Transaction's gas limit is too low."""
    INTRINSIC_GAS_BELOW_FLOOR_GAS_COST = auto()
    """Transaction's gas limit is below the floor gas cost."""
    INITCODE_SIZE_EXCEEDED = auto()
    """
    Transaction's initcode for a contract-creating transaction is too large.
    """
    TYPE_1_TX_PRE_FORK = auto()
    """Transaction type 1 included before activation fork."""
    TYPE_2_TX_PRE_FORK = auto()
    """Transaction type 2 included before activation fork."""
    TYPE_3_TX_PRE_FORK = auto()
    """Transaction type 3 included before activation fork."""
    TYPE_3_TX_ZERO_BLOBS_PRE_FORK = auto()
    """Transaction type 3, with zero blobs, included before activation fork."""
    TYPE_3_TX_INVALID_BLOB_VERSIONED_HASH = auto()
    """Transaction contains a blob versioned hash with an invalid version."""
    TYPE_3_TX_WITH_FULL_BLOBS = auto()
    """Transaction contains full blobs (network-version of the transaction)."""
    TYPE_3_TX_BLOB_COUNT_EXCEEDED = auto()
    """Transaction contains too many blob versioned hashes."""
    TYPE_3_TX_CONTRACT_CREATION = auto()
    """Transaction is a type 3 transaction and has an empty `to`."""
    TYPE_3_TX_MAX_BLOB_GAS_ALLOWANCE_EXCEEDED = auto()
    """Transaction causes block to go over blob gas limit."""
    GAS_ALLOWANCE_EXCEEDED = auto()
    """Transaction causes block to go over blob gas limit."""
    GAS_LIMIT_EXCEEDS_MAXIMUM = auto()
    """
    Transaction gas limit exceeds the maximum allowed limit for the given fork.
    """
    TYPE_3_TX_ZERO_BLOBS = auto()
    """Transaction is type 3, but has no blobs."""
    TYPE_4_EMPTY_AUTHORIZATION_LIST = auto()
    """Transaction is type 4, but has an empty authorization list."""
    TYPE_4_INVALID_AUTHORITY_SIGNATURE = auto()
    """Transaction authority signature is invalid"""
    TYPE_4_INVALID_AUTHORITY_SIGNATURE_S_TOO_HIGH = auto()
    """Transaction authority signature is invalid"""
    TYPE_4_TX_CONTRACT_CREATION = auto()
    """Transaction is a type 4 transaction and has an empty `to`."""
    TYPE_4_INVALID_AUTHORIZATION_FORMAT = auto()
    """
    Transaction is type 4, but contains an authorization that has an invalid
    format.
    """
    TYPE_4_TX_PRE_FORK = auto()
    """Transaction type 4 included before activation fork."""
    LOG_MISMATCH = auto()
    """Transaction receipt logs do not match expected logs."""

TYPE_NOT_SUPPORTED = auto() class-attribute instance-attribute

Transaction type is not supported on this chain configuration.

SENDER_NOT_EOA = auto() class-attribute instance-attribute

Transaction is coming from address that is not exist anymore.

ADDRESS_TOO_SHORT = auto() class-attribute instance-attribute

Transaction to is not allowed to be less than 20 bytes.

ADDRESS_TOO_LONG = auto() class-attribute instance-attribute

Transaction to is not allowed to be more than 20 bytes.

NONCE_MISMATCH_TOO_HIGH = auto() class-attribute instance-attribute

Transaction nonce > sender.nonce.

NONCE_MISMATCH_TOO_LOW = auto() class-attribute instance-attribute

Transaction nonce < sender.nonce.

NONCE_TOO_BIG = auto() class-attribute instance-attribute

Transaction nonce is not allowed to be max_uint64 - 1 (this is probably TransactionTest).

NONCE_IS_MAX = auto() class-attribute instance-attribute

Transaction nonce is not allowed to be max_uint64 - 1 (this is StateTests).

NONCE_OVERFLOW = auto() class-attribute instance-attribute

Transaction nonce is not allowed to be more than uint64.

GASLIMIT_OVERFLOW = auto() class-attribute instance-attribute

Transaction gaslimit exceeds 2^64-1 maximum value.

VALUE_OVERFLOW = auto() class-attribute instance-attribute

Transaction value exceeds 2^256-1 maximum value.

GASPRICE_OVERFLOW = auto() class-attribute instance-attribute

Transaction gasPrice exceeds 2^256-1 maximum value.

GASLIMIT_PRICE_PRODUCT_OVERFLOW = auto() class-attribute instance-attribute

Transaction gasPrice * gasLimit exceeds 2^256-1 maximum value.

INVALID_SIGNATURE_VRS = auto() class-attribute instance-attribute

Invalid transaction v, r, s values.

RLP_INVALID_SIGNATURE_R = auto() class-attribute instance-attribute

Error reading transaction signature R value.

RLP_INVALID_SIGNATURE_S = auto() class-attribute instance-attribute

Error reading transaction signature S value.

RLP_LEADING_ZEROS_GASLIMIT = auto() class-attribute instance-attribute

Error reading transaction gaslimit field RLP.

RLP_LEADING_ZEROS_GASPRICE = auto() class-attribute instance-attribute

Error reading transaction gasprice field RLP.

RLP_LEADING_ZEROS_VALUE = auto() class-attribute instance-attribute

Error reading transaction value field RLP.

RLP_LEADING_ZEROS_NONCE = auto() class-attribute instance-attribute

Error reading transaction nonce field RLP.

RLP_LEADING_ZEROS_R = auto() class-attribute instance-attribute

Error reading transaction signature R field RLP.

RLP_LEADING_ZEROS_S = auto() class-attribute instance-attribute

Error reading transaction signature S field RLP.

RLP_LEADING_ZEROS_V = auto() class-attribute instance-attribute

Error reading transaction signature V field RLP.

RLP_LEADING_ZEROS_BASEFEE = auto() class-attribute instance-attribute

Error reading transaction basefee field RLP.

RLP_LEADING_ZEROS_PRIORITY_FEE = auto() class-attribute instance-attribute

Error reading transaction priority fee field RLP.

RLP_LEADING_ZEROS_DATA_SIZE = auto() class-attribute instance-attribute

Error reading transaction data field RLP, (rlp field length has leading zeros).

RLP_LEADING_ZEROS_NONCE_SIZE = auto() class-attribute instance-attribute

Error reading transaction nonce field RLP, (rlp field length has leading zeros).

RLP_TOO_FEW_ELEMENTS = auto() class-attribute instance-attribute

Error reading transaction RLP, structure has too few elements than expected.

RLP_TOO_MANY_ELEMENTS = auto() class-attribute instance-attribute

Error reading transaction RLP, structure has too many elements than expected.

RLP_ERROR_EOF = auto() class-attribute instance-attribute

Error reading transaction RLP, rlp stream unexpectedly finished.

RLP_ERROR_SIZE = auto() class-attribute instance-attribute

Error reading transaction RLP, rlp size is invalid.

RLP_ERROR_SIZE_LEADING_ZEROS = auto() class-attribute instance-attribute

Error reading transaction RLP, field size has leading zeros.

INVALID_CHAINID = auto() class-attribute instance-attribute

Transaction chain id encoding is incorrect.

RLP_INVALID_DATA = auto() class-attribute instance-attribute

Transaction data field is invalid rlp.

RLP_INVALID_GASLIMIT = auto() class-attribute instance-attribute

Transaction gaslimit field is invalid rlp.

RLP_INVALID_NONCE = auto() class-attribute instance-attribute

Transaction nonce field is invalid rlp.

RLP_INVALID_TO = auto() class-attribute instance-attribute

Transaction to field is invalid rlp.

RLP_INVALID_ACCESS_LIST_ADDRESS_TOO_LONG = auto() class-attribute instance-attribute

Transaction access list address is > 20 bytes.

RLP_INVALID_ACCESS_LIST_ADDRESS_TOO_SHORT = auto() class-attribute instance-attribute

Transaction access list address is < 20 bytes.

RLP_INVALID_ACCESS_LIST_STORAGE_TOO_LONG = auto() class-attribute instance-attribute

Transaction access list storage hash > 32 bytes.

RLP_INVALID_ACCESS_LIST_STORAGE_TOO_SHORT = auto() class-attribute instance-attribute

Transaction access list storage hash < 32 bytes.

RLP_INVALID_HEADER = auto() class-attribute instance-attribute

Transaction failed to read from RLP as rlp header is invalid.

RLP_INVALID_VALUE = auto() class-attribute instance-attribute

Transaction value field is invalid rlp/structure.

EC_RECOVERY_FAIL = auto() class-attribute instance-attribute

Transaction has correct signature, but ec recovery failed.

INSUFFICIENT_ACCOUNT_FUNDS = auto() class-attribute instance-attribute

Transaction's sender does not have enough funds to pay for the transaction.

INSUFFICIENT_MAX_FEE_PER_GAS = auto() class-attribute instance-attribute

Transaction's max-fee-per-gas is lower than the block base-fee.

PRIORITY_OVERFLOW = auto() class-attribute instance-attribute

Transaction's max-priority-fee-per-gas exceeds 2^256-1 maximum value.

PRIORITY_GREATER_THAN_MAX_FEE_PER_GAS = auto() class-attribute instance-attribute

Transaction's max-priority-fee-per-gas is greater than the max-fee-per-gas.

PRIORITY_GREATER_THAN_MAX_FEE_PER_GAS_2 = auto() class-attribute instance-attribute

Transaction's max-priority-fee-per-gas is greater than the max-fee-per-gas (TransactionTests).

INSUFFICIENT_MAX_FEE_PER_BLOB_GAS = auto() class-attribute instance-attribute

Transaction's max-fee-per-blob-gas is lower than the block's blob-gas price.

INTRINSIC_GAS_TOO_LOW = auto() class-attribute instance-attribute

Transaction's gas limit is too low.

INTRINSIC_GAS_BELOW_FLOOR_GAS_COST = auto() class-attribute instance-attribute

Transaction's gas limit is below the floor gas cost.

INITCODE_SIZE_EXCEEDED = auto() class-attribute instance-attribute

Transaction's initcode for a contract-creating transaction is too large.

TYPE_1_TX_PRE_FORK = auto() class-attribute instance-attribute

Transaction type 1 included before activation fork.

TYPE_2_TX_PRE_FORK = auto() class-attribute instance-attribute

Transaction type 2 included before activation fork.

TYPE_3_TX_PRE_FORK = auto() class-attribute instance-attribute

Transaction type 3 included before activation fork.

TYPE_3_TX_ZERO_BLOBS_PRE_FORK = auto() class-attribute instance-attribute

Transaction type 3, with zero blobs, included before activation fork.

TYPE_3_TX_INVALID_BLOB_VERSIONED_HASH = auto() class-attribute instance-attribute

Transaction contains a blob versioned hash with an invalid version.

TYPE_3_TX_WITH_FULL_BLOBS = auto() class-attribute instance-attribute

Transaction contains full blobs (network-version of the transaction).

TYPE_3_TX_BLOB_COUNT_EXCEEDED = auto() class-attribute instance-attribute

Transaction contains too many blob versioned hashes.

TYPE_3_TX_CONTRACT_CREATION = auto() class-attribute instance-attribute

Transaction is a type 3 transaction and has an empty to.

TYPE_3_TX_MAX_BLOB_GAS_ALLOWANCE_EXCEEDED = auto() class-attribute instance-attribute

Transaction causes block to go over blob gas limit.

GAS_ALLOWANCE_EXCEEDED = auto() class-attribute instance-attribute

Transaction causes block to go over blob gas limit.

GAS_LIMIT_EXCEEDS_MAXIMUM = auto() class-attribute instance-attribute

Transaction gas limit exceeds the maximum allowed limit for the given fork.

TYPE_3_TX_ZERO_BLOBS = auto() class-attribute instance-attribute

Transaction is type 3, but has no blobs.

TYPE_4_EMPTY_AUTHORIZATION_LIST = auto() class-attribute instance-attribute

Transaction is type 4, but has an empty authorization list.

TYPE_4_INVALID_AUTHORITY_SIGNATURE = auto() class-attribute instance-attribute

Transaction authority signature is invalid

TYPE_4_INVALID_AUTHORITY_SIGNATURE_S_TOO_HIGH = auto() class-attribute instance-attribute

Transaction authority signature is invalid

TYPE_4_TX_CONTRACT_CREATION = auto() class-attribute instance-attribute

Transaction is a type 4 transaction and has an empty to.

TYPE_4_INVALID_AUTHORIZATION_FORMAT = auto() class-attribute instance-attribute

Transaction is type 4, but contains an authorization that has an invalid format.

TYPE_4_TX_PRE_FORK = auto() class-attribute instance-attribute

Transaction type 4 included before activation fork.

LOG_MISMATCH = auto() class-attribute instance-attribute

Transaction receipt logs do not match expected logs.

UndefinedException

Bases: str

Undefined Exception.

Source code in packages/testing/src/execution_testing/exceptions/exceptions/base.py 
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
class UndefinedException(str):
    """Undefined Exception."""

    mapper_name: str | None

    def __new__(
        cls, value: str, *, mapper_name: str | None = None
    ) -> "UndefinedException":
        """Create a new UndefinedException instance."""
        if isinstance(value, UndefinedException):
            return value
        assert isinstance(value, str)
        instance = super().__new__(cls, value)
        instance.mapper_name = mapper_name
        return instance

    @classmethod
    def __get_pydantic_core_schema__(
        cls, source_type: Any, handler: GetCoreSchemaHandler
    ) -> PlainValidatorFunctionSchema:
        """
        Call class constructor without info and appends the serialization
        schema.
        """
        return no_info_plain_validator_function(
            cls,
            serialization=to_string_ser_schema(),
        )

__new__(value, *, mapper_name=None)

Create a new UndefinedException instance.

Source code in packages/testing/src/execution_testing/exceptions/exceptions/base.py 
78
79
80
81
82
83
84
85
86
87
def __new__(
    cls, value: str, *, mapper_name: str | None = None
) -> "UndefinedException":
    """Create a new UndefinedException instance."""
    if isinstance(value, UndefinedException):
        return value
    assert isinstance(value, str)
    instance = super().__new__(cls, value)
    instance.mapper_name = mapper_name
    return instance

__get_pydantic_core_schema__(source_type, handler) classmethod

Call class constructor without info and appends the serialization schema.

Source code in packages/testing/src/execution_testing/exceptions/exceptions/base.py 
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
@classmethod
def __get_pydantic_core_schema__(
    cls, source_type: Any, handler: GetCoreSchemaHandler
) -> PlainValidatorFunctionSchema:
    """
    Call class constructor without info and appends the serialization
    schema.
    """
    return no_info_plain_validator_function(
        cls,
        serialization=to_string_ser_schema(),
    )

from_pipe_str(value)

Parse a single string as a pipe separated list into enum exceptions.

Source code in packages/testing/src/execution_testing/exceptions/exceptions/base.py 
115
116
117
118
119
120
121
122
def from_pipe_str(value: Any) -> str | list[str]:
    """Parse a single string as a pipe separated list into enum exceptions."""
    if isinstance(value, str):
        exception_list = value.split("|")
        if len(exception_list) == 1:
            return exception_list[0]
        return exception_list
    return value

to_pipe_str(value)

Single pipe-separated string representation of an exception list.

Obtain a deterministic ordering by ordering using the exception string representations.

Source code in packages/testing/src/execution_testing/exceptions/exceptions/base.py 
103
104
105
106
107
108
109
110
111
112
def to_pipe_str(value: Any) -> str:
    """
    Single pipe-separated string representation of an exception list.

    Obtain a deterministic ordering by ordering using the exception string
    representations.
    """
    if isinstance(value, list):
        return "|".join(str(exception) for exception in value)
    return str(value)