NUnit is a unit-test framework for all .Net languages, written entirely in C# and designed to take advantage of many .NET language features, for example custom attributes and other reflection-related capabilities. With the latest version of the framework, NUnit 3.0, you can running tests in parallel without the need of adding the PNUnit extension as it was with NUnit 2.6.4. For more information and documentation about the framework, as well as how to use it in your testing, you can visit the official NUnit website.
You’ll need to have these components installed to set up NUnit testing on Sauce with C# and .NET:
-
Visual Studio
-
Selenium DLLs for .NET installed and referenced by your project
-
NUnit 3.0
####Create the Visual Studio Project:
-
Open a new project in Visual Studio. Make sure the .NET Framework is at least 3.5, 4.0, or 4.5
-
Select a C# class library template.
-
Give the project a name and click OK.
####Install the Selenium DLLs:
After you’ve set up your project in Visual Studio, you need to make sure that it references the required Selenium DLLs for .NET.
-
Download the Selenium DLLs for .NET from http://www.seleniumhq.org/download/
-
In the Solutions Explorer, select the project and right-click References.
-
Click Add Reference.
-
Click Browse and navigate to either the net35 or net40 folder of the directory where you saved the Selenium .NET DLLs.
-
Add all four .DLL references to your project.
#####Install NUnit + PNUnit and Import the Libraries into Your Project:
-
Download the latest version of NUnit(3.0) from http://www.nunit.org/index.php?p=download.
-
In the Solutions Explorer, select the project and right-click References.
-
Click Add Reference.
-
Click Browse, navigate to the directory where you saved NUnit on your machine and go to framework -> 3.0.5797.27534.
-
Once inside the 3.0.5797.27534 folder, click on the folder of the .Net Framework version that your Visual Studio is built on. For example, if you're using the .Net 4.0 Framework, you would select the net-40 folder.
-
Add the nunit.framework.dll reference to your project.
####SauceTest.cs:
Now let’s take a look at a simple C# .Net project. This example test opens Google, verifies that “Google” is the title of the page, and then searches for Sauce Labs. If you look at the code, you know notice several TestFixture objects, which are used to NUnit what browser/OS combinations we want to use in our Sauce job. How the parallel execution is done is with the use of the following ParallelizableAttribute:
[Parallelizable(ParallelScope.Fixtures)]
Inside the constructor, we give it an ParallelScope arugement, in this case we're telling that we want TestFixtures to run in parallel with one another. You can read more about the ParallelizableAttribute in the NUnit documentation.
NOTE: Currently, the ability to run methods in parallel within a class has not been implemented, so the only way to acheieve parallelism is with the use of different TestFixtures.
- In Visual Studio, install the NUnit 3.0 Test Adapter
- Select Tools | Extension Manager.
- In the left panel of the Extension Manager, select Online Extensions.
- Locate the NUnit 3.0 Test Adapter in the center panel and highlight it.
- Click 'Download' and follow the instructions.
-
To view the NUnit Test Adaptor, go to Test | Windows | Test Explorer. You should now see the Test Explorer tab on the left side of your project
-
Build the project by going Build > Build Solution, or use the CTRL-SHIFT-B shortcut. When you initially open a solution, no tests will be displayed. After compiling the assemblies in the solution, Visual Studio will interact with the NUnit Test Adapter to discover tests and a list of them will be shown in the Test Explorer.
-
Click Run All to launch your test to the Sauce Dashboard. If you want to run a single test from that or just a few, all you would need to do hold CTRL and left-click the test(s) in the Adapter, right-click and select the "Run Selected Tests" option.