Running xUnit.net-Based TestLeft Tests

About

Requirements

Creating and Running a TestLeft Test

xUnit.net is a unit testing framework for .NET applications. TestLeft provides an xUnit project template for Visual Studio that simplifies creation of xUnit.net tests that run TestLeft code. You will be able to run such tests by using the xUnit.net Visual Studio runner.

• The xUnit project and test templates are available only for Visual Studio projects that target .NET Framework version 4.5 or higher.

  Note:

  If your project targets an earlier version of .NET Framework, or if you use another unit testing framework, you can add TestLeft code to your unit tests and run them by using your unit testing framework manually, without using the templates.

• TestLeft xUnit templates include references to needed xUnit.net packages. When you build your TestLeft xUnit tests, Visual Studio will download and install needed packages automatically by using NuGet Package Manager.

  Note:

  Enable the Allow NuGet to download missing packages and Automatically check for missing packages during build in Visual Studio options of NuGet Package Manager to enable downloading needed packages. To learn more, see the NuGet documentation.

1. Add a TestLeft xUnit Test Project to your solution:

   • In Visual Studio’s Solution Explorer, right-click the solution and then click Add New Project.

   • In the Add New Project dialog, select the Test category and then select the TestLeft xUnit Project type.

     

     Click the image to enlarge it.

   • Click OK to add a project.

   • Visual Studio will add a TestLeft xUnit Project to your solution.

     

     Click the image to enlarge it.

2. By default, the created project includes references to needed xUnit.net packages. Build the project. Visual Studio will download and install the packages automatically.

3. Write your test code.

   Notes:

   • The project defines a sample test - HelloWorldTest. You can delete it if you do not need it or use it as a base to create your own tests.

   • The project also defines a TestFixture class. Use that class to create tests.

   • The xUnit TestLeft project includes a reference to the SmartBear.TestLeft.dll library. You do not have to add it.

   To learn how to create test instructions, see Writing Test Code.

4. Build the project.

5. Select the needed test in the Test Explorer panel and run it.

   Note:

   Tests created by using TestLeft xUnit templates do not save their test results automatically. To view the test log, in your TestLeft test code, add instructions that will export test results to an external file. See Saving Test Logs.