ito_core/validate/
report.rs

1//! Report builder for validation runs.
2//!
3//! This module provides the [`ReportBuilder`] to accumulate issues found during
4//! a validation pass and compile them into a final [`ValidationReport`].
5//!
6//! It handles the logic of aggregating issues and determining the overall
7//! success/failure status based on the "strict" mode setting.
8
9use super::{ValidationIssue, ValidationReport};
10
11#[derive(Debug, Default)]
12/// A stateful builder for collecting validation issues.
13///
14/// Use this during a validation pass to accumulate issues as they are found.
15/// Call `finish()` at the end to generate the final report.
16pub struct ReportBuilder {
17    strict: bool,
18    issues: Vec<ValidationIssue>,
19}
20
21impl ReportBuilder {
22    /// Create a new builder with the given strictness setting.
23    ///
24    /// If `strict` is `true`, the presence of any `WARNING` issues will cause
25    /// the final report to be marked as failed. If `false`, only `ERROR` issues
26    /// cause failure.
27    pub fn new(strict: bool) -> Self {
28        Self {
29            strict,
30            issues: Vec::new(),
31        }
32    }
33
34    /// Add a single issue to the report.
35    pub fn push(&mut self, issue: ValidationIssue) {
36        self.issues.push(issue);
37    }
38
39    /// Extend this builder with multiple issues.
40    ///
41    /// Useful when merging results from sub-validations.
42    pub fn extend<I>(&mut self, issues: I)
43    where
44        I: IntoIterator<Item = ValidationIssue>,
45    {
46        self.issues.extend(issues);
47    }
48
49    /// Finish building and compute the final [`ValidationReport`].
50    ///
51    /// This consumes the builder, calculating summary statistics and the
52    /// final `valid` boolean based on the accumulated issues and strictness.
53    pub fn finish(self) -> ValidationReport {
54        ValidationReport::new(self.issues, self.strict)
55    }
56}
57
58/// Convenience constructor for a [`ReportBuilder`].
59///
60/// Equivalent to `ReportBuilder::new(strict)`.
61pub fn report(strict: bool) -> ReportBuilder {
62    ReportBuilder::new(strict)
63}
64
65#[cfg(test)]
66#[path = "report_tests.rs"]
67mod report_tests;
ito_core/validate/report.rs

ito_core/validate/
report.rs
