nextest_runner/config/mod.rs
1// Copyright (c) The nextest Contributors
2// SPDX-License-Identifier: MIT OR Apache-2.0
3
4//! Configuration support for nextest.
5//!
6//! See the [nextest configuration reference](https://nexte.st/docs/configuration/reference/).
7//!
8//! ## Multi-pass parsing
9//!
10//! Nextest's configuration parsing happens in several passes, similar to a
11//! typical compiler.
12//!
13//! * The first pass verifies that the configuration looks fine and is done
14//! very early in the process. A successful first phase parse is represented by
15//! [`EarlyProfile`](core::EarlyProfile).
16//! * The second pass applies the host and target platforms to the configuration,
17//! resulting in an [`EvaluatableProfile`](core::EvaluatableProfile).
18//! * The final pass resolves actual per-test settings, via [`TestSettings`](overrides::TestSettings).
19//!
20//! Multi-pass parsing allows for profile parsing errors to be returned as early
21//! as possible -- before the host and target platforms are known. Returning
22//! errors early leads to a better user experience.
23
24pub mod core;
25pub mod elements;
26pub mod overrides;
27pub mod scripts;
28mod utils;