Digitals.Testing 1.0.0

Digitals.Testing

Digitals.Testing is the whole test stack for a .NET test project in one reference: xunit.v3 on Microsoft.Testing.Platform, NSubstitute, FakeTimeProvider, Microsoft's coverage engine and the TRX reporter. It adds the Digitals test policy, our own DT1#### rules and a coverage gate that fails the run below the floor. It is the test-project companion to Digitals.Analyzers.

Reference it from each test project, and remove the test packages it replaces (xunit.v3, xunit, xunit.runner.visualstudio, Microsoft.NET.Test.Sdk, NSubstitute, Moq, coverlet.collector, coverlet.msbuild, FluentAssertions, Microsoft.Extensions.TimeProvider.Testing, Microsoft.Testing.Extensions.TrxReport). The reference has no Version because it assumes central package management; without it, add Version with the latest from this page:

<ItemGroup>
  <PackageReference Include="Digitals.Testing" />
</ItemGroup>

Select the Microsoft.Testing.Platform runner in global.json at the repo root. Without it, dotnet build fails with DIGT001 and .NET 10's dotnet test refuses to run, since the VSTest route would collect no coverage and never run the gate:

{
  "test": { "runner": "Microsoft.Testing.Platform" }
}

Below a floor, dotnet test fails with the numbers:

Line coverage 82.4% is below the 100.0% floor (416 of 505 covered). Add tests; do not lower the floor.

Each limit is a property (DigitalsMinLineCoverage, DigitalsMinBranchCoverage, DigitalsMaxCrapScore, DigitalsMaxCyclomaticComplexity) and a ratchet: an existing repo sets it once to where it is, beside a comment naming what moves it back, and tightens it from there. DigitalsSkipCoverageGate turns the gate off and keeps the report.

The Testing rules page explains every rule, check and limit, with a failing and a passing example and the message it prints. Moving an existing repo's tests onto the package: the adoption guide.

No PrivateAssets on the reference: the package carries runtime assemblies, and a shared test-utilities library that packs itself needs them to flow on. The package targets net10.0 and later. The bundled packages keep their own licences and reach you as ordinary NuGet dependencies. Release notes are on GitHub Releases.