Struct ResolvedPackages 

pub struct ResolvedPackages { /* private fields */ }

Collection of resolved packages from a lock file.

Supports multiple versions per package name, returning the highest semver version through public API methods.

Examples

use deps_core::lockfile::{ResolvedPackages, ResolvedPackage, ResolvedSource};

let mut packages = ResolvedPackages::new();
packages.insert(
    ResolvedPackage::new(
        "serde".into(),
        "1.0.195".into(),
        ResolvedSource::Registry {
            url: "https://github.com/rust-lang/crates.io-index".into(),
            checksum: "abc123".into(),
        },
    )
    .with_dependencies(vec!["serde_derive".into()]),
);

assert_eq!(packages.version("serde"), Some("1.0.195"));
assert_eq!(packages.len(), 1);

Implementations

impl ResolvedPackages

pub fn new() -> Self

Creates a new empty collection.

pub fn insert(&mut self, package: ResolvedPackage)

Inserts a resolved package, storing all versions per name.

pub fn get(&self, name: &str) -> Option<&ResolvedPackage>

Gets the resolved package with the highest semver version.

pub fn version(&self, name: &str) -> Option<&str>

Gets the highest resolved version string for a package.

pub fn all(&self, name: &str) -> Option<&[ResolvedPackage]>

Returns all stored versions for a package.

pub fn iter_all(&self) -> impl Iterator<Item = (&String, &[ResolvedPackage])>

Returns an iterator yielding every stored version for each unique package name, unlike Self::iter which collapses each name down to best_package’s single pick.

The building block for per-occurrence lock-file resolution (issue #649): a caller disambiguating two manifest occurrences of the same resolved package name (e.g. a Cargo package = "..." rename pinning an older major alongside a plain dependency on the current major) needs every retained version for that name, not just the one Self::iter/Self::into_map would collapse it to.

pub fn len(&self) -> usize

Returns the number of unique package names.

pub fn is_empty(&self) -> bool

Returns true if there are no resolved packages.

pub fn iter(&self) -> impl Iterator<Item = (&String, &ResolvedPackage)>

Returns an iterator yielding the best version per unique package name.

pub fn into_map(self) -> HashMap<String, ResolvedPackage>

Converts into a HashMap with the best version per package name.

Trait Implementations

impl Clone for ResolvedPackages

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResolvedPackages

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

Formats the value using the given formatter.

impl Default for ResolvedPackages

fn default() -> Self

Returns the “default value” for a type.