Expand description
Configuration support for nextest.
§Multi-pass parsing
Nextest’s configuration parsing happens in several passes, similar to a typical compiler.
- The first pass verifies that the configuration looks fine and is done
very early in the process. A successful first phase parse is represented by
EarlyProfile. - The second pass applies the host and target platforms to the configuration,
resulting in an
EvaluatableProfile. - The final pass resolves actual per-test settings, via
TestSettings.
Multi-pass parsing allows for profile parsing errors to be returned as early as possible – before the host and target platforms are known. Returning errors early leads to a better user experience.
Structs§
- Archive
Config - Configuration for archives.
- Archive
Include - Type for the archive-include key.
- Compiled
Default Filter - A compiled form of the default filter for a profile.
- Config
Identifier - An identifier used in configuration.
- Custom
Test Group - Represents a custom test group.
- Early
Profile - A nextest profile that can be obtained without identifying the host and target platforms.
- Evaluatable
Profile - A configuration profile for nextest. Contains most configuration used by the nextest runner.
- Junit
Config - Global JUnit configuration stored within a profile.
- Leak
Timeout - Controls leak timeout behavior.
- Nextest
Config - Overall configuration for nextest.
- Nextest
Version Config - Nextest version configuration.
- Slow
Timeout - Type for the slow-timeout config key.
- Test
Group Config - Configuration for a test group.
- Test
Priority - A test priority: a number between -100 and 100.
- Test
Settings - Settings for individual tests.
- Tool
Config File - A tool-specific config file.
- Version
Only Config - A “version-only” form of the nextest configuration.
Enums§
- Archive
Include OnMissing - What to do when an archive-include path is missing.
- Compiled
Default Filter Section - Within
CompiledDefaultFilter, the part of the config that the default filter comes from. - Config
Experimental - Experimental configuration features.
- Leak
Timeout Result - The result of controlling leak timeout behavior.
- MaxFail
- Type for the max-fail flag and fail-fast configuration.
- Nextest
Version Eval - The result of checking whether a
NextestVersionConfigsatisfies a requirement. - Nextest
Version Req - Specification for a nextest version. Part of
NextestVersionConfig. - Recursion
Depth - Recursion depth.
- Retry
Policy - Type for the retry config key.
- Test
Group - Represents the test group a test is in.
- Test
Threads - Type for the test-threads config key.
- Threads
Required - Type for the threads-required config key.
Functions§
- get_
num_ cpus - Gets the number of available CPUs and caches the value.