Updating the entire solution to include .NET 10 as a compile target.

* Updated GitHub Actions steps (`checkout` and `setup-dotnet`) to v5, `sdk.version` in `global.json` to `10.0.x`, and `TargetFrameworks` to include `net10.0`.
* Fixed breaking code changes as a result of .NET 10 relating to implicit conversion.
* Refactored tests to use xUnit v3 and Microsoft Test Platform.
* Reviewed and converted many of the extension methods to .NET 10 extension blocks.
* Scoped preconditions to their associated exceptions, and added attributes such as `NotNull`, and `CallerArgumentExpression`.
* Eliminated some code due to implicit span conversion.
* Updated lots of XMLDoc documentation, providing enhanced clarity.

Author: MrMatthewLayton

.github/workflows/dotnet.yml

@@ -11,21 +11,26 @@ on:
 
 env:
   USE_FULL_NUMERIC_PROVIDER: "true"
+  MSBUILDDISABLENODEREUSE: "1"
 
 jobs:
   build:
 
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
     - name: Setup .NET
-      uses: actions/setup-dotnet@v4
+      uses: actions/setup-dotnet@v5
       with:
         global-json-file: global.json
     - name: Restore dependencies
       run: dotnet restore
     - name: Build
       run: dotnet build --no-restore
-    - name: Test
-      run: dotnet test --no-build --verbosity normal
+    - name: Test (.NET 8.0)
+      run: dotnet test --no-build --framework net8.0 --verbosity quiet
+    - name: Test (.NET 9.0)
+      run: dotnet test --no-build --framework net9.0 --verbosity quiet
+    - name: Test (.NET 10.0)
+      run: dotnet test --no-build --framework net10.0 --verbosity quiet

Directory.Build.props

@@ -2,11 +2,11 @@
 
     <!--GLOBAL-->
     <PropertyGroup>
-        <Version>12.2.0</Version>
-        <PackageVersion>12.2.0</PackageVersion>
-        <AssemblyVersion>12.2.0</AssemblyVersion>
-        <TargetFrameworks>net8.0;net9.0</TargetFrameworks>
-        <LangVersion>13</LangVersion>
+        <Version>13.0.0</Version>
+        <PackageVersion>13.0.0</PackageVersion>
+        <AssemblyVersion>13.0.0</AssemblyVersion>
+        <TargetFrameworks>net8.0;net9.0;net10.0</TargetFrameworks>
+        <LangVersion>14</LangVersion>
         <Nullable>enable</Nullable>
         <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
         <Authors>ONIXLabs</Authors>
@@ -41,16 +41,15 @@
 
     <!--UNIT TESTS-->
     <PropertyGroup Condition="$([System.String]::Copy('$(MSBuildProjectName)').EndsWith('.UnitTests'))">
+        <OutputType>Exe</OutputType>
         <IsTestProject>true</IsTestProject>
         <IsPackable>false</IsPackable>
         <GeneratePackageOnBuild>false</GeneratePackageOnBuild>
+        <UseMicrosoftTestingPlatformRunner>true</UseMicrosoftTestingPlatformRunner>
     </PropertyGroup>
 
     <ItemGroup Condition="$([System.String]::Copy('$(MSBuildProjectName)').EndsWith('.UnitTests'))">
-        <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.14.1"/>
-        <PackageReference Include="xunit" Version="2.9.3"/>
-        <PackageReference Include="xunit.runner.visualstudio" Version="2.8.2"/>
-        <PackageReference Include="coverlet.collector" Version="6.0.4"/>
+        <PackageReference Include="xunit.v3" Version="3.2.0"/>
         <Using Include="Xunit"/>
     </ItemGroup>
 
@@ -62,9 +61,14 @@
     </PropertyGroup>
 
     <ItemGroup Condition="$([System.String]::Copy('$(MSBuildProjectName)').EndsWith('.UnitTests.Data'))">
-        <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.14.1"/>
-        <PackageReference Include="xunit" Version="2.9.3"/>
+        <PackageReference Include="xunit.v3.extensibility.core" Version="3.2.0"/>
+        <Using Include="System"/>
+        <Using Include="System.Collections.Generic"/>
+        <Using Include="System.Reflection"/>
+        <Using Include="System.Threading.Tasks"/>
         <Using Include="Xunit"/>
+        <Using Include="Xunit.Sdk"/>
+        <Using Include="Xunit.v3"/>
     </ItemGroup>
 
     <!--PLAYGROUND-->