Struct CratesIoRegistry 

pub struct CratesIoRegistry { /* private fields */ }

Client for interacting with crates.io registry.

Uses the sparse index protocol for fast version lookups (via SparseIndexClient) and the REST API for package search. All requests are cached via the provided HttpCache.

Implementations

impl CratesIoRegistry

pub fn new(cache: Arc<HttpCache>) -> Self

Creates a new registry client with the given HTTP cache.

pub async fn get_versions(&self, name: &str) -> Result<Vec<CargoVersion>>

Fetches all versions for a crate from the sparse index.

Returns versions sorted newest-first. Includes yanked versions.

Errors

Returns an error if:

• HTTP request fails
• Response body is invalid UTF-8
• JSON parsing fails

Examples

let cache = Arc::new(HttpCache::new());
let registry = CratesIoRegistry::new(cache);

let versions = registry.get_versions("serde").await.unwrap();
assert!(!versions.is_empty());

pub async fn get_versions_with( &self, name: &str, _freshness: FreshnessSettings, ) -> Result<Vec<CargoVersion>>

Like Self::get_versions, but threads freshness through so a caller routing via CargoRegistry’s get_versions_for_source crates.io fallback arms cannot silently drop it if crates.io ever gains its own publish-time enrichment (issue #588 critic M10) — today this is a pure pass-through, identical to Self::get_versions, since crates.io’s sparse index carries no such enrichment yet.

pub async fn get_latest_matching( &self, name: &str, req_str: &str, ) -> Result<Option<CargoVersion>>

Finds the latest version matching the given semver requirement.

Only returns non-yanked versions.

Errors

Returns an error if:

• Version requirement string is invalid semver
• HTTP request fails

Examples

let cache = Arc::new(HttpCache::new());
let registry = CratesIoRegistry::new(cache);

let latest = registry.get_latest_matching("serde", "^1.0").await.unwrap();
assert!(latest.is_some());

pub async fn search(&self, query: &str, limit: usize) -> Result<Vec<CrateInfo>>

Searches for crates by name/keywords.

Returns up to limit results sorted by relevance.

Errors

Returns an error if:

• HTTP request fails
• JSON parsing fails

Examples

let cache = Arc::new(HttpCache::new());
let registry = CratesIoRegistry::new(cache);

let results = registry.search("serde", 10).await.unwrap();
assert!(!results.is_empty());

Trait Implementations

impl Clone for CratesIoRegistry

fn clone(&self) -> CratesIoRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Registry for CratesIoRegistry

fn get_versions<'a>( &'a self, name: &'a PackageName, ) -> BoxFuture<'a, Result<Vec<Box<dyn Version>>>>

Fetches all available versions for a package.

fn get_latest_matching<'a>( &'a self, name: &'a PackageName, req: &'a VersionReq, ) -> BoxFuture<'a, Result<Option<Box<dyn Version>>>>

Finds the latest version matching a version requirement.

fn select_latest_matching( &self, versions: &[Box<dyn Version>], req: &VersionReq, ) -> Option<usize>

Index of the latest version in versions satisfying req, with no I/O.

fn search<'a>( &'a self, query: &'a str, limit: usize, ) -> BoxFuture<'a, Result<Vec<Box<dyn Metadata>>>>

Searches for packages by name or keywords.

fn as_any(&self) -> &dyn Any

Downcast to concrete registry type for ecosystem-specific operations

fn get_versions_with<'a>( &'a self, name: &'a PackageName, freshness: FreshnessSettings, ) -> Pin<Box<dyn Future<Output = Result<Vec<Box<dyn Version>>, DepsError>> + Send + 'a>>

Like get_versions, but lets a registry that can obtain Version::published_at only through an extra request gate that request behind freshness.enabled instead of always paying for it.

fn get_versions_from<'a>( &'a self, name: &'a PackageName, source: &'a DependencySource, freshness: FreshnessSettings, ) -> Pin<Box<dyn Future<Output = Result<Vec<Box<dyn Version>>, DepsError>> + Send + 'a>>

Like get_versions_with, but additionally carries the dependency’s resolved DependencySource, for a registry that routes a single fetch across more than one underlying index (e.g. deps-cargo’s CargoRegistry, which dispatches a DependencySource::AlternateRegistry to a private sparse index instead of crates.io).

fn get_latest_matching_with_context<'a>( &'a self, name: &'a PackageName, req: &'a VersionReq, minimum_stability: Option<&'a str>, ) -> Pin<Box<dyn Future<Output = Result<Option<Box<dyn Version>>, DepsError>> + Send + 'a>>

Like get_latest_matching, but lets a registry whose “latest matching” selection can be refined by ecosystem-specific manifest state (e.g. Composer’s minimum-stability field, #424) read it, alongside req.

fn get_latest_matching_from<'a>( &'a self, name: &'a PackageName, source: &'a DependencySource, req: &'a VersionReq, minimum_stability: Option<&'a str>, ) -> Pin<Box<dyn Future<Output = Result<Option<Box<dyn Version>>, DepsError>> + Send + 'a>>

Like get_latest_matching_with_context, but additionally carries the dependency’s resolved DependencySource — the get_latest_matching-shaped counterpart to get_versions_from, covering the fallback path a caller takes when the list-based pick fails on a non-empty get_versions_from result (see deps_core::lsp_helpers::hover’s list_fallback_latest and deps-lsp’s background-fetch fallback for the two call sites this exists for).

fn select_latest_matching_with_context( &self, versions: &[Box<dyn Version>], req: &VersionReq, minimum_stability: Option<&str>, ) -> Option<usize>

Like select_latest_matching, but lets a registry whose selection can be refined by ecosystem-specific manifest state (e.g. Composer’s minimum-stability field, #424) read it, alongside versions and req. See get_latest_matching_with_context for why minimum_stability is an opaque per-ecosystem string rather than a shared type.

fn reports_yanked(&self) -> bool

Whether get_versions results carry meaningful per-version yank/deprecation data via Version::removal_status.