Dotnet tool support (#213)

* Support .net 8+ for tool install

Author: pm7y

README.md

@@ -13,24 +13,36 @@ A simulator that provides endpoints to mimic the functionality of [Azure Event G
 
 ### .NET Tool (Recommended)
 
-Install as a global .NET tool:
+Requires .NET 8.0 SDK or later. Supports .NET 8.0, 9.0, and 10.0.
 
-```bash
-dotnet tool install -g AzureEventGridSimulator
-```
+#### Global Install
 
-Then run with:
+Install once, use from anywhere:
 
 ```bash
+dotnet tool install -g AzureEventGridSimulator
 azure-eventgrid-simulator
 ```
 
-To update to the latest version:
+To update: `dotnet tool update -g AzureEventGridSimulator`
+
+#### Local Install (Project-level)
+
+Install per-project for team consistency and version control:
 
 ```bash
-dotnet tool update -g AzureEventGridSimulator
+# Create tool manifest if it doesn't exist
+dotnet new tool-manifest
+
+# Install the tool
+dotnet tool install AzureEventGridSimulator
+
+# Run it
+dotnet tool run azure-eventgrid-simulator
 ```
 
+The tool manifest (`.config/dotnet-tools.json`) can be committed to source control. Team members just run `dotnet tool restore` after cloning.
+
 ### Docker
 
 See the [Docker](#docker) section below for running via Docker.

src/AzureEventGridSimulator/AzureEventGridSimulator.csproj

@@ -1,10 +1,15 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
   <PropertyGroup>
+    <!-- Multi-target for .NET Tool compatibility (clears TargetFramework from Directory.Build.props) -->
+    <TargetFramework></TargetFramework>
+    <TargetFrameworks>net8.0;net9.0;net10.0</TargetFrameworks>
     <IsWebConfigTransformDisabled>true</IsWebConfigTransformDisabled>
 
     <!-- .NET Tool packaging -->
     <IsPackable>true</IsPackable>
     <PackAsTool>true</PackAsTool>
+    <RollForward>LatestMinor</RollForward>
+    <TargetLatestRuntimePatch>false</TargetLatestRuntimePatch>
     <ToolCommandName>azure-eventgrid-simulator</ToolCommandName>
     <PackageId>AzureEventGridSimulator</PackageId>
     <PackageOutputPath>./nupkg</PackageOutputPath>

src/AzureEventGridSimulator/Infrastructure/Extensions/KestrelServerOptionsExtensions.cs

@@ -24,10 +24,14 @@ this KestrelServerOptions options
         if (certificateFileSpecified && certificatePasswordSpecified)
         {
             // The certificate file and password was specified.
+#if NET9_0_OR_GREATER
             certificate = X509CertificateLoader.LoadPkcs12FromFile(
                 certificateFile,
                 certificatePassword
             );
+#else
+            certificate = new X509Certificate2(certificateFile, certificatePassword);
+#endif
         }
         else if (certificateFileSpecified && !certificatePasswordSpecified)
         {

src/AzureEventGridSimulator/Infrastructure/Settings/Subscribers/HttpSubscriberSettings.cs

@@ -50,7 +50,9 @@ public class HttpSubscriberSettings : ISubscriberSettings
 
     public Guid GetValidationCode()
     {
-        return new Guid(Encoding.UTF8.GetBytes(Endpoint).Reverse().Take(16).ToArray());
+        return new Guid(
+            Encoding.UTF8.GetBytes(Endpoint).AsEnumerable().Reverse().Take(16).ToArray()
+        );
     }
 
     public void Validate()

src/AzureEventGridSimulator/Infrastructure/Settings/SubscriptionSettings.cs

@@ -44,6 +44,8 @@ public class SubscriptionSettings
 
     public Guid GetValidationCode()
     {
-        return new Guid(Encoding.UTF8.GetBytes(Endpoint).Reverse().Take(16).ToArray());
+        return new Guid(
+            Encoding.UTF8.GetBytes(Endpoint).AsEnumerable().Reverse().Take(16).ToArray()
+        );
     }
 }

src/Directory.Build.props

@@ -17,7 +17,7 @@
   <Target
     Name="CSharpier"
     BeforeTargets="BeforeBuild"
-    Condition="'$(DesignTimeBuild)' != 'true' And '$(MSBuildProjectName)' == 'AzureEventGridSimulator'"
+    Condition="'$(DesignTimeBuild)' != 'true' And '$(MSBuildProjectName)' == 'AzureEventGridSimulator' And '$(TargetFramework)' == 'net10.0'"
   >
     <Exec
       Command="dotnet tool restore"