Added additional placeholder services for NavigationManager, HttpClient, and IStringLocalizer (#223)

* Update affix.tmpl.partial

* Adding placeholder navigation manager

Adding placeholder navigation manager that throws a helpful exception to prompt users to go look at the docs

* Implementing placeholder httpclient

Implementing placeholder httpclient that throws exceptions that prompts users to read the documentation

* Moving exception to it's own file

* Adding placeholder log factory

Adding placeholder log factory that throws exceptions to prompt users to create a mock

* Added placeholder string localizer

Added placeholder string localizer that throws exceptions that prompt the user to look at documentation

* Fixing merge conflict

* Working on warnings

* Docs: added httpclient mocking guide to docs

* Code review feedback

* Adding xml comment to fix build

* Updated changelog.md, moved all test doubles into the same namespace to avoid users having to import many namespaces, cleaned code a little

* Update template with new test doubles namespace

Co-authored-by: Egil Hansen <egil@assimilated.dk>

Author: joro550

CHANGELOG.md

@@ -11,6 +11,7 @@ List of new features.
 
 - Two new overloads to the `RenderFragment()` and `ChildContent()` component parameter factory methods have been added that takes a `RenderFragment` as input. By [@egil](https://github.com/egil) in [#203](https://github.com/egil/bUnit/pull/203).
 - Added a `ComponentParameterCollection` type. The `ComponentParameterCollection` is a collection of component parameters, that knows how to turn those components parameters into a `RenderFragment`, which will render a component and pass any parameters inside the collection to that component. That logic was spread out over multiple places in bUnit, and is now owned by the `ComponentParameterCollection` type. By [@egil](https://github.com/egil) in [#203](https://github.com/egil/bUnit/pull/203).
+- Added additional placeholder services for `NavigationManager`, `HttpClient`, and `IStringLocalizer`, to make it easier for users to figure out why a test is failing due to missing service registration before rendering a component. By [@joro550](https://github.com/joro550) in [#203](https://github.com/egil/bUnit/pull/223).
 
 ### Changed
 List of changes in existing functionality.
@@ -32,7 +33,8 @@ List of changes in existing functionality.
     )
   );
   ```
-  By [@egil](https://github.com/egil) in [#203](https://github.com/egil/bUnit/pull/203).  
+  By [@egil](https://github.com/egil) in [#203](https://github.com/egil/bUnit/pull/203).
+- All test doubles are now in the same namespace, `Bunit.TestDoubles`. So all import statements for `Bunit.TestDoubles.JSInterop` and `Bunit.TestDoubles.Authorization` must be changed to `Bunit.TestDoubles`. By [@egil](https://github.com/egil) in [#203](https://github.com/egil/bUnit/pull/223).
 
 ### Deprecated
 List of soon-to-be removed features.

docs/samples/tests/xunit/MockHttpClientBunitHelpers.cs

@@ -0,0 +1,47 @@
+namespace Bunit.Docs.Samples
+{
+    using Bunit;
+    using Microsoft.Extensions.DependencyInjection;
+    using RichardSzalay.MockHttp;
+    using System;
+    using System.Net;
+    using System.Net.Http;
+    using System.Net.Http.Headers;
+    using System.Text.Json;
+
+    public static class MockHttpClientBunitHelpers
+	{
+		public static MockHttpMessageHandler AddMockHttpClient(this TestServiceProvider services)
+		{
+			var mockHttpHandler = new MockHttpMessageHandler();
+			var httpClient = mockHttpHandler.ToHttpClient();
+			httpClient.BaseAddress = new Uri("http://localhost");
+			services.AddSingleton<HttpClient>(httpClient);
+			return mockHttpHandler;
+		}
+
+		public static MockedRequest RespondJson<T>(this MockedRequest request, T content)
+		{
+			request.Respond(req =>
+			{
+				var response = new HttpResponseMessage(HttpStatusCode.OK);
+				response.Content = new StringContent(JsonSerializer.Serialize(content));
+				response.Content.Headers.ContentType = new MediaTypeHeaderValue("application/json");
+				return response;
+			});
+			return request;
+		}
+
+		public static MockedRequest RespondJson<T>(this MockedRequest request, Func<T> contentProvider)
+		{
+			request.Respond(req =>
+			{
+				var response = new HttpResponseMessage(HttpStatusCode.OK);
+				response.Content = new StringContent(JsonSerializer.Serialize(contentProvider()));
+				response.Content.Headers.ContentType = new MediaTypeHeaderValue("application/json");
+				return response;
+			});
+			return request;
+		}
+	}
+}

docs/samples/tests/xunit/bunit.docs.xunit.samples.csproj

@@ -5,6 +5,7 @@
   </PropertyGroup>
 
   <ItemGroup>
+    <PackageReference Include="RichardSzalay.MockHttp" Version="6.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.6.1" />
     <PackageReference Include="xunit" Version="2.4.1" />
     <PackageReference Include="xunit.runner.visualstudio" Version="2.4.1">

docs/site/docs/test-doubles/mocking-httpclient.md

@@ -5,4 +5,32 @@ title: Mocking HttpClient
 
 # Mocking `HttpClient`
 
-TODO - https://github.com/egil/bunit/issues/61
+Mocking the `HttpClient` service in .NET Core is a bit more clumbersome than interface-based services like `IJSRuntime`. 
+There is currently no built-in mock for `HttpClient` in bUnit, but with the use of 
+[RichardSzalay.MockHttp](https://www.nuget.org/packages/RichardSzalay.MockHttp/) we can easily add one that works
+with bUnit.
+
+To use RichardSzalay.MockHttp, add the following package reference to your test project's .csproj file:
+
+```xml
+<PackageReference Include="RichardSzalay.MockHttp" Version="6.0.0" />
+```
+
+To make it easier to work with [RichardSzalay.MockHttp](https://www.nuget.org/packages/RichardSzalay.MockHttp/), add 
+the following extension class to your test project. It makes it easier to add the `HttpClient` mock to 
+bUnit's test context's `Services` collection, and configure responses to requests:
+
+[!code-csharp[MockHttpClientBunitHelpers.cs](../../../samples/tests/xunit/MockHttpClientBunitHelpers.cs?start=3&end=46)]
+
+With the helper methods in place, you can do the following in your tests:
+
+```csharp
+using var ctx = new TestContext();
+var mock = ctx.Services.AddMockHttpClient();
+mock.When("/getData").RespondJson(new List<Data>{ ... });
+```
+
+This registers the mock `HttpClient` in bUnit's test context's `Services` collection, and then tells the mock that when a request is received for `/getData`, it should respond with the `new List<Data>{ ... }`, serialized as JSON.
+
+> [!TIP]
+> You can add addtional `RespondXXX` methods to the `MockHttpClientBunitHelpers` class to fit your testing needs.

docs/site/docs/toc.md

@@ -23,6 +23,7 @@
 
 # [Test Doubles](xref:test-doubles)
 ## [Faking Authorization](xref:faking-auth)
+## [Mocking HttpClient](xref:mocking-httpclient)
 ## [Mocking IJSRuntime](xref:mocking-ijsruntime)
 
 # [Miscellaneous testing tips](xref:misc-test-tips)

src/bunit.template/template/CounterCSharpTest.cs

@@ -1,7 +1,7 @@
 using System;
 using Xunit;
 using Bunit;
-using Bunit.TestDoubles.JSInterop;
+using Bunit.TestDoubles;
 using static Bunit.ComponentParameterFactory;
 
 namespace Company.BlazorTests1

src/bunit.template/template/_Imports.razor

@@ -4,5 +4,5 @@
 @using Microsoft.JSInterop
 @using Microsoft.Extensions.DependencyInjection
 @using Bunit
-@using Bunit.TestDoubles.JSInterop
+@using Bunit.TestDoubles
 @using Xunit

src/bunit.web/Extensions/TestServiceProviderExtensions.cs

@@ -1,10 +1,12 @@
+using System.Net.Http;
 using Bunit.Diffing;
 using Bunit.Rendering;
-using Bunit.TestDoubles.Authorization;
-using Bunit.TestDoubles.JSInterop;
+using Bunit.TestDoubles;
 using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Components;
 using Microsoft.AspNetCore.Components.Authorization;
 using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Localization;
 using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Logging.Abstractions;
 using Microsoft.JSInterop;
@@ -21,13 +23,20 @@ public static class TestServiceProviderExtensions
 		/// </summary>
 		public static IServiceCollection AddDefaultTestContextServices(this IServiceCollection services)
 		{
+			// Placeholders and defaults for common Blazor services
 			services.AddSingleton<ILoggerFactory>(NullLoggerFactory.Instance);
 			services.AddSingleton<AuthenticationStateProvider, PlaceholderAuthenticationStateProvider>();
 			services.AddSingleton<IAuthorizationService, PlaceholderAuthorizationService>();
 			services.AddSingleton<IJSRuntime, PlaceholderJSRuntime>();
+			services.AddSingleton<NavigationManager, PlaceholderNavigationManager>();
+			services.AddSingleton<HttpClient, PlaceholderHttpClient>();
+			services.AddSingleton<IStringLocalizer, PlaceholderStringLocalization>();
+
+			// bUnit specific services
 			services.AddSingleton<HtmlComparer>();
 			services.AddSingleton<BunitHtmlParser>();
 			services.AddSingleton<IRenderedComponentActivator, RenderedComponentActivator>();
+
 			return services;
 		}
 	}

src/bunit.web/TestDoubles/Authorization/AuthorizationState.cs

@@ -1,4 +1,4 @@
-namespace Bunit.TestDoubles.Authorization
+namespace Bunit.TestDoubles
 {
 	/// <summary>
 	/// Enumeration that represents the user's authorization state.

src/bunit.web/TestDoubles/Authorization/FakeAuthenticationStateProvider.cs

@@ -5,7 +5,7 @@
 using System.Threading.Tasks;
 using Microsoft.AspNetCore.Components.Authorization;
 
-namespace Bunit.TestDoubles.Authorization
+namespace Bunit.TestDoubles
 {
 	/// <summary>
 	/// Represents a fake implementation of AuthenticationStateProvider for testing purposes that allows