Struct cargo::core::dependency::Dependency

pub struct Dependency { /* fields omitted */ }

Information about a dependency requested by a Cargo manifest. Cheap to copy.

Methods

impl Dependency

pub fn parse(     name: &str,     version: Option<&str>,     source_id: SourceId,     inside: PackageId,     config: &Config ) -> CargoResult<Dependency>

Attempt to create a Dependency from an entry in the manifest.

pub fn parse_no_deprecated(     name: &str,     version: Option<&str>,     source_id: SourceId ) -> CargoResult<Dependency>

Attempt to create a Dependency from an entry in the manifest.

pub fn new_override(name: &str, source_id: SourceId) -> Dependency

pub fn version_req(&self) -> &VersionReq

pub fn name_in_toml(&self) -> InternedString

This is the name of this Dependency as listed in Cargo.toml.

Or in other words, this is what shows up in the [dependencies] section on the left hand side. This is not the name of the package that's being depended on as the dependency can be renamed. For that use package_name below.

Both of the dependencies below return foo for name_in_toml:

[dependencies]
foo = "0.1"

and ...

[dependencies]
foo = { version = "0.1", package = 'bar' }

pub fn package_name(&self) -> InternedString

The name of the package that this Dependency depends on.

Usually this is what's written on the left hand side of a dependencies section, but it can also be renamed via the package key.

Both of the dependencies below return foo for package_name:

[dependencies]
foo = "0.1"

and ...

[dependencies]
bar = { version = "0.1", package = 'foo' }

pub fn source_id(&self) -> SourceId

pub fn registry_id(&self) -> Option<SourceId>

pub fn set_registry_id(&mut self, registry_id: SourceId) -> &mut Dependency

pub fn kind(&self) -> Kind

pub fn specified_req(&self) -> bool

pub fn platform(&self) -> Option<&Platform>

If none, this dependencies must be built for all platforms. If some, it must only be built for the specified platform.

pub fn explicit_name_in_toml(&self) -> Option<InternedString>

The renamed name of this dependency, if any.

If the package key is used in Cargo.toml then this returns the same value as name_in_toml.

pub fn set_kind(&mut self, kind: Kind) -> &mut Dependency

pub fn set_features(     &mut self,     features: impl IntoIterator<Item = impl AsRef<str>> ) -> &mut Dependency

Sets the list of features requested for the package.

pub fn set_default_features(     &mut self,     default_features: bool ) -> &mut Dependency

Sets whether the dependency requests default features of the package.

pub fn set_optional(&mut self, optional: bool) -> &mut Dependency

Sets whether the dependency is optional.

pub fn set_source_id(&mut self, id: SourceId) -> &mut Dependency

Set the source id for this dependency

pub fn set_version_req(&mut self, req: VersionReq) -> &mut Dependency

Set the version requirement for this dependency

pub fn set_platform(&mut self, platform: Option<Platform>) -> &mut Dependency

pub fn set_explicit_name_in_toml(&mut self, name: &str) -> &mut Dependency

pub fn lock_to(&mut self, id: PackageId) -> &mut Dependency

Lock this dependency to depending on the specified package id

pub fn is_locked(&self) -> bool

Returns whether this is a "locked" dependency, basically whether it has an exact version req.

pub fn is_transitive(&self) -> bool

Returns false if the dependency is only used to build the local package.

pub fn is_build(&self) -> bool

pub fn is_optional(&self) -> bool

pub fn uses_default_features(&self) -> bool

Returns true if the default features of the dependency are requested.

pub fn features(&self) -> &[InternedString]

Returns the list of features that are requested by the dependency.

pub fn matches(&self, sum: &Summary) -> bool

Returns true if the package (sum) can fulfill this dependency request.

pub fn matches_ignoring_source(&self, id: PackageId) -> bool

Returns true if the package (sum) can fulfill this dependency request.

pub fn matches_id(&self, id: PackageId) -> bool

Returns true if the package (id) can fulfill this dependency request.

pub fn map_source(     self,     to_replace: SourceId,     replace_with: SourceId ) -> Dependency

Trait Implementations

impl Eq for Dependency

impl PartialOrd<Dependency> for Dependency

fn partial_cmp(&self, other: &Dependency) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Dependency) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Dependency) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Dependency) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Dependency) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialEq<Dependency> for Dependency

fn eq(&self, other: &Dependency) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Dependency) -> bool

This method tests for !=.

impl Clone for Dependency

fn clone(&self) -> Dependency

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Ord for Dependency

fn cmp(&self, other: &Dependency) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

impl Debug for Dependency

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

Formats the value using the given formatter.

impl Hash for Dependency

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where     H: Hasher,

Feeds a slice of this type into the given [Hasher].

impl Serialize for Dependency

fn serialize<S>(&self, s: S) -> Result<S::Ok, S::Error> where     S: Serializer,

Serialize this value into the given Serde serializer.