Struct FileMetadataCache

pub struct FileMetadataCache { /* private fields */ }

Cache for various metadata about files.

The cache is keyed by the file path and the type of metadata.

Implementations

impl FileMetadataCache

pub fn new(capacity: usize) -> Self

Instantiates a new cache which, for legacy reasons, uses Items capacity mode.

pub fn no_cache() -> Self

Instantiates a dummy cache that will never cache anything.

pub fn with_capacity(capacity: usize, mode: CapacityMode) -> Self

Instantiates a new cache with a given capacity and capacity mode.

pub fn with_base_path(&self, base_path: Path) -> Self

Creates a new cache which shares the same underlying cache but prepends base_path to all keys.

pub fn size(&self) -> usize

pub fn get<T: Send + Sync + 'static>(&self, path: &Path) -> Option<Arc<T>>

pub fn insert<T: DeepSizeOf + Send + Sync + 'static>( &self, path: Path, metadata: Arc<T>, )

pub async fn get_or_insert<T: DeepSizeOf + Send + Sync + 'static, F, Fut>( &self, path: &Path, loader: F, ) -> Result<Arc<T>>

where F: Fn(&Path) -> Fut, Fut: Future<Output = Result<T>>,

Get an item

If it exists in the cache return that

If it doesn’t then run loader to load the item, insert into cache, and return

Trait Implementations

impl Clone for FileMetadataCache

fn clone(&self) -> FileMetadataCache

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for FileMetadataCache

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

Formats the value using the given formatter.

impl DeepSizeOf for FileMetadataCache

fn deep_size_of_children(&self, _: &mut Context) -> usize

Returns an estimation of the heap-managed storage of this object. This does not include the size of the object itself.

fn deep_size_of(&self) -> usize

Returns an estimation of a total size of memory owned by the object, including heap-managed storage.