SwiftHttp

SwiftHttp is a lightweight, safe, and efficient HTTP client for .NET Standard 2.1
with built-in transient error handling, configurable retries, and jittered exponential backoff.

Designed for high-performance applications that need resilience without the weight of large dependencies.

---

🚀 Installation

dotnet add package SwiftHttp

---

💡 Example Usage

using SwiftHttp;
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var client = new SwiftHttpClient(new SwiftHttpOptions
        {
            MaxRetries = 3,
            BaseDelay = TimeSpan.FromMilliseconds(200),
            MaxDelay = TimeSpan.FromSeconds(10),
            UseJitter = true
        });

        using var response = await client.GetAsync("https://httpbin.org/status/503");
        Console.WriteLine($"Status: {response.StatusCode}");
    }
}

---

✨ Features

• .NET Standard 2.1
• Configurable max retries and backoff
• Jittered exponential backoff to avoid retry storms
• Respects Retry-After header for polite API usage
• Prevents socket exhaustion by reusing HttpClient
• Handles common transient errors (HTTP 408, 429, 5xx, timeouts)
• Small and dependency-free

---

🧪 Running Tests

dotnet test

---

📦 Project Structure

src/SwiftHttp/           # Library
tests/SwiftHttp.Tests/   # Unit tests
examples/ConsoleDemo/    # Sample console app

---

🤝 Contributing

Contributions are welcome!

1. Fork the repo
2. Create a feature branch
3. Submit a pull request

---

📜 License

MIT License – see LICENSE for details.
Copyright (c) 2025 Junilo Pagobo

---

🌐 Links

• NuGet: SwiftHttp on NuGet