Struct CacheItems 

pub struct CacheItems { /* private fields */ }

Records data about the cached sources and where their artefacts are within a Cache.

When a Source is fetched, insert its Artefact into a cache to avoid repeatedly fetching the same source definition.

When fetching a source, check the cache subdirectory to use with CacheItems::relative_path.

Implementations

impl CacheItems

pub fn new() -> Self

Create an empty collection.

pub fn get(&self, source: &Source) -> Option<&Artefact>

Retrieves a cached artefact for the given source, if it exists.

pub fn contains(&self, source: &Source) -> bool

Check whether the cache contains the given source.

pub fn insert(&mut self, artefact: Artefact)

Cache an artefact and return the digest of the Source which created it. Replaces any previous value for this source.

pub fn remove(&mut self, source: &Source) -> Option<Artefact>

Removes a cached value for the given source, returning it if it existed.

pub fn values(&self) -> impl Iterator<Item = &Artefact>

Returns an iterator over the cached values.

pub fn is_empty(&self) -> bool

Checks if the cache is empty.

pub fn len(&self) -> usize

Returns the number of cached values.

pub fn relative_path<S: AsRef<Source>>(&self, source: S) -> RelCacheDir

Get the relative path for a source within a cache directory

Trait Implementations

impl Debug for CacheItems

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

Formats the value using the given formatter.

impl Default for CacheItems

fn default() -> CacheItems

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CacheItems

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a> IntoIterator for &'a CacheItems

type Item = (&'a Digest, &'a Artefact)

The type of the elements being iterated over.

type IntoIter = Iter<'a, Digest, Artefact>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for CacheItems

type Item = (Digest, Artefact)

The type of the elements being iterated over.

type IntoIter = IntoIter<Digest, Artefact>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for CacheItems

fn eq(&self, other: &CacheItems) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CacheItems

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for CacheItems

impl StructuralPartialEq for CacheItems