Skip to content

Validation Field Errors

validation_field_errors

Collection of validation errors scoped to a single field.

Defines ValidationFieldErrors, which aggregates multiple Error[object]
instances for one field, enabling per-field error reporting in validation
workflows. Extends ValueErrorMixin (catchable as ValueError) and
FieldErrors[Error[object]].

ValidationFieldErrors

Bases: ValueErrorMixin, FieldErrors[Error[object]]

Validation errors associated with a specific field.

Example
from forging_blocks.foundation.errors import ErrorMessage, FieldReference
from forging_blocks.foundation.errors import Error as FBError

err = FBError[str](ErrorMessage("Too short"))
field_errs = ValidationFieldErrors(FieldReference("username"), [err])
assert field_errs.field == FieldReference("username")
assert len(field_errs) == 1
assert isinstance(field_errs, ValueError)
Source code in src/forging_blocks/foundation/errors/combined/validation_field_errors.py
class ValidationFieldErrors(ValueErrorMixin, FieldErrors[Error[object]]):
    """Validation errors associated with a specific field.

    Example:
        ```python
        from forging_blocks.foundation.errors import ErrorMessage, FieldReference
        from forging_blocks.foundation.errors import Error as FBError

        err = FBError[str](ErrorMessage("Too short"))
        field_errs = ValidationFieldErrors(FieldReference("username"), [err])
        assert field_errs.field == FieldReference("username")
        assert len(field_errs) == 1
        assert isinstance(field_errs, ValueError)
        ```
    """