.NET 8 Build

.config/dotnet-tools.json

@@ -3,7 +3,7 @@
   "isRoot": true,
   "tools": {
     "sign": {
-      "version": "0.9.1-beta.23356.1",
+      "version": "0.9.1-beta.23530.1",
       "commands": [
         "sign"
       ]

.devcontainer/Dockerfile

@@ -1,5 +1,5 @@
 # See here for image contents: https://github.com/microsoft/vscode-dev-containers/tree/v0.177.0/containers/dotnet/.devcontainer/base.Dockerfile
 
 # [Choice] .NET version: 7.0, 6.0, 5.0
-ARG VARIANT="6.0"
+ARG VARIANT="8.0"
 FROM mcr.microsoft.com/vscode/devcontainers/dotnet

.devcontainer/devcontainer.json

@@ -20,7 +20,7 @@
   "remoteEnv": {
     "PATH": "${containerWorkspaceFolder}/.dotnet:${containerEnv:PATH}",
     "DOTNET_MULTILEVEL_LOOKUP": "0",
-    "TARGET": "net6.0",
+    "TARGET": "net8.0",
     "DOTNET_WATCH_SUPPRESS_LAUNCH_BROWSER": "true"
   },
   // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root.

.editorconfig

@@ -6,6 +6,8 @@ root = true
 # don't use tabs for indentation
 [*]
 indent_style = space
+vsspell_section_id = 41b65011239a40959ccaae2a4ec7044a
+vsspell_ignored_words_41b65011239a40959ccaae2a4ec7044a = Accessor|app|clr|Edm|inline|middleware|Mvc|odata|Validator|Deconstruct
 
 # code files
 [*.{cs,csx,vb,vbx}]
@@ -88,8 +90,8 @@ csharp_space_between_method_declaration_parameter_list_parentheses = true
 csharp_space_between_method_call_parameter_list_parentheses = true
 csharp_space_between_parentheses = control_flow_statements, expressions
 
-# ide code suppressions
-# dotnet_diagnostic.IDE0079.severity = none
+# primary construcrtors
+csharp_style_prefer_primary_constructors = false:none
 
 # style code suppressions
 dotnet_diagnostic.SA1002.severity = none
@@ -110,6 +112,13 @@ dotnet_diagnostic.SA1502.severity = none
 dotnet_diagnostic.SA1516.severity = none
 dotnet_diagnostic.SA1600.severity = none
 
+# TEMP: currently suppressed rules due to false positives
+# REF: https://github.com/DotNetAnalyzers/StyleCopAnalyzers/issues/3687
+# REF: https://github.com/dotnet/aspnetcore/issues/52556
+dotnet_diagnostic.SA1010.severity = none # Opening square brackets should be spaced correctly
+dotnet_diagnostic.ASP0022.severity = none # Route conflict detected between route handlers
+dotnet_diagnostic.ASP0023.severity = none # Route conflict detected between route handlers
+
 # test settings
 
 # Default severity for analyzer diagnostics with category 'Reliability'
@@ -128,6 +137,7 @@ dotnet_diagnostic.CA1707.severity = none
 dotnet_diagnostic.CA1711.severity = none
 dotnet_diagnostic.CA1716.severity = none
 dotnet_diagnostic.CA1806.severity = none
+dotnet_diagnostic.CA1861.severity = none
 dotnet_diagnostic.CA2007.severity = none
 dotnet_diagnostic.CA2234.severity = none
 dotnet_code_quality.CA2000.excluded_symbol_names = HttpRequestMessage|HttpResponseMessage|HttpConfiguration|HttpRouteCollection|HostedHttpRouteCollection|HttpServer|HttpClient
@@ -138,6 +148,13 @@ dotnet_diagnostic.SA1300.severity = none
 dotnet_diagnostic.SA1507.severity = none
 dotnet_diagnostic.SA1601.severity = none
 
+# TEMP: currently suppressed rules due to false positives
+# REF: https://github.com/DotNetAnalyzers/StyleCopAnalyzers/issues/3687
+# REF: https://github.com/dotnet/aspnetcore/issues/52556
+dotnet_diagnostic.SA1010.severity = none # Opening square brackets should be spaced correctly
+dotnet_diagnostic.ASP0022.severity = none # Route conflict detected between route handlers
+dotnet_diagnostic.ASP0023.severity = none # Route conflict detected between route handlers
+
 # test methods should use all lowercase characters
 dotnet_naming_symbols.test_methods.applicable_kinds           = method
 dotnet_naming_symbols.test_methods.applicable_accessibilities = public
@@ -180,4 +197,4 @@ dotnet_naming_style.test_methods.word_separator = _
 
 dotnet_naming_rule.test_methods.style    = test_methods
 dotnet_naming_rule.test_methods.symbols  = test_methods
-dotnet_naming_rule.test_methods.severity = error
+dotnet_naming_rule.test_methods.severity = error

.github/dependabot.yml

@@ -19,7 +19,7 @@ updates:
   # only servicing 5.x release
   - package-ecosystem: "nuget"
     directory: "/"
-    target-branch: "release/5.0"
+    target-branch: "release/5.1"
     schedule:
       interval: "monthly"
     allow:
@@ -29,5 +29,5 @@ updates:
     reviewers:
       - "commonsensesoftware"
     commit-message:
-      prefix: "[release/5.0] "
+      prefix: "[release/5.1] "
       include: scope

.github/workflows/codeql-analysis.yml

@@ -31,7 +31,7 @@ jobs:
       uses: actions/setup-dotnet@v3
       id: installdotnet
       with:
-        dotnet-version: 7.0.x
+        dotnet-version: 8.0.x
 
     - name: Create temporary global.json
       run: echo '{"sdk":{"version":"${{ steps.installdotnet.outputs.dotnet-version }}"}}' > ./global.json

azure-pipelines.yml

@@ -2,6 +2,7 @@ trigger:
   branches:
     include:
     - main
+    - release/*
   paths:
     exclude:
     - .config
@@ -16,6 +17,7 @@ trigger:
 
 pr:
 - main
+- release/*
 
 # build at least once a month so the build badge is up-to-date
 schedules:

build/test.targets

@@ -3,7 +3,7 @@
 
  <PropertyGroup>
   <FluentAssertionsVersion>6.8.0</FluentAssertionsVersion>
-  
+
   <!--
    beware of other versions that may contain SponsorLink
    REF: https://github.com/moq/moq/issues/1372
@@ -27,7 +27,7 @@
  </ItemGroup>
 
  <ItemGroup Condition=" '$(IsAspNetCore)' == 'true' ">
-  <PackageReference Include="Microsoft.AspNetCore.TestHost" Version="7.0.10" />
+  <PackageReference Include="Microsoft.AspNetCore.TestHost" Version="$(DotNetReleaseBasePackageVersion)" />
  </ItemGroup>
 
  <ItemGroup>

examples/AspNet/OData/SomeOpenApiODataWebApiExample/BooksController.cs

@@ -14,15 +14,15 @@
 [RoutePrefix( "api/books" )]
 public class BooksController : ApiController
 {
-    private static readonly Book[] books = new Book[]
-    {
+    private static readonly Book[] books =
+    [
         new() { Id = "9781847490599", Title = "Anna Karenina", Author = "Leo Tolstoy", Published = 1878 },
         new() { Id = "9780198800545", Title = "War and Peace", Author = "Leo Tolstoy", Published = 1869 },
         new() { Id = "9780684801520", Title = "The Great Gatsby", Author = "F. Scott Fitzgerald", Published = 1925 },
         new() { Id = "9780486280615", Title = "The Adventures of Huckleberry Finn", Author = "Mark Twain", Published = 1884 },
         new() { Id = "9780140430820", Title = "Moby Dick", Author = "Herman Melville", Published = 1851 },
         new() { Id = "9780060934347", Title = "Don Quixote", Author = "Miguel de Cervantes", Published = 1605 },
-    };
+    ];
 
     /// <summary>
     /// Gets all books.

examples/AspNetCore/Directory.Build.props

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+
+ <Import Project="$([MSBuild]::GetPathOfFileAbove('$(MSBuildThisFile)','$(MSBuildThisFileDirectory)../'))" />
+
+ <PropertyGroup>
+  <TargetFramework>net8.0</TargetFramework>
+ </PropertyGroup>
+
+</Project>

examples/AspNetCore/OData/Directory.Build.props

@@ -1,11 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
 
- <Import Project="$([MSBuild]::GetPathOfFileAbove('$(MSBuildThisFile)','$(MSBuildThisFileDirectory)../'))"
-         Condition="Exists($([MSBuild]::GetPathOfFileAbove('$(MSBuildThisFile)','$(MSBuildThisFileDirectory)../')))"/>
+ <Import Project="$([MSBuild]::GetPathOfFileAbove('$(MSBuildThisFile)','$(MSBuildThisFileDirectory)../'))" />
 
  <ItemGroup>
-  <PackageReference Include="Microsoft.AspNetCore.OData" Version="8.0.11" />
+  <PackageReference Include="Microsoft.AspNetCore.OData" Version="8.2.3" />
  </ItemGroup>
 
 </Project>

examples/AspNetCore/OData/ODataAdvancedExample/ODataAdvancedExample.csproj

@@ -1,9 +1,5 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
- <PropertyGroup>
-  <TargetFramework>net7.0</TargetFramework>
- </PropertyGroup>
-
  <ItemGroup>
   <ProjectReference Include="..\..\..\..\src\AspNetCore\OData\src\Asp.Versioning.OData\Asp.Versioning.OData.csproj" />
  </ItemGroup>

examples/AspNetCore/OData/ODataBasicExample/ODataBasicExample.csproj

@@ -1,9 +1,5 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
- <PropertyGroup>
-  <TargetFramework>net7.0</TargetFramework>
- </PropertyGroup>
-
  <ItemGroup>
    <ProjectReference Include="..\..\..\..\src\AspNetCore\OData\src\Asp.Versioning.OData\Asp.Versioning.OData.csproj" />
  </ItemGroup>

examples/AspNetCore/OData/ODataConventionsExample/ODataConventionsExample.csproj

@@ -1,9 +1,5 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
- <PropertyGroup>
-  <TargetFramework>net7.0</TargetFramework>
- </PropertyGroup>
-
  <ItemGroup>
   <ProjectReference Include="..\..\..\..\src\AspNetCore\OData\src\Asp.Versioning.OData\Asp.Versioning.OData.csproj" />
  </ItemGroup>

examples/AspNetCore/OData/ODataOpenApiExample/ODataOpenApiExample.csproj

@@ -1,16 +1,15 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
  <PropertyGroup>
-  <TargetFramework>net7.0</TargetFramework>
   <GenerateDocumentationFile>true</GenerateDocumentationFile>
  </PropertyGroup>
 
  <ItemGroup>
-  <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0-*" />
+  <PackageReference Include="Swashbuckle.AspNetCore" Version="6.5.0-*" />
  </ItemGroup>
 
  <ItemGroup>
    <ProjectReference Include="..\..\..\..\src\AspNetCore\OData\src\Asp.Versioning.OData.ApiExplorer\Asp.Versioning.OData.ApiExplorer.csproj" />
  </ItemGroup>
- 
+
 </Project>

examples/AspNetCore/OData/SomeODataOpenApiExample/BooksController.cs

@@ -13,15 +13,15 @@
 [Route( "api/[controller]" )]
 public class BooksController : ControllerBase
 {
-    private static readonly Book[] books = new Book[]
-    {
+    private static readonly Book[] books =
+    [
         new() { Id = "9781847490599", Title = "Anna Karenina", Author = "Leo Tolstoy", Published = 1878 },
         new() { Id = "9780198800545", Title = "War and Peace", Author = "Leo Tolstoy", Published = 1869 },
         new() { Id = "9780684801520", Title = "The Great Gatsby", Author = "F. Scott Fitzgerald", Published = 1925 },
         new() { Id = "9780486280615", Title = "The Adventures of Huckleberry Finn", Author = "Mark Twain", Published = 1884 },
         new() { Id = "9780140430820", Title = "Moby Dick", Author = "Herman Melville", Published = 1851 },
         new() { Id = "9780060934347", Title = "Don Quixote", Author = "Miguel de Cervantes", Published = 1605 },
-    };
+    ];
 
     /// <summary>
     /// Gets all books.

examples/AspNetCore/OData/SomeODataOpenApiExample/SomeODataOpenApiExample.csproj

@@ -1,16 +1,15 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
  <PropertyGroup>
-  <TargetFramework>net7.0</TargetFramework>
   <GenerateDocumentationFile>true</GenerateDocumentationFile>
  </PropertyGroup>
 
  <ItemGroup>
-  <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0-*" />
+  <PackageReference Include="Swashbuckle.AspNetCore" Version="6.5.0-*" />
  </ItemGroup>
 
  <ItemGroup>
    <ProjectReference Include="..\..\..\..\src\AspNetCore\OData\src\Asp.Versioning.OData.ApiExplorer\Asp.Versioning.OData.ApiExplorer.csproj" />
  </ItemGroup>
- 
+
 </Project>

examples/AspNetCore/WebApi/BasicExample/BasicExample.csproj

@@ -1,9 +1,5 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
- <PropertyGroup>
-  <TargetFramework>net7.0</TargetFramework>
- </PropertyGroup>
-
  <ItemGroup>
    <ProjectReference Include="..\..\..\..\src\AspNetCore\WebApi\src\Asp.Versioning.Mvc\Asp.Versioning.Mvc.csproj" />
  </ItemGroup>

examples/AspNetCore/WebApi/ByNamespaceExample/ByNamespaceExample.csproj

@@ -1,9 +1,5 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
- <PropertyGroup>
-  <TargetFramework>net7.0</TargetFramework>
- </PropertyGroup>
-
  <ItemGroup>
    <ProjectReference Include="..\..\..\..\src\AspNetCore\WebApi\src\Asp.Versioning.Mvc\Asp.Versioning.Mvc.csproj" />
  </ItemGroup>

examples/AspNetCore/WebApi/ConventionsExample/ConventionsExample.csproj

@@ -1,9 +1,5 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
- <PropertyGroup>
-  <TargetFramework>net7.0</TargetFramework>
- </PropertyGroup>
-
  <ItemGroup>
    <ProjectReference Include="..\..\..\..\src\AspNetCore\WebApi\src\Asp.Versioning.Mvc\Asp.Versioning.Mvc.csproj" />
  </ItemGroup>

examples/AspNetCore/WebApi/MinimalApiExample/MinimalApiExample.csproj

@@ -1,7 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
  <PropertyGroup>
-  <TargetFramework>net7.0</TargetFramework>
   <Nullable>enable</Nullable>
  </PropertyGroup>
 

examples/AspNetCore/WebApi/MinimalOpenApiExample/MinimalOpenApiExample.csproj

@@ -1,11 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
- <PropertyGroup>
-  <TargetFramework>net7.0</TargetFramework>
- </PropertyGroup>
-
  <ItemGroup>
-  <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0-*" />
+  <PackageReference Include="Swashbuckle.AspNetCore" Version="6.5.0-*" />
  </ItemGroup>
 
  <ItemGroup>

examples/AspNetCore/WebApi/OpenApiExample/OpenApiExample.csproj

@@ -1,12 +1,11 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
  <PropertyGroup>
-  <TargetFramework>net7.0</TargetFramework>
   <GenerateDocumentationFile>true</GenerateDocumentationFile>
  </PropertyGroup>
 
  <ItemGroup>
-  <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0-*" />
+  <PackageReference Include="Swashbuckle.AspNetCore" Version="6.5.0-*" />
  </ItemGroup>
 
  <ItemGroup>

src/Abstractions/src/Asp.Versioning.Abstractions/AmbiguousApiVersionException.cs

@@ -12,22 +12,22 @@ public partial class AmbiguousApiVersionException : Exception
     /// <summary>
     /// Initializes a new instance of the <see cref="AmbiguousApiVersionException"/> class.
     /// </summary>
-    public AmbiguousApiVersionException() => apiVersions = Array.Empty<string>();
+    public AmbiguousApiVersionException() => apiVersions = [];
 
     /// <summary>
     /// Initializes a new instance of the <see cref="AmbiguousApiVersionException"/> class.
     /// </summary>
     /// <param name="message">The associated error message.</param>
     public AmbiguousApiVersionException( string message )
-        : base( message ) => apiVersions = Array.Empty<string>();
+        : base( message ) => apiVersions = [];
 
     /// <summary>
     /// Initializes a new instance of the <see cref="AmbiguousApiVersionException"/> class.
     /// </summary>
     /// <param name="message">The associated error message.</param>
     /// <param name="innerException">The inner <see cref="Exception">exception</see> that caused the current exception, if any.</param>
     public AmbiguousApiVersionException( string message, Exception innerException )
-        : base( message, innerException ) => apiVersions = Array.Empty<string>();
+        : base( message, innerException ) => apiVersions = [];
 
     /// <summary>
     /// Initializes a new instance of the <see cref="AmbiguousApiVersionException"/> class.