Add GetMessageHandler() to HttpMock

[Copilot]

Summary

Adds a GetMessageHandler() method to HttpMock alongside the existing GetClient() and GetClientFactory() methods. It returns the underlying MockHttpMessageHandler typed as HttpMessageHandler, allowing users to wire the mock handler directly into an HttpClient or other infrastructure that accepts an HttpMessageHandler.

Changes

• Mockly/HttpMock.cs: Added GetMessageHandler() public method with XML doc comment and CA1024 suppression (consistent with GetClient() and GetClientFactory())
• Mockly.Specs/HttpMockSpecs.cs: Added WhenGettingMessageHandler test class with a passing test
• Mockly.ApiVerificationTests/ApprovedApi/net8.0.verified.txt: Added new method to approved API surface
• Mockly.ApiVerificationTests/ApprovedApi/net472.verified.txt: Added new method to approved API surface
• website/docs/quick-start.md: Added a new "Using a Raw HttpMessageHandler" section
• website/docs/usage.md: Added a section comparing all three wiring options (GetClient, GetClientFactory, GetMessageHandler)

Usage

var mock = new HttpMock();
mock.ForGet().WithPath("/ping").RespondsWithStatus(HttpStatusCode.OK);

HttpMessageHandler handler = mock.GetMessageHandler();
using var client = new HttpClient(handler) { BaseAddress = new Uri("https://localhost/") };

var response = await client.GetAsync("/ping");

[dennisdoomen]

Suggested change

	public async Task GetMessageHandler_returns_handler_that_intercepts_requests()
	public async Task Can_return_a_message_handler_that_intercepts_requests()

[Copilot]

Done in 6979ce2.

[coveralls]

Coverage Report for CI Build 24231931000

Coverage increased (+0.04%) to 83.649%

Details

• Coverage increased (+0.04%) from the base build.
• Patch coverage: 3 of 3 lines across 1 file are fully covered (100%).
• No coverage regressions found.

Uncovered Changes

No uncovered changes found.

Coverage Regressions

No coverage regressions found.

---

Coverage Stats

Relevant Lines:	1010
Covered Lines:	899
Line Coverage:	89.01%
Relevant Branches:	311
Covered Branches:	206
Branch Coverage:	66.24%
Branches in Coverage %:	Yes
Coverage Strength:	334.8 hits per line

---

💛 - Coveralls

[github-actions]

Test Results

  3 files  ±0    3 suites  ±0   4s ⏱️ -1s
 89 tests +1   89 ✅ +1  0 💤 ±0  0 ❌ ±0 
175 runs  +2  175 ✅ +2  0 💤 ±0  0 ❌ ±0 

Results for commit 6979ce2. ± Comparison against base commit 5a70745.

♻️ This comment has been updated with latest results.