MathAssertions 0.0.1

Prefix Reserved
.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package MathAssertions --version 0.0.1
                    


                    

                
NuGet\Install-Package MathAssertions -Version 0.0.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="MathAssertions" Version="0.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="MathAssertions" Version="0.0.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="MathAssertions" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add MathAssertions --version 0.0.1
                    


                    

                
#r "nuget: MathAssertions, 0.0.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package MathAssertions@0.0.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=MathAssertions&version=0.0.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=MathAssertions&version=0.0.1
                    


                            Install as a Cake Tool

MathAssertions

NuGet License: MIT .NET

Scope: Test projects only. Not intended for production code.

Framework-agnostic core for the MathAssertions package family. The actual TUnit fluent assertions ship in the framework-specific adapter package (currently MathAssertions.TUnit).

Most users want MathAssertions.TUnit, not this package directly. This package only ships the shared MathTolerance helpers; the adapter package adds the assertion entry points your test framework expects.

What's in this package (v0.0.1)

MathTolerance static class with pure, NaN-aware, infinity-aware tolerance-comparison helpers:

  • IsApproximatelyEqual(double, double, double)
  • IsApproximatelyEqual(float, float, float)
  • IsApproximatelyEqual(Vector3, Vector3, double) (component-wise; components widen to double so a tight double tolerance is honored at full precision)

All helpers reject NaN and negative tolerance via ArgumentOutOfRangeException.

What lands at v0.1.0

Vector2 / Vector4 component-wise; Quaternion component-wise plus rotational equivalence (handling the q / -q double-cover); Matrix4x4 element-wise; Plane component-wise plus geometric equivalence; Complex; span overloads; statistics (mean, median, variance, percentile); linear-algebra invariants; number theory; 3D geometry primitives plus intersection / containment / pointcloud assertions.

Test-framework adapters

Package Test framework Status
MathAssertions.TUnit TUnit Available now
MathAssertions.NUnit NUnit Possible if there is demand
MathAssertions.xUnit xUnit Possible if there is demand
MathAssertions.MSTest MSTest Possible if there is demand

If you'd find a non-TUnit adapter useful, open a feature request. Adapters are not built proactively.

When to install this package directly

Only when authoring a non-TUnit adapter for the assertion family, or when calling MathTolerance from a [GenerateAssertion] extension on a private type. For any TUnit testing use case, install MathAssertions.TUnit.

Installation

dotnet add package MathAssertions.TUnit

MathAssertions comes transitively. You don't need to install it directly unless you're building your own adapter package.

Stability

The public surface above is semver-bound. Breaking changes require a major version bump. The exact text of any future failure-message rendering produced inside MathTolerance is not stable and may gain extra detail or change formatting in any release.

Repository

github.com/JohnVerheij/MathAssertions.TUnit for the full README, design notes, and roadmap.

License

MIT. Copyright (c) 2026 John Verheij.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • net10.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on MathAssertions:

Package Downloads
MathAssertions.TUnit

TUnit-native math assertions for .NET tests. Fluent .Method(...) entry points (generated via TUnit's [GenerateAssertion]) covering tolerance comparisons (scalar, vector, quaternion, matrix, plane, complex, double[]/float[]), sequences, statistics, Vector3 linear algebra, long-integer number theory, and the Geometry3D primitive surface (containment, distance, intersection, pointcloud aggregates). Extensible: consumers add tolerance assertions for their own domain types via [GenerateAssertion] extensions calling MathTolerance helpers. AOT-compatible, trimmable, no reflection.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.3.0 167 5/14/2026
0.2.0 203 5/12/2026
0.1.0 146 5/9/2026
0.0.1 130 5/8/2026

See CHANGELOG.md