Struct Cache 

pub struct Cache {
    pub version: u32,
    pub queues: BTreeMap<String, Vec<String>>,
}

Fields

version: u32

queues: BTreeMap<String, Vec<String>>

Queue key -> the profiles known to see it.

Implementations

impl Cache

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

Read it, or start empty. A cache that cannot be read is not an error: the worst outcome is a warning we fail to give.

pub fn record(&mut self, profile: &str, queue_keys: &[String])

Replace what is known about one profile.

Replace rather than merge: a queue the profile can no longer see should stop being attributed to it, or the warning outlives the fact.

pub fn rename(&mut self, from: &str, to: &str) -> bool

Follow a profile that was renamed.

Stale names are already harmless — profiles_for filters against the configured ones — but dropping the knowledge would make the next bare key ambiguous again until something lists queues afresh. Returns whether anything moved, so an unchanged cache is not rewritten.

pub fn forget(&mut self, profile: &str) -> bool

Drop everything remembered about a profile that no longer exists.

profiles_for already ignores names that are not configured, so this is about a later profile reusing the name: it must not inherit the queues its namesake could see. Returns whether anything went, so an unchanged cache is not rewritten.

pub fn profiles_for(&self, queue: &str, configured: &[String]) -> Vec<String>

Which profiles see this queue, among those still configured.

Filtering against the current config matters: a profile deleted from the config must not keep making its old queues look ambiguous.

pub fn save(&mut self, path: &Path)

Write it out. Failing to save a cache is not worth failing a command for.

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.