95,254

Downloads

665

Downloads of v 2.0.0

61

Average downloads per day

2017-06-27

Last published

Share on Social Networks

NFluent, smooth your .NET TDD...

2.0.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 (http://fest.easytesting.org/).

To install NFluent, smooth your .NET TDD experience!, run the following command in the Package Manager Console

Install-Package NFluent

Release Notes

New feature(s):

* Support for NetStandard > 1.3

* Support for Net.Core > 1.0

* Compatible for Net > 2.0

* Built for: 2.0, 3.0, 3.5, 4.0, 4.5, NetStandard 1.3

* All: introduce: HasSameValueAs(x) that perform comparison using 'operator==' instead of 'Equals'.

* All: introduce: HasAValueDifferentFrom(x) that perform comparison using 'operator!=' instead of '!Equals'.

* Streams: introduce HasSameSequenceOfBytesAs() check.

* Numbers: introduce IsPositiveOrZero() check.

* Numbers: introduce IsNegativeOrZero() check.

* FloatingNumbers (float, double): introduce IsCloseTo(expected, within) check for estimated value.

* Exception: introduce the DueTo<InnerException> as an extension to Throws<Exception>. It verifies that the checked exception was triggered by a specific exception. This is done by scanning the 'innerException' chain until the expected type is identified. Further checking is done on the inner exception.

* Exception: introduce WithProperties( expression, expectedValue) to check the value of any exception members, thanks to a selector expression.

* IEnumerable: introduce HasElementAt(int index) which checks for an item as a specific index. Furthermore, this item can be checked as well thanks to 'Which'. E.g: Check.That(_collection).ContainsElementAt(3).Which.IsEqualTo("foo").

* IEnumerable: introduce HasFirstElement() which checks for the first item. Furthermore, this item can be checked as well thanks to 'Which'. E.g: Check.That(_collection).ContainsElementAt(3).Which.IsEqualTo("foo").

* IEnumerable: introduce HasLastElement() which checks for the last item. Furthermore, this item can be checked as well thanks to 'Which'. E.g: Check.That(_collection).ContainsElementAt(3).Which.IsEqualTo("foo").

* IEnumerable: introduce HasOneElementOnly() which checks for the first and single item. Furthermore, this item can be checked as well thanks to 'Which'. E.g: Check.That(_collection).ContainsElementAt(3).Which.IsEqualTo("foo").

* IEnumerable: introduce HasElementThatMatches( bool predicate()) which checks that an enumerable has at least on item matching the given predicate. You can use 'Which' to check further this item. E.g.: Check.That(_collection).HasItemThatMatches((_) => _.StartWith("foo")).Which.IsEqualTo("foobar").

* IDictionary<K,V>: now explicitely supported.

* IDictionary<K,V>: introduce ContainsEntry<K, V>(K key, V value) which checks that a dictionary contains a specific value for a given key.

* Hashtable: now explicitely supported.

--------------

Change(s):

* IEnumerable: improved description within error messages: partial dump around first difference for large sets

* IDictionnary: no longer supported. Hashtable is supported instead

* Numbers: introduce IsStrictlyPositive() as a substitute for IsPositive() which is now obsolete.

* Numbers: introduce IsStrictlyNegative() as a substitute for IsNegative() which is now obsolete.

* Numbers: introduce IsStrictlyGreaterThan() as a substitute for IsGreaterThan() which is now obsolete.

* Numbers: introduce IsStrictlyLessThan() as a substitute for IsLessThan() which is now obsolete.

* Floating Numbers: introduce IsCloseTo() to check if a number is close to another one.

* Check.ThatCode(...).Throws<T>() now requires T to be an exception. This restriction ensures only Exceptions are proposed in autocompletion.

* Improve error messages (consistency and relevance).

* Strings: generate specific error message using IsEqualTo() when the actual string is empty

* Strings: generate specific error message using IsEqualTo() when the expected string is empty

* Strings: provides part of string where first difference occurs even when strings have different lenghts

* Objects: IsSameReferenceAs supersede IsSameReferenceThan (now flagged as obsolete)

* Objects: Dump hascodes only when NFluent cannot highligth difference.

* Check.That(Action) can no longer be used (error, obsolete)

* Check.That(Func<T>) can no longer be used (error, obsolete)

* Simplify the way you can extend NFluent by adding your own checks. Now, you can call: var checker = ExtensibilityHelper.ExtractChecker(check);

at the beginning of your check extension method, and then rely on its ExecuteCheck() or BuildMessage() helper methods to do the job. Note: the Checker is part of the NFluent.Extensibility namespace.

* Reviewing of public elements: Some classes are no longer public. They should never have been in the first case.

* Signature of ILambdaExceptionCheck has been updated to refer the checked exception type (instead of RunTrace). This is a breaking change for edge cases, that will impact your extension method on exceptions, if any; it can also impact your tests if you use the explicit signature.

--------------

Bug Fixe(s):

* Fix the inversion between expected and actual error message for the .WithMessage checks on exception.

* Fix the issue with null value on Check.That(...).IsBefore(...)

* HasFieldsWithSameValues now recurse along the hierarchy class (Fix for #141)

* Fix stack overflow triggered by HasFieldsWithSameValues() on object with reference loop (#148)

* Properly escaped strings when generating error messages.

* GitHub issues: #124, #133, #141, #148, #153, #154, #156, #159, #164, #165, #167, #174, #177, #178, #179, #187

Owners

Authors

Thomas PIERRAIN, Cyrille DUPUYDAUBY, Rui CARVALHO, Marc-Antoine LATOUR

Copyright

Copyright 2014-2017 Thomas PIERRAIN, Cyrille Dupuydauby

Tags

Dependencies

This package has no dependencies.

Version History

Version Downloads Last updated
NFluent, smooth... 2.0.0-alpha-44 311 Wednesday, May 10, 2017
NFluent, smooth... 2.0.0-alpha 1,663 Thursday, September 22, 2016
NFluent, smooth... 1.3.1 83,837 Monday, July 28, 2014
NFluent, smooth... 1.2.0 3,107 Monday, June 16, 2014
NFluent, smooth... 1.1.0 2,545 Friday, February 14, 2014
Smooth your .NET... 1.0.0 875 Tuesday, December 31, 2013
Smooth your .NET... 0.11.0 425 Tuesday, November 26, 2013
Smooth your .NET... 0.9.0 590 Tuesday, August 6, 2013
Smooth your .NET... 0.8.0 298 Saturday, July 6, 2013
Smooth your .NET... 0.7.0 261 Tuesday, June 4, 2013
Smooth your .NET... 0.6.0 232 Sunday, May 19, 2013
Smooth your .NET... 0.5.0 279 Sunday, April 21, 2013