nc7s/rust-crates-index

Rust library for retrieving and interacting with the crates.io index

crates-index

Library for retrieving and interacting with the crates.io registry git-based index.

The index contains metadata for all Rust libraires and programs published on crates.io: their verisons, dependencies, and feature flags.

Documentation

Example

let index = crates_index::Index::new_cargo_default()?;

for crate_releases in index.crates() {
    let _ = crate_releases.most_recent_release(); // newest version
    let crate_version = crate_releases.highest_version(); // max version by semver
    println!("crate name: {}", crate_version.name());
    println!("crate version: {}", crate_version.version());
}

Migration from 0.16 and 0.17

• BareIndex and BareIndexRepo have become the Index.
• Index::new_cargo_default()? is the preferred way of accessing the index. Use with_path() to clone to a different directory.
• There's no need to call retrieve() or exists(). It's always retrieved and always exists.
• retrieve_or_update() is just update().
• highest_version() returns crate metadata rather than just the version number. Call highest_version().version().parse() to get semver::Version.
• There's no crate_index_paths(), because there are no files any more. Use crate_ to get individual crates.

Similar crates

• crates_io_api

License

Licensed under version 2 of the Apache License