cp

Author: egil

src/bunit.core/FragmentBase.cs

@@ -0,0 +1,8 @@
+// This file is used by Code Analysis to maintain SuppressMessage
+// attributes that are applied to this project.
+// Project-level suppressions either have no target or are given
+// a specific target and scoped to a namespace, type, member, etc.
+
+using System.Diagnostics.CodeAnalysis;
+
+[assembly: SuppressMessage("Usage", "BL0006:Do not use RenderTree types")]

src/bunit.core/GlobalSuppressions.cs

@@ -1,13 +1,14 @@
 using System.Threading.Tasks;
+using Bunit.RazorTesting;
 using Microsoft.AspNetCore.Components;
 
 namespace Bunit
 {
-    /// <summary>
-    /// Represents a component that can be added inside a <see cref="Fixture"/>,
-    /// where a component under test can be defined as the child content.
-    /// </summary>
-    public class ComponentUnderTest : FragmentBase
+	/// <summary>
+	/// Represents a component that can be added inside a <see cref="Fixture"/>,
+	/// where a component under test can be defined as the child content.
+	/// </summary>
+	public class ComponentUnderTest : FragmentBase
     {
         /// <inheritdoc />
         public override Task SetParametersAsync(ParameterView parameters)

src/bunit.core/RazorTestRenderer.cs

@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.Threading.Tasks;
+using Bunit.RazorTesting;
 using Microsoft.AspNetCore.Components;
 
 namespace Bunit
@@ -69,6 +70,7 @@ public class Fixture : RazorTest
 		/// </summary>
 		[Parameter] public IReadOnlyCollection<Func<Task>> TestsAsync { get => _testsAsync; set => _testsAsync = value ?? Array.Empty<Func<Task>>(); }
 
+		/// <inheritdoc/>
 		public override Task RunTest() => throw new NotImplementedException();
 	}
 }

…nit.web/Components/ComponentUnderTest.cs ….core/RazorTesting/ComponentUnderTest.cssrc/bunit.web/Components/ComponentUnderTest.cs renamed to src/bunit.core/RazorTesting/ComponentUnderTest.cs src/bunit.web/Components/ComponentUnderTest.cs renamed to src/bunit.core/RazorTesting/ComponentUnderTest.cs

@@ -0,0 +1,17 @@
+using Bunit.RazorTesting;
+using Microsoft.AspNetCore.Components;
+
+namespace Bunit
+{
+	/// <summary>
+	/// Represents a component that can be added inside a <see cref="Fixture"/>, whose content
+	/// can be accessed in Razor-based test.
+	/// </summary>
+	public class Fragment : FragmentBase
+    {
+        /// <summary>
+        /// Gets or sets the id of the fragment.
+        /// </summary>
+        [Parameter] public string Id { get; set; } = string.Empty;
+    }
+}

src/bunit.web/Components/Fixture.cs src/bunit.core/RazorTesting/Fixture.cssrc/bunit.web/Components/Fixture.cs renamed to src/bunit.core/RazorTesting/Fixture.cs

@@ -0,0 +1,39 @@
+using System;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+
+namespace Bunit.RazorTesting
+{
+	/// <summary>
+	/// Represents a component that can be used to capture a render fragment.
+	/// </summary>
+	public abstract class FragmentBase : IComponent
+	{
+		/// <summary>
+		/// A no-op test method.
+		/// </summary>
+		protected static void NoopTestMethod() { }
+
+		/// <summary>
+		/// A no-op async test method
+		/// </summary>
+		protected static Task NoopTestMethodAsync() => Task.CompletedTask;
+
+		/// <summary>
+		/// Gets or sets the child content of the fragment.
+		/// </summary>
+		[Parameter] public RenderFragment ChildContent { get; set; } = default!;
+
+		/// <inheritdoc />
+		public void Attach(RenderHandle renderHandle) { }
+
+		/// <inheritdoc />
+		public virtual Task SetParametersAsync(ParameterView parameters)
+		{
+			parameters.SetParameterProperties(this);
+			if (ChildContent is null)
+				throw new InvalidOperationException($"No {nameof(ChildContent)} specified in test component.");
+			return Task.CompletedTask;
+		}
+	}
+}

src/bunit.core/RazorTesting/Fragment.cs

@@ -5,7 +5,7 @@
 using System.Threading.Tasks;
 using Microsoft.AspNetCore.Components;
 
-namespace Bunit
+namespace Bunit.RazorTesting
 {
 	/// <summary>
 	/// Represents a component used to define tests in Razor files.
@@ -22,6 +22,10 @@ public abstract class RazorTest : FragmentBase
 		/// </summary>
 		[Parameter] public string? Skip { get; set; }
 
+		/// <summary>
+		/// Run the test logic of the <see cref="RazorTest"/>.
+		/// </summary>
+		/// <returns></returns>
 		public abstract Task RunTest();
 
 		/// <inheritdoc/>

src/bunit.core/RazorTesting/FragmentBase.cs

@@ -1,10 +1,9 @@
-using System;
+using System;
 
 namespace Bunit
 {
     /// <summary>
-    /// Represents an exception that is thrown when a search for a component in a 
-    /// <see cref="IRenderedFragment"/> did not succeed.
+    /// Represents an exception that is thrown when a search for a component did not succeed.
     /// </summary>
     public class ComponentNotFoundException : Exception
     {
@@ -16,4 +15,4 @@ public ComponentNotFoundException(Type componentType) : base($"A component of ty
         {
         }
     }
-}
+}