Introduction To NUnit Testing Framework

Introduction

Every successful software development follows a lifecycle known as SDLC (Software Development Life Cycle).As per Wikipedia: "SDLC is a process followed for a software project, within a software organization. It consists of a detailed plan describing how to develop, maintain, replace and alter or enhance specific software. The life cycle defines a methodology for improving the quality of software and the overall development process."

unit Testing

As we are a developer we normally understand the requirements and write the code. Apart from those we also spend some time software testing. Software testing is a process of executing a program or application with the intent of finding the software bugs. It can also be described as the process of validating and verifying a software program or application or product. I have Googled and tried to find out what kind of testing a developer can do. I got lot of solutions from the internet, and  the best one I found is here. So mainly a developer must have knowledge of Unit Testing.

What is Unit Testing?

Let's try to find the exact definition of the Unit.

What is Unit Testing

UNIT In this IT world a unit refers to simply a smallest piece of code which takes an input ,does certain operation, and gives an output.

And testing this small piece of code is called Unit Testing. A lot of unit test frameworks are available for .Net nowadays, if we check in Visual Studio we have MSTest from Microsoft integrated in Visual Studio. Some 3rd party frameworks are:

  • NUnit
  • MbUnit

Out of all these Nunit is the most-used testing Framework.

What Is NUnit?

NUnit is a unit-testing framework for all .Net languages. NUnit is Open Source software and NUnit 3.0 is released under the MIT license. This framework is very easy to work with and has user friendly attributes for working. You can check the details of Nunit from here.  If you want to learn what are the main differences between MsTest and Nunit I recommend you check the following Link.  You can also check several other links that are available on the  internet. I did a small inspection on internet and found the following result in using different Testing frameworks. As per the Slant website, this is what most people recommend on using different unit Testing frameworks. 

What Is NUnit

To work with Nunit let's set up a simple console application as follows.

What Is NUnit

Write the following class in this project.

namespace DemoProject {  
    public class EmployeeDetails {  
        public int id {  
            get;  
            set;  
        }  
        public string Name {  
            get;  
            set;  
        }  
        public double salary {  
            get;  
            set;  
        }  
        public string Geneder {  
            get;  
            set;  
        }  
    }  
}

Now in the class program write some conditions which need to be tested.

using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Text;  
using System.Threading.Tasks;  
namespace DemoProject {  
    public class Program {  
        public string Login(string UserId, string Password) {  
            if (string.IsNullOrEmpty(UserId) || string.IsNullOrEmpty(Password)) {  
                return "Userid or password could not be Empty.";  
            } else {  
                if (UserId == "Admin" && Password == "Admin") {  
                    return "Welcome Admin.";  
                }  
                return "Incorrect UserId or Password.";  
            }  
        }  
        public List < EmployeeDetails > AllUsers() {  
            List < EmployeeDetails > li = new List < EmployeeDetails > ();  
            li.Add(new EmployeeDetails {  
                id = 100, Name = "Bharat", Geneder = "male", salary = 40000  
            });  
            li.Add(new EmployeeDetails {  
                id = 101, Name = "sunita", Geneder = "Female", salary = 50000  
            });  
            li.Add(new EmployeeDetails {  
                id = 103, Name = "Karan", Geneder = "male", salary = 40000  
            });  
            li.Add(new EmployeeDetails {  
                id = 104, Name = "Jeetu", Geneder = "male", salary = 23000  
            });  
            li.Add(new EmployeeDetails {  
                id = 105, Name = "Manasi", Geneder = "Female", salary = 80000  
            });  
            li.Add(new EmployeeDetails {  
                id = 106, Name = "Ranjit", Geneder = "male", salary = 670000  
            });  
            return li;  
        }  
        public List < EmployeeDetails > getDetails(int id) {  
            List < EmployeeDetails > li1 = new List < EmployeeDetails > ();  
            Program p = new Program();  
            var li = p.getUserDetails();  
            foreach(var x in li) {  
                if (x.id == id) {  
                    li1.Add(x);  
                }  
            }  
            return li1;  
        }  
        static void Main(string[] args) {}  
    }  
}

So here I have written 3 methods or we can say some requirements which we want to test by using Unit Test. So please add a new project (Class Library Type) in the Solution Explorer as follows.

Class Library

The Nunit framework does not require any specific project type, but most of the time people will add a class library to separate their code from their unit tests. You need to reference the nunit.framework.dll yourself. But if you use nuget this will be done for you automatically while installing NUnit.

So for using Nunit we need to go for Nuget Package Manager and download it.

Nuget Package Manager

Now after installing the Nunit we need one more dll that needs to be installed in the project.

NUnit Test Adapter for Visual Studio

The NUnit Test Adapter allows you to run NUnit tests inside Visual Studio. 

Note

If you do not add this component in your project you will not be able to find your tests in test Explorer.

NUnit Test Adapter

Note

You need to install both the Libraries in the project where you are writing the test methods only.

NUnit Test Adapter

Before writing any test case let's be aware of all the components we are using in Nunit. If you check the Nunit site you will get all the attributes and other component details there.

https://www.nunit.org/

Now our next job is to add the Demo Project dll in DemoProjectTest References.

NUnit Test Adapter

Now it will add the following dll to the references.

NUnit Test Adapter

So here is the test case I  have written to test our requirements.

using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Text;  
using System.Threading.Tasks;  
using NUnit.Framework;  
using DemoProject;  
namespace DemoProjectTest {  
    [TestFixture]  
    public class DemoTests {  
        List < EmployeeDetails > li;  
        [Test]  
        public void Checkdetails() {  
                Program pobj = new Program();  
                li = pobj.AllUsers();  
                foreach(var x in li) {  
                    Assert.IsNotNull(x.id);  
                    Assert.IsNotNull(x.Name);  
                    Assert.IsNotNull(x.salary);  
                    Assert.IsNotNull(x.Geneder);  
                }  
            }  
            [Test]  
            public void TestLogin() {  
                Program pobj = new Program();  
                string x = pobj.Login("Ajit", "1234");  
                string y = pobj.Login("", "");  
                string z = pobj.Login("Admin", "Admin");  
                Assert.AreEqual("Userid or password could not be Empty.", y);  
                Assert.AreEqual("Incorrect UserId or Password.", x);  
                Assert.AreEqual("Welcome Admin.", z);  
            }  
            [Test]  
            public void getuserdetails() {  
            Program pobj = new Program();  
            var p = pobj.getDetails(100);  
            foreach(var x in p) {  
                Assert.AreEqual(x.id, 100);  
                Assert.AreEqual(x.Name, "Bharat");  
            }  
        }  
    }  
}

TestFixture

The class that is to be tested using Nunit should be decorated with TextFixture.

Test

This attribute identifies the method to be tested. If we do not write this attribute then we can't to identify the test in Testexplorer. We have an Assert class with the following methods for validating different conditions in the TestFixture.

TestFixture

Each methods has different functions.To know about this please check the Nunit Home Page.

Now let's check our test. Go to the Visual Studio Test Explorer.

Visual Studio Test Explorer

Now if we check the Left side of Visual Studio it will open a pane called Test Explorer with all the test scenarios as follows.

Visual Studio Test Explorer

Now from here if we run a test individually just right click on it and run the test

Run a Test

So in this way we can run the tests.

If the test Runs successfully it will show the following tick mark.

Run a test

Beside these attribute we have some more attributes like,

  1. SetUp
    This attribute is used when you want to execute a piece of code in each test case. It identifies a method to be executed each time before a TestMethod/Test is executed. Let's check this with an example. Here I have created a new project for testing. Here I have created four test methods.

    SetUp

    Now let's check the methods.

    SetUp nunit

    So here I have the methods where we have used setUp attribute. Let's try to debug and check SubMethod. For debugging just Right Click and Debug selected Test.

    SetUp nunit

    Now if we notice the sequence it will go to the Addmethod first like these.

    SetUp nunit

    Thus the method where the setup attribute is written will be executed first before any test method. 
  2. TearDown
    After completely executing each test if you want to execute a piece of code then you have to write this code under TearDown attribute. So let's check this again.S o we have set breakpoints to check the sequence of execution.

    TearDown

    If we check the sequence of execution the method that used TearDown attribute will be executed last after execution of the Test case.

    TearDown 

Note

If two SetUp classes are there the class that was written first will be executed first and then after that, the class that is written next to it will execute. (Top to bottom approach).

Similarly, in tear down the order is reversed -- it will follow bottom to top approach.

So in this way, we can test our requirements using Nunit Testing. I will explain all the remaining attributes in my next article. Hope this article will help you to learn the basic concepts of Nunit.

References

  • http://nunit.org
  • https://www.slant.co/topics/543/~unit-testing-frameworks-for-net 

Thanks for reading this article and Happy New Year to all.