33 releases (17 breaking)

new 0.18.0 Jan 10, 2025
0.17.0 Nov 28, 2024
0.16.1 Nov 14, 2024
0.15.0 Jun 29, 2024
0.2.1 Nov 29, 2020

#50 in Parser implementations

Download history 18037/week @ 2024-09-22 19713/week @ 2024-09-29 20437/week @ 2024-10-06 24908/week @ 2024-10-13 22037/week @ 2024-10-20 24247/week @ 2024-10-27 25024/week @ 2024-11-03 23392/week @ 2024-11-10 24125/week @ 2024-11-17 25079/week @ 2024-11-24 25589/week @ 2024-12-01 25869/week @ 2024-12-08 23464/week @ 2024-12-15 8965/week @ 2024-12-22 8914/week @ 2024-12-29 18263/week @ 2025-01-05

60,506 downloads per month
Used in 150 crates (17 directly)

Apache-2.0 OR MIT

56KB
1K SLoC

cargo-manifest

serde definitions to read and write Cargo.toml files.

Description

This Rust crate contains various structs and enums to represent the contents of a Cargo.toml file. These definitions can be used with serde and the toml crate to read and write Cargo.toml manifest files.

This crate also to some degree supports post-processing of the data to emulate Cargo's workspace inheritance and autobins features. This is used for example by crates.io to extract whether a crate contains a library or executable binaries.

[!NOTE] The cargo team regularly adds new features to the Cargo.toml file definition. This crate aims to keep up-to-date with these changes. You should keep this crate up-to-date to correctly parse all fields in modern Cargo.toml files.

Installation

cargo add cargo-manifest

Usage

use cargo_manifest::Manifest;

let manifest = Manifest::from_path("Cargo.toml").unwrap();

see docs.rs for more information.

Users

Alternatives

This crate is a fork of the cargo_toml project. There are only some minor differences between these projects at this point, you will need to evaluate which one fits your needs better.

There is also cargo-util-schemas now, which is maintained by the cargo team themselves. This crate was extracted from the cargo codebase and is used inside the cargo binary itself. It is kept up-to-date with the latest changes to the Cargo.toml file format, but is currently lacking some of the post-processing features that cargo-manifest provides.

License

This project is licensed under either of

at your option.

Dependencies

~2.4–3MB
~64K SLoC