Struct FileDispenser 

pub struct FileDispenser { /* private fields */ }

File-backed dispenser using a TOML state file with advisory locking. This is the Phase 1 implementation per the distributed architecture spec.

Implementations

impl FileDispenser

pub fn open(path: PathBuf, mode: IdMode) -> Result<Self>

Create or open a file-backed dispenser. The file will be created if it doesn’t exist.

Trait Implementations

impl Dispenser for FileDispenser

Available on crate feature native only.

fn next(&self, object_type: &str) -> Result<u32>

Get the next sequence number for the given object type. Increments the counter atomically.

fn peek(&self, object_type: &str) -> Result<u32>

Peek at the next sequence number without incrementing.

fn state(&self) -> Result<DispenserState>

Get the full current state (all counters).

fn format_id(&self, object_type: &str, seq: u32) -> Result<String>

Format an object ID according to the current mode.

fn next_id(&self, object_type: &str) -> Result<String>

Dispense a new sequence number and return the formatted ID.