Struct HttpReadOnlyObjectStore 

pub struct HttpReadOnlyObjectStore { /* private fields */ }

Read-only ObjectStore backed by a public HTTPS origin.

Keys are appended to the origin as path segments: origin https://cdn.yah.dev + key blobs/abc… → https://cdn.yah.dev/blobs/abc….

Implementations

impl HttpReadOnlyObjectStore

pub fn new(origin: impl Into<String>) -> Result<Self, Error>

Build a store against origin (e.g. https://cdn.yah.dev).

A trailing slash on origin is trimmed so key joining stays single-slashed.

pub fn origin(&self) -> &str

The origin this store reads from.

Trait Implementations

impl ObjectStore for HttpReadOnlyObjectStore

fn locate(&self, key: &str) -> String

Where key lives, in a form an operator can act on — a URL for a remote backend, an opaque descriptor otherwise (R746-F1).

fn get(&self, key: &str) -> Result<Option<Vec<u8>>, Error>

Read bytes at key. Returns None when the key does not exist — NotFound is reserved for ambiguous cases (HEAD-then-GET race etc.).

fn head(&self, key: &str) -> Result<bool, Error>

Returns true when key exists. Cheaper than get for backends that support HEAD; the default impl falls back to get(...).is_some().

fn put(&self, _key: &str, _data: Vec<u8>) -> Result<(), Error>

Write data at key. Overwrites any existing object unconditionally.

fn delete(&self, _key: &str) -> Result<(), Error>

Remove key. Idempotent — succeeds whether or not the key existed.

fn list_prefix(&self, _prefix: &str) -> Result<Vec<String>, Error>

List all keys with the given prefix (prefix-match, not glob).

fn put_cached( &self, _key: &str, _data: Vec<u8>, _cache_control: &str, ) -> Result<(), Error>

Write data at key with an explicit Cache-Control (R703-B8).

fn put_if( &self, _key: &str, _data: Vec<u8>, _cond: Precondition, ) -> Result<String, Error>

Conditionally write data at key, returning the resulting ETag.

fn etag(&self, _key: &str) -> Result<Option<String>, Error>

Current ETag of key, or None if absent.