NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet
NuGet, #1464 most downloaded on NuGet
A fork of FluentAssertions.
Latest stable
9.6.0
Last release 3 months ago
20 Aug 2026
Release timing varies
gaps range from 9 days to 5 months
Nearly every release is documented
notes for 16 of 16 stable releases
1 version withdrawn
withdrawn after publishing
127 years old
17 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
Fix build due to vulnerabilities in System.Security.Cryptography.Xml by @lg2de in https://github.com/AwesomeAssertions/AwesomeAssertions/pull/548
Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/9.5.0...9.6.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
e3679af
This commit was created on GitHub.com and signed with GitHub’s verified signature .
GPG key ID: B5690EEEBB952194
Verified Learn about vigilant mode .
Enable adding reportables to AssertionScope by @cbersch in #551
Add option ExcludingObsoleteMembers for structural comparison by @lg2de in #558
Fix duplicate matching rules by @lg2de in #566
Remove obsolete information from FailReason description by @cbersch in #589
fix: upper and lower case issue by @aco-mreble in #591
Extend design guidelines for API changes by @lg2de in #547
Add documentation to all public API by @lg2de in #556
Fix build due to vulnerabilities in System.Security.Cryptography.Xml by @lg2de in #548
Enable renovate updates for the Build project (Fallout) by @lg2de in #549
Use ignored temp directory for npm by @cbersch in #554
Fix navigation link to new assertion scopes doc by @cbersch in #555
Fixes visibility of some members by @lg2de in #557
Cleanup Build and Renovate by @lg2de in #564
Remove obsolete warning suppressions by @lg2de in #608
Code cleanup on CollectionAssertionSpecs by @lg2de in #609
Calculate NuGet version only when packaging is enabled by @lg2de in #611
Enable automatic upgrade for all build project packages by @cbersch in #550
Fix verify settings while updating Verify.DiffPlex to 3.3.1 by @lg2de in #586
Fix test adapter updates by @cbersch in #588
Fix package updates of MTP by @lg2de in #606
Upgrade NUnit 4.x and NUnit3TestAdapter 6.x by @cbersch in #587
Remove obsolete reference to System.Reflection.Metadata by @lg2de in #607
Update to Fallout 10.4.0 by @lg2de in #594
Update actions/setup-dotnet action to v6 by @renovate [bot] in #569
Update dependency LibGit2Sharp to 0.32.0 by @renovate [bot] in #563
Update dependency Meziantou.Analyzer to 3.0.163 by @renovate [bot] in #612
Update dependency Microsoft.NET.Test.Sdk to 18.9.0 by @renovate [bot] in #614
Update dependency Microsoft.Testing.Extensions.CodeCoverage to 18.9.0 by @renovate [bot] in #583
Update dependency Microsoft.Testing.Extensions.TrxReport to 2.3.3 by @renovate [bot] in #577
Update mstest monorepo to 4.3.3 by @renovate [bot] in #601
Update dependency Nuget.Packaging to 7.6.0 by @renovate [bot] in #578
Update dependency Reflectify to 1.10.0 by @renovate [bot] in #615
Update dependency Roslynator.Analyzers to 4.16.1 by @renovate [bot] in #613
Update dependency SharpCompress to 0.50.4 by @renovate [bot] in #596
Update dependency TUnit to 1.63.0 by @renovate [bot] in #579
Update dependency Verify.XunitV3 to 31.28.0 by @renovate [bot] in #580
Full Changelog : 9.5.0...9.6.0
renovate, cbersch, and 2 other contributors
AssertionScope.AddReportable to add custom reportable information to the current scope - #551AssertionChain.WithReportable overloads - #551ExcludingObsoleteMembers to SelfReferenceEquivalencyOptions allowing obsolete members to be ignored in structural comparison - #558
IEquivalencyOptions has been marked as "technically public" and not part of the public API.NotBeUpperCased and NotBeLowerCased for all lower-/uppercase strings - #591AssertionChain.AddReportable in favor of AssertionChain.WithReportable to get a more consistent fluent API for chaining - #551<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
GivenSelector<T>.FailWith() to match AssertionChain.FailWith() by @JakenVeina in https://github.com/AwesomeAssertions/AwesomeAssertions/pull/522Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/9.4.0...9.5.0
[Not]BeDecoratedWith for ParameterInfo - #449AssertionChain.ForCondition() that allows for lazy execution of condition - #511AndWhichConstraint from IntersectWith - #495AndWhichConstraint from XElementAssertions.HaveAttribute - #504GivenSelector<T>.FailWith arguments only upon failure - #522<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/9.3.0...9.4.0
EqualApproximately for collections of INumber<T> - #413[return: NotNull to all Should() and assertion methods - #433[NotNull] attribute on the Should() methods for nullable value types - #411StringSyntaxAttribute to the because parameter of several assertions - #404LifeCycle.InstancePerTestCase with Microsoft.Testing.Platform - #362AssertionScope - #393<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/9.2.1...9.3.0
ExcludingMembersNamed to BeEquivalentTo's options which enables excluding members with specified name - #317string null subject - #314<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/9.2.0...9.2.1
StartWith and EndWith string assertions - #225<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
[!CAUTION] This version is not recommended due to the following issue: https://github.com/AwesomeAssertions/AwesomeAssertions/issues/309
Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/9.1.0...9.2.0
Contain to assert the occurrences - #238<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
BeParsableInto<T> and NotBeParsableInto<T> by @ITaluone in https://github.com/AwesomeAssertions/AwesomeAssertions/pull/185Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/9.0.0...9.1.0
[Not]BeParsableInto - #185TypeSelectorAssertions failure messages - #200<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/8.2.0...9.0.0
FluentAssertions to AwesomeAssertions and the assembly name to AwesomeAssertions.dll, see the Migration Guide for more details - #136<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/8.1.0...8.2.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/8.1.0...8.2.0
HaveProperty to TypeAssertions which only takes the property name - #142[CustomAssertions] attribute - #118That[DoNot]HaveAccessModifier method for filtering types - #143AssertionChain that assertion classes were initialized with - #138
DateTimeOffsetRangeAssertionsDateTimeRangeAssertionsExecutionTimeAssertionsMethodInfoSelectorAssertionsPropertyInfoSelectorAssertionsTaskCompletionSourceAssertions<!-- Release notes generated using configuration in .github/release.yml at 8.1.0 -->
<!-- Release notes generated using configuration in .github/release.yml at 8.1.0 -->
ForConstraint to GivenSelector<T> by @ITaluone in https://github.com/AwesomeAssertions/AwesomeAssertions/pull/44StringEqualityStrategy to between 45 and 60 characters by @vbreuss in https://github.com/AwesomeAssertions/AwesomeAssertions/pull/94StringEqualityStrategy configurable by @vbreuss in https://github.com/AwesomeAssertions/AwesomeAssertions/pull/100null check by @cbersch in https://github.com/AwesomeAssertions/AwesomeAssertions/pull/93Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/8.0.2...8.1.0
ForConstraint to GivenSelector<T> allowing further chaining after .Then - #44StringEqualityStrategy configurable - #100StringEqualityStrategy - #94Type formatting - #78AssertionChain that assertion classes were initialized with - #115
BooleanAssertionsDateOnlyAssertionsDateTimeAssertionsDateTimeOffsetAssertionsEnumAssertionsGuidAssertionsSimpleTimeSpanAssertionsTimeOnlyAssertionsTypeSelectorAssertions<!-- Release notes generated using configuration in .github/release.yml at 8.0.2 -->
<!-- Release notes generated using configuration in .github/release.yml at 8.0.2 -->
Task was treated as a failure in CompleteWithinAsync by @ScarletKuro in https://github.com/AwesomeAssertions/AwesomeAssertions/commit/b9cef9185f19d65228be59b0e3a1a3f6abfb8ef4Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/8.0.1...8.0.2
{} inside or as a Dictionary key - #24Task was treated as a failure in CompleteWithinAsync - b9cef9184BeEquivalentTo only gives one diff after a preceding successful assertion - #74chore: add Company and Product metadata to FluentAssertions.csproj by @jcfnomada in https://github.com/AwesomeAssertions/AwesomeAssertions/pull/30
Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/8.0.0...8.0.1
<!-- Release notes generated using configuration in .github/release.yml at 8.0.0 -->
<!-- Release notes generated using configuration in .github/release.yml at 8.0.0 -->
No technical changes—just a branding update and the promotion of the last release candidate to a stable release.
Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/8.0.0-rc.3...8.0.0
NotBeIn to check if a DateTime is not in a given DateTimeKind - #2536Satisfy method available to all reference types to allow for nested assertions - #2597BeNaN and NotBeNaN for assertions on float and double - #2606IValueFormatters to a (nested) AssertionScope - #2676XElement - #2690
[Not]HaveElementWithValueNotHaveElement[Not]HaveAttributeNotHaveAttributeWithValueXDocument - #2690
[Not]HaveElementWithValueNotHaveElementEquivalencyOptions in string assertions - #2413
BeEquivalentTo on object graphs or collections.[CustomAssertionsAssembly] attribute - #2389Should() methods on reference types are now annotated with the [NotNull] attribute for a better Awesome Assertions experience when nullable reference types are enabled - #2380.Which construct will now amend the caller identifier - #2539MethodInfoFormatter and improved the PropertyInfoFormatter - #2539Excluding() / For().Exclude() and Including() on BeEquivalentTo() now also accepts an anonymous object to include/exclude multiple members at once - #2488BeEquivalentTo via ExcludingExplicitlyImplementedProperties - #2851RaisePropertyChangeFor to return a filtered list of events - #2677WithMapping was used in BeEquivalentTo - #2860WithStrictOrderingFor(x => x) with BeEquivalentTo - #2932DataSet, DataTable, DataRow and DataColumn into a new package FluentAssertions.DataSet - #2267...OrEqualTo methods - #2269
GenericCollectionAssertions
HaveCountGreaterOrEqualTo: Use HaveCountGreaterThanOrEqualToHaveCountLessOrEqualTo: Use HaveCountLessThanOrEqualToComparableTypeAssertions
BeGreaterOrEqualTo: Use BeGreaterThanOrEqualToBeLessOrEqualTo: Use BeLessThanOrEqualToSimpleTimeSpanAssertions
BeGreaterOrEqualTo: Use BeGreaterThanOrEqualToBeLessOrEqualTo: Use BeLessThanOrEqualToExecutionTimeAssertions
BeGreaterOrEqualTo: Use BeGreaterThanOrEqualToBeLessOrEqualTo: Use BeLessThanOrEqualToDefaultValueFormatter.SpacesPerIndentionLevel property which was added during the development of v6, but wasn't removed before the release of v6 - #2281AllSatisfy now succeeds when asserting that an empty collection satisfies some predicates - #2321OnlyContain now succeeds when asserting that an empty collection matches some predicates - #2350BinaryFormatter - #2278EquivalencyAssertionOptions to EquivalencyOptionsEquivalencyAssertionOptions<TExpectation> to EquivalencyOptions<TExpectation>IEquivalencyAssertionOptions to IEquivalencyOptionsSelfReferenceEquivalencyAssertionOptions<TSelf> to SelfReferenceEquivalencyOptions<TSelf>WithoutMatchingRules and WithoutSelectionRules while using BeEquivalentTo - #2457utcNow overload for .Monitor<T>() - #2629BeLowerCased/BeUpperCased have been changed to align with the behavior of ToLower/ToUpper - #2660HaveAttribute to HaveAttributeWithValue on XElement - #2690RespectingRuntimeTypes to PreferringRuntimeMemberTypes and RespectingDeclaredTypes to PreferringDeclaredMemberTypes - #2866ExcludingNestedObjects to WithoutRecursing to better describe its purpose - #2876HttpResponseMessage. Use FluentAssertions.Web instead. - #2909Configuration and Services into GlobalConfiguration accessible through AssertionEngine.Configuration and AssertionConfiguration.Current.Configuration - #2901app.config file - #2901ForConstraint to IAssertionsScope to support chaining .ForConstraint() after .Then - #2324AsyncFunctionAssertions into real base class - #2359
protected.GenericAsyncFunctionAssertions has been moved to NonGenericAsyncFunctionAssertions.NotThrow and NotThrowAfter from DelegateAssertions<TDelegate, TAssertions> to ActionAssertions - #2371EquivalencyValidator internal - #2854<!-- Release notes generated using configuration in .github/release.yml at 7.2.1 -->
<!-- Release notes generated using configuration in .github/release.yml at 7.2.1 -->
Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/7.2.0...7.2.1
<!-- Release notes generated using configuration in .github/release.yml at 7.2.0 -->
<!-- Release notes generated using configuration in .github/release.yml at 7.2.0 -->
Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/7.1.0...7.2.0
<!-- Release notes generated using configuration in .github/release.yml at 7.1.0 -->
<!-- Release notes generated using configuration in .github/release.yml at 7.1.0 -->
Full Changelog: https://github.com/AwesomeAssertions/AwesomeAssertions/compare/7.0.0...7.1.0
This is the first release of AwesomeAssertions.
This is the first release of AwesomeAssertions.
dotnet add package AwesomeAssertions --version 7.0.0
Full Changelog: https://github.com/meenzen/AwesomeAssertions/commits/7.0.0
BeEquivalentTo where write-only properties would cause a NullReferenceException - #2836One column per quarter.