Struct GlwEventCache 

pub struct GlwEventCache { /* private fields */ }

Three-tier cache for GLW events.

&mut self is required on the read methods because the in-memory LRU promotes entries on access and the redb writes happen on the write path.

Implementations

impl GlwEventCache

pub fn new( cache_directory: PathBuf, base_url: Option<Url>, ) -> Result<Self, GlwEventCacheError>

Create a new cache backed by <cache_directory>/glw_event.redb.

base_url is the GLW base URL (must include the version segment as a path, e.g. http://example.com/glw127/). Pass None to use the workspace default.

Errors

Returns GlwEventCacheError if the database file cannot be created or if the default URL fails to parse (the latter being unreachable for the hard-coded defaults).

pub async fn get_event_by_id( &mut self, id: EventId, ) -> Result<Option<GlwEvent>, GlwEventCacheError>

Get a GLW event by numeric id.

Returns Ok(None) if the server reports no such event.

Errors

Returns GlwEventCacheError if a database or upstream HTTP operation fails.

pub async fn get_event_by_key( &mut self, key: &GlwEventKey, ) -> Result<Option<GlwEvent>, GlwEventCacheError>

Get a GLW event by string event key.

Errors

Returns GlwEventCacheError if a database or upstream HTTP operation fails.

pub async fn refresh_event_by_id( &mut self, id: EventId, ) -> Result<Option<GlwEvent>, GlwEventCacheError>

Force a fresh fetch of an event by id, bypassing all cache tiers.

Errors

Returns GlwEventCacheError if a database or upstream HTTP operation fails.

pub async fn refresh_event_by_key( &mut self, key: &GlwEventKey, ) -> Result<Option<GlwEvent>, GlwEventCacheError>

Force a fresh fetch of an event by key, bypassing all cache tiers.

Errors

Returns GlwEventCacheError if a database or upstream HTTP operation fails.

Trait Implementations

impl Debug for GlwEventCache

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

Formats the value using the given formatter.