Module config

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

• ArchiveConfig
  Configuration for archives.
• ArchiveInclude
  Type for the archive-include key.
• CompiledDefaultFilter
  A compiled form of the default filter for a profile.
• ConfigIdentifier
  An identifier used in configuration.
• CustomTestGroup
  Represents a custom test group.
• EarlyProfile
  A nextest profile that can be obtained without identifying the host and target platforms.
• EvaluatableProfile
  A configuration profile for nextest. Contains most configuration used by the nextest runner.
• JunitConfig
  Global JUnit configuration stored within a profile.
• NextestConfig
  Overall configuration for nextest.
• NextestVersionConfig
  Nextest version configuration.
• SlowTimeout
  Type for the slow-timeout config key.
• TestGroupConfig
  Configuration for a test group.
• TestSettings
  Settings for individual tests.
• ToolConfigFile
  A tool-specific config file.
• VersionOnlyConfig
  A “version-only” form of the nextest configuration.

Enums

• ArchiveIncludeOnMissing
  What to do when an archive-include path is missing.
• CompiledDefaultFilterSection
  Within CompiledDefaultFilter, the part of the config that the default filter comes from.
• ConfigExperimental
  Experimental configuration features.
• MaxFail
  Type for the max-fail flag
• NextestVersionEval
  The result of checking whether a NextestVersionConfig satisfies a requirement.
• NextestVersionReq
  Specification for a nextest version. Part of NextestVersionConfig.
• RecursionDepth
  Recursion depth.
• RetryPolicy
  Type for the retry config key.
• TestGroup
  Represents the test group a test is in.
• TestThreads
  Type for the test-threads config key.
• ThreadsRequired
  Type for the threads-required config key.

Functions

• get_num_cpus
  Gets the number of available CPUs and caches the value.