Mateusz Stanek

Czytelne testy z FluentAssertions

FluentAssertions

FluentAssertions jest biblioteką, dzięki której assercje w testach są dużo bardziej czytelne. Osobiście używam jej, jeśli tylko mogę. Assercje z jej wykorzystaniem są łatwe do zrozumienia, a i komunikaty błędów są moim zdaniem czytelniejsze, niż w przypadku standardowych assercji.

Instalacja w projekcie

Bibliotekę FluentAssertions można zainstalować z Nuget-a, wybierając  manage nuget package z menu kontekstowego na referencjach projektu testowego

lub poprzez Package Manager Console (zwrócić należy uwagę, żeby wygrać odpowiedni projekt w konsoli) z wykorzystaniem polecenia:

PowerShell
1
Install-Package FluentAssertions

Pierwsze Kroki

FluentAssertions jako główny komponent wykorzystuje extension method, który to pobiera nasz obiekt, na którym chcemy wykonać porównanie i tworzy nam obiekt assercji. Takie połączenie jest dla mnie wygodniejsze, niż wykorzystywanie statycznych metod z klasy Assert.

Zapis assercji zawsze wygląda podobnie

C#
1
ObiektZAktualnąWartością.Should().MetodaPorównania(obiektDoPorównania)

Assercje na obiektach

Z operacji na obiektach poza prostymi porównaniami  typów prostych, każdy typ prosty ma specyficzne dla siebie porównania. Na przykład dla wartości całkowitych  możemy sprawdzić z automatu czy liczba ma określoną wartość, czy może jest w jakimś zakresie

C#
1
2
3
4
int actualInt = 234;
actualInt.Should().NotBeInRange(0, 255);
actualInt.Should().BePositive();
actualInt.Should().Be(234);

lub dla wartości zmiennoprzecinkowych możemy określić wartość w przybliżeniu

C#
1
2
double actualDouble = 234.567;
actualDouble.Should().BeApproximately(234.5, 0.25);

Niby proste zabiegi, ale zwiększają one czytelność porównań, przez co redukują możliwość powstania błędu.

Dla typów złożonych też istnieje możliwość porównania właściwości klas, wszystkich właściwości, co przy zmianach niweluje możliwość pominięcia, którejś z właściwości. W kodzie porównywania złożonych obiektów, które nie mają przeciążonego operatora równości ciągle za dużo widzę porównywania każdej właściwości w osobnym assercie. Dzięki FluentAssertions takie porównanie może wyglądać tak

C#
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
ChopData actualComplex = new ChopData();
actualComplex.Words = new string[] { "ala", "ma", "kota" };
actualComplex.WordsCount = 3;
 
ChopData expectedComplex = new ChopData();
expectedComplex.Words = new string[] { "ala", "ma", "kota" };
expectedComplex.WordsCount = 3;
 
actualComplex.Should().BeEquivalentTo(expectedComplex);
 
gdzie
public class ChopData
{
    public string[] Words { get; set; }
    public int WordsCount { get; set; }
}

Assercje na listach

Wśród operacji na listach możemy wybrać kilka dosyć ciekawych.

C#
1
2
3
4
5
List<string> actualList = new List<string>() { "ala", "ma", "kota"};
actualList.Should().NotBeEmpty();
actualList.Should().NotContainNulls();
actualList.Should().OnlyHaveUniqueItems();
actualList.Should().HaveElementPreceding("kota", "ma");

Assercje a wyjątki

Testowanie wyjątków wygląda nieco inaczej niż w standardowym assercie, gdzie wykorzystujemy atrybuty. Tutaj wykorzystujemy akcję jako element, na którym operujemy. Sprawdzenie czy wyjątek zostanie wywołany może wyglądać tak :

C#
1
2
3
LogicClass testedClass = new LogicClass();
Action act = () => testedClass.ThrowException() ;
act.Should().Throw<Exception>().WithMessage("Invalida argument exception");

Biblioteka FluentAssertions jest bardzo dobrze udokumentowana. Ja polecam ze swojej strony odrobinę się nią pobawić. Metody są naprawdę bardzo intuicyjne i tak naprawdę wystarczy wykorzystać możliwości jakie daje nam intelisence.  Gdyby ktoś jednak chciał poczytać więcej proponuję rozpocząć lekturę od strony projektu http://fluentassertions.com/

Proste zabawy dostępne są na moim GitHubie w katalogu https://github.com/Matejkos/BlogProjects/tree/master/FluentAssertionsPlayGround

Related posts:

  1. Własny Atrybut
  2. Atrybuty w C#
  3. Przetwarzanie kolekcji z Linq to Object cz1
  4. Pętle języka C#
11 lutego 2018 MiroBurn Challange Programowanie
No Comments

Tydzień blogowania - retrospekcja

Extension methods - nowe metody w starych typach

Dodaj komentarz Anuluj pisanie odpowiedzi

Zobacz

  • Mateusz Stanek o mnie
Mateusz Stanek

Zaprzyjaźnione blogi

SGDev.pl

Ostatnie wpisy

  • Rola Prelegent
  • Elektronika – powrót do starego hobby
  • Badger2040
  • 2023 Tydzień 11
  • 2023 Tydzień 10

Najnowsze komentarze

  • Lukas L - Podsumowanie roku 2022
  • Oktawian Kurzynski - Enumeracja – wartość domyślna
  • Mateusz Stanek - Typy generyczne
  • Ola - Enumeracja – wartość domyślna
  • Typy generyczne w języku C# nie są 'rozwiązywane' w czasie kompilacji - Typy generyczne

Archiwa

  • marzec 2025
  • marzec 2023
  • luty 2023
  • styczeń 2023
  • grudzień 2022
  • marzec 2018
  • luty 2018
  • kwiecień 2017
  • marzec 2017
  • luty 2017

Kategorie

  • Bez kategorii
  • DSP2017
  • Elektronika
  • MiroBurn Challange
  • Narzędzia
  • Podsumowanie
  • Produktywność
  • Programowanie
  • Projekt
  • Prywatne
  • Rok 2023
  • Tips

Ostatnie wpisy

  • Rola Prelegent
  • Elektronika – powrót do starego hobby
  • Badger2040
  • 2023 Tydzień 11
  • 2023 Tydzień 10
Dumnie wspierane przez WordPressa | Motyw: Neblue by NEThemes.
Ta strona korzysta z ciasteczek aby świadczyć usługi na najwyższym poziomie. Dalsze korzystanie ze strony oznacza, że zgadzasz się na ich użycie.Zgoda
Privacy & Cookies Policy

Privacy Overview

This website uses cookies to improve your experience while you navigate through the website. Out of these cookies, the cookies that are categorized as necessary are stored on your browser as they are essential for the working of basic functionalities of the website. We also use third-party cookies that help us analyze and understand how you use this website. These cookies will be stored in your browser only with your consent. You also have the option to opt-out of these cookies. But opting out of some of these cookies may have an effect on your browsing experience.
Necessary
Always Enabled
Necessary cookies are absolutely essential for the website to function properly. This category only includes cookies that ensures basic functionalities and security features of the website. These cookies do not store any personal information.
Non-necessary
Any cookies that may not be particularly necessary for the website to function and is used specifically to collect user personal data via analytics, ads, other embedded contents are termed as non-necessary cookies. It is mandatory to procure user consent prior to running these cookies on your website.
SAVE & ACCEPT