Expand description
This crate contains deserializers for machine-readable output generated by cargo-nextest.
Implemented so far:
- ✅ Listing tests with
TestListSummary - ✅ Semantic exit codes with
NextestExitCode
§Examples
Get the list of tests in the repository:
// This example requires `cargo nextest` to be installed.
use nextest_metadata::ListCommand;
let command = ListCommand::new();
let test_list = command.exec().unwrap();
// The result is a TestListSummary.
println!("{:?}", test_list);§Minimum supported Rust version (MSRV)
The minimum supported Rust version is Rust 1.78.
While this crate is a pre-release (0.x.x) it may have its MSRV bumped in a patch release. Once a crate has reached 1.x, any MSRV bump will be accompanied with a new minor version.
§Minimum supported cargo-nextest version
The “minimum supported cargo-nextest version” is cargo-nextest 0.9.15.
For more about nextest-metadata’s stability policy, see the Stability page on the nextest site.
Structs§
- Binary
List Summary - A serializable suite of test binaries.
- Build
Platforms Summary - Serialized representation of the host and the target platform.
- Build
Script Info Summary - Extended build script information for a single package.
- Host
Platform Summary - Serialized representation of the host platform.
- List
Command - Command builder for
cargo nextest list. - Platform
Libdir Unavailable - The reason why a platform libdir is unavailable.
- Rust
Binary Id - A unique identifier for a test suite (a Rust binary).
- Rust
Binary IdComponents - The components of a
RustBinaryId. - Rust
Build Meta Summary - Rust metadata used for builds and test runs.
- Rust
NonTest Binary Kind - Information about the kind of a Rust non-test binary.
- Rust
NonTest Binary Summary - A non-test Rust binary. Used to set the correct environment variables in reused builds.
- Rust
Test Binary Kind - Information about the kind of a Rust test binary.
- Rust
Test Binary Summary - A serializable Rust test binary.
- Rust
Test Case Summary - Serializable information about an individual test case within a Rust test suite.
- Rust
Test Kind - The kind of Rust test something is.
- Rust
Test Suite Status Summary - Information about whether a test suite was listed or skipped.
- Rust
Test Suite Summary - A serializable suite of tests within a Rust test binary.
- Target
Platform Summary - Serialized representation of the target platform.
- Test
Case Name - The name of a test case within a binary.
- Test
List Summary - Root element for a serializable list of tests generated by nextest.
Enums§
- Build
Platform - The platform a binary was built on (useful for cross-compilation)
- Command
Error - An error that occurs while running a
cargo nextestcommand. - Filter
Match - An enum describing whether a test matches a filter.
- Mismatch
Reason - The reason for why a test doesn’t match a filter.
- Nextest
Exit Code - Documented exit codes for
cargo nextestfailures. - Platform
Libdir Summary - Serialized representation of a platform’s library directory.
- Rust
Binary IdName AndKind - The name and kind of a Rust binary, present within a
RustBinaryId.