VitoRestbox 1.0.0

📘 VitoRestbox

VitoRestbox is a clean, expressive HTTP request builder for .NET, designed to simplify REST API calls and enrich your application's communication with external services. Inspired by the name Vito—derived from the Latin word vita, meaning “life”—this library brings clarity, vitality, and composability to your HTTP interactions.

✨ Features

✅ Fluent, sentence-like API for building HTTP requests
✅ Supports all HTTP verbs: GET, POST, PUT, PATCH, DELETE
✅ Built-in JSON serialization with customizable options
✅ Header and authentication injection
✅ Flexible .WithHeaders(...) builder pattern
✅ Lifecycle hooks:

• BeforeSend for request inspection
• AfterSend for response handling
• OnFailure for error tracking
• OnException for graceful fallback
  ✅ Timeout configuration with .WithTimeout(...)
  ✅ Exception control with .SuppressExceptions(...)
  ✅ Sync and async execution support
  ✅ Works seamlessly with HttpClient and DI containers

🚀 Quick Start

var result = await VitoRestboxRequest
    .New(httpClient)
    .To("https://api.example.com/users")
    .WithBearerToken("your-token")
    .Post(new { name = "Reza" })
    .SendAsync<UserResponse>();

🧠 Fluent Header Builder

You can inject multiple headers using chained or multiple lambdas:

.WithHeaders
(
    h => h.Add("Authorization", "Bearer xyz"),
    h => h.Add("X-Request-ID", Guid.NewGuid().ToString())
)

Or use a single chained builder:

.WithHeaders(h => h.Add("Authorization", "Bearer xyz").Add("X-Request-ID", Guid.NewGuid().ToString()))

⏱ Timeout & Exception Control

Set a timeout for the request:

.WithTimeout(15) // Timeout after 15 seconds

Suppress exceptions and handle failures manually:

.SuppressExceptions() // Prevents exceptions from being thrown

📦 Installation

dotnet add package VitoRestbox

Or via NuGet Package Manager:

Install-Package VitoRestbox

🧪 Testing

VitoRestbox is fully testable with xUnit, FluentAssertions, and custom HttpMessageHandler mocks. See VitoRestboxRequestTests.cs for examples.

📖 Philosophy

In Latin, vita means "life"—and VitoRestbox aims to bring life to your API calls by making HTTP communication readable, composable, and expressive. Whether you're building microservices, SDKs, or internal tools, this library helps you express intent and outcome with precision.

👤 Author

Reza Ghadimi
🔗 LinkedIn
🐙 GitHub Profile
📦 VitoRestbox Repository

📄 License

MIT License