Struct cached_path::Cache
source · pub struct Cache {
pub dir: PathBuf,
/* private fields */
}
Expand description
Fetches and manages resources in a local cache directory.
Fields§
§dir: PathBuf
The root directory of the cache.
Implementations§
source§impl Cache
impl Cache
sourcepub fn builder() -> CacheBuilder
pub fn builder() -> CacheBuilder
Create a CacheBuilder
.
sourcepub fn cached_path(&self, resource: &str) -> Result<PathBuf, Error>
pub fn cached_path(&self, resource: &str) -> Result<PathBuf, Error>
Get the cached path to a resource.
If the resource is local file, it’s path is returned. If the resource is a static HTTP resource, it will cached locally and the path to the cache file will be returned.
sourcepub fn cached_path_with_options(
&self,
resource: &str,
options: &Options
) -> Result<PathBuf, Error>
pub fn cached_path_with_options( &self, resource: &str, options: &Options ) -> Result<PathBuf, Error>
Get the cached path to a resource using the given options.
Examples
Use a particular subdirectory of the cache root:
let path = cache.cached_path_with_options(
resource,
&Options::default().subdir(subdir),
).unwrap();
Treat the resource as an archive and extract it. The path returned is the path to the extraction directory:
let path = cache.cached_path_with_options(
resource,
&Options::default().extract(),
).unwrap();
assert!(path.is_dir());
sourcepub fn cached_path_in_subdir(
&self,
resource: &str,
subdir: Option<&str>
) -> Result<PathBuf, Error>
👎Deprecated since 0.4.4: Please use Cache::cached_path_with_options() instead
pub fn cached_path_in_subdir( &self, resource: &str, subdir: Option<&str> ) -> Result<PathBuf, Error>
A convenience method to get the cached path to a resource using the given cache subdirectory (relative to the cache root).
This is equivalent to:
let path = cache.cached_path_with_options(
resource,
&Options::default().subdir(subdir),
).unwrap();