Struct cargo::core::resolver::VersionPreferences

pub struct VersionPreferences {
    try_to_use: HashSet<PackageId>,
    prefer_patch_deps: HashMap<InternedString, HashSet<Dependency>>,
}

A collection of preferences for particular package versions.

This is built up with Self::prefer_package_id and Self::prefer_dependency, then used to sort the set of summaries for a package during resolution via Self::sort_summaries.

As written, a version is either “preferred” or “not preferred”. Later extensions may introduce more granular preferences.

Fields

try_to_use: HashSet<PackageId>

prefer_patch_deps: HashMap<InternedString, HashSet<Dependency>>

Implementations

impl VersionPreferences

pub fn prefer_package_id(&mut self, pkg_id: PackageId)

Indicate that the given package (specified as a PackageId) should be preferred.

pub fn prefer_dependency(&mut self, dep: Dependency)

Indicate that the given package (specified as a Dependency) should be preferred.

pub fn sort_summaries( &self, summaries: &mut Vec<Summary>, version_ordering: VersionOrdering, first_version: bool )

Sort the given vector of summaries in-place, with all summaries presumed to be for the same package. Preferred versions appear first in the result, sorted by version_ordering, followed by non-preferred versions sorted the same way.

Trait Implementations

impl Default for VersionPreferences

fn default() -> VersionPreferences

Returns the “default value” for a type.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 96 bytes