Gabbium.HttpClientTestExtensions 1.0.1

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.