Struct ValidationError 

pub struct ValidationError {
    pub path: Vec<PathSegment>,
    pub code: String,
    pub message: String,
    pub params: HashMap<String, Value>,
}

A single validation error with location context.

Each error includes the path to the invalid field (supporting nested structs and collection indices), a machine-readable error code, a human-readable message, and optional constraint parameters for structured error reporting.

Example

use rusdantic_core::{ValidationError, PathSegment};

let error = ValidationError {
    path: vec![
        PathSegment::Field("user".to_string()),
        PathSegment::Field("email".to_string()),
    ],
    code: "email".to_string(),
    message: "invalid email format".to_string(),
    params: Default::default(),
};

assert_eq!(error.path_string(), "user.email");

Fields

path: Vec<PathSegment>

Path to the invalid field.

For nested structs, this contains multiple segments: ["user", "addresses", 0, "zip_code"]

code: String

Machine-readable error code.

Standard codes include: "length_min", "length_max", "range_min", "range_max", "email", "url", "pattern", "contains", "required", "custom".

message: String

Human-readable error message suitable for display to end users.

params: HashMap<String, Value>

Constraint parameters providing context about the validation failure.

For example, a length violation might include: {"min": 3, "max": 20, "actual": 1}

Implementations

impl ValidationError

pub fn new(code: impl Into<String>, message: impl Into<String>) -> Self

Create a new validation error with the given code and message.

pub fn with_param(self, key: impl Into<String>, value: impl Into<Value>) -> Self

Add a parameter to this error for structured error reporting.

pub fn with_path(self, path: Vec<PathSegment>) -> Self

Set the path for this error.

pub fn path_string(&self) -> String

Format the path as a dot-notation string.

Field segments are joined with ., index segments are formatted as [N]. Example: "user.addresses[0].zip_code"

Trait Implementations

impl Clone for ValidationError

fn clone(&self) -> ValidationError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ValidationError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ValidationError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for ValidationError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for ValidationError

fn eq(&self, other: &ValidationError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ValidationError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ValidationError