Struct ValidationContextBuilder 

pub struct ValidationContextBuilder { /* private fields */ }

Builder for ValidationContext.

Implementations

impl ValidationContextBuilder

pub fn new() -> Self

Create a new context builder.

Structure, code-list, and profile layers are enabled by default. The envelope layer is disabled by default.

pub fn with_metadata<T: Any + Send + Sync + 'static>(self, value: T) -> Self

Attach typed metadata accessible to context-aware profile rules.

pub fn with_message_ref(self, message_ref: impl Into<String>) -> Self

Stamp every issue produced by this context with the given message reference.

pub fn with_message_type(self, message_type: impl Into<String>) -> Self

Set message type metadata for downstream validators.

pub fn structure(self, enabled: bool) -> Self

Enable/disable structure validators.

pub fn code_list(self, enabled: bool) -> Self

Enable/disable code-list validators.

pub fn profile(self, enabled: bool) -> Self

Enable/disable profile validators.

pub fn bail_on_first_critical(self, bail: bool) -> Self

Stop all validation as soon as the first Critical-severity issue is produced.

When set, ValidationContext::validate_lenient returns immediately after the first Critical issue from any validator, skipping all remaining packs and layers.

Default: false (collect all issues across all layers).

pub fn envelope(self, enabled: bool) -> Self

Enable/disable envelope layer validators.

Off by default. Call with_envelope_validation to add the built-in EnvelopeValidator and enable the layer in one step.

pub fn with_envelope_validation(self) -> Self

Add the built-in EnvelopeValidator and enable the envelope layer.

pub fn with_validator<V>(self, layer: ValidationLayer, validator: V) -> Self

where V: Validator + 'static,

Add a validator assigned to layer.

pub fn with_profile_pack(self, pack: ProfileRulePack) -> Self

Add a profile rule pack to the profile layer.

pub fn with_profile_pack_arc(self, pack: Arc<ProfileRulePack>) -> Self

Add a reference-counted profile rule pack to the profile layer.

Unlike with_profile_pack, this method stores the pack behind an Arc so context forking (via ValidationContext::fork_with_message_ref) only increments the reference count instead of deep-cloning the rule vec.

This is the preferred API for downstream code that caches packs in static storage (LazyLock, OnceLock) and reuses them across many validation calls.

Example

use std::sync::{Arc, LazyLock};
use edifact_rs::{ProfileRulePack, ValidationContext};

static PACK: LazyLock<Arc<ProfileRulePack>> = LazyLock::new(|| {
    Arc::new(ProfileRulePack::new("MIG").require_segment("BGM", "MIG-BGM-M"))
});

let ctx = ValidationContext::builder()
    .with_profile_pack_arc(Arc::clone(&*PACK))
    .build();

pub fn with_static_issue(self, issue: ValidationIssue) -> Self

Unconditionally append issue to every report produced by this context.

Static issues are emitted on every validate_* call — they are not evaluated against segments. This is useful for advisory notices that should always be present regardless of message content (e.g. “AHB layer is inactive for this message type”).

pub fn build(self) -> ValidationContext

Finalize builder and create context.

Trait Implementations

impl Default for ValidationContextBuilder

fn default() -> Self

Returns the “default value” for a type.