Struct CratesIoClient 

pub struct CratesIoClient {
    pub cache: HashMap<String, CacheEntry<CrateResponse>>,
    pub persistent_cache: Option<PersistentCache>,
    pub cache_ttl: Duration,
    /* private fields */
}

Client for interacting with crates.io API

Fields

cache: HashMap<String, CacheEntry<CrateResponse>>

In-memory cache for crate info (15 minute TTL)

persistent_cache: Option<PersistentCache>

Persistent cache for offline mode

cache_ttl: Duration

Cache TTL

Implementations

impl CratesIoClient

pub fn new() -> Self

Create a new crates.io client

pub fn with_cache_ttl(self, ttl: Duration) -> Self

Create a client with custom TTL

pub fn with_persistent_cache(self) -> Self

Enable persistent file-based cache

pub fn set_offline(&mut self, offline: bool)

Set offline mode (only use cached data)

pub fn is_offline(&self) -> bool

Check if client is in offline mode

pub async fn get_crate(&mut self, name: &str) -> Result<CrateResponse>

Get crate info from crates.io (cached)

pub async fn get_latest_version(&mut self, name: &str) -> Result<Version>

Get the latest version of a crate

pub async fn is_version_published( &mut self, name: &str, version: &Version, ) -> Result<bool>

Check if a specific version is published

pub async fn crate_exists(&mut self, name: &str) -> bool

Check if a crate exists on crates.io

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

Get all published versions of a crate (non-yanked)

pub async fn get_dependencies( &mut self, name: &str, version: &str, ) -> Result<Vec<DependencyData>>

Get dependencies for a specific crate version from crates.io

Fetches from /api/v1/crates/{name}/{version}/dependencies

pub async fn verify_available( &mut self, name: &str, version: &Version, ) -> Result<()>

Verify a crate is available on crates.io (post-publish check)

pub fn clear_cache(&mut self)

Clear the cache

pub fn clear_expired(&mut self)

Clear expired cache entries

Trait Implementations

impl Debug for CratesIoClient

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

Formats the value using the given formatter.

impl Default for CratesIoClient

Available on crate feature native only.

fn default() -> Self

Returns the “default value” for a type.