Struct ContentWriter 

pub struct ContentWriter { /* private fields */ }

Writer for building content.bin

Supports two modes:

1. Streaming mode (init() called): Writes file contents to disk incrementally to avoid RAM buildup
2. In-memory mode (default): Accumulates content in RAM for backward compatibility with tests

Implementations

impl ContentWriter

pub fn new() -> Self

Create a new content writer (in-memory mode by default)

Call init() to enable streaming mode before adding files.

pub fn init(&mut self, path: PathBuf) -> Result<()>

Initialize the writer by creating the output file and writing header placeholder

Crash safety: bytes are streamed into <path>.tmp; finalize() renames the temp file over path only after the header is complete and synced, so a reader never sees a short content.bin.

pub fn add_file(&mut self, path: PathBuf, content: &str) -> u32

Add a file to the content store

Streaming mode (if init() was called): Writes content to disk immediately. In-memory mode (default): Accumulates content in RAM.

Returns the file_id (index into files array)

pub fn write(&mut self, path: impl AsRef<Path>) -> Result<()>

Write the content store to disk

This is the main entry point for the old API. It initializes the writer (if needed), and finalizes the file.

pub fn file_count(&self) -> usize

Get the number of files

pub fn content_size(&self) -> usize

Get total content size

pub fn finalize_if_needed(&mut self) -> Result<()>

Finalize content store if it hasn’t been finalized yet

This is safe to call multiple times - subsequent calls are no-ops.

Trait Implementations

impl Default for ContentWriter

fn default() -> Self

Returns the “default value” for a type.