Table of Contents

Class TestAssemblyConfiguration

Namespace
Xunit.Runner.Common
Assembly
xunit.v3.runner.common.dll

Represents the configuration items set in the configuration file of a test assembly. Should be read with the ConfigReader class.

public class TestAssemblyConfiguration
Inheritance
TestAssemblyConfiguration
Inherited Members

Properties

AppDomain

Gets or sets a flag indicating whether an app domain should be used to discover and run tests.

public AppDomainSupport? AppDomain { get; set; }

Property Value

AppDomainSupport?

AppDomainOrDefault

Gets or sets a flag indicating whether an app domain should be used to discover and run tests. If the flag is not set, returns the default value (IfAvailable).

public AppDomainSupport AppDomainOrDefault { get; }

Property Value

AppDomainSupport

AssertEquivalentMaxDepth

Gets a value which indicates the maximum object depth to compare when using Assert.Equivalent.

public int? AssertEquivalentMaxDepth { get; set; }

Property Value

int?

Culture

Gets or sets the desired culture to run the tests under. Use null (default) to indicate that we should use the default OS culture; use an empty string to indicate that we should use the invariant culture; or use any culture value that is valid for calling CultureInfo(string).

public string? Culture { get; set; }

Property Value

string

DiagnosticMessages

Gets or sets a flag indicating that the end user wants diagnostic messages from the test framework.

public bool? DiagnosticMessages { get; set; }

Property Value

bool?

DiagnosticMessagesOrDefault

Gets a flag indicating that the end user wants diagnostic messages from the test framework. If the flag is not set, returns the default value (false).

public bool DiagnosticMessagesOrDefault { get; }

Property Value

bool

ExplicitOption

Gets or sets a flag indicating how explicit tests should be handled.

public ExplicitOption? ExplicitOption { get; set; }

Property Value

ExplicitOption?

ExplicitOptionOrDefault

Gets a flag indicating how explicit tests should be handled. If the flag isn't set, returns the default value (Off).

public ExplicitOption ExplicitOptionOrDefault { get; }

Property Value

ExplicitOption

FailSkips

Gets or sets a flag indicating that skipped tests should be converted into failed tests.

public bool? FailSkips { get; set; }

Property Value

bool?

FailSkipsOrDefault

Gets a flag indicating that skipped tests should be converted into failed tests. If the flag is not set, returns the default value (false).

public bool FailSkipsOrDefault { get; }

Property Value

bool

FailTestsWithWarnings

Gets or sets a flag indicating that passing tests with warnings should be converted into failed tests.

public bool? FailTestsWithWarnings { get; set; }

Property Value

bool?

FailTestsWithWarningsOrDefault

Gets or sets a flag indicating that passing tests with warnings should be converted into failed tests. If the flag is not set, returns the default value (false).

public bool FailTestsWithWarningsOrDefault { get; }

Property Value

bool

Filters

Gets the list of filters used during test discovery.

public XunitFilters Filters { get; }

Property Value

XunitFilters

IncludeSourceInformation

Gets or sets a flag indicating that discovery should include source information for the test cases.

public bool? IncludeSourceInformation { get; set; }

Property Value

bool?

IncludeSourceInformationOrDefault

Gets a flag indicating that discovery should include source information for the test cases. If the flag is not set, returns the default value (false).

public bool IncludeSourceInformationOrDefault { get; }

Property Value

bool

InternalDiagnosticMessages

Gets or sets a flag indicating that the end user wants internal diagnostic messages from the test framework.

public bool? InternalDiagnosticMessages { get; set; }

Property Value

bool?

InternalDiagnosticMessagesOrDefault

Gets a flag indicating that the end user wants internal diagnostic messages from the test framework. If the flag is not set, returns the default value (false).

public bool InternalDiagnosticMessagesOrDefault { get; }

Property Value

bool

LongRunningTestSeconds

Gets the number of seconds that a test can run before being considered "long running". Set to a positive value to enable the feature.

public int? LongRunningTestSeconds { get; set; }

Property Value

int?

LongRunningTestSecondsOrDefault

Gets the number of seconds that a test can run before being considered "long running". If the value is not set, returns the default value (-1).

public int LongRunningTestSecondsOrDefault { get; }

Property Value

int

MaxParallelThreads

Gets or sets the maximum number of thread to use when parallelizing this assembly. A value of null or 0 indicates that the default should be used (ProcessorCount); a value of -1 indicates that tests should run with an unlimited-sized thread pool.

public int? MaxParallelThreads { get; set; }

Property Value

int?

MaxParallelThreadsOrDefault

Gets the maximum number of thread to use when parallelizing this assembly. If the value is not set, returns the default value (ProcessorCount).

public int MaxParallelThreadsOrDefault { get; }

Property Value

int

MethodDisplay

Gets or sets the default display name for test methods.

public TestMethodDisplay? MethodDisplay { get; set; }

Property Value

TestMethodDisplay?

MethodDisplayOptions

Gets or sets the default display options for test methods.

public TestMethodDisplayOptions? MethodDisplayOptions { get; set; }

Property Value

TestMethodDisplayOptions?

MethodDisplayOptionsOrDefault

Gets the default display options for test methods. If the value is not set, returns the default value (None).

public TestMethodDisplayOptions MethodDisplayOptionsOrDefault { get; }

Property Value

TestMethodDisplayOptions

MethodDisplayOrDefault

Gets the default display name for test methods. If the value is not set, returns the default value (ClassAndMethod).

public TestMethodDisplay MethodDisplayOrDefault { get; }

Property Value

TestMethodDisplay

ParallelAlgorithm

Gets or sets the algorithm to be used for parallelization.

public ParallelAlgorithm? ParallelAlgorithm { get; set; }

Property Value

ParallelAlgorithm?

ParallelAlgorithmOrDefault

Gets or sets the algorithm to be used for parallelization.

public ParallelAlgorithm ParallelAlgorithmOrDefault { get; }

Property Value

ParallelAlgorithm

ParallelizeAssembly

Gets or sets a flag indicating that this assembly is safe to parallelize against other assemblies.

public bool? ParallelizeAssembly { get; set; }

Property Value

bool?

ParallelizeAssemblyOrDefault

Gets a flag indicating that this assembly is safe to parallelize against other assemblies. If the flag is not set, returns the default value (false).

public bool ParallelizeAssemblyOrDefault { get; }

Property Value

bool

ParallelizeTestCollections

Gets or sets a flag indicating that this test assembly wants to run test collections in parallel against one another.

public bool? ParallelizeTestCollections { get; set; }

Property Value

bool?

ParallelizeTestCollectionsOrDefault

Gets a flag indicating that this test assembly wants to run test collections in parallel against one another. If the flag is not set, returns the default value (true).

public bool ParallelizeTestCollectionsOrDefault { get; }

Property Value

bool

PreEnumerateTheories

Gets or sets a flag indicating whether theory data should be pre-enumerated during test discovery.

public bool? PreEnumerateTheories { get; set; }

Property Value

bool?

PrintMaxEnumerableLength

Gets a value indicating the maximum length for printing collections.

public int? PrintMaxEnumerableLength { get; set; }

Property Value

int?

PrintMaxObjectDepth

Gets a value indicating the maximum recursive depth when printing objects.

public int? PrintMaxObjectDepth { get; set; }

Property Value

int?

PrintMaxObjectMemberCount

Gets a value indicating the maximum members to show when printing objects.

public int? PrintMaxObjectMemberCount { get; set; }

Property Value

int?

PrintMaxStringLength

Gets a value indicating the maximum length for printing string values.

public int? PrintMaxStringLength { get; set; }

Property Value

int?

Seed

Gets or sets the seed value used for randomization. Only supported for v3 or later test assemblies.

public int? Seed { get; set; }

Property Value

int?

ShadowCopy

Gets or sets a flag indicating whether shadow copies should be used.

public bool? ShadowCopy { get; set; }

Property Value

bool?

ShadowCopyFolder

Gets or sets the folder to be used for shadow copy files. If the value is not set, the system defaults for shadow copying are used.

public string? ShadowCopyFolder { get; set; }

Property Value

string

ShadowCopyOrDefault

Gets a flag indicating whether shadow copies should be used. If the flag is not set, returns the default value (true).

public bool ShadowCopyOrDefault { get; }

Property Value

bool

ShowLiveOutput

Gets or sets a flag indicating whether output from ITestOutputHelper should be shown live as they're logged (in addition to being collected together after the test finishes).

public bool? ShowLiveOutput { get; set; }

Property Value

bool?

ShowLiveOutputOrDefault

Gets a flag indicating whether output from ITestOutputHelper should be shown live as they're logged (in addition to being collected together after the test finishes). If the flag is not set, returns the default value (false).

public bool ShowLiveOutputOrDefault { get; }

Property Value

bool

StopOnFail

Gets or sets a flag indicating whether testing should stop on a failure.

public bool? StopOnFail { get; set; }

Property Value

bool?

StopOnFailOrDefault

Gets a flag indicating whether testing should stop on a test failure. If the flag is not set, returns the default value (false).

public bool StopOnFailOrDefault { get; }

Property Value

bool

SynchronousMessageReporting

Gets or sets a flag indicating that synchronous message reporting is desired.

public bool? SynchronousMessageReporting { get; set; }

Property Value

bool?

SynchronousMessageReportingOrDefault

Gets a flag indicating that synchronous message reporting is desired. If the flag is not set, returns the default value (false).

public bool SynchronousMessageReportingOrDefault { get; }

Property Value

bool