automapper_validation/lib.rs
1//! AHB condition expression parsing, evaluation, and EDIFACT message validation.
2//!
3//! This crate provides three layers of functionality:
4//!
5//! 1. **Expression parsing** ([`expr`]): Parses AHB status strings like
6//! `"Muss [182] ∧ [6] ∧ [570]"` into a [`ConditionExpr`] AST.
7//!
8//! 2. **Condition evaluation** ([`eval`]): Evaluates condition expressions
9//! using a [`ConditionEvaluator`] trait with three-valued logic
10//! (True/False/Unknown) for graceful handling of external conditions.
11//!
12//! 3. **Message validation** ([`validator`]): Validates EDIFACT messages
13//! against AHB rules, producing a [`ValidationReport`] with typed issues.
14//!
15//! # Quick Start
16//!
17//! ```ignore
18//! use automapper_validation::expr::{ConditionParser, ConditionExpr};
19//! use automapper_validation::eval::{ConditionExprEvaluator, ConditionResult};
20//! use automapper_validation::validator::{EdifactValidator, ValidationLevel};
21//!
22//! // Parse a condition expression
23//! let expr = ConditionParser::parse("Muss [182] ∧ [152]").unwrap();
24//!
25//! // Validate pre-parsed segments against AHB workflow
26//! let validator = EdifactValidator::new(my_evaluator);
27//! let report = validator.validate(&segments, &workflow, &external, ValidationLevel::Full);
28//! ```
29
30pub mod display;
31pub mod error;
32pub mod eval;
33pub mod expr;
34pub mod generated;
35pub mod pipeline;
36pub mod validator;
37pub mod workflow_schema;
38
39// Re-export key types at crate root for convenience
40pub use display::{
41 Bo4eView, EdifactView, IssueDisplay, IssueNarrator, IssueView, TechnicalNarrator,
42};
43pub use error::{ParseError, ValidationError};
44pub use eval::{
45 CodeListProvider, CompositeExternalProvider, ConditionEvaluator, ConditionExprEvaluator,
46 ConditionResult, CountryPostalCodeProvider, EvaluationContext, GroupNavigator,
47 KonfigurationenProvider, MapExternalProvider, MarketRole, MarketRoleProvider,
48 NoOpGroupNavigator, Sector, SectorProvider,
49};
50pub use expr::{ConditionExpr, ConditionParser};
51pub use validator::{
52 build_validated_tree, validate_unt_segment_count, AhbGroupNode, AhbNode, EdifactValidator,
53 ErrorCodes, IssueKind, SegmentPosition, Severity, UnresolvedConditions, ValidatedTree,
54 ValidationCategory, ValidationIssue, ValidationLevel, ValidationReport,
55};
56
57// Re-export AHB workflow types for callers
58pub use pipeline::validate_edifact_message;
59pub use validator::validate::{AhbCodeRule, AhbFieldRule, AhbWorkflow};
60pub use workflow_schema::ahb_workflow_from_pid_schema;
61
62// Re-export generated evaluators
63pub use generated::*;
64
65// `IssueKind::StructureDiagnostic`'s `kind` field is this type, so a
66// dependant matching on `IssueKind` needs it without adding its own
67// version-pinned dependency on `mig-assembly`.
68pub use mig_assembly::StructureDiagnosticKind;