Struct cargo_edit::LocalManifest

pub struct LocalManifest {
    pub path: PathBuf,
    pub manifest: Manifest,
}

A Cargo manifest that is available locally.

Fields

path: PathBuf

Path to the manifest

manifest: Manifest

Manifest contents

Implementations

impl LocalManifest

pub fn find(path: Option<&Path>) -> CargoResult<Self>

Construct a LocalManifest. If no path is provided, make an educated guess as to which one the user means.

pub fn try_new(path: &Path) -> CargoResult<Self>

Construct the LocalManifest corresponding to the Path provided.

pub fn write(&self) -> CargoResult<()>

Write changes back to the file

pub fn upgrade(
    &mut self,
    dependency: &Dependency,
    dry_run: bool,
    skip_compatible: bool
) -> CargoResult<()>

Instruct this manifest to upgrade a single dependency. If this manifest does not have that dependency, it does nothing.

pub fn get_dependency(
    &self,
    table_path: &[String],
    dep_key: &str
) -> CargoResult<Dependency>

Lookup a dependency

pub fn get_dependencies(
    &self
) -> impl Iterator<Item = (Vec<String>, CargoResult<Dependency>)> + '_

Returns all dependencies

pub fn get_dependency_versions<'s>(
    &'s self,
    dep_key: &'s str
) -> impl Iterator<Item = (Vec<String>, CargoResult<Dependency>)> + 's

Lookup a dependency

pub fn insert_into_table(
    &mut self,
    table_path: &[String],
    dep: &Dependency
) -> CargoResult<()>

Add entry to a Cargo.toml.

pub fn update_table_entry(
    &mut self,
    table_path: &[String],
    dep: &Dependency,
    dry_run: bool
) -> CargoResult<()>

Update an entry in Cargo.toml.

pub fn update_table_named_entry(
    &mut self,
    table_path: &[String],
    dep_key: &str,
    dep: &Dependency,
    dry_run: bool
) -> CargoResult<()>

Update an entry with a specified name in Cargo.toml.

pub fn remove_from_table(&mut self, table: &str, name: &str) -> CargoResult<()>

Remove entry from a Cargo.toml.

Examples

  use cargo_edit::{Dependency, LocalManifest, Manifest};
  use toml_edit;

  let root = std::path::PathBuf::from("/").canonicalize().unwrap();
  let path = root.join("Cargo.toml");
  let mut manifest = LocalManifest { path, manifest: Manifest { data: toml_edit::Document::new() } };
  let dep = Dependency::new("cargo-edit").set_version("0.1.0");
  let _ = manifest.insert_into_table(&vec!["dependencies".to_owned()], &dep);
  assert!(manifest.remove_from_table("dependencies", &dep.name).is_ok());
  assert!(manifest.remove_from_table("dependencies", &dep.name).is_err());
  assert!(!manifest.data.contains_key("dependencies"));

pub fn add_deps(
    &mut self,
    table: &[String],
    deps: &[Dependency]
) -> CargoResult<()>

Add multiple dependencies to manifest

pub fn get_dependency_tables_mut<'r>(
    &'r mut self
) -> impl Iterator<Item = &mut dyn TableLike> + 'r

Allow mutating depedencies, wherever they live

pub fn set_package_version(&mut self, version: &Version)

Override the manifest’s version

pub fn gc_dep(&mut self, dep_key: &str)

Remove references to dep_key if its no longer present

Methods from Deref<Target = Manifest>

pub fn package_name(&self) -> CargoResult<&str>

Get the manifest’s package name

pub fn get_table<'a>(&'a self, table_path: &[String]) -> CargoResult<&'a Item>

Get the specified table from the manifest.

pub fn get_table_mut<'a>(
    &'a mut self,
    table_path: &[String]
) -> CargoResult<&'a mut Item>

Get the specified table from the manifest.

pub fn get_sections(&self) -> Vec<(Vec<String>, Item)>

Get all sections in the manifest that exist and might contain dependencies. The returned items are always Table or InlineTable.

pub fn features(&self) -> CargoResult<BTreeMap<String, Vec<String>>>

returns features exposed by this manifest

Trait Implementations

impl Debug for LocalManifest

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

Formats the value using the given formatter.

impl Deref for LocalManifest

type Target = Manifest

The resulting type after dereferencing.

fn deref(&self) -> &Manifest

Dereferences the value.

impl DerefMut for LocalManifest

fn deref_mut(&mut self) -> &mut Manifest

Mutably dereferences the value.