Struct HeaderCacheEntry 

pub struct HeaderCacheEntry {
    pub schema_version: u32,
    pub repo: String,
    pub revision: String,
    pub filename: String,
    pub etag: String,
    pub cached_at: SystemTime,
    pub info: SafetensorsHeaderInfo,
}

On-disk cache entry for one parsed remote header.

Fields

schema_version: u32

Cache schema version. Compared against SCHEMA_VERSION.

repo: String

The repository identifier this entry was parsed for.

revision: String

The resolved revision (branch, tag, or commit SHA — "main" when the caller did not pin one).

filename: String

The filename within the repo.

etag: String

The remote etag the header was fetched against. A different etag on a later call means the upstream file changed, invalidating this entry.

cached_at: SystemTime

When this entry was written — feeds the Source: cached header (age: ...) display line.

info: SafetensorsHeaderInfo

The parsed header.

Implementations

impl HeaderCacheEntry

pub fn new( repo: String, revision: String, filename: String, etag: String, info: SafetensorsHeaderInfo, ) -> Self

Builds a fresh entry for a header just parsed remotely.

pub fn is_compatible_with( &self, repo: &str, revision: &str, filename: &str, etag: &str, ) -> bool

Returns true when this entry is still valid for the given request — every field but cached_at/info must match exactly.

pub async fn load( path: &Path, repo: &str, revision: &str, filename: &str, etag: &str, ) -> Option<Self>

Reads and validates the cache entry at path against the given request.

Returns None on a cache miss for any reason — an absent file, unparseable JSON, or a stale/mismatched entry — never an error; the caller falls back to a normal remote fetch either way.

pub async fn save_atomic(&self, path: &Path) -> Result<(), FetchError>

Writes this entry to path atomically (write-tmp + rename), via the shared atomic_write::write_atomic helper — the same durability pattern chunked_state::ChunkedState::save_atomic uses. Creates the parent directory (.hf-fm-header-cache/) if it does not exist yet — the first --cache-headers call against a repo that was never downloaded.

Errors

Returns FetchError::Io on filesystem errors during the parent directory creation, the temp write, or the rename.

Trait Implementations

impl Clone for HeaderCacheEntry

fn clone(&self) -> HeaderCacheEntry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HeaderCacheEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HeaderCacheEntry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HeaderCacheEntry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.