Struct ExtrasSpecification 

pub struct ExtrasSpecification(/* private fields */);

Manager of all extra decisions and settings history.

This is an Arc mostly just to avoid size bloat on things that contain these.

Implementations

impl ExtrasSpecification

pub fn from_args( extra: Vec<ExtraName>, no_extra: Vec<ExtraName>, no_default_extras: bool, only_extra: Vec<ExtraName>, all_extras: bool, ) -> Self

Create from raw CLI args

pub fn from_extra(extra: Vec<ExtraName>) -> Self

Helper to make a spec from just a –extra

pub fn from_all_extras() -> Self

Helper to make a spec from just –all-extras

pub fn with_defaults( &self, defaults: DefaultExtras, ) -> ExtrasSpecificationWithDefaults

Apply defaults to a base ExtrasSpecification.

Methods from Deref<Target = ExtrasSpecificationInner>

pub fn prod(&self) -> bool

Returns true if packages other than the ones referenced by these extras should be considered.

That is, if I tell you to install a project and this is false, you should ignore the project itself and all its dependencies, and instead just install the extras.

(This is really just asking if an –only flag was passed.)

pub fn contains(&self, extra: &ExtraName) -> bool

Returns true if the specification includes the given extra.

pub fn desugarred_names(&self) -> impl Iterator<Item = &ExtraName>

Iterate over all extras that we think should exist.

pub fn extra_names<'a, Names>( &'a self, all_names: Names, ) -> impl Iterator<Item = &'a ExtraName> + 'a

where Names: Iterator<Item = &'a ExtraName> + 'a,

Returns an iterator over all extras that are included in the specification, assuming all_names is an iterator over all extras.

pub fn explicit_names(&self) -> impl Iterator<Item = &ExtraName>

Iterate over all groups the user explicitly asked for on the CLI

pub fn is_empty(&self) -> bool

Returns true if the specification will have no effect.

pub fn history(&self) -> &ExtrasSpecificationHistory

Get the raw history for diagnostics

Trait Implementations

impl Clone for ExtrasSpecification

fn clone(&self) -> ExtrasSpecification

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExtrasSpecification

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

Formats the value using the given formatter.

impl Default for ExtrasSpecification

fn default() -> ExtrasSpecification

Returns the “default value” for a type.

impl Deref for ExtrasSpecification

type Target = ExtrasSpecificationInner

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.