HttpStudio 1.0.0

HttpStudio

A lightweight, developer-friendly wrapper around HttpClient that simplifies making HTTP requests (GET, POST, PUT, PATCH, DELETE, File Uploads, and File Downloads) in .NET.

It provides generic response handling, header support, file uploads/downloads, and consistent error handling using a custom HttpHelperException.

🚀 Installation

Install via NuGet Package Manager:

dotnet add package HttpStudio

Or in Visual Studio Package Manager Console:

Install-Package HttpStudio

📖 Quick Start

🔹 ASP.NET Core (Dependency Injection)

Register HttpHelper in your DI container:

builder.Services.AddHttpClient<HttpHelper>(client =>
{
    client.BaseAddress = new Uri("https://yourapiurl/");
});

Inject and use it:

public class UserService
{
    private readonly HttpHelper _httpHelper;

    public UserService(HttpHelper httpHelper)
    {
        _httpHelper = httpHelper;
    }

    public async Task GetUserAsync()
    {
        var user = await _httpHelper.GetAsync<User>("users/1");
        Console.WriteLine(user.Name);
    }
}

🔹 Console App (Without Dependency Injection)

using HttpStudio;

class Program
{
    static async Task Main(string[] args)
    {
        using var httpClient = new HttpClient
        {
            BaseAddress = new Uri("https://yourapiurl/")
        };

        var httpHelper = new HttpHelper(httpClient);

        var userJson = await httpHelper.GetAsync<string>("users/1");
        Console.WriteLine(userJson);
    }
}

⚡ Features & Usage

🔄 Generic Response Handling

• Get raw JSON/string
• Or deserialize directly into your own models

// Raw string
var userJson = await httpHelper.GetAsync<string>("users/1");

// Strongly-typed
var user = await httpHelper.GetAsync<User>("users/1");
Console.WriteLine(user.Name);

👉 Works across GET, POST, PUT, PATCH, DELETE

✅ Supported Methods

GET

var user = await httpHelper.GetAsync<User>("users/1");

POST (JSON body)

var result = await httpHelper.PostAsync<User, object>(
    "users",
    new { Name = "Bhai Shahb", Email = "test@email.com" }
);

PUT

var updated = await httpHelper.PutAsync<User, User>("users/1", updatedUser);

PATCH

var patched = await httpHelper.PatchAsync<User, object>(
    "users/1",
    new { Name = "Updated Name" }
);

DELETE

var response = await httpHelper.DeleteAsync<string>("users/1");

📤 Multipart Form-Data (File Uploads)

using var fileStream = File.OpenRead("photo.png");

var result = await httpHelper.PostFormDataAsync(
    "upload",
    formFields: new Dictionary<string, string>
    {
        { "userId", "123" }
    },
    files: new List<(string, string, Stream, string)>
    {
        ("file", "photo.png", fileStream, "image/png")
    }
);

📥 File Download

Save to Disk

await httpHelper.DownloadFileAsync(
    "files/report.pdf",
    "C:/Downloads/report.pdf"
);

Stream the File (without saving)

using var stream = await httpHelper.DownloadFileAsStreamAsync("files/report.pdf");
// Forward stream to browser, cloud storage, etc.

📝 Headers

Both single-value and multi-value headers are supported:

var headers = new Dictionary<string, string>
{
    { "Authorization", "Bearer my-jwt-token" }
};

var multiHeaders = new Dictionary<string, IEnumerable<string>>
{
    { "Accept", new[] { "application/json", "text/plain" } }
};

var response = await httpHelper.GetAsync<string>(
    "users/1",
    headers,
    multiHeaders
);

⏳ Cancellation Tokens

Every method supports cancellation:

using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var user = await httpHelper.GetAsync<User>("users/1", cancellationToken: cts.Token);

⚠️ Error Handling

All methods throw a HttpHelperException when:

• The server returns a non-success status code
• The response cannot be deserialized
• Network issues or timeouts occur

Example:

try
{
    var user = await httpHelper.GetAsync<User>("users/999");
}
catch (HttpHelperException ex)
{
    Console.WriteLine($"Error: {ex.Message}, Status: {ex.StatusCode}");
    Console.WriteLine($"Response: {ex.ResponseBody}");
}

✅ Benefits

• 🚫 No more HttpClient boilerplate
  Simple methods for GET, POST, PUT, PATCH, DELETE.

• 🔄 Flexible generic responses
  Return raw JSON (string) or deserialize into typed objects.

• 📦 File uploads via multipart/form-data
  Upload files along with additional form fields.

• 📥 File downloads
  Save directly to disk or return as a stream.

• 📝 Full header control
  Add single or multi-value headers to requests.

• ⏳ Cancellation & timeout support
  All methods accept CancellationToken.

• ⚡ Consistent exception handling
  All failures throw HttpHelperException with status code, content, and inner error.

• 🧩 Works in ASP.NET Core (with DI) or Console Apps
  Just inject or pass an HttpClient instance.

📌 Requirements

• .NET 6.0 or later