Struct Decoder 

pub struct Decoder { /* private fields */ }

VIN decoder backed by mmap’d FST/rkyv lookup maps.

Construct via Decoder::new (uses default data dir / env var) or Decoder::open (explicit path).

Implementations

impl Decoder

pub fn new() -> Result<Self>

Open the decoder using the default data directory.

Resolution order:

1. VIN_DECODE_DATA_DIR environment variable
2. $HOME/.vin-decode-cache
3. ./.vin-decode-cache

With the embedded feature, this also auto-installs bundled data into the resolved directory on first run.

pub fn open(dir: &Path) -> Result<Self>

Open the decoder against an explicit data directory. The wmi_rules curated table is optional — only loaded if wmi_rules.fst exists.

pub fn decode(&self, raw: &str) -> Result<Vehicle>

Decode a VIN with full validation (length, charset, check digit).

pub fn decode_unchecked(&self, raw: &str) -> Result<Vehicle>

Decode a VIN, skipping the check-digit step.

Useful for VINs from non-NHTSA jurisdictions where the check digit isn’t enforced.

pub fn decode_batch(&self, vins: &[&str]) -> Vec<Result<Vehicle>>

where Self: Sync,

Decode a slice of VINs (parallelized with parallel feature, sequential otherwise).