dupdobnightly - NFluent 2.6.0-beta-0197
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 (http://fest.easytesting.org/).
PM> Install-Package NFluent -Version 2.6.0-beta-0197 -Source https://www.myget.org/F/dupdobnightly/api/v3/index.json
> nuget.exe install NFluent -Version 2.6.0-beta-0197 -Source https://www.myget.org/F/dupdobnightly/api/v3/index.json
> dotnet add package NFluent --version 2.6.0-beta-0197 --source https://www.myget.org/F/dupdobnightly/api/v3/index.json
source https://www.myget.org/F/dupdobnightly/api/v3/index.json
nuget NFluent ~> 2.6.0-beta-0197
Copy to clipboard
> choco install NFluent --version 2.6.0-beta-0197 --source https://www.myget.org/F/dupdobnightly/api/v2
Import-Module PowerShellGet
Register-PSRepository -Name "dupdobnightly" -SourceLocation "https://www.myget.org/F/dupdobnightly/api/v2"
Install-Module -Name "NFluent" -RequiredVersion "2.6.0-beta-0197" -Repository "dupdobnightly" -AllowPreRelease
Copy to clipboard
V 2.6.0
New feature
- NFluent now supports assumption through Assume keyword. Full documentation to be provided for official release
Improvements
- Actual and expected value naming has been redesigned to improve naming accuracy. Impact vary depending on checks and types.
Fixes
Fix issue with IEnumerable
Several error messages have been improved due to fix on check helpers.
NotSupportedException when using ContainsExactly on strings.
Extensibility
ICheckLogic.DefineExpectedValues now expects an generic 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
- #292, #295, #296, #297, #299
V 2.5.0
Main feature
- CaptureConsole class mocks the system console. Using it you can inject/simulate
user input (with Input and InputLine methods) and read/review what the code has put on the
console (with the Output property). The class is disposable: normal behavior
is restored on Dispose.
Example
using (var console = new CaptureConsole)
{
console.InputLine("12+13");
// the code I need to check (a calculator here)
Calculator.Process();
// perform the check
Check.That(console.Output).IsEqualTo("25");
}
New checks
- Console related checks (see above)
Improvements
Stabilize Assembly Version to reduce friction induced by strong naming (assembly version is still V2.4.0)
Align to Microsoft guidelines for OSS libraries (https://docs.microsoft.com/en-us/dotnet/standard/library-guidance/)
HasAvalue() and HasNoValue() are available on all nullable types
Add support for WithCustomMessage for dynamics.
Revised signature for enumerable checks to reduce type erasure (loss of type information when chaining checks). Regression tests have been added regarding non generic IEnumerable support, but as the changes
are significant, please revert to us if you face issues.
Fixes reporting of end of line markers: only carriage return chars were reported.
Changed error text for missing or extra lines in string to make it clearer.
IsEqualTo provides more details for IEnumerable (make sure first different item is visible).
Number of items in expected value was often not reported in error messages.
Fixes
Fix false positive with TimeSpan due linked to precision loss. It concerns: IsEqualTo(TimeSpan), IsLessThan(TimeSpan), IsGreaterThan(TimeSpan)
Fix random FileNotFound exceptions on the first failing assertion while using XUnit in some specific setup.
Error message for Check.ThatCode().LastsLessThan did not report the actual time.
Error message for Not.ThrowsAny() was wrong.
Hashtable not properly reported in error messages.
Fixed error messages for negated checks on dynamics.
Fix false positive for IsNotZero (and IsZero) for decimal that are close to 0 (<.5).
IsEquivalentTo now supports dictionary types.
IsEqualTo now supports dictionary types. Error message hints to use IsEquivalentTo when relevant.
GitHub Issues
- #269, #274, #270, #275, #276, #280, #283, #184, #284, #286, #290
V 2.4.0
Main feature: Custom explicit error message
You can now provides explicit error messages for each check, thanks to WithCustomMessage. E.g:
Check.WithCustomMessage("Ticket must be valid at this stage").That(ticket.Status).IsEqualTo(Status.Valid);
This feature has often been requested and we are happy to finaly deliver it, but please keep on
naming your test methods properly.
Custom error messages are not avaible for dynamic types.
New checks
IsInAscendingOrder: checks if an IEnumerable is sorted in ascending orders, it accepts an optional comparer instance
IsInDescendingOrder: checks if an IEnumerable is sorted in descending orders, it accepts an optional comparer instance
IsSubSetOf: checks if an IEnumerable is a subset of another collection.
IsInstanceOf
Improvements
Truncation default lenght for message is now 20Ko as an experiment. Please bring feedback. You can still adjust
default truncation with the Check.StringTruncationLength property
Multidimensional arrays are properly reported in error messages, respecting index structure.
Sourcelink (Net Core 2.1+ and Net Standard 2.0): you can debug through NFluent code using Sourlink on Core 2.1 projects
Multi dimensional array types are reported with the number of dimensions (eg: int[,,])
Fixes
As now works with Not (and vice versa).
Exception when using HasElementThatMatches or ContainsOnlyElementsThatMatch on arrays, and possibly
other enumerable types.
Exception when using multidimensional arrays (such as int[2,5]) with Considering/HasFiedsWithSameValueAs.
false Negative when comparing multimensionnal arrays, e.g.: int[3,5] was equal to int[5,3] and with int[15].
Exception when reporting strings containing braces.
GitHub Issues
- #255, #38, #166, #258, #259, #260, #261, #262, #264, #265
V 2.3.1
Fixes
- NullReferenceException on failed check using xUnit and NetCore
GitHub Issues
- #251
V 2.3.0
Main feature: redesigned extensibility
One of the fundamental features of NFluent is that you can add your own checks.
Articles explained how to do that, but syntax was still too cumbersome
for our taste. This version brings major improvements detailed here:
- Simplified support for creating custom checks thanks to new helper methods
and classes (see https://github.com/tpierrain/NFluent/wiki/Extensibility)
- Customization of error reporting: by default, any check failure is reported
by raising an exception. You can now provide your own reporting system. You need to provide an implementation
of IErrorReporter interface, and specify you want to use it by setting the Check.Reporter interface.
Other New features(s)
IsNullOrWhiteSpace: checks if a string is null, empty or contains only white space(s).
IReadOnlyDictionary (Net 4.5+)
ContainsKey, ContainsValue, ContainsPair are supported.
async method/delegates
Check.ThatCode now supports async methods/delegates transparently.
Check expression now provides the result as a string. I.e Check.That(true).IsTrue().ToString() returns "Success".
New check: IsDefaultValue, which fails if the sut is not the default value for its type: null for ref types, 0 for value types.
New check: ContainsNoDuplicateItem for enumerable, that fails of it contains a dupe.
New check: IsEquivalentTo for enumerable, that checks if its contents match an expected content, disregarding order.
New check: DoesNotContainNull for enumerable, that fails if an entry is null.
New check: IsAnInstanceOfOneOf that checks if the sut is of one of exptected types.
New check: IsNotAnInstanceOfThese that checks if the sut type is different from a list of forbidden types.
New check: DueToAnyFrom(...) that checks that an exception has been triggered by another exception from a list of possible types.
Fixes
Check.ThatCode(...).Not.Throws<T>() may throw an InvalidCastException when thrown exception is not T.
Extension checks to Throw<>, ThrowType or ThrowAny raise an exception when used with Not as it does not make sense.
Which() raises an exception when used on a negated check (Not).
Fix exception when using Considering and indexed properties.
Fix loss of type when using Contains and ContainsExactly. This restores fluentness for IEnumerable
Fixed error messages for double (and float) equality check that reported checked value in place of the expected one.
Fixed error messages for Check.That(TimeSpan).IsGreaterThan
False positive whith Considering() or HasFieldsWithSameValues when haing ints and enum attributes with the same value.
Changes
Improved error messages
ContainsOnlyElementsThatMatch: now provides the index and value of the first failing value.
IsOnlyMadeOf: improved error messages
DateTime checks: revamped all messages
Enum: error message on enum types now use 'enum' instead of 'value'.
IsInstanceOf: be more specific regarding types
Considering()...IsNull/IsNotNull: error messages specify member triggering the failure.
Breaking
Added automatic conversion between decimal and other numerical types. Check.That(100M).IsEqualTo(100) no longer fails.
Removed Failure method from IChecker interface
GitHub Issues
#228, #227, #222, #223, #217, #230, #232,
#236, #238, #242, #243, #244, #245, #246,
#231, #247, #161, #249
- .NETFramework 2.0: 2.0.0.0
- .NETFramework 3.0: 3.0.0.0
- .NETFramework 3.5: 3.5.0.0
- .NETFramework 4.0: 4.0.0.0
- .NETFramework 4.5: 4.5.0.0
- .NETStandard 1.3: 1.3.0.0
- .NETStandard 2.0: 2.0.0.0
OwnersDupdob |
AuthorsThomas PIERRAIN, Cyrille DUPUYDAUBY, Rui CARVALHO, Marc-Antoine LATOUR |
Project URLhttp://www.n-fluent.net/ |
LicenseApache-2.0 |
Tagstdd bdd test fluent check checks easy nunit xunit mbunit mstestsucks |
Info263 total downloads |
3 downloads for version 2.6.0-beta-0197 |
Download (1.3 MB) |
Found on the current feed only |
Package history
Version | Size | Last updated | Downloads | Mirrored? | |||
---|---|---|---|---|---|---|---|
3.0.0-beta-0250 | 634.56 KB | Fri, 04 Feb 2022 15:10:23 GMT | 23 | ||||
3.0.0-beta-0246 | 640.28 KB | Wed, 13 Oct 2021 10:03:19 GMT | 21 | ||||
3.0.0-beta-0245 | 638.54 KB | Mon, 11 Oct 2021 21:43:04 GMT | 5 | ||||
3.0.0-beta-0244 | 638.07 KB | Mon, 11 Oct 2021 13:07:00 GMT | 3 | ||||
3.0.0-beta-0241 | 628.11 KB | Tue, 22 Jun 2021 07:44:49 GMT | 2 | ||||
3.0.0-beta-0238 | 774.62 KB | Tue, 16 Feb 2021 21:16:51 GMT | 64 | ||||
3.0.0-beta-0237 | 773.02 KB | Sat, 13 Feb 2021 15:06:07 GMT | 5 | ||||
3.0.0-beta-0236 | 764.76 KB | Sun, 24 Jan 2021 15:23:35 GMT | 5 | ||||
3.0.0-beta-0223 | 764.58 KB | Wed, 16 Dec 2020 21:28:20 GMT | 3 | ||||
3.0.0-beta-0222 | 761.9 KB | Thu, 22 Oct 2020 07:46:33 GMT | 7 | ||||
3.0.0-beta-0220 | 761.89 KB | Wed, 14 Oct 2020 07:22:28 GMT | 21 | ||||
3.0.0-beta-0216 | 761.89 KB | Tue, 13 Oct 2020 13:59:47 GMT | 20 | ||||
3.0.0-beta-0214 | 756.99 KB | Thu, 23 Jul 2020 07:02:28 GMT | 4 | ||||
2.7.0-beta-0213 | 1.44 MB | Wed, 29 Jan 2020 06:07:43 GMT | 19 | ||||
2.6.0-beta-0197 | 1.3 MB | Fri, 03 May 2019 07:05:26 GMT | 3 | ||||
2.5.1-beta-0194 | 1.24 MB | Fri, 22 Mar 2019 21:38:54 GMT | 5 | ||||
2.4.0-beta-0187 | 881.53 KB | Thu, 06 Sep 2018 20:18:31 GMT | 5 | ||||
2.4.0-beta-0186 | 881.49 KB | Thu, 06 Sep 2018 12:51:55 GMT | 5 | ||||
2.4.0-beta-0183 | 760.05 KB | Thu, 19 Jul 2018 15:57:18 GMT | 21 | ||||
2.4.0-beta-0182 | 758.11 KB | Wed, 18 Jul 2018 13:18:25 GMT | 22 |