Struct PypiRegistry 

pub struct PypiRegistry { /* private fields */ }

Client for interacting with the PyPI registry.

Uses the PyPI JSON API for package metadata. All requests are cached via the provided HttpCache.

Examples

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

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

Implementations

impl PypiRegistry

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

Creates a new PyPI registry client with the given HTTP cache.

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

Fetches all versions for a package from PyPI.

Returns versions sorted newest-first. Filters out yanked versions by default.

Errors

Returns an error if:

• HTTP request fails
• Response body is invalid UTF-8
• JSON parsing fails
• Package does not exist

Examples

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

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

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

Finds the latest version matching the given PEP 440 version specifier.

Only returns non-yanked, non-prerelease versions by default.

Errors

Returns an error if:

• HTTP request fails
• Package does not exist
• Version specifier is invalid

Examples

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

let latest = registry.get_latest_matching("flask", ">=3.0,<4.0").await.unwrap();
assert!(latest.is_some());

pub async fn search( &self, _query: &str, _limit: usize, ) -> Result<Vec<PypiPackage>, PypiError>

Searches for packages by name/keywords.

Note: PyPI does not provide an official search API, so this returns an empty result for now. Future implementation could use third-party search services or scraping.

Errors

Currently always returns Ok with empty vector.

Examples

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

let results = registry.search("flask", 10).await.unwrap();
// Currently returns empty, to be implemented

pub async fn get_package_metadata( &self, name: &str, ) -> Result<PypiPackage, PypiError>

Fetches package metadata including description and project URLs.

Errors

Returns an error if:

• HTTP request fails
• Package does not exist
• JSON parsing fails

Trait Implementations

impl Clone for PypiRegistry

fn clone(&self) -> PypiRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl PackageRegistry for PypiRegistry

type Version = PypiVersion

Version information type for this registry.

type Metadata = PypiPackage

Metadata type for search results.

type VersionReq = String

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<<PypiRegistry as PackageRegistry>::Version>, DepsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, PypiRegistry: '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 <PypiRegistry as PackageRegistry>::VersionReq, ) -> Pin<Box<dyn Future<Output = Result<Option<<PypiRegistry as PackageRegistry>::Version>, DepsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, PypiRegistry: '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<<PypiRegistry as PackageRegistry>::Metadata>, DepsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, PypiRegistry: 'async_trait,

Searches for packages by name or keywords.

impl Registry for PypiRegistry

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

where 'life0: 'async_trait, 'life1: 'async_trait, PypiRegistry: '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>>, DepsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, PypiRegistry: '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>>, DepsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, PypiRegistry: '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 + 'static)

Downcast to concrete registry type for ecosystem-specific operations