GM.HttpClient 1.2.0

<p align="center"> <img src="https://raw.githubusercontent.com/gmetskhvarishvili/GM.HttpClient/master/icon.png" alt="GM.HttpClient" width="140" height="140" /> </p>

GM.HttpClient

A lightweight, dependency-injection-friendly HttpClient for .NET. One registration call wires a Refit client to a typed options section and layers on a configurable Polly resilience pipeline plus a set of delegating handlers. Part of the GM.* family of packages. Targets net10.0.

Out of the box each client gets:

• Resilience — retry (exponential backoff), circuit breaker, timeout, and an optional fallback response.
• Authorization — optional Basic auth from configuration.
• Response caching — in-memory caching of successful GET responses.
• Header injection — static headers applied to every request.
• Context propagation — forwards the caller's IP as X-Client-IP when an HttpContext is present.
• Structured logging — request/response logging with timing via ILogger.

Install

dotnet add package GM.HttpClient

Uses the ASP.NET Core shared framework (Microsoft.AspNetCore.App) for IHttpContextAccessor, so consumers should build on the ASP.NET Core (Microsoft.NET.Sdk.Web) SDK.

Configure

Bind options from a configuration section (shape matches GMAPIClientOptions):

{
  "GitHubApi": {
    "BaseUrl": "https://api.github.com",
    "Headers": { "User-Agent": "my-app" },
    "RetryPolicy": { "RetryCount": 3 },
    "CircuitBreakerPolicy": { "FailureThreshold": 2, "BreakDuration": "00:00:30" },
    "TimeoutPolicy": { "Timeout": "00:00:10" },
    "FallbackPolicy": { "UseFallback": true },
    "Authorization": { "UseAuthorization": false },
    "Caching": { "EnableCaching": true, "CacheDuration": "00:05:00" }
  }
}

Register

Define a Refit interface, then register it against a configuration section and a client name:

using GM.HttpClient;
using Refit;

public interface IGitHubApi
{
    [Get("/users/{user}")]
    Task<GitHubUser> GetUserAsync(string user);
}

var section = builder.Configuration.GetSection("GitHubApi");

builder.Services.AddGMHttpClient<IGitHubApi, GMAPIClientOptions>(
    configSection: section,
    clientName: "GitHubApi");

Use

Inject the Refit interface anywhere — the resilience pipeline and handlers run on every call:

public class ProfileService(IGitHubApi api)
{
    public Task<GitHubUser> GetAsync(string user) => api.GetUserAsync(user);
}

AddGMHttpClient also accepts optional hooks for extra registrations and custom handlers:

builder.Services.AddGMHttpClient<IGitHubApi, GMAPIClientOptions>(
    section,
    "GitHubApi",
    additionalConfig: (services, cfg) => { /* extra options binding */ },
    customHandlers:   services => { /* register your own DelegatingHandlers */ });

Contributing & releases

Versioning, tags, the changelog, and publishing are automated from Conventional Commits — see CONTRIBUTING.md.

License

MIT — see LICENSE.