{"id":7856,"date":"2023-06-20T14:49:39","date_gmt":"2023-06-20T12:49:39","guid":{"rendered":"https:\/\/medtech-ingenieur.de\/?p=7856"},"modified":"2023-08-02T14:39:27","modified_gmt":"2023-08-02T12:39:27","slug":"unit-testen-c","status":"publish","type":"post","link":"https:\/\/medtech-ingenieur.de\/en\/unit-testen-c\/","title":{"rendered":"Introduction to Unit Testing in C# for Beginners \u2013 Setup, Basics, and Helpful Tools"},"content":{"rendered":"
\nUnit tests are essential for software development. They help prevent errors that would otherwise be discovered late and difficult to locate. Visual Studio offers several extensions for C# developers to help us create unit tests.<\/p>\n
In this blog post, I'll guide you through the most important steps in setting up a test project: Using an example, I'll create a simple unit test, provide some useful tips, and introduce helpful tools. The prerequisite for readable and effective unit tests is that the individual components of the code can be tested independently of the rest of the software.<\/p>\n
You can learn how to make your code testable using interfaces in my next blog post, \u201cInterfaces for better unit testing.\u201d<\/p>\n
Why should you perform unit tests?<\/h2>\n
\n
Ensuring the functionality of classes and methods.<\/li>\n
Simplifies the search for errors because certain sections of the code are covered by unit tests and can be excluded as a source of errors.<\/li>\n
After adjusting methods or classes, you can quickly and easily determine whether the functionality is still available.<\/li>\n<\/ul>\n
<\/p>\n
Basics of unit tests<\/h2>\n
When creating unit tests, the following should be considered:<\/p>\n
\n
To create meaningful unit tests, the individual components must be testable independently of each other. How to ensure the testability of your code with interfaces is explained using an example in the blog post "Interfaces for Better Unit Testing."<\/li>\n
A unit test always tests exactly one function.<\/li>\n
The input parameters and the desired result must be known in order to check the function for correctness.<\/li>\n
For each constraint of a function, a unit test must be created to cover all possible scenarios for which this function can be used.<\/li>\n<\/ul>\n
Structure of a unit test<\/h4>\n
There are a few points to consider when creating structured and readable unit tests:<\/p>\n
\n
A test method is written for each scenario.<\/li>\n
The name of the test method contains which method is being tested and what it is being tested for.<\/li>\n
The name of the test method ends with the word \u201cShould\u201d.<\/li>\n
Example: the test method for the function Calc(int n1, int n2) which adds two numbers could be named Calc::AddTwoNumbersShould()<\/li>\n
A test can usually be divided into three blocks<\/li>\n<\/ul>\n\n
\n\n
Arrange:<\/strong> \n\u2013 Preparation of the input parameters \n\u2013 Determine the desired result \n\u2013 Creating objects for testing<\/li>\n
Act:<\/strong> \n\u2013 Execution of the function to be tested \n\u2013 Act usually consists of only a single line<\/li>\n
Assert:<\/strong> \n\u2013 Checking the results \n\u2013 Check whether exceptions were thrown<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n
This division makes your tests more readable and understandable, because you can see at a glance what the input parameters and expected results are (Arrange block), what is being tested (Act block), and why the test fails (Assert block).<\/p>\n
<\/p>\n
Example of unit testing a method for a calculator<\/h2>\n
The following steps are described<\/p>\n
\n
Set up<\/li>\n
The class to be tested: Calculator<\/li>\n
How do you create a test project?<\/li>\n
How do you create a test class?<\/li>\n
Adding the reference to the project to be tested<\/li>\n
Creating a test \na. What can be tested?<\/li>\n
Running a test \na. with the test explorer \nb. with axocover<\/li>\n<\/ol>\n
1. Setup<\/strong> \nIn the following example the following setup was used<\/p>\n
Aoxcover: VisualStudio -> Tools -> Extensions and Updates \no AxoCover v 1.1.7.0<\/li>\n<\/ul>\n
2. The class to be tested: Calculator<\/strong> \nFor this example, we will test the method Calc(int n1, int n2) of the Calculator class, which is shown in Figure 1. Here, we will limit ourselves to addition only.<\/p>\n
Figure 1: Class to be tested<\/figcaption><\/figure>\n
3. Create a test project<\/strong> \nCreate a second project of type \u201cNUnit 3 Unit Test Project\u201d in the solution folder.<\/p>\n
Figure 2: Creating a test project<\/figcaption><\/figure>\n
4. Create a test class<\/strong> \nNow create a new test class in your new test project. Select the "NUnit Test Fixture" type and name it after the class or function you want to test. In the following, the name "CalcShould" was used.<\/p>\n
Figure 3: Creating a test class<\/figcaption><\/figure>\n
In the newly created test fixture, a first test method TestMethod() is automatically created, as shown in Figure 4.<\/p>\n
Figure 4: Automatically created test class<\/figcaption><\/figure>\n
5. Adding the reference to the project to be tested<\/strong> \nTo access the classes from your actual project, you first need to add a reference to your project. To do this, right-click on the references of your test project and select "Add References." Then add your project.<\/p>\n
Figure 5: Adding the reference to the project to be tested<\/figcaption><\/figure>\n
Now you can add a using directive to your main project in your test fixture. You can now access the class you're testing.<\/p>\n
Figure 6: Adding the Using directive to the project to be tested in the test fixture<\/figcaption><\/figure>\n
6. Creating a test<\/strong> \nFigure 7 shows a test method that tests the Calc method of the Calculator class. This method only tests the addition of two natural numbers.<\/p>\n
Arrange:<\/p>\n
In the Arrange block, an object of the Calculator class is created and the input parameters number1 and number2, as well as the expected result resultShould, are specified.<\/p>\n
Act:<\/p>\n
In the Act block, the Calc method is executed with the appropriate input parameters and the result is stored in the variable result.<\/p>\n
Assert:<\/p>\n
The Assert block checks whether the result match the expected result resultShould.<\/p>\n
Figure 7: Unit test for the Calc method for adding two integers<\/figcaption><\/figure>\n
What can be tested in a unit test?<\/strong> \nBelow are some helpful ways to use the Assert class in unit tests.<\/p>\n
\n\n
\n
Using Assert<\/th>\n
Meaning<\/th>\n<\/tr>\n
\n
Assert.That() Is.Equal(var x, var y)<\/td>\n
Test can only be passed if x has the same value as y<\/td>\n<\/tr>\n
\n
Assert.Fail()<\/td>\n
The test can only pass if the code fails before reaching this line. For example, because an unhandled exception is thrown beforehand.<\/td>\n<\/tr>\n
\n
Assert.That(x, Is.GreaterThan(y));<\/td>\n
The test can only be passed if x is greater than y<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
![\"\"](\"https:\/\/medtech-ingenieur.de\/wp-content\/uploads\/2023\/06\/Affordable-homes-in-thriving-communities.png\")
![\"\"](\"https:\/\/medtech-ingenieur.de\/wp-content\/uploads\/2023\/06\/Bild1-1.png\")
![\"\"](\"https:\/\/medtech-ingenieur.de\/wp-content\/uploads\/2023\/06\/Bild2-1.png\")
![\"\"](\"https:\/\/medtech-ingenieur.de\/wp-content\/uploads\/2023\/06\/Bild3-1.png\")
![\"\"](\"https:\/\/medtech-ingenieur.de\/wp-content\/uploads\/2023\/06\/Bild4-1.png\")
![\"\"](\"https:\/\/medtech-ingenieur.de\/wp-content\/uploads\/2023\/06\/Bild5-1.png\")
![\"\"](\"https:\/\/medtech-ingenieur.de\/wp-content\/uploads\/2023\/06\/Bild6-1.png\")
![\"\"](\"https:\/\/medtech-ingenieur.de\/wp-content\/uploads\/2023\/06\/Bild7-1.png\")
![\"\"](\"https:\/\/medtech-ingenieur.de\/wp-content\/uploads\/2023\/06\/Bild8.png\")
![\"\"](\"https:\/\/medtech-ingenieur.de\/wp-content\/uploads\/2023\/06\/Bild9.png\")
![\"\"](\"https:\/\/medtech-ingenieur.de\/wp-content\/uploads\/2023\/06\/Bild10.png\")
![\"\"](\"https:\/\/medtech-ingenieur.de\/wp-content\/uploads\/2023\/06\/Bild11.png\")