Struct crates_index::SparseIndex

pub struct SparseIndex { /* private fields */ }

Wrapper around managing a sparse HTTP index, re-using Cargo’s local disk caches.

Currently it only uses local Cargo cache, and does not access the network in any way.

Implementations

impl Index

pub fn from_url(url: &str) -> Result<Self, Error>

Creates a view over the sparse HTTP index from a provided URL, opening the same location on disk that Cargo uses for that registry index’s metadata and cache.

Note this function takes the CARGO_HOME environment variable into account

pub fn new_cargo_default() -> Result<Self, Error>

Creates an index for the default crates.io registry, using the same disk location as Cargo itself.

This is the recommended way to access the crates.io sparse index.

Note this function takes the CARGO_HOME environment variable into account

pub fn with_path( cargo_home: impl AsRef<Path>, url: impl AsRef<str> ) -> Result<Self, Error>

Creates a view over the sparse HTTP index from the provided URL, rooted at the specified location

pub fn at_path(path: PathBuf, url: String) -> Self

Creates a view over the sparse HTTP index at the exact specified path

pub fn index_config(&self) -> Result<IndexConfig, Error>

Get the global configuration of the index.

pub fn crate_from_cache(&self, name: &str) -> Result<Crate, Error>

Reads a crate from the local cache of the index. There are no guarantees around freshness, and if the crate is not known in the cache, no fetch will be performed.

pub fn url(&self) -> &str

The HTTP url of the index

pub fn crate_url(&self, name: &str) -> Option<String>

Get the URL that can be used to fetch the index entry for the specified crate

The body of a successful response for the returned URL can be parsed via Crate::from_slice