Struct MetadataCache 

pub struct MetadataCache<T>
where
    T: for<'de> Deserialize<'de>,
{ /* private fields */ }

Generic cache for parsed shader metadata.

Avoids re-parsing shader files on every access while still allowing invalidation for hot reload scenarios.

T must be deserializable from YAML via serde. Use the type aliases ShaderMetadataCache and CursorShaderMetadataCache for the two concrete cache types used by par-term.

Implementations

impl<T> MetadataCache<T>

where T: for<'de> Deserialize<'de>,

pub fn new() -> MetadataCache<T>

Create a new empty metadata cache.

pub fn with_shaders_dir(shaders_dir: PathBuf) -> MetadataCache<T>

Create a new metadata cache with a specific shaders directory.

pub fn set_shaders_dir(&mut self, shaders_dir: PathBuf)

Set the shaders directory path.

pub fn get(&mut self, shader_name: &str) -> Option<&T>

where T: Debug,

Get metadata for a shader, loading and caching if necessary.

Arguments

• shader_name - Filename of the shader (e.g., “crt.glsl”)

Returns

• Some(&T) if metadata was found
• None if no metadata was found or the shader couldn’t be read

pub fn get_fresh(&self, shader_name: &str) -> Option<T>

Get metadata without caching (always reads from disk).

Useful for hot reload scenarios where you want fresh data.

pub fn invalidate(&mut self, shader_name: &str)

Invalidate cached metadata for a specific shader.

Call this when a shader file has been modified (hot reload).

pub fn invalidate_all(&mut self)

Invalidate all cached metadata.

Call this when the shaders directory might have changed.

pub fn is_cached(&self, shader_name: &str) -> bool

Check if metadata is cached for a shader.

pub fn cache_size(&self) -> usize

Get the number of cached entries.

Trait Implementations

impl<T> Debug for MetadataCache<T>

where T: Debug + for<'de> Deserialize<'de>,

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

Formats the value using the given formatter.

impl<T> Default for MetadataCache<T>

where T: for<'de> Deserialize<'de>,

fn default() -> MetadataCache<T>

Returns the “default value” for a type.