Struct AprWriter 

pub struct AprWriter { /* private fields */ }

APR format writer — delegates to AprV2Writer for ONE format.

This is a convenience wrapper around AprV2Writer that provides a simple key-value metadata API. All output uses the canonical APR format (v2 binary layout with header, metadata, tensor index, and aligned data sections).

Implementations

impl AprWriter

pub fn new() -> AprWriter

Create new writer

pub fn set_metadata(&mut self, key: impl Into<String>, value: Value)

Set metadata key-value pair

pub fn add_tensor_f32( &mut self, name: impl Into<String>, shape: Vec<usize>, data: &[f32], )

Add tensor with f32 data (copies the slice)

pub fn add_tensor_f32_owned( &mut self, name: impl Into<String>, shape: Vec<usize>, data: Vec<f32>, )

ALB-099: Add tensor with owned f32 data — zero-copy for large tensors. Use this when the caller already owns a Vec to avoid a redundant copy.

pub fn to_bytes(&self) -> Result<Vec<u8>, String>

Write to bytes using the canonical APR format.

Errors

Returns error if serialization fails

pub fn into_bytes(self) -> Result<Vec<u8>, String>

ALB-099: Consume the writer and serialize — zero-copy for owned tensor data. Avoids the f32→bytes copy for tensors added via add_tensor_f32_owned.

Errors

Returns error if serialization fails

pub fn write<P>(&self, path: P) -> Result<(), String>

where P: AsRef<Path>,

Write to file atomically (F-CKPT-009).

Writes to a .tmp file, fsyncs, then renames. A crash at any point leaves the original file intact.

Errors

Returns error if write fails

pub fn write_into<P>(self, path: P) -> Result<(), String>

where P: AsRef<Path>,

ALB-105: Consuming streaming write — streams tensor data to disk instead of serializing the entire model into a Vec then writing.

Peak RAM = metadata + tensor index + largest single tensor (not all tensors). Same atomic write semantics as write() (F-CKPT-009): writes to a .tmp file via AprV2StreamingWriter, fsyncs, then renames.

Errors

Returns error if write fails

Trait Implementations

impl Debug for AprWriter

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

Formats the value using the given formatter.

impl Default for AprWriter

fn default() -> AprWriter

Returns the “default value” for a type.