Fluent.Client 1.1.0

<div align="center"> <h1>🌊 Fluent.Client</h1> <h3><em>A fluent HTTP client wrapper for .NET.</em></h3> </div>

<p align="center"> <strong>Build HTTP requests with a clean, chainable API. Less boilerplate, more productivity.</strong> </p>

<p align="center"> <a href="https://www.nuget.org/packages/Fluent.Client"><img src="https://img.shields.io/nuget/v/Fluent.Client.svg" alt="NuGet"/></a> <a href="https://www.nuget.org/packages/Fluent.Client"><img src="https://img.shields.io/nuget/dt/Fluent.Client.svg" alt="NuGet Downloads"/></a> <a href="https://github.com/lepoco/fluent/stargazers"><img src="https://img.shields.io/github/stars/lepoco/fluent?style=social" alt="GitHub stars"/></a> <a href="https://github.com/lepoco/fluent/blob/main/LICENSE"><img src="https://img.shields.io/github/license/lepoco/fluent" alt="License"/></a> </p>

<p align="center"> <a href="https://lepo.co/">Created in Poland by Leszek Pomianowski</a> and <a href="https://github.com/lepoco/fluent/graphs/contributors">open-source community</a>. </p>

Table of Contents

• Table of Contents
• 🤔 Why This Library?
• ⚡ Get Started
  • Install the Package
  • Quick Example
• 📖 How to Use
  • 1. Create a Request
    • Available HTTP Methods
  • 2. Configure the Request
    • Authorization
    • Query Parameters
    • Chaining Multiple Configurations
  • 3. Send the Request
• 📚 API Reference
  • Request Creation Methods
  • Configuration Methods
  • Execution Methods
• 🧪 Testing with AwesomeAssertions
• 👥 Maintainers
• 💬 Support
• 📄 License

🤔 Why This Library?

Traditional HttpClient usage requires verbose setup:

// ❌ Traditional approach - verbose and repetitive
var request = new HttpRequestMessage(HttpMethod.Post, "/api/users");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
request.Content = new StringContent(
    JsonSerializer.Serialize(new { Name = "John" }),
    Encoding.UTF8,
    "application/json");
var response = await client.SendAsync(request);

With Fluent.Client, requests become expressive one-liners:

// ✅ Fluent approach - clean and readable
var response = await client
    .Authorize(token: "abc123")
    .Post("/api/users", new { Name = "John" })
    .SendAsync();

⚡ Get Started

Install the Package

dotnet add package Fluent.Client

📦 NuGet: https://www.nuget.org/packages/Fluent.Client

Quick Example

using Fluent.Client;

var client = new HttpClient { BaseAddress = new Uri("https://api.example.com/") };

// Simple POST with JSON body
var response = await client
    .Post("/api/users", new { Name = "John Doe" })
    .SendAsync();

📖 How to Use

1. Create a Request

Start by creating a request using one of the HTTP method extensions on HttpClient.

using Fluent.Client;

var client = new HttpClient { BaseAddress = new Uri("https://api.example.com/") };

// POST with JSON body
var request = client.Post("/api/v1/users", new { Name = "John Doe" });

// GET with query parameters
var request = client.Get("/api/v1/users", new { page = 1, limit = 10 });

// DELETE
var request = client.Delete("/api/v1/users/897");

// PUT with body
var request = client.Put("/api/v1/users/897", new { Name = "Jane Doe" });

Available HTTP Methods

2. Configure the Request

Chain configuration methods to add headers, authorization, and more.

Authorization

// Bearer token
client.Authorize(token: "jwt-token-here").Get("/api/protected");

// Basic authentication
client.Authorize(username: "john", password: "secret").Get("/api/protected");

Query Parameters

// Pass as anonymous object
client.Get("/api/users", new 
{ 
    page = 1, 
    limit = 10, 
    sortBy = "createdAt" 
});

Chaining Multiple Configurations

var request = client
    .Authorize(token: "abc123")
    .Get("/api/v1/basket", new { includeItems = true });

3. Send the Request

Send the request and handle the response.

<details open> <summary><strong>Get HttpResponseMessage</strong></summary>

using HttpResponseMessage response = await request.SendAsync();

if (response.IsSuccessStatusCode)
{
    var content = await response.Content.ReadAsStringAsync();
    Console.WriteLine(content);
}

</details>

<details> <summary><strong>Deserialize Response Automatically</strong></summary>

// Automatically deserialize JSON response to typed object
UserCreatedResponse result = await request.SendAsync<UserCreatedResponse>();

Console.WriteLine($"Created user: {result.Id}");

</details>

<details> <summary><strong>Direct Execution (No SendAsync)</strong></summary>

// The request returns Task<HttpResponseMessage>, so you can await directly
using var response = await client
    .Authorize(token: "abc123")
    .Post("/api/users", new { Name = "John" });

</details>

📚 API Reference

Request Creation Methods

Configuration Methods

Execution Methods

🧪 Testing with AwesomeAssertions

Pair this library with Fluent.Client.AwesomeAssertions for expressive test assertions:

await client
    .Authorize(token: "abc123")
    .Post("/api/users", new { Name = "John" })
    .Should()
    .Succeed("because valid user data was provided");

📦 Install: dotnet add package Fluent.Client.AwesomeAssertions

👥 Maintainers

• Leszek Pomianowski (@pomianowski)

💬 Support

For support, please open a GitHub issue. We welcome bug reports, feature requests, and questions.

📄 License

This project is licensed under the terms of the MIT open source license. Please refer to the LICENSE file for the full terms.

You can use it in private and commercial projects. Keep in mind that you must include a copy of the license in your project.