Struct SegmentStore 

pub struct SegmentStore { /* private fields */ }

The on-disk spill area: numbered segment files plus their in-RAM metadata.

Implementations

impl SegmentStore

pub fn create(dest: &Path) -> Result<Self>

Create the spill directory beside dest (the conversion’s output file or directory), so disk-headroom checks and the spill share a volume.

pub fn dir(&self) -> &Path

The spill directory (for disk-headroom checks against its volume).

pub fn len(&self) -> usize

Number of segments written so far.

pub fn is_empty(&self) -> bool

True when nothing has been spilled.

pub fn ids(&self) -> impl Iterator<Item = SegmentId>

The segment ids in spill (= document) order.

pub fn segment_path(&self, id: SegmentId) -> PathBuf

The path of a segment’s file (exists only after write_segment).

pub fn write_segment( &mut self, xml: &str, meta: SegmentMeta, ) -> Result<SegmentId>

Spill one or more serialized sibling subtrees as a new segment (raw, splice-ready text — see the module doc for why no wrapper is written).

pub fn wrapped_segment(&self, id: SegmentId) -> Result<String>

The segment’s content wrapped for stand-alone PARSING: a _lxfragment root carrying the namespace declarations recorded at spill time. Built in memory — the file itself stays raw and splice-ready.

pub fn finalize_segment(&mut self, id: SegmentId, output: &str) -> Result<()>

Replace a spilled segment with its processed, splice-ready output text (raw — no wrapper; appended verbatim at the placeholder during assembly).

pub fn read_segment(&self, id: SegmentId) -> Result<String>

The file’s current content, whichever lifecycle stage it is in.

pub fn retire_segment(&mut self, id: SegmentId) -> Result<()>

Mark a segment retired: its text was inlined into an enclosing segment, so pass 2 skips it and assembly never asks for it. The file is truncated (the content lives in the outer segment now).

pub fn is_retired(&self, id: SegmentId) -> bool

Was this segment inlined into an enclosing one?

pub fn meta(&self, id: SegmentId) -> Result<&SegmentMeta>

The metadata recorded when the segment was spilled.

Trait Implementations

impl Debug for SegmentStore

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

Formats the value using the given formatter.

impl Drop for SegmentStore

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.