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 build(self) -> ValidationContext

Finalize builder and create context.

Trait Implementations

impl Default for ValidationContextBuilder

fn default() -> Self

Returns the “default value” for a type.