feat!: add support for URL-encoded form data content

[vbreuss]

This pull request refactors and simplifies the HTTP content parameter matching APIs in the Mockolate.Web namespace. It removes specialized interfaces and classes for string and binary content, consolidates their functionality into a more general IHttpContentParameter interface, and introduces support for form data content. The changes improve API consistency and extensibility for matching HTTP request content in tests.

API Refactoring and Simplification:

• Removed the specialized IsBinaryContent and IsStringContent extension methods, interfaces, and implementations, consolidating their functionality into the new, unified IHttpContentParameter interface. This includes removing IBinaryContentParameter, IStringContentParameter, and related code, and updating the API surface accordingly.

• Updated the IHttpRequestMessageParameter interface and its implementation to remove WhoseStringContentIs and WhoseBinaryContentIs methods, replacing them with a more flexible WhoseContentIs method that optionally takes a media type and configuration action.

New Features:

• Added support for matching HTTP form data parameters by introducing the HttpFormDataValue class and related API methods, such as WithFormData, to the IHttpContentParameter interface.

Other Improvements:

• Improved string comparison in HttpQueryParameterValue.Matches to use StringComparison.Ordinal for consistency and correctness.
• Minor code organization improvements, such as reordering fields in HttpRequestMessageParameter for clarity.

Test and Documentation Updates:

• Updated the expected API surface in Mockolate_net10.0.txt to reflect the new interface structure and removed/added methods and classes.

These changes make the HTTP content matching API easier to use and extend, while reducing duplication and improving maintainability.

[Copilot]

Pull request overview

Adds a new It.IsFormDataContent() matcher to allow mocking/verifying HTTP calls based on URL-encoded form data (including form data embedded inside multipart form content).

Changes:

• Introduces It.IsFormDataContent() and IFormDataContentParameter fluent API for matching form data content.
• Adds parsing/matching logic for URL-encoded key/value pairs (including URL decoding).
• Adds unit tests covering .Containing(...) matching behavior and order independence.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 12 comments.

File	Description
Tests/Mockolate.Tests/Web/ItExtensionsTests.IsFormDataContentTests.cs	Adds tests for the new form-data matcher behavior.
Source/Mockolate/Web/ItExtensions.cs	Adds FormDataMatcher helper to extract and match URL-encoded form data.
Source/Mockolate/Web/ItExtensions.HttpContent.IsFormDataContent.cs	Adds the public matcher API and hooks it into HttpContent matching.
Source/Mockolate/Web/HttpFormDataValue.cs	Introduces a value wrapper for form-data matching with extensible match semantics.

[github-actions]

🚀 Benchmark Results

Details

BenchmarkDotNet v0.15.8, Linux Ubuntu 24.04.3 LTS (Noble Numbat)

AMD EPYC 7763 3.20GHz, 1 CPU, 4 logical and 2 physical cores

.NET SDK 10.0.102

[Host] : .NET 10.0.2 (10.0.2, 10.0.225.61305), X64 RyuJIT x86-64-v3
Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10

Method	Mean	Error	StdDev	Gen0	Gen1	Allocated
Simple_Mockolate	1.627 μs	0.0219 μs	0.0194 μs	0.2270	-	3.73 KB
Simple_Moq	175.934 μs	0.8522 μs	0.7972 μs	0.4883	-	14.55 KB
Simple_NSubstitute	5.789 μs	0.0281 μs	0.0263 μs	0.5569	0.0076	9.14 KB
Simple_FakeItEasy	6.367 μs	0.0480 μs	0.0426 μs	0.4959	-	8.11 KB

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 4 comments.

[Copilot]

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated 5 comments.

[github-actions]

Test Results

    21 files  ±  0      21 suites  ±0   4m 52s ⏱️ -48s
 2 655 tests + 20   2 654 ✅ + 20  1 💤 ±0  0 ❌ ±0 
17 830 runs  +120  17 829 ✅ +120  1 💤 ±0  0 ❌ ±0 

Results for commit d089b0f. ± Comparison against base commit 2ae9bf8.

This pull request removes 108 and adds 128 tests. Note that renamed tests count towards both.

Mockolate.Tests.Web.ItExtensionsTests+IsBinaryContentTests ‑ Containing_ShouldCheckForEquality(body: [1, 2, 3], expected: [1, 2, 3, 4], expectSuccess: False)
Mockolate.Tests.Web.ItExtensionsTests+IsBinaryContentTests ‑ Containing_ShouldCheckForEquality(body: [1, 2, 3], expected: [1, 2, 3], expectSuccess: True)
Mockolate.Tests.Web.ItExtensionsTests+IsBinaryContentTests ‑ Containing_ShouldCheckForEquality(body: [1, 2, 3], expected: [1, 2], expectSuccess: True)
Mockolate.Tests.Web.ItExtensionsTests+IsBinaryContentTests ‑ Containing_ShouldCheckForEquality(body: [1, 2, 3], expected: [1, 3], expectSuccess: False)
Mockolate.Tests.Web.ItExtensionsTests+IsBinaryContentTests ‑ Containing_ShouldCheckForEquality(body: [1, 2, 3], expected: [1], expectSuccess: True)
Mockolate.Tests.Web.ItExtensionsTests+IsBinaryContentTests ‑ Containing_ShouldCheckForEquality(body: [1, 2, 3], expected: [2, 3], expectSuccess: True)
Mockolate.Tests.Web.ItExtensionsTests+IsBinaryContentTests ‑ Containing_ShouldCheckForEquality(body: [1, 2, 3], expected: [2], expectSuccess: True)
Mockolate.Tests.Web.ItExtensionsTests+IsBinaryContentTests ‑ Containing_ShouldCheckForEquality(body: [1, 2, 3], expected: [3], expectSuccess: True)
Mockolate.Tests.Web.ItExtensionsTests+IsBinaryContentTests ‑ Containing_ShouldCheckForEquality(body: [1], expected: [1], expectSuccess: True)
Mockolate.Tests.Web.ItExtensionsTests+IsBinaryContentTests ‑ Containing_ShouldCheckForEquality(body: [1], expected: [2], expectSuccess: False)
…

Mockolate.Tests.Web.ItExtensionsTests+IsHttpContentTests ‑ ShouldSupportMonitoring
Mockolate.Tests.Web.ItExtensionsTests+IsHttpContentTests ‑ ShouldVerifyMediaType(mediaType: "image/gif", expectSuccess: False)
Mockolate.Tests.Web.ItExtensionsTests+IsHttpContentTests ‑ ShouldVerifyMediaType(mediaType: "image/png", expectSuccess: True)
Mockolate.Tests.Web.ItExtensionsTests+IsHttpContentTests ‑ ShouldVerifyMediaType(mediaType: "text/plain", expectSuccess: False)
Mockolate.Tests.Web.ItExtensionsTests+IsHttpContentTests ‑ WithMediaType_ShouldVerifyMediaType(mediaType: "image/gif", expectSuccess: False)
Mockolate.Tests.Web.ItExtensionsTests+IsHttpContentTests ‑ WithMediaType_ShouldVerifyMediaType(mediaType: "image/png", expectSuccess: True)
Mockolate.Tests.Web.ItExtensionsTests+IsHttpContentTests ‑ WithMediaType_ShouldVerifyMediaType(mediaType: "text/plain", expectSuccess: False)
Mockolate.Tests.Web.ItExtensionsTests+IsHttpContentTests+WithBytesContainingTests ‑ ShouldCheckForEquality(body: [1, 2, 3], expected: [1, 2, 3, 4], expectSuccess: False)
Mockolate.Tests.Web.ItExtensionsTests+IsHttpContentTests+WithBytesContainingTests ‑ ShouldCheckForEquality(body: [1, 2, 3], expected: [1, 2, 3], expectSuccess: True)
Mockolate.Tests.Web.ItExtensionsTests+IsHttpContentTests+WithBytesContainingTests ‑ ShouldCheckForEquality(body: [1, 2, 3], expected: [1, 2], expectSuccess: True)
…

♻️ This comment has been updated with latest results.

[Copilot]

Pull request overview

Copilot reviewed 26 out of 26 changed files in this pull request and generated 8 comments.

[Copilot]

Pull request overview

Copilot reviewed 27 out of 27 changed files in this pull request and generated 5 comments.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
97.4% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[github-actions]

This is addressed in release v1.3.0.