valust 0.8.0

A data validation library for Rust
Documentation 
1
2
3
4
5
6
7
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

//! Transform errors.

use std::fmt::{self, Write};

use sealed::sealed;

use super::ErrorShow;

#[derive(Debug)]
/// Represents an error that occurs during a transformation process.
pub struct TransformError {
    /// The name of the field where the error occurred.
    pub field: &'static str,
    /// The path to the field where the error occurred.
    pub path: String,
    /// The value that caused the error.
    pub value: String,
    /// The underlying cause of the error.
    pub cause: Box<dyn ErrorShow + 'static>,
    /// An optional message providing additional information about the error.
    pub message: Option<&'static str>,
    /// The expression that caused the error.
    pub expression: &'static str,
    /// The name of the source type involved in the transformation.
    pub source_type_name: &'static str,
    /// The name of the target type involved in the transformation.
    pub target_type_name: &'static str,
}

#[sealed]
impl crate::error::display::ErrorDisplay for TransformError {
    fn full_display(&self, w: &mut impl Write) -> fmt::Result {
        if let Some(msg) = self.message {
            writeln!(w, "Transform error: {}", msg)?;
        } else {
            writeln!(w, "Transform error:")?;
        }
        writeln!(w, "Cause: {}", self.cause)?;
        writeln!(
            w,
            "Value: {}: {} = {}",
            self.field, self.source_type_name, self.value
        )?;
        writeln!(
            w,
            "Transformer: ({} => {}) {}",
            self.source_type_name, self.target_type_name, self.expression
        )?;
        writeln!(w, "Path: {}", self.path)?;
        writeln!(w)?;

        Ok(())
    }

    fn brief_display(&self, w: &mut impl Write) -> fmt::Result {
        write!(w, "Transform error: ")?;
        if let Some(msg) = self.message {
            writeln!(w, "{}", msg)?;
        } else {
            writeln!(w, "{}", self.cause)?;
        }

        Ok(())
    }

    fn human_readable_display(&self, w: &mut impl Write) -> fmt::Result {
        write!(w, "Transform: ",)?;
        if let Some(msg) = self.message {
            writeln!(w, "{}", msg)?;
        } else {
            writeln!(w, "{}", self.cause)?;
        }
        writeln!(w, "Backtrace:")?;
        writeln!(w, "    Value: {}", self.value)?;
        writeln!(
            w,
            "    Operation: ({} => {}) {}",
            self.source_type_name, self.target_type_name, self.expression
        )?;
        writeln!(w, "    Error: {:?}", self.cause)?;

        Ok(())
    }
}