Get hardware information easily with C#, I have added unit tests to it to test the original project
This project is my desire to experience developing my skills and supporting open source projects, As I'm learning unit tests I've thought of using a project that I didn't implement and test to take on the role of tester while programming projects. Based on that, I share this experience with you :)
Project fork from: https://github.com/adanmercado/WMIHardwareInfo
- Unit Testing rules
- Given_When_Then
- AAA
- Unit Testing in C#
- My experience with my first project
- Assert
- C# library: Fluent Assertions
- Code Coverage
- Test Driven Development (TDD)
- Problems with the first run
- Shortcuts while typing tests
After watching one of the courses on YouTube, there are two main rules:
- Given_When_Then
It is a way to write the name of the test method, for example, there is a method in the project that is its name
GetPropertiesForWMIClass
After apply rule the test method is
GetPropertiesForWMIClass_When_ClassWin32_Processor_Return_name_CPU
Another example of a method
GetPropertyValuesForWMIClass
The name of the test method name is
GetPropertyValuesForWMIClass_With_Win32_Processor_name_Return_i7_8550U
Because this result is supposed to be obtained, from reading the name of the test function we know the objection of it, the input, and the expected result
- AAA
AAA: Arrange , Act, Assert Which are the steps to write the test wherewith Arrange we know the inputs and declare the variables, then in Act we prepare the method to be tested, and finally Assert to check between the expected values for the test to be true and the actual value that returned. It has been implemented in the project's test methods.
To add a test project to the solution
- Select solution in a project and >
Add > New project - The option is
MSTest Test Project - Add test project with name like
wmi-hardwareTests
After fixing the problem of the project to run it, I wrote a paragraph about it 📝 I've created a test project inside Solution 🧪, which contains three test classes that direct each file to the main project.
I had socket programming experience and know about WMI, so I started making generic tests or depending on my hardware model. For the record, some method was not able to use Assert in the comparison, so I just run the method through the test and it does not return an Exception error. For the record, you can make the method work if you define this before the method, and I will explain this in the next paragraphs.
In this picture, we can see the result of the test that you took
Verification functions differ according to the type of data you will be comparing
- Assert
- StringAssert
- CollectionAssert
In order to know what is the benefit of adding a library to the test when it already exists? It is simplicity, which is what we will notice now in this example
[TestMethod]
//Given_When_Then rule
public void GetPropertyValuesForWMIClass_With_Win32_Processor_name_Return_i7_8550U()
{
///AAA rule
//Arrange
WMIConnection connection = new WMIConnection();
//Get all devices of wmi class
string actual = "";
foreach (var device in WMIResult.GetPropertyValuesForWMIClass(connection, "SELECT * FROM Win32_Processor", "Win32_Processor"))
{
foreach (var property in device)
{
actual = actual + property.Key + ": " + property.Value;
}
}
//Act
string expected = "i7-8550U";//Of course, it varies according to the type of processor that will be tested
//Assert
StringAssert.Contains(actual, expected);
}
If we focus on the verification and comparison part, which is Assert. After using the Fluent Assertions library, you will become
//Assert
StringAssert.Contains(actual, expected);
//FluentAssertions
actual.Should().Contain(expected);
We notice the difference in clarity between the two methods, as with the Fluent library, it is closer to the English language without going into the finer details as in the Assert types.
The way to add it is by going to a store, then searching for nuget as in the picture
One of the benefits of this library for me is the ease of verification which ensures greater accuracy in the examination where the greater focus of the exam is. This example in the project didn't work for me checking in multiple ways with Assert! But it simply worked with FluentAssertions!
[TestMethod]
public void GetPropertiesForWMIClass_When_ClassWin32_Processor_Return_name_CPU()
{
List<string> actualList = WMIClasses.GetPropertiesForWMIClass("Win32_Processor");
string expected = "Name";
List<string> expectedList = new List<string> { "Name", "NumberOfCores", "NumberOfLogicalProcessors" };
//Assert
CollectionAssert.Contains(actualList, expected);
//Filled with Assert
//CollectionAssert.Contains(actualList, expectedList);
//But succeeded with FluentAssertions
actualList.Should().Contain(expectedList);
}
In (Visual Studio 2019) this feature is considered paid and not in the community version.
#todo test free tools 🔜
With this approach, we focus on writing the test first before the feature is present in the original project of course it will fail the first time. Then we go and write the code in the method to match the unit test solution. It allows us to write test-oriented code. This is a picture from the internet showing the process:
When I first run the project before adding anything I encountered a problem as in the picture:
The solution on the first run did not show all the results and seemed incomplete
The solution was to modify the code to be smarter and become
if (item[property] == null)
{
//To get out of the for each loop
//without going through the problem that stopped the program
//break;
continue;
}
device.Add(property, item[property].ToString());
}
where put (continue) is true to complement what's inside the WMI class
Write (testm) + Tab = to create test method
Write (prop) + Tab = to create property by fast shortcut
Write (cw) + Tab = to create statement of Console for Write Line
This project took the time: 12 Hours to 8-7-2021 (720M to 6)
Everything I wrote is from my writing and understanding at this time about unit tests without copying text from sources where I tried to explain the method as I like to read it for myself later when reviewing it 🧐
There is a part of the course on YouTube that is not covered here, I may add it at a later time or in another project as appropriate.
The course that I watched in Arabic on YouTube to learn the tests, and then I made this test project: https://www.youtube.com/playlist?list=PLwj1YcMhLRN28xijrXMO255JHsO3csus-
My GitHub: https://github.com/MohammadYAmmar
My LinkedIn: https://www.linkedin.com/in/mohammad-y-ammar/ If you have seen the description and test codes, may can you recommend my programming skills or unit tests on LinkedIn? :)
If you liked it, do not forget to give the project a star ⭐🌟 to encourage us to continue.
Thank you for reading all of this to benefit you instead of just copying and pasting ✂!