Struct PackageCacheLayer 

pub struct PackageCacheLayer { /* private fields */ }

Implementations

impl PackageCacheLayer

pub fn new(path: impl Into<PathBuf>) -> Self

Creates an unfiltered package-cache layer with default validation.

pub fn with_validation_mode(self, validation_mode: ValidationMode) -> Self

Sets the validation mode used by this layer.

pub fn with_filter(self, spec: MatchSpec) -> Self

Adds an inclusion MatchSpec to this layer.

Multiple inclusion specifications are combined with OR. If no inclusion specification is configured, all packages are included.

pub fn excluding(self, spec: MatchSpec) -> Self

Excludes packages matching spec from this layer.

Exclusions take precedence over inclusion specifications.

pub fn path(&self) -> &Path

Returns the root directory of this layer.

pub fn accepts(&self, cache_key: &CacheKey) -> bool

Returns whether this layer accepts cache_key.

pub fn is_readonly(&self) -> bool

Determine if the layer is read-only in the filesystem

pub async fn try_validate( &self, cache_key: &CacheKey, ) -> Result<CacheMetadata, PackageCacheLayerError>

Validate the packages.

An entry this cache object has not touched before is validated from disk, just as Self::validate_or_fetch would: layers hold entries written by other processes or earlier runs, and a lookup that only believed its own in-memory bookkeeping would refetch all of those.

pub async fn validate_or_fetch<F, Fut, E>( &self, fetch: F, cache_key: &CacheKey, reporter: Option<Arc<dyn CacheReporter>>, ) -> Result<CacheMetadata, PackageCacheLayerError>

where F: Fn(PathBuf) -> Fut + Send + 'static, Fut: Future<Output = Result<(), E>> + Send + 'static, E: Error + Send + Sync + 'static,

Validate the package, and fetch it if invalid.

Trait Implementations

impl Clone for PackageCacheLayer

fn clone(&self) -> PackageCacheLayer

Returns a duplicate of the value.

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

Performs copy-assignment from source.