Merge branch 'main' into dev

Author: egil

README.md

@@ -8,13 +8,11 @@
 
 **bUnit** is a testing library for Blazor Components. Its goal is to make it easy to write _comprehensive, stable unit tests_. You can:
 
-- Setup and define components under tests in C# or Razor syntax
+- Setup and define components under tests using C# or Razor syntax
 - Verify outcome using semantic HTML comparer
-- Interact with and inspect components
-- Trigger event handlers
-- Provide cascading values
-- Inject services
-- Mock `IJsRuntime`
+- Interact with and inspect components, trigger event handlers
+- Pass parameters, cascading values and inject services into components under test
+- Mock `IJsRuntime` and Blazors authentication and authorization
 - Perform snapshot testing
 
 bUnit builds on top of existing unit testing frameworks such as xUnit, NUnit, and MSTest, which runs the Blazor components tests, just as any normal unit test. 
@@ -27,14 +25,20 @@ bUnit is available on NuGet in various incarnations. If you are using xUnit as y
 
 | Name | Type | NuGet Download Link |
 | ----- | ----- | ---- |
-| bUnit | Library, includes core, web, and xUnit | [![Nuget](https://img.shields.io/nuget/dt/bunit?logo=nuget&style=flat-square)](https://www.nuget.org/packages/bunit/) | 
+| bUnit | Library, includes core, web, and xUnit support | [![Nuget](https://img.shields.io/nuget/dt/bunit?logo=nuget&style=flat-square)](https://www.nuget.org/packages/bunit/) | 
 | bUnit.core | Library, only core | [![Nuget](https://img.shields.io/nuget/dt/bunit.core?logo=nuget&style=flat-square)](https://www.nuget.org/packages/bunit.core/) | 
 | bUnit.web | Library, web and core | [![Nuget](https://img.shields.io/nuget/dt/bunit.web?logo=nuget&style=flat-square)](https://www.nuget.org/packages/bunit.web/) | 
-| bUnit.xUnit |Library, xUnit and core | [![Nuget](https://img.shields.io/nuget/dt/bunit.xunit?logo=nuget&style=flat-square)](https://www.nuget.org/packages/bunit.xunit/) | 
+| bUnit.xUnit | Library, xUnit and core | [![Nuget](https://img.shields.io/nuget/dt/bunit.xunit?logo=nuget&style=flat-square)](https://www.nuget.org/packages/bunit.xunit/) | 
 | bUnit.template | Template, which currently creates an xUnit based bUnit test projects only | [![Nuget](https://img.shields.io/nuget/dt/bunit.template?logo=nuget&style=flat-square)](https://www.nuget.org/packages/bunit.template/) | 
 
 To get started, head to the [getting started documentation](https://bunit.egilhansen.com/docs/getting-started) to learn more.
 
+## Sponsors
+
+A hugh thank you to the [sponsors of my work with bUnit](https://github.com/sponsors/egil). The higher tier sponsors are:
+
+- [Hassan Rezk Habib (@hassanhabib)](https://github.com/hassanhabib)
+
 ## Milestones to v1.0.0
 
 These are the current goals that should be reached before v1.0.0 is ready:

docs/README.md

@@ -28,5 +28,5 @@ To build and view the documentation locally, a few steps is needed:
 
 - All pages should have a [YAML header](https://dotnet.github.io/docfx/spec/docfx_flavored_markdown.html#yaml-header) with an `UID` to enable easy [cross reference](https://dotnet.github.io/docfx/spec/docfx_flavored_markdown.html#cross-reference) between pages
 - All page and code references should be created using the [`xref:UID` cross reference syntax](https://dotnet.github.io/docfx/tutorial/links_and_cross_references.html#using-cross-reference).
-- Prefer to include code snippets as from sample files in the `samples` projects, using the [code snippet syntax](https://dotnet.github.io/docfx/spec/docfx_flavored_markdown.html#code-snippet).
-- All code snippets should use 2 spaces as an indention unit (1 tab = 2 spaces)
+- Prefer to include code snippets as sample files in the `samples` projects, using the [code snippet syntax](https://dotnet.github.io/docfx/spec/docfx_flavored_markdown.html#code-snippet).
+- All code snippets should use 2 spaces as an indention unit (1 tab = 2 spaces)

docs/samples/tests/xunit/CounterTestWithCtx.cs

@@ -0,0 +1,23 @@
+using Xunit;
+using Bunit;
+
+namespace Bunit.Docs.Samples
+{
+  public class CounterTestWithCtx
+  {
+    [Fact]
+    public void CounterShouldIncrementWhenClicked()
+    {
+      // Arrange: render the Counter.razor component
+      using var ctx = new TestContext();
+      var cut = ctx.RenderComponent<Counter>();
+
+      // Act: find and click the <button> element to increment
+      // the counter in the <p> element
+      cut.Find("button").Click();
+
+      // Assert: first find the <p> element, then verify its content
+      cut.Find("p").MarkupMatches("<p>Current count: 1</p>");
+    }
+  }
+}

docs/site/docs/basics-of-blazor-component-testing.md

@@ -1,3 +1,8 @@
+---
+uid: contribute
+title: Contribute
+---
+
 # Contribute
 
 To get in touch, ask questions or provide feedback, you can: