nextest_runner/user_config/
mod.rs

1// Copyright (c) The nextest Contributors
2// SPDX-License-Identifier: MIT OR Apache-2.0
3
4//! User-specific configuration for nextest.
5//!
6//! User config stores per-user preferences that shouldn't be version-controlled,
7//! like UI preferences and default output settings. This is separate from the
8//! repository config (`.config/nextest.toml`) which controls test execution
9//! behavior.
10//!
11//! ## Config file location
12//!
13//! The user config file is searched for in the following locations:
14//!
15//! - **Unix/macOS**: `$XDG_CONFIG_HOME/nextest/config.toml` or
16//!   `~/.config/nextest/config.toml`
17//! - **Windows**: `%APPDATA%\nextest\config.toml`, with fallback to
18//!   `~/.config/nextest/config.toml` for dotfiles portability
19//!
20//! On Windows, both locations are checked in order, and the first existing
21//! config file is used. This allows users to share dotfiles across platforms.
22//!
23//! ## Configuration hierarchy
24//!
25//! Settings are resolved in the following order (highest priority first):
26//!
27//! 1. CLI arguments (e.g., `--show-progress=bar`)
28//! 2. Environment variables (e.g., `NEXTEST_SHOW_PROGRESS=bar`)
29//! 3. User overrides (first matching `[[overrides]]` for each setting)
30//! 4. User base config (`[ui]` section)
31//! 5. Built-in defaults
32
33mod discovery;
34mod early;
35pub mod elements;
36mod helpers;
37mod imp;
38
39pub use discovery::*;
40pub use early::*;
41pub use imp::*;
nextest_runner/user_config/mod.rs

nextest_runner/user_config/
mod.rs
