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 evaluator_factory;
34pub mod expr;
35pub mod generated;
36pub mod pipeline;
37pub mod validator;
38pub mod workflow_schema;
39
40// Re-export key types at crate root for convenience
41pub use display::{
42 Bo4eView, EdifactView, IssueDisplay, IssueNarrator, IssueView, TechnicalNarrator,
43};
44pub use error::{ParseError, ValidationError};
45pub use eval::{binds_once, once_per_transaction, packages_allow_none, requiredness};
46pub use eval::{
47 presence_condition, presence_conditions, refuses_presence, AbsentTarget, AnswerCodeLists,
48 CodeListProvider, CompositeExternalProvider, ConditionEvaluator, ConditionExprEvaluator,
49 ConditionResult, CountryPostalCodeProvider, EvaluationContext, GroupNavigator,
50 KonfigurationenProvider, MapExternalProvider, MarketRole, MarketRoleProvider,
51 NoOpGroupNavigator, PresentTarget, Sector, SectorProvider,
52};
53pub use expr::{ConditionExpr, ConditionParser};
54pub use validator::{
55 build_validated_tree, validate_unt_segment_count, AhbGroupNode, AhbNode, EdifactValidator,
56 ErrorCodes, IssueKind, SegmentPosition, Severity, UnresolvedConditions, ValidatedTree,
57 ValidationCategory, ValidationIssue, ValidationLevel, ValidationReport,
58};
59
60// Re-export AHB workflow types for callers
61pub use evaluator_factory::evaluator_for;
62pub use pipeline::{
63 validate_edifact_message, validate_edifact_message_reporting_segments,
64 validate_edifact_message_with_structure,
65};
66pub use validator::validate::{AhbCodeRule, AhbFieldRule, AhbWorkflow};
67pub use workflow_schema::ahb_workflow_from_pid_schema;
68
69// Re-export generated evaluators
70pub use generated::*;
71
72// `IssueKind::StructureDiagnostic`'s `kind` field is this type, so a
73// dependant matching on `IssueKind` needs it without adding its own
74// version-pinned dependency on `mig-assembly`.
75pub use mig_assembly::StructureDiagnosticKind;