Guard the public API surface with Verify snapshots (alternative to #530)

Directory.Packages.props

@@ -41,6 +41,7 @@
     <PackageVersion Include="GitHubActionsTestLogger" Version="2.4.1" />
     <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="18.0.1" />
     <PackageVersion Include="NetArchTest.Rules" Version="1.3.2" />
+    <PackageVersion Include="PublicApiGenerator" Version="11.4.6" />
     <!--    <PackageVersion Include="TeamCity.VSTest.TestAdapter" Version="1.0.41" />-->
     <PackageVersion Include="Verify.Xunit" Version="31.7.1" />
     <PackageVersion Include="Verify.DiffPlex" Version="3.1.2" />

fallout.slnx

@@ -46,6 +46,7 @@
   <Project Path="tests\Nuke.Common.Shim.Specs\Nuke.Common.Shim.Specs.csproj" />
   <Project Path="tests\Nuke.Components.Shim.Specs\Nuke.Components.Shim.Specs.csproj" />
   <Project Path="tests\Fallout.ProjectModel.Specs\Fallout.ProjectModel.Specs.csproj" />
+  <Project Path="tests\Fallout.PublicApi.Specs\Fallout.PublicApi.Specs.csproj" />
   <Project Path="tests\Fallout.Solution.Specs\Fallout.Solution.Specs.csproj" />
   <Project Path="tests\Fallout.SourceGenerators.Specs\Fallout.SourceGenerators.Specs.csproj" />
   <Project Path="tests\Benchmarks\Fallout.Persistence.Solution.Benchmarks\Fallout.Persistence.Solution.Benchmarks.csproj" />

src/Fallout.Common/Tools/AzureSignTool/AzureSignTool.Generated.cs

@@ -17,6 +17,7 @@
 namespace Fallout.Common.Tools.AzureSignTool;
 
 /// <summary><p>Azure Sign Tool is similar to <c>signtool</c> in the Windows SDK, with the major difference being that it uses Azure Key Vault for performing the signing process. The usage is like <c>signtool</c>, except with a limited set of options for signing and options for authenticating to Azure Key Vault.</p><p>For more details, visit the <a href="https://github.com/vcsjones/AzureSignTool">official website</a>.</p></summary>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [NuGetTool(Id = PackageId, Executable = PackageExecutable)]
 public partial class AzureSignToolTasks : ToolTasks, IRequireNuGetPackage
@@ -36,6 +37,7 @@ public partial class AzureSignToolTasks : ToolTasks, IRequireNuGetPackage
 }
 #region AzureSignToolSettings
 /// <inheritdoc cref="AzureSignToolTasks.AzureSignTool(Fallout.Common.Tools.AzureSignTool.AzureSignToolSettings)"/>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [Command(Type = typeof(AzureSignToolTasks), Command = nameof(AzureSignToolTasks.AzureSignTool), Arguments = "sign")]
 public partial class AzureSignToolSettings : ToolOptions
@@ -90,6 +92,7 @@ public partial class AzureSignToolSettings : ToolOptions
 #endregion
 #region AzureSignToolSettingsExtensions
 /// <inheritdoc cref="AzureSignToolTasks.AzureSignTool(Fallout.Common.Tools.AzureSignTool.AzureSignToolSettings)"/>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 public static partial class AzureSignToolSettingsExtensions
 {
@@ -375,6 +378,7 @@ public static partial class AzureSignToolSettingsExtensions
 #region AzureSignToolDigestAlgorithm
 /// <summary>Used within <see cref="AzureSignToolTasks"/>.</summary>
 [Serializable]
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [TypeConverter(typeof(TypeConverter<AzureSignToolDigestAlgorithm>))]
 public partial class AzureSignToolDigestAlgorithm : Enumeration

src/Fallout.Common/Tools/BenchmarkDotNet/BenchmarkDotNet.Generated.cs

@@ -17,6 +17,7 @@
 namespace Fallout.Common.Tools.BenchmarkDotNet;
 
 /// <summary><p>Powerful .NET library for benchmarking</p><p>For more details, visit the <a href="https://benchmarkdotnet.org/">official website</a>.</p></summary>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [NuGetTool(Id = PackageId, Executable = PackageExecutable)]
 public partial class BenchmarkDotNetTasks : ToolTasks, IRequireNuGetPackage
@@ -36,6 +37,7 @@ public partial class BenchmarkDotNetTasks : ToolTasks, IRequireNuGetPackage
 }
 #region BenchmarkDotNetSettings
 /// <inheritdoc cref="BenchmarkDotNetTasks.BenchmarkDotNet(Fallout.Common.Tools.BenchmarkDotNet.BenchmarkDotNetSettings)"/>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [Command(Type = typeof(BenchmarkDotNetTasks), Command = nameof(BenchmarkDotNetTasks.BenchmarkDotNet))]
 public partial class BenchmarkDotNetSettings : ToolOptions
@@ -142,6 +144,7 @@ public partial class BenchmarkDotNetSettings : ToolOptions
 #endregion
 #region BenchmarkDotNetSettingsExtensions
 /// <inheritdoc cref="BenchmarkDotNetTasks.BenchmarkDotNet(Fallout.Common.Tools.BenchmarkDotNet.BenchmarkDotNetSettings)"/>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 public static partial class BenchmarkDotNetSettingsExtensions
 {
@@ -779,6 +782,7 @@ public static partial class BenchmarkDotNetSettingsExtensions
 #region BenchmarkDotNetJob
 /// <summary>Used within <see cref="BenchmarkDotNetTasks"/>.</summary>
 [Serializable]
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [TypeConverter(typeof(TypeConverter<BenchmarkDotNetJob>))]
 public partial class BenchmarkDotNetJob : Enumeration
@@ -797,6 +801,7 @@ public static implicit operator BenchmarkDotNetJob(string value)
 #region BenchmarkDotNetOutlierMode
 /// <summary>Used within <see cref="BenchmarkDotNetTasks"/>.</summary>
 [Serializable]
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [TypeConverter(typeof(TypeConverter<BenchmarkDotNetOutlierMode>))]
 public partial class BenchmarkDotNetOutlierMode : Enumeration
@@ -814,6 +819,7 @@ public static implicit operator BenchmarkDotNetOutlierMode(string value)
 #region BenchmarkDotNetExporter
 /// <summary>Used within <see cref="BenchmarkDotNetTasks"/>.</summary>
 [Serializable]
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [TypeConverter(typeof(TypeConverter<BenchmarkDotNetExporter>))]
 public partial class BenchmarkDotNetExporter : Enumeration
@@ -834,6 +840,7 @@ public static implicit operator BenchmarkDotNetExporter(string value)
 #region BenchmarkDotNetProfiler
 /// <summary>Used within <see cref="BenchmarkDotNetTasks"/>.</summary>
 [Serializable]
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [TypeConverter(typeof(TypeConverter<BenchmarkDotNetProfiler>))]
 public partial class BenchmarkDotNetProfiler : Enumeration
@@ -851,6 +858,7 @@ public static implicit operator BenchmarkDotNetProfiler(string value)
 #region BenchmarkDotNetRunStrategy
 /// <summary>Used within <see cref="BenchmarkDotNetTasks"/>.</summary>
 [Serializable]
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [TypeConverter(typeof(TypeConverter<BenchmarkDotNetRunStrategy>))]
 public partial class BenchmarkDotNetRunStrategy : Enumeration
@@ -867,6 +875,7 @@ public static implicit operator BenchmarkDotNetRunStrategy(string value)
 #region BenchmarkDotNetCaseMode
 /// <summary>Used within <see cref="BenchmarkDotNetTasks"/>.</summary>
 [Serializable]
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [TypeConverter(typeof(TypeConverter<BenchmarkDotNetCaseMode>))]
 public partial class BenchmarkDotNetCaseMode : Enumeration

src/Fallout.Common/Tools/Boots/Boots.Generated.cs

@@ -17,6 +17,7 @@
 namespace Fallout.Common.Tools.Boots;
 
 /// <summary><p>boots is a .NET global tool for <c>bootstrapping</c> <c>vsix</c> and <c>pkg</c> files.</p><p>For more details, visit the <a href="https://github.com/jonathanpeppers/boots">official website</a>.</p></summary>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [NuGetTool(Id = PackageId, Executable = PackageExecutable)]
 public partial class BootsTasks : ToolTasks, IRequireNuGetPackage
@@ -36,6 +37,7 @@ public partial class BootsTasks : ToolTasks, IRequireNuGetPackage
 }
 #region BootsSettings
 /// <inheritdoc cref="BootsTasks.Boots(Fallout.Common.Tools.Boots.BootsSettings)"/>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [Command(Type = typeof(BootsTasks), Command = nameof(BootsTasks.Boots))]
 public partial class BootsSettings : ToolOptions
@@ -60,6 +62,7 @@ public partial class BootsSettings : ToolOptions
 #endregion
 #region BootsSettingsExtensions
 /// <inheritdoc cref="BootsTasks.Boots(Fallout.Common.Tools.Boots.BootsSettings)"/>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 public static partial class BootsSettingsExtensions
 {
@@ -141,6 +144,7 @@ public static partial class BootsSettingsExtensions
 #region BootsProductType
 /// <summary>Used within <see cref="BootsTasks"/>.</summary>
 [Serializable]
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [TypeConverter(typeof(TypeConverter<BootsProductType>))]
 public partial class BootsProductType : Enumeration
@@ -158,6 +162,7 @@ public static implicit operator BootsProductType(string value)
 #region BootsFileType
 /// <summary>Used within <see cref="BootsTasks"/>.</summary>
 [Serializable]
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [TypeConverter(typeof(TypeConverter<BootsFileType>))]
 public partial class BootsFileType : Enumeration

src/Fallout.Common/Tools/CMake/CMake.Generated.cs

@@ -17,6 +17,7 @@
 namespace Fallout.Common.Tools.CMake;
 
 /// <summary><p>The cmake executable is the command-line interface of the cross-platform build system generator CMake.</p><p>For more details, visit the <a href="https://cmake.org/cmake/help/latest/manual/cmake.1.html">official website</a>.</p></summary>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [PathTool(Executable = PathExecutable)]
 public partial class CMakeTasks : ToolTasks, IRequirePathTool
@@ -49,6 +50,7 @@ public partial class CMakeTasks : ToolTasks, IRequirePathTool
 }
 #region CMakeGenerateSettings
 /// <inheritdoc cref="CMakeTasks.CMakeGenerate(Fallout.Common.Tools.CMake.CMakeGenerateSettings)"/>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [Command(Type = typeof(CMakeTasks), Command = nameof(CMakeTasks.CMakeGenerate))]
 public partial class CMakeGenerateSettings : ToolOptions
@@ -93,6 +95,7 @@ public partial class CMakeGenerateSettings : ToolOptions
 #endregion
 #region CMakeBuildSettings
 /// <inheritdoc cref="CMakeTasks.CMakeBuild(Fallout.Common.Tools.CMake.CMakeBuildSettings)"/>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [Command(Type = typeof(CMakeTasks), Command = nameof(CMakeTasks.CMakeBuild), Arguments = "--build")]
 public partial class CMakeBuildSettings : ToolOptions
@@ -115,6 +118,7 @@ public partial class CMakeBuildSettings : ToolOptions
 #endregion
 #region CMakeInstallSettings
 /// <inheritdoc cref="CMakeTasks.CMakeInstall(Fallout.Common.Tools.CMake.CMakeInstallSettings)"/>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [Command(Type = typeof(CMakeTasks), Command = nameof(CMakeTasks.CMakeInstall), Arguments = "--install")]
 public partial class CMakeInstallSettings : ToolOptions
@@ -135,6 +139,7 @@ public partial class CMakeInstallSettings : ToolOptions
 #endregion
 #region CMakeGenerateSettingsExtensions
 /// <inheritdoc cref="CMakeTasks.CMakeGenerate(Fallout.Common.Tools.CMake.CMakeGenerateSettings)"/>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 public static partial class CMakeGenerateSettingsExtensions
 {
@@ -388,6 +393,7 @@ public static partial class CMakeGenerateSettingsExtensions
 #endregion
 #region CMakeBuildSettingsExtensions
 /// <inheritdoc cref="CMakeTasks.CMakeBuild(Fallout.Common.Tools.CMake.CMakeBuildSettings)"/>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 public static partial class CMakeBuildSettingsExtensions
 {
@@ -499,6 +505,7 @@ public static partial class CMakeBuildSettingsExtensions
 #endregion
 #region CMakeInstallSettingsExtensions
 /// <inheritdoc cref="CMakeTasks.CMakeInstall(Fallout.Common.Tools.CMake.CMakeInstallSettings)"/>
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 public static partial class CMakeInstallSettingsExtensions
 {
@@ -573,6 +580,7 @@ public static partial class CMakeInstallSettingsExtensions
 #region CMakeGenerator
 /// <summary>Used within <see cref="CMakeTasks"/>.</summary>
 [Serializable]
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [TypeConverter(typeof(TypeConverter<CMakeGenerator>))]
 public partial class CMakeGenerator : Enumeration
@@ -592,6 +600,7 @@ public static implicit operator CMakeGenerator(string value)
 #region CMakePlatform
 /// <summary>Used within <see cref="CMakeTasks"/>.</summary>
 [Serializable]
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [TypeConverter(typeof(TypeConverter<CMakePlatform>))]
 public partial class CMakePlatform : Enumeration
@@ -609,6 +618,7 @@ public static implicit operator CMakePlatform(string value)
 #region CMakeConfiguration
 /// <summary>Used within <see cref="CMakeTasks"/>.</summary>
 [Serializable]
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [TypeConverter(typeof(TypeConverter<CMakeConfiguration>))]
 public partial class CMakeConfiguration : Enumeration
@@ -626,6 +636,7 @@ public static implicit operator CMakeConfiguration(string value)
 #region CMakeLogLevel
 /// <summary>Used within <see cref="CMakeTasks"/>.</summary>
 [Serializable]
+[System.CodeDom.Compiler.GeneratedCode("Fallout.Tooling.Generator", "1.0.0")]
 [ExcludeFromCodeCoverage]
 [TypeConverter(typeof(TypeConverter<CMakeLogLevel>))]
 public partial class CMakeLogLevel : Enumeration