Struct ValidationContext 

pub struct ValidationContext { /* private fields */ }

Collects all validation diagnostics emitted during the loading pipeline.

Pass a &mut ValidationContext to each validation function. After all layers have run, call into_result to convert the collected diagnostics into a Result<(), LoadError>.

Examples

use cobre_io::validation::{ValidationContext, ErrorKind};

let mut ctx = ValidationContext::new();
assert!(!ctx.has_errors());
assert!(ctx.into_result().is_ok());

Implementations

impl ValidationContext

pub fn new() -> Self

Creates an empty validation context with no diagnostics.

pub fn add_error( &mut self, kind: ErrorKind, file: impl Into<PathBuf>, entity: Option<impl Into<String>>, message: impl Into<String>, )

Adds an error diagnostic to the context.

pub fn add_warning( &mut self, kind: ErrorKind, file: impl Into<PathBuf>, entity: Option<impl Into<String>>, message: impl Into<String>, )

Adds a warning diagnostic to the context.

pub fn has_errors(&self) -> bool

Returns true if any error-severity diagnostics have been collected.

pub fn error_count(&self) -> usize

Returns the number of error-severity diagnostics without allocating.

pub fn errors(&self) -> Vec<&ValidationEntry>

Returns all error-severity ValidationEntry items.

pub fn warnings(&self) -> Vec<&ValidationEntry>

Returns a slice of all warning-severity ValidationEntry items.

pub fn into_result(self) -> Result<(), LoadError>

Converts the collected diagnostics into a Result.

Warnings are not surfaced by this method — inspect warnings() before calling into_result().

Errors

Returns LoadError::ConstraintError if any error-severity diagnostics were collected. The description field contains all error messages joined by newlines, formatted as [ErrorKind] file (entity): message.

Examples

use cobre_io::validation::{ValidationContext, ErrorKind};

let mut ctx = ValidationContext::new();
ctx.add_warning(ErrorKind::UnusedEntity, "system/thermals.json", Some("T1"), "inactive");
assert!(ctx.into_result().is_ok());

Trait Implementations

impl Debug for ValidationContext

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

Formats the value using the given formatter.

impl Default for ValidationContext

fn default() -> ValidationContext

Returns the “default value” for a type.