Struct cargo_edit_9::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_9::{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.