xunit.execution.desktop

This class represents utility methods needed to supplement the reflection capabilities provided by the CLR

Creates an instance of the test class for the given test case. Sends the and messages as appropriate.

The test The type of the test class The constructor arguments for the test class The message bus used to send the test messages The timer used to measure the time taken for construction The cancellation token source

Disposes the test class instance. Sends the and messages as appropriate.

The test The test class instance to be disposed The message bus used to send the test messages The timer used to measure the time taken for construction The cancellation token source

Gets methods in the target type that match the protection level of the supplied method

The type The method The reflection method informations that match

Gets all the custom attributes for the given assembly.

The assembly The type of the attribute The matching attributes that decorate the assembly

Gets all the custom attributes for the given attribute.

The attribute The type of the attribute to find The matching attributes that decorate the attribute

Gets all the custom attributes for the method that are of the given type.

The method The type of the attribute The matching attributes that decorate the method

Gets all the custom attributes for the given type.

The type The type of the attribute The matching attributes that decorate the type

Converts an into a , if possible (for example, this will not work when the test method is based on source code rather than binaries).

The method to convert The runtime method, if available; null, otherwise

Converts an into a , if possible (for example, this will not work when the test class is based on source code rather than binaries).

The type to convert The runtime type, if available, null, otherwise

Extension methods for reading and .

Gets a flag that determines whether diagnostic messages will be emitted.

Gets a flag that determines whether diagnostic messages will be emitted. If the flag is not present, returns the default value (false).

Gets a flag that determines the default display name format for test methods.

Gets a flag that determines the default display options to format test methods.

Gets a flag that determines the default display name format for test methods. If the flag is not present, returns the default value ().

Gets the options that determine the default display formatting options for test methods. If no options are not present, returns the default value ().

Gets a flag that determines whether theories are pre-enumerated. If they enabled, then the discovery system will return a test case for each row of test data; they are disabled, then the discovery system will return a single test case for the theory.

Gets a flag that determines whether theories are pre-enumerated. If enabled, then the discovery system will return a test case for each row of test data; if disabled, then the discovery system will return a single test case for the theory. If the flag is not present, returns the default value (true).

Gets a flag that determines whether xUnit.net should report test results synchronously.

Gets a flag that determines whether xUnit.net should report test results synchronously. If the flag is not set, returns the default value (false).

Gets a flag that determines whether diagnostic messages will be emitted.

Gets a flag that determines whether diagnostic messages will be emitted. If the flag is not present, returns the default value (false).

Gets the parallel algorithm to be used.

Gets the parallel algorithm to be used. If the flag is not present, return the default value ().

Gets a flag to disable parallelization.

Gets a flag to disable parallelization. If the flag is not present, returns the default value (false).

Gets the maximum number of threads to use when running tests in parallel.

Gets the maximum number of threads to use when running tests in parallel. If set to 0 (or not set), the value of is used; if set to a value less than 0, does not limit the number of threads.

Gets a flag which indicates if the developer wishes to see output from live while it's being reported (in addition to seeing it collected together when the test is finished).

Gets a flag which indicates if the developer wishes to see output from live while it's being reported (in addition to seeing it collected together when the test is finished). If the flag is not present, returns the default value (false).

Gets a flag to stop testing on test failure.

Gets a flag to stop testing on test failure. If the flag is not present, returns the default value (false).

Gets a flag that determines whether xUnit.net should report test results synchronously.

Gets a flag that determines whether xUnit.net should report test results synchronously. If the flag is not set, returns the default value (false).

This implementation of allows the developer to track the count of outstanding "async void" operations, and wait for them all to complete.

Initializes a new instance of the class.

The existing synchronization context (may be null).

Returns a task which is signaled when all outstanding operations are complete.

Default implementation of . Orders tests in an unpredictable but stable order, so that repeated test runs of the identical test assembly run tests in the same order.

Initializes a new instance of the class.

Message sink to report diagnostic messages to

Default implementation of . Orders tests in an unpredictable and unstable order, so that repeated test runs of the identical test assembly run test collections in a random order.

Tracks disposable objects, and disposes them in the reverse order they were added to the tracker.

Add an object to be disposed.

The object to be disposed.

Represents a caching factory for the types used for extensibility throughout the system.

Disposes the instances that are contained in the cache.

Gets an instance of the given type, casting it to , using the provided constructor arguments. There is a single instance of a given type that is cached and reused, so classes retrieved from this factory must be stateless and thread-safe.

The interface type. The message sink used to send diagnostic messages The implementation type. The constructor arguments. Since diagnostic message sinks are optional, the code first looks for a type that takes the given arguments plus the message sink, and only falls back to the message sink-less constructor if none was found. The instance of the type.

Gets a data discoverer.

The message sink used to send diagnostic messages The discoverer type

Gets a data discoverer, as specified in a reflected .

The message sink used to send diagnostic messages The data discoverer attribute The data discoverer, if the type is loadable; null, otherwise.

Gets a test case orderer.

The message sink used to send diagnostic messages The test case orderer type

Gets a test case orderer, as specified in a reflected .

The message sink used to send diagnostic messages The test case orderer attribute. The test case orderer, if the type is loadable; null, otherwise.

Gets a test collection orderer.

The message sink used to send diagnostic messages The test collection orderer type

Gets a test collection orderer, as specified in a reflected .

The message sink used to send diagnostic messages The test collection orderer attribute. The test collection orderer, if the type is loadable; null, otherwise.

Gets a test framework discoverer.

The message sink used to send diagnostic messages The test framework type discoverer type

Gets a test framework discoverer, as specified in a reflected .

The message sink used to send diagnostic messages The test framework discoverer attribute

Gets a trait discoverer.

The message sink used to send diagnostic messages The trait discoverer type

Gets a trait discoverer, as specified in a reflected .

The message sink used to send diagnostic messages The trait discoverer attribute. The trait discoverer, if the type is loadable; null, otherwise.

Gets an xUnit.net v2 test discoverer.

The message sink used to send diagnostic messages The test case discoverer type

Gets an xUnit.net v2 test collection factory.

The message sink used to send diagnostic messages The test collection factory type The test assembly under test

Gets an xUnit.net v2 test collection factory, as specified in a reflected .

The message sink used to send diagnostic messages The collection behavior attribute. The test assembly. The collection factory.

Implementation of that creates a single default test collection for the assembly, and places any tests classes without the into it.

Initializes a new instance of the class.

The assembly. The message sink used to send diagnostic messages

Implementation of which creates a new test collection for each test class that isn't decorated with .

Initializes a new instance of the class.

The assembly info. The message sink used to send diagnostic messages

Represents a formatter that formats the display name of a class and/or method into a more human readable form using additional options.

Initializes a new instance of the class.

The used by the formatter. The used by the formatter.

Formats the specified display name.

The display name to format. The formatted display name.

A simple implementation of that can be used to report an error rather than running a test.

Initializes a new instance of the class.

The message sink used to send diagnostic messages Default method display to use (when not customized). The test method. The error message to report for the test.

Initializes a new instance of the class.

The message sink used to send diagnostic messages Default method display to use (when not customized). Default method display options to use (when not customized). The test method. The error message to report for the test.

Gets the error message that will be display when the test is run.

Measures and aggregates execution time of one or more actions.

Returns the total time aggregated across all the actions.

Executes an action and aggregates its run time into the total.

The action to measure.

Executes an asynchronous action and aggregates its run time into the total.

The action to measure.

Aggregates a time span into the total time.

The time to add.

Implementation of that supports finding test cases on methods decorated with .

Initializes a new instance of the class.

The message sink used to send diagnostic messages

Gets the message sink used to report messages.

Creates a single for the given test method.

The discovery options to be used. The test method. The attribute that decorates the test method.

Discover test cases from a test method. By default, if the method is generic, or it contains arguments, returns a single ; otherwise, it returns the result of calling .

The discovery options to be used. The test method the test cases belong to. The fact attribute attached to the test method. Returns zero or more test cases represented by the test method.

An implementation of to support .

Initializes a new instance of the class.

The test case that the lambda represents. The message bus to report run status to. The exception aggregator used to run code and collect exceptions. The task cancellation token source, used to cancel the test run.

A base class that provides default behavior when running tests in an assembly. It groups the tests by test collection, and then runs the individual test collections.

The type of the test case used by the test framework. Must derive from .

Initializes a new instance of the class.

The assembly that contains the tests to be run. The test cases to be run. The message sink to report diagnostic messages to. The message sink to report run status to. The user's requested execution options.

Gets or sets the exception aggregator used to run code and collect exceptions.

Gets or sets the user's requested execution options.

Gets or sets the message sink to report diagnostic messages to.

Gets or sets the message sink to report run status to.

Gets or sets the assembly that contains the tests to be run.

Gets or sets the test case orderer that will be used to decide how to order the tests.

Gets or sets the test collection orderer that will be used to decide how to order the test collections.

Gets or sets the test cases to be run.

Override this to provide the display name for the test framework (f.e., "xUnit.net 2.0"). This value is placed into .

Override this to provide the environment information (f.e., "32-bit .NET 4.0"). This value is placed into .

This method is called just after is sent, but before any test collections are run. This method should NEVER throw; any exceptions should be placed into the .

This method is called just before is sent. This method should NEVER throw; any exceptions should be placed into the .

Creates the message bus to be used for test execution. By default, it inspects the options for the flag, and if present, creates a message bus that ensures all messages are delivered on the same thread.

The message bus.

Orders the test collections using the .

Test collections (and the associated test cases) in run order

Runs the tests in the test assembly.

Returns summary information about the tests that were run.

Runs the list of test collections. By default, groups the tests by collection and runs them synchronously.

The message bus to report run status to. The task cancellation token source, used to cancel the test run. Returns summary information about the tests that were run.

Override this method to run the tests in an individual test collection.

The message bus to report run status to. The test collection that is being run. The test cases to be run. The task cancellation token source, used to cancel the test run. Returns summary information about the tests that were run.

A base class that provides default behavior when running test cases.

The type of the test case used by the test framework. Must derive from .

Initializes a new instance of the class.

The test case to be run. The message bus to report run status to. The exception aggregator used to run code and collect exceptions. The task cancellation token source, used to cancel the test run.

Gets or sets the exception aggregator used to run code and collect exceptions.

Gets or sets the task cancellation token source, used to cancel the test run.

Gets or sets the message bus to report run status to.

Gets or sets the test case to be run.

This method is called just after is sent, but before any test collections are run. This method should NEVER throw; any exceptions should be placed into the .

This method is called just before is sent. This method should NEVER throw; any exceptions should be placed into the .

Runs the tests in the test case.

Returns summary information about the tests that were run.

Override this method to run the tests in an individual test method.

Returns summary information about the tests that were run.

A base class that provides default behavior when running tests in a test class. It groups the tests by test method, and then runs the individual test methods.

The type of the test case used by the test framework. Must derive from .

Initializes a new instance of the class.

The test class to be run. The test class that contains the tests to be run. The test cases to be run. The message sink used to send diagnostic messages The message bus to report run status to. The test case orderer that will be used to decide how to order the test. The exception aggregator used to run code and collect exceptions. The task cancellation token source, used to cancel the test run.

Gets or sets the exception aggregator used to run code and collect exceptions.

Gets or sets the task cancellation token source, used to cancel the test run.

Gets or sets the CLR class that contains the tests to be run.

Gets the message sink used to send diagnostic messages.

Gets or sets the message bus to report run status to.

Gets or sets the test case orderer that will be used to decide how to order the test.

Gets or sets the test cases to be run.

Gets or sets the test class to be run.

Creates the arguments for the test class constructor. Attempts to resolve each parameter individually, and adds an error when the constructor arguments cannot all be provided. If the class is static, does not look for constructor, since one will not be needed.

The test class constructor arguments.

Gets the message to be used when the constructor is missing arguments.

This method is called just after is sent, but before any test methods are run. This method should NEVER throw; any exceptions should be placed into the .

This method is called just before is sent. This method should NEVER throw; any exceptions should be placed into the .

Runs the tests in the test class.

Returns summary information about the tests that were run.

Runs the list of test methods. By default, orders the tests, groups them by method and runs them synchronously.

Returns summary information about the tests that were run.

Override this method to run the tests in an individual test method.

The test method that contains the test cases. The CLR method that contains the tests to be run. The test cases to be run. The constructor arguments that will be used to create the test class. Returns summary information about the tests that were run.

Selects the constructor to be used for the test class. By default, chooses the parameterless constructor. Override to change the constructor selection logic.

The constructor to be used for creating the test class.

Tries to supply a test class constructor argument. By default, always fails. Override to change the argument lookup logic.

The constructor that will be used to create the test class. The parameter index. The parameter information. The argument value that should be used for the parameter. Returns true if the argument was supplied; false, otherwise.

A base class that provides default behavior when running tests in a test collection. It groups the tests by test class, and then runs the individual test classes.

The type of the test case used by the test framework. Must derive from .

Initializes a new instance of the class.

The test collection that contains the tests to be run. The test cases to be run. The message bus to report run status to. The test case orderer that will be used to decide how to order the test. The exception aggregator used to run code and collect exceptions. The task cancellation token source, used to cancel the test run.

Gets or sets the exception aggregator used to run code and collect exceptions.

Gets or sets the task cancellation token source, used to cancel the test run.

Gets or sets the message bus to report run status to.

Gets or sets the test case orderer that will be used to decide how to order the test.

Gets or sets the test cases to be run.

Gets or sets the test collection that contains the tests to be run.

This method is called just after is sent, but before any test classes are run. This method should NEVER throw; any exceptions should be placed into the .

This method is called just before is sent. This method should NEVER throw; any exceptions should be placed into the .

Runs the tests in the test collection.

Returns summary information about the tests that were run.

Runs the list of test classes. By default, groups the tests by class and runs them synchronously.

Returns summary information about the tests that were run.

Override this method to run the tests in an individual test class.

The test class to be run. The CLR class that contains the tests to be run. The test cases to be run. Returns summary information about the tests that were run.

A base class that provides default behavior to invoke a test method. This includes support for async test methods (both "async Task" and "async void") as well as creation and disposal of the test class.

The type of the test case used by the test framework. Must derive from .

Initializes a new instance of the class.

The test that this invocation belongs to. The message bus to report run status to. The test class that the test method belongs to. The arguments to be passed to the test class constructor. The test method that will be invoked. The arguments to be passed to the test method. The exception aggregator used to run code and collect exceptions. The task cancellation token source, used to cancel the test run.

Gets or sets the exception aggregator used to run code and collect exceptions.

Gets or sets the task cancellation token source, used to cancel the test run.

Gets or sets the constructor arguments used to construct the test class.

Gets the display name of the invoked test.

Gets or sets the message bus to report run status to.

Gets or sets the test to be run.

Gets the test case to be run.

Gets or sets the runtime type of the class that contains the test method.

Gets or sets the runtime method of the method that contains the test.

Gets or sets the arguments to pass to the test method when it's being invoked.

Gets or sets the object which measures execution time.

Creates the test class, unless the test method is static or there have already been errors. Note that this method times the creation of the test class (using ). It is also responsible for sending the and messages, so if you override this method without calling the base, you are responsible for all of this behavior. This method should NEVER throw; any exceptions should be placed into the .

The class instance, if appropriate; null, otherwise

This method is called just after the test method has finished executing. This method should NEVER throw; any exceptions should be placed into the .

This method is called just before the test method is invoked. This method should NEVER throw; any exceptions should be placed into the .

This method calls the test method via reflection. This is an available override point if you need to do some other form of invocation of the actual test method.

The instance of the test class The return value from the test method invocation

Creates the test class (if necessary), and invokes the test method.

Returns the time (in seconds) spent creating the test class, running the test, and disposing of the test class.

Invokes the test method on the given test class instance. This method sets up support for "async void" test methods, ensures that the test method has the correct number of arguments, then calls to do the actual method invocation. It ensure that any async test method is fully completed before returning, and returns the measured clock time that the invocation took.

The test class instance Returns the time taken to invoke the test method

A base class that provides default behavior when running tests in a test method.

The type of the test case used by the test framework. Must derive from .

Initializes a new instance of the class.

The test method under test. The CLR class that contains the test method. The CLR method that contains the tests to be run. The test cases to be run. The message bus to report run status to. The exception aggregator used to run code and collect exceptions. The task cancellation token source, used to cancel the test run.

Gets or sets the exception aggregator used to run code and collect exceptions.

Gets or sets the task cancellation token source, used to cancel the test run.

Gets or sets the CLR class that contains the test method.

Gets or sets the message bus to report run status to.

Gets or sets the CLR method that contains the tests to be run.

Gets or sets the test cases to be run.

Gets or sets the test method that contains the test cases.

This method is called just after is sent, but before any test cases are run. This method should NEVER throw; any exceptions should be placed into the .

This method is called just before is sent. This method should NEVER throw; any exceptions should be placed into the .

Runs the tests in the test method.

Returns summary information about the tests that were run.

Runs the list of test cases. By default, it runs the cases in order, synchronously.

Returns summary information about the tests that were run.

Override this method to run an individual test case.

The test case to be run. Returns summary information about the test case run.

A base class that provides default behavior when running a test. This includes support for skipping tests.

The type of the test case used by the test framework. Must derive from .

Initializes a new instance of the class.

The test that this invocation belongs to. The message bus to report run status to. The test class that the test method belongs to. The arguments to be passed to the test class constructor. The test method that will be invoked. The arguments to be passed to the test method. The skip reason, if the test is to be skipped. The exception aggregator used to run code and collect exceptions. The task cancellation token source, used to cancel the test run.

Gets or sets the exception aggregator used to run code and collect exceptions.

Gets or sets the task cancellation token source, used to cancel the test run.

Gets or sets the constructor arguments used to construct the test class.

Gets or sets the display name of the invoked test.

Gets or sets the message bus to report run status to.

Gets or sets the skip reason for the test, if set.

Gets or sets the test to be run.

Gets the test case to be run.

Gets or sets the runtime type of the class that contains the test method.

Gets or sets the runtime method of the method that contains the test.

Gets or sets the arguments to pass to the test method when it's being invoked.

This method is called just after is sent, but before the test class is created. This method should NEVER throw; any exceptions should be placed into the .

This method is called just before is sent. This method should NEVER throw; any exceptions should be placed into the .

Runs the test.

Returns summary information about the test that was run.

Override this method to invoke the test.

The exception aggregator used to run code and collect exceptions. Returns a tuple which includes the execution time (in seconds) spent running the test method, and any output that was returned by the test.

The test assembly runner for xUnit.net v2 tests.

Initializes a new instance of the class.

Gets the synchronization context used when potentially running tests in parallel. If is greater than 0, it creates and uses an instance of .

The maximum number of parallel threads.

Ensures the assembly runner is initialized (sets up the collection behavior, parallelization options, and test orderers from their assembly attributes).

The test case runner for xUnit.net v2 tests.

Initializes a new instance of the class.

The test case to be run. The display name of the test case. The skip reason, if the test is to be skipped. The arguments to be passed to the test class constructor. The arguments to be passed to the test method. The message bus to report run status to. The exception aggregator used to run code and collect exceptions. The task cancellation token source, used to cancel the test run.

Gets the list of s that will be used for this test case.

Gets or sets the arguments passed to the test class constructor

Gets or sets the display name of the test case

Gets or sets the skip reason for the test, if set.

Gets or sets the runtime type for the test class that the test method belongs to.

Gets of sets the runtime method for the test method that the test case belongs to.

Gets or sets the arguments to pass to the test method when it's being invoked.

Creates the instance for the given test case.

Creates the test runner used to run the given test.

Gets the list of attributes that apply to this test case.

The test class runner for xUnit.net v2 tests.

Initializes a new instance of the class.

Gets the fixture mappings that were created during .

Gets the already initialized async fixtures .

Creates the instance of a class fixture type to be used by the test class. If the fixture can be created, it should be placed into the dictionary; if it cannot, then the method should record the error by calling Aggregator.Add.

The type of the fixture to be created

The test collection runner for xUnit.net v2 tests.

Initializes a new instance of the class.

The test collection that contains the tests to be run. The test cases to be run. The message sink used to send diagnostic messages The message bus to report run status to. The test case orderer that will be used to decide how to order the test. The exception aggregator used to run code and collect exceptions. The task cancellation token source, used to cancel the test run.

Gets the fixture mappings that were created during .

Gets the message sink used to send diagnostic messages.

Creates the instance of a collection fixture type to be used by the test collection. If the fixture can be created, it should be placed into the dictionary; if it cannot, then the method should record the error by calling Aggregator.Add.

The type of the fixture to be created

Gives an opportunity to override test case orderer. By default, this method gets the orderer from the collection definition. If this function returns null, the test case orderer passed into the constructor will be used.

The test invoker for xUnit.net v2 tests.

Initializes a new instance of the class.

The test that this invocation belongs to. The message bus to report run status to. The test class that the test method belongs to. The arguments to be passed to the test class constructor. The test method that will be invoked. The arguments to be passed to the test method. The list of s for this test invocation. The exception aggregator used to run code and collect exceptions. The task cancellation token source, used to cancel the test run.

Gets the list of s for this test invocation.

The test method runner for xUnit.net v2 tests.

Initializes a new instance of the class.

The test method to be run. The test class that contains the test method. The test method that contains the tests to be run. The test cases to be run. The message sink used to send diagnostic messages to. The message bus to report run status to. The exception aggregator used to run code and collect exceptions. The task cancellation token source, used to cancel the test run. The constructor arguments for the test class.

The test runner for xUnit.net v2 tests.

Initializes a new instance of the class.

The test that this invocation belongs to. The message bus to report run status to. The test class that the test method belongs to. The arguments to be passed to the test class constructor. The test method that will be invoked. The arguments to be passed to the test method. The skip reason, if the test is to be skipped. The list of s for this test. The exception aggregator used to run code and collect exceptions. The task cancellation token source, used to cancel the test run.

Gets the list of s for this test.

Override this method to invoke the test method.

The exception aggregator used to run code and collect exceptions. Returns the execution time (in seconds) spent running the test method.

The test case runner for xUnit.net v2 theories (which could not be pre-enumerated; pre-enumerated test cases use ).

Initializes a new instance of the class.

The test case to be run. The display name of the test case. The skip reason, if the test is to be skipped. The arguments to be passed to the test class constructor. The message sink used to send diagnostic messages The message bus to report run status to. The exception aggregator used to run code and collect exceptions. The task cancellation token source, used to cancel the test run.

Gets the message sink used to report messages.

The default implementation of .

Initializes a new instance of the class.

The test assembly. The optional configuration filename (defaults to the configuration file of the current app domain if not provided) The version number of the assembly (defaults to "0.0.0.0")

Gets or sets the assembly version.

The default implementation of .

Initializes a new instance of the class.

The test collection the class belongs to The test class

An implementation of for . Compares the fully qualified names of the types.

The singleton instance of the comparer.

The default implementation of .

Initializes a new instance of the class.

The test assembly the collection belongs to The optional type which contains the collection definition The display name for the test collection

Initializes a new instance of the class.

The test assembly the collection belongs to The optional type which contains the collection definition The display name for the test collection The test collection's unique ID

An implementation of for . Compares the IDs of the test collections.

The singleton instance of the comparer.

A helper class that gets the list of test collection definitions for a given assembly. Reports any misconfigurations of the test assembly via the diagnostic message sink.

Gets the test collection definitions for the given assembly.

The assembly. The message sink used to send diagnostic messages A list of mappings from test collection name to test collection definitions (as

A default implementation of that tracks objects to be disposed when the framework is disposed. The discoverer and executor are automatically tracked for disposal, since those interfaces mandate an implementation of .

Initializes a new instance of the class.

The message sink used to send diagnostic messages

Gets the message sink used to send diagnostic messages.

Gets the disposal tracker for the test framework.

Override this method to provide the implementation of .

The assembly that is being discovered. Returns the test framework discoverer.

Override this method to provide the implementation of .

The assembly that is being executed. Returns the test framework executor.

A base implementation of that supports test filtering and runs the discovery process on a thread pool thread.

Initializes a new instance of the class.

The test assembly. The source information provider. The message sink used to send diagnostic messages

Gets the assembly that's being discovered.

Gets the message sink used to report diagnostic messages.

Gets the disposal tracker for the test framework discoverer.

Get the source code information provider used during discovery.

Implement this method to create a test class for the given CLR type.

The CLR type. The test class.

Core implementation to discover unit tests in a given test class.

The test class. Set to true to attempt to include source information. The message sink to send discovery messages to. The options used by the test framework during discovery. Returns true if discovery should continue; false otherwise.

Determines if a type should be used for discovery. Can be used to filter out types that are not desirable. The default implementation filters out abstract (non-static) classes.

The type. Returns true if the type can contain tests; false, otherwise.

Reports a discovered test case to the message bus, after updating the source code information (if desired).

A reusable implementation of which contains the basic behavior for running tests.

The type of the test case used by the test framework. Must derive from .

Initializes a new instance of the class.

Name of the test assembly. The source line number information provider. The message sink to report diagnostic messages to.

Gets the assembly information of the assembly under test.

Gets the message sink to send diagnostic messages to.

Gets the disposal tracker for the test framework discoverer.

Gets the source information provider.

Override to create a test framework discoverer that can be used to discover tests when the user asks to run all test.

The test framework discoverer

Override to run test cases.

The test cases to be run. The message sink to report run status to. The user's requested execution options.

This class proxies for the real implementation of , based on whether the user has overridden the choice via . If no attribute is found, defaults to .

Initializes a new instance of the class.

The test assembly (expected to implement ). The source information provider (expected to implement ). The diagnostic message sink (expected to implement ).

Gets the test framework that's being wrapped by the proxy.

INTERNAL CLASS. DO NOT USE.

The default implementation of .

Initializes a new instance of the class.

The test class The test method

An implementation of for . Compares the names of the methods.

The singleton instance of the comparer.

A base class implementation of which is based on test cases being related directly to test methods.

Used for de-serialization.

Initializes a new instance of the class.

Default method display to use (when not customized). The test method this test case belongs to. The arguments for the test method.

Initializes a new instance of the class.

Default method display to use (when not customized). Default method display options to use (when not customized). The test method this test case belongs to. The arguments for the test method.

Returns the base display name for a test ("TestClassName.MethodName").

Returns the default method display to use (when not customized).

Returns the default method display options to use (when not customized).

Gets or sets the exception that happened during initialization. When this is set, then the test execution should fail with this exception.

Gets the generic types that were used to close the generic test method, if applicable; null, if the test method was not an open generic.

Call to ensure the object is fully initialized().

Gets the unique ID for the test case.

Converts an array of bytes to its hexadecimal value as a string.

The bytes. A string containing the hexadecimal representation of the provided bytes.

Gets a hexadecimal digit character from the 4-bit value.

A value in the range [0, 15]. A character in the range ['0','9'] or ['a','f'].

Called when initializing the test cases, either after constructor or de-serialization. Override this method to add additional initialization-time work.

Default implementation of .

Gets the output provided by the test.

Initialize the test output helper with information about a test.

Resets the test output helper to its uninitialized state.

Thrown if a test exceeds the specified timeout.

Initializes a new instance of the class, returning a message indicating that the test method isn't compatible with timeout functionality.

Initializes a new instance of the class, returning a message indicating that the test method timed out.

The timeout that was exceeded, in milliseconds

Implementation of that supports finding test cases on methods decorated with .

Initializes a new instance of the class.

The message sink used to send diagnostic messages

Gets the message sink to be used to send diagnostic messages.

Creates test cases for a single row of data. By default, returns a single instance of with the data row inside of it.

The discovery options to be used. The test method the test cases belong to. The theory attribute attached to the test method. The row of data for this test case. The test cases

Creates test cases for a skipped theory. By default, returns a single instance of (which inherently discovers the skip reason via the fact attribute).

The discovery options to be used. The test method the test cases belong to. The theory attribute attached to the test method. The skip reason that decorates . The test cases

Creates test cases for the entire theory. This is used when one or more of the theory data items are not serializable, or if the user has requested to skip theory pre-enumeration. By default, returns a single instance of , which performs the data discovery at runtime.

The discovery options to be used. The test method the test cases belong to. The theory attribute attached to the test method. The test case

Creates test cases for a single row of skipped data. By default, returns a single instance of with the data row inside of it.

If this method is overridden, the implementation will have to override otherwise the default behavior will look at the and the test case will not be skipped. The discovery options to be used. The test method the test cases belong to. The theory attribute attached to the test method. The row of data for this test case. The reason this test case is to be skipped The test cases

Discover test cases from a test method.

This method performs the following steps: - If the theory attribute is marked with Skip, returns the single test case from ; - If pre-enumeration is off, or any of the test data is non serializable, returns the single test case from ; - If there is no theory data, returns a single test case of with the error in it; - Otherwise, it returns one test case per data row, created by calling or if the data attribute has a skip reason. The discovery options to be used. The test method the test cases belong to. The theory attribute attached to the test method. Returns zero or more test cases represented by the test method.

Represents a test case that had a valid data row, but the data row was generated by a data attribute with the skip property set.

This class is only ever used if the discoverer is pre-enumerating theories and the data row is serializable.

Initializes a new instance of the class.

The message sink used to send diagnostic messages Default method display to use (when not customized). The test method this test case belongs to. The reason that this test case will be skipped The arguments for the test method.

Initializes a new instance of the class.

An implementation of for xUnit v2.

Initializes a new instance of the class.

The test case this test belongs to. The display name for this test.

Gets the xUnit v2 test case.

Default implementation of for xUnit v2 that supports tests decorated with both and .

Initializes a new instance of the class.

The message sink used to send diagnostic messages Default method display to use (when not customized). The test method this test case belongs to. The arguments for the test method.

Initializes a new instance of the class.

Gets the message sink used to report messages.

Gets the display name for the test case. Calls with the given base display name (which is itself either derived from , falling back to .

The fact attribute the decorated the test case. The base display name from . The display name for the test case.

Gets the skip reason for the test case. By default, pulls the skip reason from the property.

The fact attribute the decorated the test case. The skip reason, if skipped; null, otherwise.

Gets the timeout for the test case. By default, pulls the skip reason from the property.

The fact attribute the decorated the test case. The timeout in milliseconds, if set; 0, if unset.

The implementation of that supports discovery and execution of unit tests linked against xunit.core.dll, using xunit.execution.dll.

Initializes a new instance of the class.

The message sink used to send diagnostic messages

The implementation of that supports discovery of unit tests linked against xunit.core.dll, using xunit.execution.dll.

Gets the display name of the xUnit.net v2 test framework.

Initializes a new instance of the class.

The test assembly. The source information provider. The message sink used to send diagnostic messages The test collection factory used to look up test collections.

Gets the mapping dictionary of fact attribute type to discoverer type.

Gets the test collection factory that makes test collections.

Finds the tests on a test method.

The test method. Set to true to indicate that source information should be included. The message bus to report discovery messages to. The options used by the test framework during discovery. Return true to continue test discovery, false, otherwise.

Gets the test case discover instance for the given discoverer type. The instances are cached and reused, since they should not be stateful.

The discoverer type. Returns the test case discoverer instance.

The implementation of that supports execution of unit tests linked against xunit.core.dll, using xunit.execution.dll.

Initializes a new instance of the class.

Name of the test assembly. The source line number information provider. The message sink to report diagnostic messages to.

Gets the test assembly that contains the test.

Represents a test case which runs multiple tests for theory data, either because the data was not enumerable or because the data was not serializable.

Initializes a new instance of the class.

The message sink used to send diagnostic messages Default method display to use (when not customized). The method under test.

Initializes a new instance of the class.

The message sink used to send diagnostic messages Default method display to use (when not customized). Default method display options to use (when not customized). The method under test.

An implementation of which runs work on custom threads rather than in the thread pool, and limits the number of in-flight actions.

Initializes a new instance of the class.

The maximum number of tasks to run at any one time.

Gets a flag indicating whether maximum concurrency is supported.

This is an internal class, and is not intended to be called from end-user code.

Implementation of that delegates to another implementation of while calling into a callback for each message.

Initializes a new instance of the class.

The message bus to delegate to. The callback to send messages to.

Implementation of that delegates to another implementation of while calling into a callback for each message. In addition, it issues a event when a message of the type is seen.

The type of the T final message.

Initializes a new instance of the class.

The message bus to delegate to. The callback to send messages to.

The final message that was seen that caused to be triggered.

An event that is triggered when a message of type is seen.

Implementation of that delegates to another implementation of while calling into a callback for each message.

Initializes a new instance of the class.

The inner message sink. The callback.

Implementation of that delegates to another implementation of while calling into a callback for each message. In addition, it issues a event when a message of the type is seen.

The type of the T final message.

Initializes a new instance of the class.

The inner message sink. The callback.

The final message that was seen that caused to be triggered.

An event that is triggered when a message of type is seen.

Reflection-based implementation of .

Initializes a new instance of the class.

The assembly to be wrapped.

Initializes a new instance of the class.

The assembly to be wrapped.

Reflection-based implementation of .

Initializes a new instance of the class.

The attribute to be wrapped.

Reflection-based implementation of .

Initializes a new instance of the class.

The method to be wrapped.

Reflection-based implementation of .

Initializes a new instance of the class.

The parameter to be wrapped.

Reflection-based implementation of .

Initializes a new instance of the class.

The type to wrap.

Wrapper to implement types from xunit.abstractions.dll using reflection.

Converts arguments into their target types. Can be particularly useful when pulling attribute constructor arguments, whose types may not strictly match the parameter types.

The arguments to be converted. The target types for the conversion. The converted arguments.

Converts an into an .

The assembly to wrap. The wrapper

Converts an into an using reflection.

The attribute to wrap. The wrapper

Converts a into an using reflection.

The method to wrap The wrapper

Converts a into an using reflection.

THe parameter to wrap The wrapper

Converts a into an using reflection.

The type to wrap The wrapper

This is an internal class, and is not intended to be called from end-user code.

INTERNAL CLASS. DO NOT USE.

Represents an exception that happened during the process of a test class. This typically means there were problems identifying the correct test class constructor, or problems creating the fixture data for the test class.

Initializes a new instance of the class.

The exception message.

Initializes a new instance of the class.

The exception message. The inner exception.

The implementation of that supports attributes of type .

A helper class to retrieve the traits from a method.

Get the traits from a method.

The member (method, field, etc.) to get the traits for. A list of traits that are defined on the method.

Extension methods for .

Converts a type into a name string.

The type to convert. Name string of type.

Resolves argument values for the test method, including support for optional method arguments.

The test method to resolve. The user-supplied method arguments. The argument values

Formulates the extended portion of the display name for a test method. For tests with no arguments, this will return just the base name; for tests with arguments, attempts to format the arguments and appends the argument list to the test name.

The test method The base part of the display name The test method arguments The test method's generic types The full display name for the test method

Resolves an individual generic type given an intended generic parameter type and the type of an object passed to that type.

The generic type, e.g. T, to resolve. The non-generic or open generic type, e.g. T, to try to match with the type of the object passed to that type. The non-generic or closed generic type, e.g. string, used to resolve the method parameter. The resolved type, e.g. the parameters (T, T, string, typeof(object)) -> (T, T, string, typeof(string)). True if resolving was successful, else false.

Gets the ElementType of a type, only if it is an array.

The type to get the ElementType of. If type is an array, the ElementType of the type, else the original type.

Gets the underlying ElementType of a type, if the ITypeInfo supports reflection.

The type to get the ElementType of. A flag indicating whether the type is an array. If type has an element type, underlying ElementType of a type, else the original type.

Resolves an individual generic type given an intended generic parameter type and the type of an object passed to that type.

The generic type, e.g. T, to resolve. The non-generic or closed generic type, e.g. string, used to resolve the method parameter. The generic arguments of the open generic type to match with the passed parameter. The resolved type. True if resolving was successful, else false.

Resolves a generic type for a test method. The test parameters (and associated parameter infos) are used to determine the best matching generic type for the test method that can be satisfied by all the generic parameters and their values.

The generic type to be resolved The parameter values being passed to the test method The parameter infos for the test method The best matching generic type

Resolves all the generic types for a test method. The test parameters are used to determine the best matching generic types for the test method that can be satisfied by all the generic parameters and their values.

The test method The parameter values being passed to the test method The best matching generic types base implementation of MD4 family style digest as outlined in "Handbook of Applied Cryptography", pages 344 - 347.

implementation of SHA-1 as outlined in "Handbook of Applied Cryptography", pages 346 - 349. It is interesting to ponder why the, apart from the extra IV, the other difference here from MD5 is the "endianness" of the word processing!

Copy constructor. This will copy the state of the provided message digest.

reset the chaining variables

Utility classes for dealing with Exception objects.

Combines multiple levels of messages into a single message.

The failure information from which to get the messages. The combined string.

Combines multiple levels of stack traces into a single stack trace.

The failure information from which to get the stack traces. The combined string.

Unwraps exceptions and their inner exceptions.

The exception to be converted. The failure information.

An implementation of and that ignores all messages.

Indicates the parallelization algorithm to use.

The conservative parallelization algorithm uses a semaphore to limit the number of started tests to be equal to the desired parallel thread count. This has the effect of allowing tests that have started to finish faster, since there are no extra tests competing for a chance to run, at the expense that CPU utilization will be lowered if the test project spaws a lot of async tests that have significant wait times.

The aggressive parallelization algorithm uses a synchronization context to limit the number of running tests to be equal to the desired parallel thread count. This has the effect of being able to use the CPU more effectively since there are typically most tests capable of running than there are CPU cores, at the expense of tests that have already started being put into the back of a long queue before they can run again.

Serializes and de-serializes objects. Serialization of objects is typically limited to supporting the VSTest-based test runners (Visual Studio Test Explorer, Visual Studio Code, dotnet test, etc.). Serializing values with this is not guaranteed to be cross-compatible and should not be used for anything durable.

De-serializes an object.

The type of the object The object's serialized value The de-serialized object

Converts an assembly qualified type name into a object.

The assembly qualified type name. The instance of the , if available; null, otherwise.

Converts an assembly name + type name into a object.

The assembly name. The type name. The instance of the , if available; null, otherwise.

Gets an assembly qualified type name for serialization, with special handling for types which live in assembly decorated by .

Determines whether the given is serializable with .

The object to test for serializability. Returns true if the object can be serialized; false, otherwise.

Serializes an object.

The value to serialize The serialized value

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of and .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

The message to send

Initializes a new instance of the class.

The format of the message to send The arguments used to format the message

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Default implementation of .

Initializes a new instance of the class.

Gets the default comparer to be used for the provided when a custom one has not been provided. Creates an instance of wrapped by .

The type to be compared

Gets the default comparer to be used as an inner comparer for the provided when a custom one has not been provided. For non-collections, this defaults to an -based comparer; for collections, this creates an inner comparer based on the item type in the collection.

The type to create an inner comparer for

This exception is thrown when an operation failure has occured during equality comparison operations. This generally indicates that a necessary pre-condition was not met for comparison operations to succeed.

Gets an exception that indicates that GetHashCode was called on which usually indicates that an item comparison function was used to try to compare two hash sets.

Default implementation of used by the xUnit.net equality assertions (except for collections, which are handled directly by the appropriate assertion methods).

The type that is being compared.

Initializes a new instance of the class.

The inner comparer to be used when the compared objects are enumerable.

A class that wraps to add .

The type that is being compared.

Initializes a new instance of the class.

The comparer that is being adapted.

Gets the substitution token used as assembly name suffix to indicate that the assembly is a generalized reference to the platform-specific assembly.

Base class for all long-lived objects that may cross over an AppDomain.

Creates a new instance of the type.

Disconnects all remote objects.

A mirror class of the CLR's class.

Initializes a new instance of the class.

The data to copy into the serialization info

De-serializes a value that was serialized with .

The type of the object to de-serialize into The serialized value The de-serialized object

Returns the triple values out of a serialized triple.

The serialized triple The de-serialized triple

Serializes an object.

The value to be serialized The serialized object

Returns a triple for a key/value pair of data in a complex object

The triple to be serialized The serialized version of the triple

Returns BASE64 encoded string that represents the entirety of the data.

Represents a triple of information used when serializing complex types: the property name, the value to be serialized, and the value's type.

Gets the triple's key

Gets the triple's value

Gets the triple's value type

Initializes a new instance of the class.

The triple's key The triple's value The triple's value type

Formats value for display in assertion messages and data-driven test display names.

Gets the maximum printing depth, in terms of objects before truncation.

Gets the maximum number of values printed for collections before truncation.

Gets the maximum number of items (properties or fields) printed in an object before truncation.

Gets the maximum strength length before truncation.

Gets the ellipsis value (three middle dots, aka U+00B7).

Escapes a string for printing, attempting to most closely model the value on how you would enter the value in a C# string literal. That means control codes that are normally backslash escaped (like "\n" for newline) are represented like that; all other control codes for ASCII values under 32 are printed as "\xnn".

The string value to be escaped

Formats a value for display.

The value to be formatted The optional printing depth (1 indicates a top-level value)

Formats a type. This maps built-in C# types to their C# native name (e.g., printing "int" instead of "Int32" or "System.Int32").

The type to get the formatted name of Set to true to include the namespace; set to false for just the simple type name

Rethrows an exception object without losing the existing stack trace information

The exception to re-throw. For more information on this technique, see http://www.dotnetjunkies.com/WebLog/chris.taylor/archive/2004/03/03/8353.aspx. The remote_stack_trace string is here to support Mono.

Unwraps an exception to remove any wrappers, like .

The exception to unwrap. The unwrapped exception.

Guard class, used for guard clauses and argument validation

Methods which help bridge and contain the differences between Type and TypeInfo.