feat: Added Feature TestGroup (#692)

* feat: Added Feature `TestGroup`

* fix(style): Formatting updated

Author: samtrion

src/NetEvolve.Extensions.MSTest/Internals.cs

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

src/NetEvolve.Extensions.MSTest/TestGroupAttribute.cs

@@ -0,0 +1,18 @@
+namespace NetEvolve.Extensions.MSTest;
+
+using System;
+using NetEvolve.Extensions.MSTest.Internal;
+
+/// <summary>
+/// Attribute used to decorate a test class or method as <b>TestGroup</b>, with explicit Id.
+/// </summary>
+[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
+public sealed class TestGroupAttribute : TestCategoryWithIdBaseAttribute
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="UserStoryAttribute"/> class.
+    /// </summary>
+    /// <param name="id">UserStory Id</param>
+    public TestGroupAttribute(string id)
+        : base(Internals.TestGroup, id) { }
+}

src/NetEvolve.Extensions.NUnit/Internal/CategoryIdBaseAttribute.cs

@@ -1,5 +1,6 @@
 namespace NetEvolve.Extensions.NUnit.Internal;
 
+using System.Xml.Linq;
 using global::NUnit.Framework;
 using global::NUnit.Framework.Interfaces;
 using global::NUnit.Framework.Internal;

src/NetEvolve.Extensions.NUnit/Internal/NamedCategoryBaseAttribute.cs

@@ -0,0 +1,46 @@
+namespace NetEvolve.Extensions.NUnit.Internal;
+
+using global::NUnit.Framework;
+using global::NUnit.Framework.Interfaces;
+using global::NUnit.Framework.Internal;
+
+/// <summary>
+/// Abstract class implementation.
+/// </summary>
+public abstract class NamedCategoryBaseAttribute : NUnitAttribute, IApplyToTest
+{
+    /// <summary>
+    /// Gets the category value of the trait.
+    /// </summary>
+    public string Category { get; }
+
+    /// <summary>
+    /// Gets the Id
+    /// </summary>
+    public string Id { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="CategoryIdBaseAttribute"/> class.
+    /// </summary>
+    /// <param name="category">Category</param>
+    /// <param name="id">Id</param>
+    protected NamedCategoryBaseAttribute(string category, string id)
+    {
+        Category = category;
+        Id = id;
+    }
+
+    /// <inheritdoc/>
+    public void ApplyToTest(Test test)
+    {
+        if (test is null)
+        {
+            return;
+        }
+
+        if (!string.IsNullOrEmpty(Id))
+        {
+            test.Properties.Add(Category, Id!);
+        }
+    }
+}

src/NetEvolve.Extensions.NUnit/Internals.cs

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

src/NetEvolve.Extensions.NUnit/TestGroupAttribute.cs

@@ -0,0 +1,18 @@
+namespace NetEvolve.Extensions.NUnit;
+
+using System;
+using NetEvolve.Extensions.NUnit.Internal;
+
+/// <summary>
+/// Attribute used to decorate a test class or method as <b>TestGroup</b>, with explicit id
+/// </summary>
+[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
+public sealed class TestGroupAttribute : NamedCategoryBaseAttribute
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="TestGroupAttribute"/> class.
+    /// </summary>
+    /// <param name="id">TestGroup Name</param>
+    public TestGroupAttribute(string id)
+        : base(Internals.TestGroup, id) { }
+}

src/NetEvolve.Extensions.TUnit/Internal/NamedCategoryTraitBaseAttribute.cs

@@ -0,0 +1,44 @@
+namespace NetEvolve.Extensions.TUnit.Internal;
+
+using global::TUnit.Core.Interfaces;
+
+/// <summary>
+/// Abstract implementation.
+/// </summary>
+public abstract class NamedCategoryTraitBaseAttribute : Attribute, ITestDiscoveryEventReceiver
+{
+    /// <summary>
+    /// Gets the category value of the trait.
+    /// </summary>
+    public string Category { get; }
+
+    /// <summary>
+    /// Gets the Id
+    /// </summary>
+    public string Id { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="NamedCategoryTraitBaseAttribute"/> class.
+    /// </summary>
+    /// <param name="category">Category</param>
+    /// <param name="id">Id</param>
+    protected NamedCategoryTraitBaseAttribute(string category, string id)
+    {
+        Category = category;
+        Id = id;
+    }
+
+    /// <inheritdoc/>
+    public void OnTestDiscovery(DiscoveredTestContext discoveredTestContext)
+    {
+        if (discoveredTestContext is null)
+        {
+            return;
+        }
+
+        if (!string.IsNullOrWhiteSpace(Id))
+        {
+            discoveredTestContext.AddProperty(Category, Id);
+        }
+    }
+}

src/NetEvolve.Extensions.TUnit/Internals.cs

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

src/NetEvolve.Extensions.TUnit/TestGroupAttribute.cs

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

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

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