This document discusses improving automated tests with Fluent Assertions. It covers supported frameworks like MSTest, NUnit, and XUnit. Common assertions are described for strings, numbers, dates, collections, and JSON. Assertions can be batched into scopes. Similar libraries exist for Java (AssertJ), Python (Fluentcheck, Assertpy) and JavaScript (Chai).

1. Gorilla Logic Proprietary and Confidential
Improving Automated Tests with Fluent
Assertions Jorge Vega Citalan
jorge.vega.citalan@gmail.com

2. Gorilla Logic Proprietary and Confidential
Agenda
Introduction
Supported Frameworks and Platforms
Common Asserts
Assertions Scope
Asserts with JSON
Java, Python & JavaScript?
2
1
3
4
5
6
2

3. Gorilla Logic Proprietary and ConfidentialGorilla Logic Proprietary and Confidential
Introduction

4. Gorilla Logic Proprietary and Confidential
Introduction
❏ Improve readability of test source code.
4

5. Gorilla Logic Proprietary and Confidential
Introduction
❏ Clearer explanations about why a test
failed.
5

6. Gorilla Logic Proprietary and ConfidentialGorilla Logic Proprietary and Confidential
Supported Frameworks and Platforms

7. Gorilla Logic Proprietary and Confidential
Supported Frameworks
❏ Fluent Assertions supports the following unit
test frameworks:
■ MSTest (Visual Studio 2010, 2012 Update 2, 2013
and 2015)
■ MSTest2 (Visual Studio 2017, Visual Studio 2019)
■ NUnit
■ XUnit
■ XUnit2
■ MBUnit
■ Gallio
■ NSpec
■ MSpec
7

8. Gorilla Logic Proprietary and Confidential
Supported Platforms
❏ Fluent Assertions supports the following
minimum platforms:
■ .NET Core 1.0 and 2.0
■ .NET Framework 4.5
■ Mono, Xamarin.iOS 10.0, Xamarin.Mac 3.0 and
Xamarin.Android 7.0
■ Universal Windows Platform
8

9. Gorilla Logic Proprietary and ConfidentialGorilla Logic Proprietary and Confidential
Common Asserts

10. Gorilla Logic Proprietary and Confidential
Strings
❏ Null, empty or contains whitespace only.
10

11. Gorilla Logic Proprietary and Confidential
Strings
❏ Common assertions.
11

12. Gorilla Logic Proprietary and Confidential
Strings
❏ Contain certain values.
12

13. Gorilla Logic Proprietary and Confidential
Strings
❏ Wildcards and Regular Expressions.
13

14. Gorilla Logic Proprietary and Confidential
Numerical and IComparable<T>
❏ Common assertions.
14

15. Gorilla Logic Proprietary and Confidential
Numerical
❏ Doubles and Floats.
15

16. Gorilla Logic Proprietary and Confidential
Numerical
❏ Assertions against a list of values.
16

17. Gorilla Logic Proprietary and Confidential
Dates
❏ Common assertions.
17

18. Gorilla Logic Proprietary and Confidential
Dates
❏ Date details.
18

19. Gorilla Logic Proprietary and Confidential
Dates
❏ Ranges.
19

20. Gorilla Logic Proprietary and Confidential
Nullable
❏ Common assertions.
20

21. Gorilla Logic Proprietary and Confidential
Collections
❏ Common asserts.
21

22. Gorilla Logic Proprietary and Confidential
Collections
❏ Individual assertions on all elements of a
collection.
22

23. Gorilla Logic Proprietary and Confidential
Dictionaries
❏ Common asserts.
23

24. Gorilla Logic Proprietary and Confidential
Dictionaries
❏ Common asserts.
24

25. Gorilla Logic Proprietary and ConfidentialGorilla Logic Proprietary and Confidential
Assertions Scope

26. Gorilla Logic Proprietary and Confidential
Assertions Scope
❏ Batch multiple assertions into an AssertionScope
so that FluentAssertions throws one exception
at the end of the scope with all failures.
26

27. Gorilla Logic Proprietary and ConfidentialGorilla Logic Proprietary and Confidential
Asserts with JSON

28. Gorilla Logic Proprietary and Confidential
JSON
❏ Assertions allowed:
■ BeEquivalentTo()
■ ContainSingleElement()
■ ContainSubtree()
■ HaveCount()
■ HaveElement()
■ HaveValue()
■ MatchRegex()
■ NotBeEquivalentTo()
■ NotHaveElement()
■ NotHaveValue()
■ NotMatchRegex()
28

29. Gorilla Logic Proprietary and Confidential
JSON
❏ Be sure to include using FluentAssertions.Json;
otherwise false positives may occur.
29

30. Gorilla Logic Proprietary and ConfidentialGorilla Logic Proprietary and Confidential
Java, Python & JavaScript?

31. Gorilla Logic Proprietary and Confidential
Java
❏ AssertJ (https://joel-costigliola.github.io/assertj/)
31

32. Gorilla Logic Proprietary and Confidential
Python
❏ Fluentcheck (https://github.com/csparpa/fluentcheck)
32

33. Gorilla Logic Proprietary and Confidential
Python
❏ Assertpj (https://pypi.org/project/assertpy/)
33

34. Gorilla Logic Proprietary and Confidential
JavaScript
❏ Chai (https://www.chaijs.com/guide/styles/#should)
34

35. Gorilla Logic Proprietary and ConfidentialGorilla Logic Proprietary and Confidential
Demo

36. Gorilla Logic Proprietary and Confidential
Q&A
"With Fluent Assertions, the assertions look
beautiful, natural and most importantly, extremely
readable" Garish