Struct cargo_edit::Dependency

pub struct Dependency {
    pub name: String,
    pub features: Option<Vec<String>>,
    pub available_features: BTreeMap<String, Vec<String>>,
    /* private fields */
}

A dependency handled by Cargo

Fields

name: String

The name of the dependency (as it is set in its Cargo.toml and known to crates.io)

features: Option<Vec<String>>

List of features to add (or None to keep features unchanged).

available_features: BTreeMap<String, Vec<String>>

Features that are exposed by the dependency

Implementations

impl Dependency

pub fn new(name: &str) -> Dependency

Create a new dependency with a name

pub fn set_version(self, version: &str) -> Dependency

Set dependency to a given version

pub fn clear_version(self) -> Dependency

Remove the existing version requirement

pub fn set_available_features(
    self,
    available_features: BTreeMap<String, Vec<String>>
) -> Dependency

Set the available features of the dependency to a given vec

pub fn set_git(
    self,
    repo: &str,
    branch: Option<String>,
    tag: Option<String>,
    rev: Option<String>
) -> Dependency

Set dependency to a given repository

pub fn set_path(self, path: PathBuf) -> Dependency

Set dependency to a given path

Panic

Panics if the path is relative

pub fn set_optional(self, opt: Option<bool>) -> Dependency

Set whether the dependency is optional

pub fn set_features(self, features: Option<Vec<String>>) -> Dependency

Set features as an array of string (does some basic parsing)

pub fn set_default_features(self, default_features: Option<bool>) -> Dependency

Set the value of default-features for the dependency

pub fn set_rename(self, rename: &str) -> Dependency

Set the alias for the dependency

pub fn set_registry(self, registry: &str) -> Dependency

Set the value of registry for the dependency

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

Get version of dependency

pub fn path(&self) -> Option<&Path>

Get the path of the dependency

pub fn registry(&self) -> Option<&str>

Get registry of the dependency

pub fn git(&self) -> Option<&str>

Get the git repo of the dependency

pub fn rename(&self) -> Option<&str>

Get the alias for the dependency (if any)

pub fn default_features(&self) -> Option<bool>

Whether default features are activated

impl Dependency

pub fn from_toml(crate_root: &Path, key: &str, item: &Item) -> Option<Self>

Create a dependency from a TOML table entry

pub fn toml_key(&self) -> &str

Get the dependency name as defined in the manifest, that is, either the alias (rename field if Some), or the official package name (name field).

pub fn to_toml(&self, crate_root: &Path) -> Item

Convert dependency to TOML

Returns a tuple with the dependency’s name and either the version as a String or the path/git repository as an InlineTable. (If the dependency is set as optional or default-features is set to false, an InlineTable is returned in any case.)

Panic

Panics if the path is relative

pub fn update_toml(&self, crate_root: &Path, item: &mut Item)

Modify existing entry to match this dependency

Trait Implementations

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 Debug for Dependency

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

Formats the value using the given formatter.

impl Default for Dependency

fn default() -> Dependency

Returns the “default value” for a type.

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 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.

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

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 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: &Rhs) -> bool

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

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

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

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

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

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

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

impl Eq for Dependency

impl StructuralEq for Dependency

impl StructuralPartialEq for Dependency