feat: Add PublicApiAttribute for marking PublicApi test definitions (#967)

* feat: Add PublicApiAttribute to all test frameworks

Co-authored-by: samtrion <[email protected]>

* chore: Update PublicApi test snapshots for new PublicApiAttribute

Co-authored-by: samtrion <[email protected]>

* fix(test): Added missing PublicAPI Defintiion

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: samtrion <[email protected]>
Co-authored-by: Martin Stühmer <[email protected]>

Author: Copilot

src/NetEvolve.Extensions.MSTest/Internals.cs

@@ -104,4 +104,9 @@ internal static class Internals
     /// TestGroup
     /// </summary>
     public const string TestGroup = nameof(TestGroup);
+
+    /// <summary>
+    /// PublicApi
+    /// </summary>
+    public const string PublicApi = nameof(PublicApi);
 }

src/NetEvolve.Extensions.MSTest/PublicApiAttribute.cs

@@ -0,0 +1,17 @@
+namespace NetEvolve.Extensions.MSTest;
+
+using System;
+using NetEvolve.Extensions.MSTest.Internal;
+
+/// <summary>
+/// Attribute used to decorate a test class or method as <b>PublicApi</b>.
+/// </summary>
+[AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
+public sealed class PublicApiAttribute : TestTraitBaseAttribute
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PublicApiAttribute"/> class.
+    /// </summary>
+    public PublicApiAttribute()
+        : base(Internals.PublicApi) { }
+}

src/NetEvolve.Extensions.NUnit/Internals.cs

@@ -104,4 +104,9 @@ internal static class Internals
     /// TestGroup
     /// </summary>
     public const string TestGroup = nameof(TestGroup);
+
+    /// <summary>
+    /// PublicApi
+    /// </summary>
+    public const string PublicApi = nameof(PublicApi);
 }

src/NetEvolve.Extensions.NUnit/PublicApiAttribute.cs

@@ -0,0 +1,17 @@
+namespace NetEvolve.Extensions.NUnit;
+
+using System;
+using global::NUnit.Framework;
+
+/// <summary>
+/// Attribute used to decorate a test class or method as <b>PublicApi</b>.
+/// </summary>
+[AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
+public sealed class PublicApiAttribute : CategoryAttribute
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PublicApiAttribute"/> class.
+    /// </summary>
+    public PublicApiAttribute()
+        : base(Internals.PublicApi) { }
+}

src/NetEvolve.Extensions.TUnit/Internals.cs

@@ -89,4 +89,9 @@ internal static class Internals
     /// TestGroup
     /// </summary>
     public const string TestGroup = nameof(TestGroup);
+
+    /// <summary>
+    /// PublicApi
+    /// </summary>
+    public const string PublicApi = nameof(PublicApi);
 }

src/NetEvolve.Extensions.TUnit/PublicApiAttribute.cs

@@ -0,0 +1,17 @@
+namespace NetEvolve.Extensions.TUnit;
+
+using System;
+using NetEvolve.Extensions.TUnit.Internal;
+
+/// <summary>
+/// Attribute used to decorate a test class or method as <b>PublicApi</b>.
+/// </summary>
+[AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
+public sealed class PublicApiAttribute : CategoryTraitBaseAttribute
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PublicApiAttribute"/> class.
+    /// </summary>
+    public PublicApiAttribute()
+        : base(Internals.PublicApi) { }
+}

src/NetEvolve.Extensions.XUnit.V3/Internals.cs

@@ -114,4 +114,9 @@ internal static class Internals
     /// TestGroup
     /// </summary>
     public const string TestGroup = nameof(TestGroup);
+
+    /// <summary>
+    /// PublicApi
+    /// </summary>
+    public const string PublicApi = nameof(PublicApi);
 }

src/NetEvolve.Extensions.XUnit.V3/PublicApiAttribute.cs

@@ -0,0 +1,17 @@
+namespace NetEvolve.Extensions.XUnit.V3;
+
+using System;
+using NetEvolve.Extensions.XUnit.V3.Internal;
+
+/// <summary>
+/// Attribute used to decorate a test class or method as <b>PublicApi</b>.
+/// </summary>
+[AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
+public sealed class PublicApiAttribute : CategoryTraitBaseAttribute
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PublicApiAttribute"/> class.
+    /// </summary>
+    public PublicApiAttribute()
+        : base(Internals.PublicApi) { }
+}

tests/NetEvolve.Extensions.MSTest.Tests.PublicApi/_snapshots/DotNet10_0/PublicApiTests.PublicApi_HasNotChanged_Expected.verified.txt

@@ -60,6 +60,10 @@
     {
         public PreDeploymentAttribute() { }
     }
+    public sealed class PublicApiAttribute : NetEvolve.Extensions.MSTest.Internal.TestTraitBaseAttribute
+    {
+        public PublicApiAttribute() { }
+    }
     public sealed class TestGroupAttribute : NetEvolve.Extensions.MSTest.Internal.TestCategoryWithIdBaseAttribute
     {
         public TestGroupAttribute(string id) { }

tests/NetEvolve.Extensions.MSTest.Tests.PublicApi/_snapshots/DotNet8_0/PublicApiTests.PublicApi_HasNotChanged_Expected.verified.txt

@@ -60,6 +60,10 @@
     {
         public PreDeploymentAttribute() { }
     }
+    public sealed class PublicApiAttribute : NetEvolve.Extensions.MSTest.Internal.TestTraitBaseAttribute
+    {
+        public PublicApiAttribute() { }
+    }
     public sealed class TestGroupAttribute : NetEvolve.Extensions.MSTest.Internal.TestCategoryWithIdBaseAttribute
     {
         public TestGroupAttribute(string id) { }