ddex-builder 0.4.5

Deterministic DDEX XML builder with smart normalization
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
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

//! Error types for DDEX Builder

use serde::{Deserialize, Serialize};
use thiserror::Error;

/// Build error types
#[derive(Error, Debug, Clone, Serialize, Deserialize)]
pub enum BuildError {
    /// Invalid format
    #[error("Invalid format in {field}: {message}")]
    InvalidFormat {
        /// Field that failed validation
        field: String,
        /// Error message describing the issue
        message: String,
    },

    /// Missing required field
    #[error("Missing required field: {field}")]
    MissingRequired {
        /// Field that failed validation
        field: String,
    },

    /// Invalid reference
    #[error("Invalid reference: {reference}")]
    InvalidReference {
        /// Reference that could not be resolved
        reference: String,
    },

    /// Validation failed
    #[error("Validation failed: {}", errors.join(", "))]
    ValidationFailed {
        /// List of validation errors
        errors: Vec<String>,
    },

    /// IO error
    #[error("IO error: {0}")]
    Io(String),

    /// Serialization error
    #[error("Serialization error: {0}")]
    Serialization(String),

    /// XML generation error
    #[error("XML generation error: {0}")]
    XmlGeneration(String),

    /// Determinism verification failed
    #[error("Determinism verification failed: {message}")]
    DeterminismFailed {
        /// General error message
        message: String,
    },

    /// Determinism guarantee violation
    #[error("Determinism guarantee violated: {guarantee} - {details}")]
    DeterminismGuaranteeViolated {
        /// Guarantee that failed
        guarantee: String,
        /// Details about the failure
        details: String,
    },

    /// Validation error
    #[error("Validation error: {0}")]
    Validation(String),

    /// Parallel processing error
    #[error("Parallel processing error: {0}")]
    Parallel(String),

    /// Security violation
    #[error("Security violation: {0}")]
    Security(String),

    /// Input sanitization failed
    #[error("Input sanitization failed: {0}")]
    InputSanitization(String),

    /// Other error
    #[error("{0}")]
    Other(String),
}

impl From<std::io::Error> for BuildError {
    fn from(err: std::io::Error) -> Self {
        BuildError::Io(err.to_string())
    }
}

impl From<serde_json::Error> for BuildError {
    fn from(err: serde_json::Error) -> Self {
        BuildError::Serialization(err.to_string())
    }
}

impl From<quick_xml::Error> for BuildError {
    fn from(err: quick_xml::Error) -> Self {
        BuildError::XmlGeneration(err.to_string())
    }
}

/// Build warning (non-fatal)
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct BuildWarning {
    /// Error code for categorization
    pub code: String,
    /// Human-readable error message
    pub message: String,
    /// Optional location information
    pub location: Option<String>,
}