Struct DataDir 

pub struct DataDir { /* private fields */ }

Configures where the Mapper looks for DataBundle files.

Bundle files follow the naming convention edifact-data-{FV}.bin (e.g., edifact-data-FV2504.bin).

Resolution order for DataDir::auto

1. $EDIFACT_DATA_DIR environment variable (if set)
2. $HOME/.edifact/data (Unix) or %USERPROFILE%\.edifact\data (Windows)
3. ./data (current working directory fallback)

Implementations

impl DataDir

pub fn auto() -> Self

Auto-detect the data directory from the environment.

See struct-level docs for resolution order.

pub fn path<P: AsRef<Path>>(path: P) -> Self

Use an explicit path for the data directory.

pub fn eager(self, fvs: &[&str]) -> Self

Mark format versions to be eagerly loaded when the Mapper is created (rather than lazy-loaded on first access).

pub fn allow_bundle_from_other_release(self, allow: bool) -> Self

Load a bundle even when it was produced by a different release.

Off by default. A crate and a bundle from different releases is the pairing that goes wrong: the format check passes, the bundle loads, and the mappings inside are from another era — which shows up as a smaller message rather than an error (issue #158).

Turn it on only when the mismatch is deliberate and you have some other way of knowing the two belong together.

pub fn allows_bundle_from_other_release(&self) -> bool

Whether a bundle from another release may be loaded.

pub fn data_path(&self) -> &Path

The resolved data directory path.

pub fn eager_fvs(&self) -> &[String]

Format versions that should be eagerly loaded.

pub fn bundle_path(&self, fv: &str) -> PathBuf

Path to the bundle file for a specific format version.

Trait Implementations

impl Clone for DataDir

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DataDir

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.