Struct CatalogManager 

pub struct CatalogManager<T> { /* private fields */ }

Dynamic network/cache/bootstrap catalog manager.

Implementations

impl<T: CatalogTransport> CatalogManager<T>

pub fn standard(transport: T) -> Self

Uses the fixed per-user catalog cache path.

pub fn new(transport: T, cache: SecureDirectory) -> Self

Uses an explicit secure directory, primarily for deterministic tests.

pub fn in_directory( transport: T, anchor: impl AsRef<Path>, relative: impl AsRef<Path>, ) -> Self

Opens an explicit private cache below a trusted anchor.

pub fn load_cached(&self) -> Result<CatalogSnapshot, CatalogError>

The catalog to start from without touching the network: the validated cache, else the bundled bootstrap copy. A background refresh then checks models.dev.

pub fn load_cached_at( &self, now: Timestamp, ) -> Result<CatalogSnapshot, CatalogError>

Self::load_cached at a supplied time for deterministic tests.

pub async fn refresh(&self) -> Result<CatalogSnapshot, CatalogError>

Refreshes using the system clock.

pub async fn refresh_at( &self, now: Timestamp, ) -> Result<CatalogSnapshot, CatalogError>

Refreshes at a supplied time for deterministic tests.