http-libs

A collection of .NET libraries for HTTP caching, structured field values, message signatures, and trusted-proxy forwarding.

Documentation · Get started · Contributing

Packages

Package	Badges
DamianH.Http.HybridCacheHandler RFC 9111 client-side HTTP caching handler for HttpClient
DamianH.Http.HybridCacheHandler.ContentStore Provider-independent streaming contracts for HTTP cache content stores
DamianH.Http.HybridCacheHandler.ContentStore.AzureBlob HTTP cache body storage using Azure Blob Storage and the official Azure SDK
DamianH.Http.HybridCacheHandler.ContentStore.S3 HTTP cache body storage using Amazon S3 and the official AWS SDK
DamianH.Http.HybridCacheHandler.ContentStore.GoogleCloudStorage HTTP cache body storage using Google Cloud Storage and the official Google SDK
DamianH.Http.HybridCacheHandler.ContentStore.FileSystem HTTP cache body storage using local files
DamianH.FileDistributedCache Local-file IDistributedCache / IBufferDistributedCache for single-process persistent caching
DamianH.Http.StructuredFieldValues RFC 8941/9651 parser, serializer, and POCO mapper for HTTP Structured Field Values
DamianH.Http.HttpSignatures RFC 9421 HTTP Message Signatures for signing and verifying HTTP messages
DamianH.Http.ForwardedHeaders RFC 7239 Forwarded parser and trusted-proxy middleware for ASP.NET Core
DamianH.Http.ForwardProxy HTTP forward (egress) proxy for Kestrel with CONNECT tunnels, proxy authentication and SSRF protection

Build and test

Requires the .NET 10 SDK. Run from the repository root; each library has its own build script and solution filter:

dotnet run signatures/build.cs -- build   # or: forwarded-headers, forward-proxy, structured-field-values, hybrid-cache-handler, file-distributed-cache
dotnet run signatures/build.cs -- test    # per library
dotnet build http-lib.slnx                # whole solution
dotnet test --solution http-lib.slnx      # all tests

Local documentation

From the repository root:

dotnet run docs/build.cs -- build     # restore, build, generate, and check
dotnet run docs/build.cs -- check     # check existing output and run negative self-tests
dotnet run docs/build.cs -- preview   # build, check, and serve locally

The build restores the repository-local Atoll CLI. The site uses the same Lagoon theme as microstack. See the authoring and preview guide for source locations and link conventions.

License

MIT — see LICENSE.

Contributing

Bug reports should be accompanied by a reproducible test case in a pull request. See Contributing for the full workflow.