Struct Manifest 

pub struct Manifest { /* private fields */ }

A manifest of requirements, constraints, and preferences.

Implementations

impl Manifest

pub fn new( requirements: Vec<Requirement>, constraints: Constraints, overrides: Overrides, excludes: Excludes, preferences: Preferences, project: Option<PackageName>, workspace_members: BTreeSet<PackageName>, exclusions: Exclusions, lookaheads: Vec<RequestedRequirements>, ) -> Self

pub fn simple(requirements: Vec<Requirement>) -> Self

pub fn with_constraints(self, constraints: Constraints) -> Self

pub fn requirements<'a>( &'a self, env: &'a ResolverEnvironment, mode: DependencyMode, ) -> impl Iterator<Item = Cow<'a, Requirement>> + 'a

Return an iterator over all requirements, constraints, and overrides, in priority order, such that requirements come first, followed by constraints, followed by overrides.

At time of writing, this is used for:

• Determining which requirements should allow yanked versions.
• Determining which requirements should allow pre-release versions (e.g., torch>=2.2.0a1).
• Determining which requirements should allow direct URLs (e.g., torch @ https://...).

pub fn requirements_no_overrides<'a>( &'a self, env: &'a ResolverEnvironment, mode: DependencyMode, ) -> impl Iterator<Item = Cow<'a, Requirement>> + 'a

Like Self::requirements, but without the overrides.

pub fn overrides<'a>( &'a self, env: &'a ResolverEnvironment, mode: DependencyMode, ) -> impl Iterator<Item = Cow<'a, Requirement>> + 'a

Only the overrides from Self::requirements.

pub fn user_requirements<'a>( &'a self, env: &'a ResolverEnvironment, mode: DependencyMode, ) -> impl Iterator<Item = Cow<'a, Requirement>> + 'a

Return an iterator over the names of all user-provided requirements.

This includes:

• Direct requirements
• Dependencies of editable requirements
• Transitive dependencies of local package requirements

At time of writing, this is used for:

• Determining which packages should use the “lowest-compatible version” of a package, when the lowest-direct strategy is in use.

pub fn direct_requirements<'a>( &'a self, env: &'a ResolverEnvironment, ) -> impl Iterator<Item = Cow<'a, Requirement>> + 'a

Returns an iterator over the direct requirements, with overrides applied.

At time of writing, this is used for:

• Determining which packages should have development dependencies included in the resolution (assuming the user enabled development dependencies).

pub fn apply<'a>( &'a self, requirements: impl IntoIterator<Item = &'a Requirement>, ) -> impl Iterator<Item = Cow<'a, Requirement>>

Apply the overrides and constraints to a set of requirements.

Constraints are always applied on top of overrides, such that constraints are applied even if a requirement is overridden.

pub fn num_requirements(&self) -> usize

Returns the number of input requirements.

Trait Implementations

impl Clone for Manifest

fn clone(&self) -> Manifest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Manifest

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

Formats the value using the given formatter.