Struct cargo_toml::Manifest

pub struct Manifest<Metadata = Value> {

    pub package: Option<Package<Metadata>>,
    pub workspace: Option<Workspace<Metadata>>,
    pub dependencies: DepsSet,
    pub dev_dependencies: DepsSet,
    pub build_dependencies: DepsSet,
    pub target: TargetDepsSet,
    pub features: FeatureSet,
    pub replace: DepsSet,
    pub patch: PatchSet,
    pub lib: Option<Product>,
    pub profile: Profiles,
    pub badges: Badges,
    pub bin: Vec<Product>,
    pub bench: Vec<Product>,
    pub test: Vec<Product>,
    pub example: Vec<Product>,
    pub lints: Option<Lints>,
}

The top-level Cargo.toml structure. This is the main type in this library.

The Metadata is a generic type for [package.metadata] table. You can replace it with your own struct type if you use the metadata and don’t want to use the catch-all Value type.

Fields

package: Option<Package<Metadata>>

Package definition (a cargo crate)

workspace: Option<Workspace<Metadata>>

Workspace-wide settings

dependencies: DepsSet

Normal dependencies

dev_dependencies: DepsSet

Dev/test-only deps

build_dependencies: DepsSet

Build-time deps

target: TargetDepsSet

[target.cfg.dependencies]

features: FeatureSet

The [features] section. This set may be incomplete!

Optional dependencies may create implied Cargo features. This features section also supports microsyntax with dep:, /, and ? for managing dependencies and their features.io

This crate has an optional features module for dealing with this complexity and getting the real list of features.

replace: DepsSet

👎Deprecated: Cargo recommends patch instead

Obsolete

patch: PatchSet

[patch.crates-io] section

lib: Option<Product>

Note that due to autolibs feature this is not the complete list unless you run Manifest::complete_from_path

profile: Profiles

Compilation/optimization settings

badges: Badges

[badges] section

bin: Vec<Product>

Note that due to autobins feature this is not the complete list unless you run Manifest::complete_from_path

bench: Vec<Product>

Benchmarks

test: Vec<Product>

Integration tests

example: Vec<Product>

Examples

lints: Option<Lints>

Lints

Implementations

impl Manifest<Value>

pub fn from_path(cargo_toml_path: impl AsRef<Path>) -> Result<Self, Error>

Parse contents from a Cargo.toml file on disk.

Calls Manifest::complete_from_path to discover implicit binaries, etc. It will search for a workspace.

pub fn from_slice(cargo_toml_content: &[u8]) -> Result<Self, Error>

Parse contents of a Cargo.toml file already loaded as a byte slice.

It does not call Manifest::complete_from_path, so may be missing implicit data, and panic if workspace inheritance is used.

pub fn from_str(cargo_toml_content: &str) -> Result<Self, Error>

Parse contents of a Cargo.toml file loaded as a string

Note: this is not a file name, but file’s TOML-syntax content. See from_path.

It does not call Manifest::complete_from_path, so may be missing implicit data, and panic if workspace inheritance is used.

impl<Metadata: for<'a> Deserialize<'a>> Manifest<Metadata>

pub fn from_slice_with_metadata( cargo_toml_content: &[u8] ) -> Result<Self, Error>

Parse Cargo.toml, and parse its [package.metadata] into a custom Serde-compatible type.

It does not call Manifest::complete_from_path, so may be missing implicit data.

pub fn from_path_with_metadata<P: AsRef<Path>>( cargo_toml_path: P ) -> Result<Self, Error>

Parse contents from Cargo.toml file on disk, with custom Serde-compatible metadata type.

Calls Manifest::complete_from_path

impl<Metadata> Manifest<Metadata>

pub fn complete_from_path(&mut self, path: &Path) -> Result<(), Error>

Cargo.toml doesn’t contain explicit information about [lib] and [[bin]], which are inferred based on files on disk.

This scans the disk to make the data in the manifest as complete as possible.

It supports workspace inheritance and will search for a root workspace. Use Manifest::complete_from_path_and_workspace to provide the workspace explicitly.

pub fn complete_from_path_and_workspace<PackageMetadataTypeDoesNotMatterHere>( &mut self, package_manifest_path: &Path, workspace_manifest_and_path: Option<(&Manifest<PackageMetadataTypeDoesNotMatterHere>, &Path)> ) -> Result<(), Error>

Manifest::complete_from_path, but allows passing workspace manifest explicitly.

workspace_manifest_and_path is the root workspace manifest already parsed, and the path is the path to the root workspace’s directory. If it’s None, the root workspace will be discovered automatically.

pub fn complete_from_abstract_filesystem<PackageMetadataTypeDoesNotMatterHere, Fs: AbstractFilesystem>( &mut self, fs: Fs, workspace_manifest_and_path: Option<(&Manifest<PackageMetadataTypeDoesNotMatterHere>, &Path)> ) -> Result<(), Error>

Cargo.toml doesn’t contain explicit information about [lib] and [[bin]], which are inferred based on files on disk.

You can provide any implementation of directory scan, which doesn’t have to be reading straight from disk (might scan a tarball or a git repo, for example).

If workspace_manifest_and_path is set, it will inherit from this workspace. If it’s None, it will try to find a workspace if needed.

pub fn needs_workspace_inheritance(&self) -> bool

If true, some fields are unavailable. If false, it’s fully usable as-is.

It is false in manifests that use workspace inheritance, but had their data completed from the root manifest already.

pub fn inherit_workspace<Ignored>( &mut self, workspace_manifest: &Manifest<Ignored>, workspace_base_path: &Path ) -> Result<(), Error>

👎Deprecated: this functionality has been merged into complete_from_path_and_workspace or complete_from_abstract_filesystem

Copy workspace-inheritable properties from the workspace_manifest.

workspace_base_path should be an absolute path to a directory where the workspace manifest is located. Used as a base for readme and license-file.

pub fn package(&self) -> &Package<Metadata>

Panics if it’s not a package (only a workspace).

You can access .package field directly to handle the Option.

Trait Implementations

impl<Metadata: Clone> Clone for Manifest<Metadata>

fn clone(&self) -> Manifest<Metadata>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Metadata: Debug> Debug for Manifest<Metadata>

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

Formats the value using the given formatter.

impl<Metadata: Default> Default for Manifest<Metadata>

fn default() -> Self

Returns the “default value” for a type.

impl<'de, Metadata> Deserialize<'de> for Manifest<Metadata>

where Metadata: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<Metadata: PartialEq> PartialEq for Manifest<Metadata>

fn eq(&self, other: &Manifest<Metadata>) -> bool

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<Metadata> Serialize for Manifest<Metadata>

where Metadata: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<Metadata> StructuralPartialEq for Manifest<Metadata>