HttpClient Test Extensions

---

📌 About

Gabbium.HttpClientTestExtensions provides fluent, readable assertions for HttpResponseMessage in integration and functional tests. It focuses on clarity (response.ShouldBeOkWithBody<T>()) and common web testing scenarios, including ProblemDetails and ValidationProblemDetails.

Use it to:

• Make readable and expressive HTTP assertions in tests.
• Standardize JSON body reading and type checks across test suites.
• Assert ProblemDetails-based error responses consistently.

---

✨ Highlights

• ✅ Fluent assertions for HttpResponseMessage (e.g., ShouldBeOkWithBody<T>(), ShouldBeNoContent()).
• 📦 Built-in JSON handling using System.Text.Json with JsonSerializerDefaults.Web.
• 🧰 First-class support for ProblemDetails and ValidationProblemDetails.
• 🧪 Designed for ASP.NET Core integration/functional tests with HttpClient.
• 🪶 Lightweight and dependency-minimal.

---

📦 Installation

dotnet add package Gabbium.HttpClientTestExtensions

---

🚀 Quick Start

using System.Net; using System.Net.Http.Json; using HttpClientTestExtensions; // your library namespace public sealed record UserDto(Guid Id, string Name); var response = await client.PostAsJsonAsync("/api/users", new { Name = "Alice" }); // Created with body + checks Location header against the created resource var created = await response.ShouldBeCreatedWithBodyAndLocation<UserDto>(x => $"/api/users/{x.Id}"); // Later on... var get = await client.GetAsync($"/api/users/{created.Id}"); var body = await get.ShouldBeOkWithBody<UserDto>(); body.Name.ShouldBe("Alice");

---

🔎 Common Scenarios

response.ShouldBeOk(); await response.ShouldBeOkWithBody<MyDto>(); response.ShouldBeCreated(); await response.ShouldBeCreatedWithBody<MyDto>(); await response.ShouldBeCreatedWithBodyAndLocation<MyDto>(x => $"/api/items/{x.Id}"); response.ShouldBeNoContent(); await response.ShouldBeBadRequestWithValidation(); await response.ShouldBeBadRequestWithProblem(); response.ShouldBeUnauthorized(); response.ShouldBeForbidden(); await response.ShouldBeNotFoundWithProblem(); await response.ShouldBeConflictWithProblem(); await response.ShouldBeUnprocessableEntityWithProblem();

---

💡 Notes

• Uses Constants.DefaultJsonOptions (configured with JsonSerializerDefaults.Web and JsonStringEnumConverter).
• Works seamlessly with Shouldly or FluentAssertions for body-level comparisons.
• Perfect for xUnit or NUnit integration test suites.

---

🪪 License

This project is licensed under the MIT License — see LICENSE for details.