Running TestLeft Tests from NUnit Tests

About

Requirements

Creating and Running a TestLeft Test

NUnit is a unit testing framework for .NET applications. TestLeft provides an NUnit project template for Visual Studio that simplifies creation of NUnit tests that run TestLeft code. You will be able to run such tests by using the NUnit utility or from Visual Studio by using NUnit Test Adapter.

• You need to have NUnit version 3.2 installed. To learn how to install it, see the Installation section of the NUnit documentation.

• To run TestLeft tests from Visual Studio by using NUnit Test Adapter, you must have the NUnit 3 Test Adapter extension installed in your Visual Studio. To learn how to install the adapter, see the Adapter Installation section in the NUnit documentation.

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

1. Add a TestLeft NUnit 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 NUnit Project type.

     

     Click the image to enlarge it.

   • Click OK to add a project.

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

     

     Click the image to enlarge it.

2. In the created project, add a reference to the nunit.framework.dll library:

   By using NuGet

   By using NuGetBy using NuGet

   • In Solution Explorer, select your NUnit TestLeft project.

   • Right-click the project and then click Manage NuGet Packages.

   • In the resulting dialog, find the NUnit package (version 3.2).

   • Click Install.

   You can find more information on installing NUnit modules in the NUnit documentation (available at https://github.com/nunit/docs/wiki/Installation).

   Manually

   ManuallyManually

   Requirement: You will need a NUnit framework installed on your computer.

   • In Solution Explorer, select your NUnit TestLeft project.

   • Right-click the References item and then click Add Reference.

     — or —

     Select Project | Add Reference from Visual Studio’s main menu.

   • In the Reference Manager, click Browse.

   • Browser for nunit.framework.dll on your computer and click Add.

   • Select the check box next to the nunit.framework.dll library and click OK.

3. The NUnit TestLeft project includes a reference to the SmartBear.TestLeft.dll library.

   The project also defines a TestFixtureBase class. The class specifies methods to call before, after and when running a test. Use the class to create tests.

   Note:

   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.

4. Write your test code. To learn how to create test instructions, see 2. Write Test Code.

5. Build the project.

6. Run the test:

   By using NUnit Test Adapter

   By using NUnit Test AdapterBy using NUnit Test Adapter

   • If you do not have NUnit 3 Test Adapter in your Visual Studio, install it. You can find detailed instructions on installing the adapter in the NUnit documentation (available at https://github.com/nunit/docs/wiki/Adapter-Installation).

     You may need to restart Visual Studio after the installation and rebuild your test project.

   • In Visual Studio, open the Test Explorer panel.

   • In the panel, select the needed test and run it.

   From the command line

   From the command lineFrom the command line

   You can use the NUnit console utility (nunit-console.exe) to run created tests. For information on command-line arguments, see the NUnit documentation (https://github.com/nunit/docs/wiki/Console-Runner).

7. After the test run is over, Visual Studio will automatically save the test results to the folder where the test assembly resides. It will store the test results in the unpacked HTML format. Open the index.htm file to view the test log.

   

   Click the image to enlarge it.