NFluent 2.7.0

NFluent is an ergonomic check library which aims to fluent your .NET TDD experience (based on simple Check.That() check statements). NFluent aims your tests to be fluent to write (with an happy 'dot' auto completion experience), fluent to read (i.e. as close as possible to plain English expression), but also fluent to troubleshoot, in a less-error-prone way comparing to the classical .NET test frameworks. NFluent is directly, but also freely, inspired by the awesome Java FEST fluent check/reflection library (

There is a newer version of this package available.
See the version list below for details.
Install-Package NFluent -Version 2.7.0
dotnet add package NFluent --version 2.7.0
<PackageReference Include="NFluent" Version="2.7.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NFluent --version 2.7.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: NFluent, 2.7.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install NFluent as a Cake Addin
#addin nuget:?package=NFluent&version=2.7.0

// Install NFluent as a Cake Tool
#tool nuget:?package=NFluent&version=2.7.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

# V 2.7.0

# New checks

* You can use IsCloseTo on DateTime and DateTimeOffset to check if a given date is close to a reference one.

* You can provide your own equality comparer (as an implementation of IEqualityComparer) when using IsEqualTo.

Check.That(sut).IsEqualTo(expected, new MyEqualityComparer());

# Improvements

* Check.That(IEnumerable).IsEquivalent(...) now uses default logic for equality check.

* Significantly improved error messages for enumeration and dictionary equality comparison.

* Restore typed IsEqualTo check. It should ensure smoother experience with autocompletion logic. Non typed version

(using Object as a parameter) is still available.

* You can use WhichMember to perform checks on any member of an exception.

Check.ThatCode(() => {...}).Throws<ArgumentException>().

WhichMember( x=> x.ParamName).IsEqualTo(myArg);

# Fixes

* the Not operator no longer erases the custom message set using WithCustomMessage

* Check.That(IDictionary).IsEquivalent now fails as expected when the sut has entries that do not exist in the expected dictionary.

* IsEquivalent now performs deep equivalence. For example, it supports Dictionaries of Dictionaries

* NFluent now mimics Net implicit type conversion for numeric types so that IsEqualTo behaves as expected when implicit conversion required

* Enum properties are properly considered when using Considering.

* Enumeration of KeyValue pairs are no longer treated as dictionaries but as enumeration. This behavior was a hack

to support custom IDictionary<K,V> implementations. Detection logic has been improved so this is no longer necessary.

* Check.That(IEnumerable).IsInDescendingOrder no longer requires items to implement IComparable

# GitHub Issues

* #306, #312, #313, #314, #315, #317, #319, #320, #321

## V 2.6.0

### New feature

* NFluent now supports assumption through Assuming entry point. For example you express it as :Assume.That(sut).IsEqualTo(expected); in a nutshell

you type Assuming instead of Check. All checks are available. Note that actual support depends on the underlying testing framework. As of now

it is supported for NUnit and MsTest

* NFluent now supports DateTimeOffset type with the same gchecks than for DateTime. These checks fails

if the offsets are different. The IsSameUtcInstant cheks perform a comparison integrating the offset.

### New checks

* You can use WhoseSize() to check the size of an enumeration. It is used as an extension keyword, as in:


### Improvements

* When using the Equals method, NFluent now uses expected.Equals(actual) instead of actual.Equals(expected).

This should have limited impact.

* Actual and expected value naming has been redesigned to improve naming accuracy. Impact vary depending on checks and types.

* Comparison of enumeration now provides details regarding the differences. You can control

how many differences are reported using the property **ExtensionsCommonHelpers.CountOfLineOfDetails**.

* Cleaned up the reporting of array fields when using Considering. The superfluous dot (as in _field.[index]_)

has been removed.

* Improved implementation for Equals when using Considering. You should use IsEqualTo when checking for

* equality, but we also provide an implementation of Equals as a failsafe.

### Fixes

* Fix issue with IEnumerable<object> and Contains(Exactly), IsEqualTo, IsEquivalentTo.

* Several error messages have been improved due to fix on check helpers.

* NotSupportedException when using ContainsExactly on strings.

* Fix issue with single dimension arrays and field based checks where the LAST item of the array was not evaluated during the check (issue found thanks to mutation test)

* Comparing Array with considering was no different than when using IsEqualTo. This has been fixed.

Therefore error messages are now in line with what was expected

### Extensibility

Foreword: several breaking changes have been introduced that may trigger build error in your custom extensions if you have made any.

Methods and types have been renamed, so your code will have to refer the new names. IF YOU ENCOUNTER ISSUES AND NEED ASSISTANCE, please open an issue, we will assist you ASAP.

* All lambda/code specific interfaces (ICodeCheck<T>...) and classes have been removed. NFluent now uses the standard interfaces and types (i.e. Check<T>)

* ICheckLogic.DefineExpectedValues now expects an generic IEnumerable<T> instead of a plain IEnumerable

* you can use ICheckLogic.DefinePossibleTypes if you need to have a list of possible types for the sut (displayed in the error message)

* improved naming: ICheckLogic.DefineExpectedValues has been renamed DefinePossibleValues

* checks helper (ICheckLogic) now correctly reports the fundamental error instead of a detail error. In previous version, the error messages could focus on details, e.g. report the

exception's message when the issue is the exception's type.

* add a flag (boolean) to BuildCheckLinkWhich method (allows to provide subitem check) that allows to speciyf sub item is available.

### GitHub Issues

* #225, #291, #292, #295, #296, #297, #299, #302


This package has no dependencies.

NuGet packages (6)

Showing the top 5 NuGet packages that depend on NFluent:

Package Downloads
Iago is a tool to write bdd like tests in kre. use `iago.runner` to execute your tests
NFluent checks for checking HttpResponseMessages.
Iago runner is a tool to run bdd like tests in kre
A library for writing flexible and easy to maintain acceptance tests
Parses offline registry hives

GitHub repositories (10)

Showing the top 5 popular GitHub repositories that depend on NFluent:

Repository Stars
The FileHelpers are a free and easy to use .NET library to read/write data from fixed length or delimited records in files, strings or streams
This repository was deprecated, use:
More than a ReClass port to the .NET platform.
WireMock.Net is a flexible library for stubbing and mocking web HTTP responses using request matching and response templating. Based on the functionality from, but extended with more functionality.
An overlay to track Elite Dangerous blueprints progress in real time

Version History

Version Downloads Last updated
2.7.2 1,457 4/8/2021
2.7.2-beta-0240 64 3/26/2021
2.7.1 26,778 12/29/2020
2.7.1-beta-0226 130 12/21/2020
2.7.0 140,651 2/11/2020
2.6.0 110,652 8/19/2019
2.5.0 97,015 3/12/2019
2.4.0 86,006 10/2/2018
2.3.1 62,187 6/12/2018
2.3.0 1,122 6/9/2018
2.2.0 50,048 2/10/2018
2.1.1 22,248 1/5/2018
2.1.0 10,452 12/10/2017
2.0.0 56,489 6/27/2017
2.0.0-alpha-44 1,547 5/10/2017
1.3.1 174,923 7/28/2014
1.2.0 8,124 6/16/2014
1.1.0 3,910 2/14/2014
1.0.0 1,647 12/31/2013
0.11.0 1,256 11/26/2013
0.9.0 1,408 8/6/2013
0.8.0 1,064 7/6/2013
0.7.0 1,018 6/4/2013
0.6.0 998 5/19/2013
0.5.0 1,085 4/21/2013