Struct CratesIoRegistry 

pub struct CratesIoRegistry { /* private fields */ }

Client for interacting with crates.io registry.

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

Implementations

impl CratesIoRegistry

pub const 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_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 PackageRegistry for CratesIoRegistry

type Version = CargoVersion

Version information type for this registry.

type Metadata = CrateInfo

Metadata type for search results.

type VersionReq = VersionReq

Version requirement type (e.g., semver::VersionReq for Cargo, npm semver for npm).

fn get_versions<'life0, 'life1, 'async_trait>( &'life0 self, name: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<Self::Version>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches all available versions for a package.

fn get_latest_matching<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, name: &'life1 str, req: &'life2 Self::VersionReq, ) -> Pin<Box<dyn Future<Output = Result<Option<Self::Version>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Finds the latest version matching a version requirement.

fn search<'life0, 'life1, 'async_trait>( &'life0 self, query: &'life1 str, limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<Self::Metadata>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Searches for packages by name or keywords.

impl Registry for CratesIoRegistry

fn get_versions<'life0, 'life1, 'async_trait>( &'life0 self, name: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<Box<dyn Version>>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches all available versions for a package.

fn get_latest_matching<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, name: &'life1 str, req: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Box<dyn Version>>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Finds the latest version matching a version requirement.

fn search<'life0, 'life1, 'async_trait>( &'life0 self, query: &'life1 str, limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<Box<dyn Metadata>>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Searches for packages by name or keywords.

fn package_url(&self, name: &str) -> String

Package URL for ecosystem (e.g., https://crates.io/crates/serde)

fn as_any(&self) -> &dyn Any

Downcast to concrete registry type for ecosystem-specific operations