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	Description	NuGet	Downloads
DamianH.HttpHybridCacheHandler	RFC 9111 client-side HTTP caching handler for HttpClient
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

Repository Structure

The HTTP cache also has separately versioned content-store packages for Azure Blob Storage, Amazon S3, Google Cloud Storage, and local files, sharing a provider-independent ContentStore package. Cloud adapters use official SDKs.

hybrid-cache-handler/         # RFC 9111 HTTP caching DelegatingHandler
file-distributed-cache/       # File-based IDistributedCache implementation
structured-field-values/      # RFC 8941/9651 structured field values
signatures/                   # RFC 9421 HTTP message signatures
forwarded-headers/            # RFC 7239 Forwarded parser and ASP.NET Core middleware
docs/Docs/Content/docs/        # Detailed documentation, grouped by library

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, 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.