Struct PersonaCache 

pub struct PersonaCache { /* private fields */ }

Thread-safe persona cache with TTL expiration.

This cache stores UserPersona data keyed by SteamID and automatically considers entries expired after the configured TTL.

Implementations

impl PersonaCache

pub fn new(config: PersonaCacheConfig) -> Self

Create a new persona cache with the given configuration.

pub fn get(&self, steam_id: &SteamID) -> Option<UserPersona>

Get persona from cache if not expired.

Returns None if the entry doesn’t exist or has expired.

pub fn insert(&self, steam_id: SteamID, data: UserPersona)

Insert or update a persona in the cache.

If the cache is at capacity, expired entries are evicted first.

pub fn get_many( &self, steam_ids: &[SteamID], ) -> (Vec<UserPersona>, Vec<SteamID>)

Bulk get - returns found (non-expired) entries and missing SteamIDs.

This is useful for optimizing batch lookups where you want to know which IDs need to be fetched from Steam.

Returns

A tuple of (found_personas, missing_steam_ids)

pub fn clear(&self)

Clear the entire cache.

pub fn invalidate(&self, steam_id: &SteamID)

Invalidate a specific entry.

Use this when you know a user’s data has changed and the cache should be refreshed on next access.

pub fn len(&self) -> usize

Get the current number of entries in the cache (including expired).

pub fn is_empty(&self) -> bool

Check if the cache is empty.

pub fn config(&self) -> &PersonaCacheConfig

Get the cache configuration.

pub fn evict_expired(&self)

Evict all expired entries.

This can be called periodically to clean up stale entries.

Trait Implementations

impl Clone for PersonaCache

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PersonaCache

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

Formats the value using the given formatter.

impl Default for PersonaCache

fn default() -> Self

Returns the “default value” for a type.