Testing Framework Configuration

• Dec 06, 2019
• 2 minutes to read

CodeRush is shipped with the necessary assemblies required to run unit tests. However, if you are using a specific framework version, you may need to run tests using your library. If you already have a testing framework in your project, refer to the Use Integrated Framework section. Otherwise, follow the instructions in the Install a Testing Framework section.

Install a Testing Framework

Follow the steps below to download and reference the necessary testing framework using the NuGet Package Manager Console.

1. Open the NuGet Package Manager Console using the Tools | NuGet Package Manager | Package Manager Console Visual Studio menu item.
2. Choose the project you are going to test in the "Default project" drop-down menu.

3. Enter one of the following commands depending on the testing framework you are going to use:

   • NUnit 3.0

     Install-Package NUnit

   • xUnit

     Install-Package xunit

   • MSpec

     Install-Package Machine.Specifications

4. Press the Enter key and wait until all the required packages are downloaded and added to the project.
5. Check to ensure that the NuGet package manager output does not contain errors.

After referencing a testing framework, you can start creating unit tests.

When the solution contains one or more unit tests, you can run them using the Unit Test Runner. Refer to the Running and Debugging Tests article to learn more about the test runner.

Use Integrated Framework

CodeRush is shipped with several versions of the most common testing frameworks:

• NUnit

  • 2.4
  • 2.5
  • 2.5.9
  • 3.0
  • 3.4
  • 3.11

• xUnit

  • 1.9
  • 2.0
  • 2.1

If you use one of these versions in your project, you can run unit tests using CodeRush without any additional configuration. Otherwise, refer to the Reuse Existing Framework section.

Unit Test Runner also supports .NET Core test cases and Microsoft Fakes isolation framework.

Reuse Existing Framework

This section describes how to configure the Unit Test Runner to run tests using the unit testing framework library that you already have.

The paths to libraries used for running tests are configured in the Unit Testing | Test Runner options page. At the Supported frameworks section, choose the required framework to see what libraries are used for running tests. Use the ellipsis button at the right of a path to a library to change the library reference.