Struct Cache 

pub struct Cache { /* private fields */ }

Cache for storing previously used flake URIs.

Used for shell completions to suggest frequently used inputs.

Implementations

impl Cache

pub fn commit(&self) -> Result<()>

Save the cache to disk.

pub fn load() -> Self

Load the cache from the default location, or return a default empty cache.

pub fn from_path(path: &Path) -> Self

Load the cache from a specific file path, or return a default empty cache.

pub fn try_from_path(path: &Path) -> Result<Self>

Try to load the cache from a specific file path.

pub fn add_entry(&mut self, id: String, uri: String)

Add or update a cache entry.

pub fn list_uris(&self) -> Vec<String>

List cached URIs sorted by hit count (most used first).

pub fn list_uris_for_id(&self, id: &str) -> Vec<String>

List cached URIs for a specific input ID, sorted by hit count (most used first).

This is useful for the “change” workflow where we want to suggest URIs that were previously used for the same input ID (e.g., both the remote github: URI and a local path: URI for testing).

pub fn populate_from_inputs<'a>( &mut self, inputs: impl Iterator<Item = (&'a str, &'a str)>, )

Add entries for all inputs without incrementing hit counts.

This is used to populate the cache with inputs discovered while running any command (list, change, update, etc.), not just add. Unlike add_entry, this does NOT increment hit counts for existing entries - it only adds new entries that don’t exist yet.

Trait Implementations

impl Clone for Cache

fn clone(&self) -> Cache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Cache

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

Formats the value using the given formatter.

impl Default for Cache

fn default() -> Cache

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Cache

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Cache

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

where __S: Serializer,

Serialize this value into the given Serde serializer.