Commencis.Core.Http 1.0.1

Commencis.Core.Http

A powerful HTTP client wrapper library for .NET applications that provides retry mechanism with Polly and gzip compression support.

Features

• 🚀 HTTP client wrapper with retry mechanism
• 🔄 Polly integration for resilient HTTP requests
• 📦 Gzip compression support
• 🛠️ Easy to configure and use
• 🔍 Detailed logging support

Installation

dotnet add package Commencis.Core.Http

Quick Start

1. Register the HTTP client in your Program.cs or Startup.cs:

using Commencis.Core.Http;
using Commencis.Core.Http.Base;
using System.Text.Json;

// Configure services
builder.Services.RegisterFusionHttpClient<IYourHttpClient, YourHttpClient>(
    new FusionClientOptions.Builder()
        .WithRetryPolicy(new RetryPolicyOptions(2, TimeSpan.FromSeconds(90)))
        .WithJsonSerializerOptions(new JsonSerializerOptions 
        { 
            PropertyNamingPolicy = JsonNamingPolicy.CamelCase 
        })
        .Build(new Uri("https://api.example.com")));

2. Create your HTTP client interface:

public interface IYourHttpClient : IFusionClientWrapper
{
    // Your custom methods here
}

3. Implement your HTTP client:

public class YourHttpClient : FusionClientWrapper, IYourHttpClient
{
    public YourHttpClient(IHttpClientFactory httpClientFactory) 
        : base(httpClientFactory)
    {
    }

    // Implement your custom methods
}

4. Use in your services:

public class YourService
{
    private readonly IYourHttpClient _httpClient;

    public YourService(IYourHttpClient httpClient)
    {
        _httpClient = httpClient;
    }

    public async Task<YourModel> GetDataAsync()
    {
        return await _httpClient.GetAsync<YourModel>("api/endpoint");
    }
}

Configuration Options

Retry Policy

var retryPolicy = new RetryPolicyOptions(
    retryCount: 2,                               // Number of retries
    retryWaitDuration: TimeSpan.FromSeconds(90)  // Wait duration between retries
);

JSON Serialization

var jsonOptions = new JsonSerializerOptions
{
    PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
    PropertyNameCaseInsensitive = true
};

License

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