Struct ObjectStore 

pub struct ObjectStore { /* private fields */ }

Content-addressed object store.

Stores artifacts using BLAKE3 hash prefixes for sharding:

objects/
├── ab/
│   └── cdef1234...
├── cd/
│   └── ef5678...
└── ...

Implementations

impl ObjectStore

pub fn new<P: AsRef<Path>>(base_path: P) -> Result<Self>

Create a new object store at the given path.

Errors

Returns an error if the directory cannot be created.

pub fn open<P: AsRef<Path>>(base_path: P) -> Result<Self>

Open an existing object store.

Errors

Returns an error if the path doesn’t exist.

pub fn base_path(&self) -> &Path

Get the base path.

pub fn put(&self, data: &[u8]) -> Result<ContentAddress>

Store bytes and return their content address.

Errors

Returns an error if writing fails.

pub fn put_with_address(&self, data: &[u8], addr: &ContentAddress) -> Result<()>

Store bytes at a specific content address.

Errors

Returns an error if writing fails or hash doesn’t match.

pub fn put_reader<R: Read>(&self, reader: R) -> Result<ContentAddress>

Store from a reader and return content address.

Errors

Returns an error if reading or writing fails.

pub fn get(&self, addr: &ContentAddress) -> Result<Vec<u8>>

Get data by content address.

Errors

Returns an error if the object doesn’t exist or reading fails.

pub fn exists(&self, addr: &ContentAddress) -> bool

Check if an object exists.

pub fn delete(&self, addr: &ContentAddress) -> Result<bool>

Delete an object by content address.

Errors

Returns an error if deletion fails.

pub fn list(&self) -> Result<Vec<String>>

List all content addresses in the store.

Errors

Returns an error if reading the directory fails.

pub fn total_size(&self) -> Result<u64>

Get total size of all stored objects in bytes.

Errors

Returns an error if reading fails.

Trait Implementations

impl Debug for ObjectStore

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

Formats the value using the given formatter.