Struct CratesIoResolver 

pub struct CratesIoResolver { /* private fields */ }

crates.io-style artifact resolver owned by the CLI layer.

The default resolver performs no network access. It resolves a spec only from an already-seeded local cache or an explicitly registered registry artifact. With the registry feature, callers can install GitRegistryResolver so unresolved specs fetch from an explicit git registry artifact endpoint and then enter the same cache layout.

Implementations

impl CratesIoResolver

pub fn new(cache_dir: PathBuf) -> Self

Builds a cache-only resolver rooted at a cache directory.

pub fn default_cache_dir() -> PathBuf

Returns the default cache directory.

Honors SIM_CLI_CACHE_DIR, then XDG_CACHE_HOME, then HOME, and falls back to the system temporary directory.

pub fn cache_dir(&self) -> &Path

Returns the cache directory this resolver reads from.

pub fn add_registry_artifact( &mut self, package: impl Into<String>, version: impl Into<String>, artifact: impl Into<PathBuf>, )

Registers an in-memory registry artifact available for resolution.

pub fn with_registry_artifact( self, package: impl Into<String>, version: impl Into<String>, artifact: impl Into<PathBuf>, ) -> Self

Registers an in-memory registry artifact, returning self.

pub fn resolve( &self, spec: &CratesIoSpec, ) -> Result<ResolvedCratesIoSource, CliError>

Resolves a spec to a cached artifact, seeding the cache when needed.

Prefers an already-cached artifact, then a registered registry artifact. With the registry feature and an installed git registry resolver, misses can fetch through that resolver. Otherwise misses fail closed with a clear cache-only error rather than pretending to fetch one.

Trait Implementations

impl Clone for CratesIoResolver

fn clone(&self) -> CratesIoResolver

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CratesIoResolver

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

Formats the value using the given formatter.

impl Default for CratesIoResolver

fn default() -> Self

Returns the “default value” for a type.