@chrismichaelps / pudu-lang-httpclient
Named HTTP clients for Pudu: a client factory, delegating handlers, pooled keep-alive connections, handler lifetimes, logging, and resilience
0.1.1Apache-2.01
InstallClose
Use @chrismichaelps/pudu-lang-httpclient
Install this release
From your project, run:
pudu install @chrismichaelps/pudu-lang-httpclient@0.1.1An exact version can install a new release immediately. Without a version, pudu follows the 72-hour minimum release age for new resolutions.
pudu install @chrismichaelps/pudu-lang-httpclientThen import it
import PuduLangHttpClient as PuduLangHttpClientTo contribute
git clone https://github.com/chrismichaelps/pudu-lang-httpclient
ADR-0002-owned-transport.md
ADR-0002 — The package owns its transport
type: adr status: Accepted tags: [adr]
Context
Std.Http.Client sends connection: close and opens a new connection, and for https a new handshake, for every request. A factory's value is reusing connections per name, bounding them per server, and renewing them by lifetime.
Decision
[[src/PuduLangHttpClient/Transport]] speaks HTTP/1.1 over Std.Net and Std.Tls itself: it pools connections per route ([[src/PuduLangHttpClient/Transport/Pool]]), reads each response's framing exactly ([[src/PuduLangHttpClient/Transport/Exchange]]), and reuses the parsers and safety checks of Std.Http, Std.Http.Message, and Std.Http.Safe.
Consequences
- Keep-alive, connection lifetimes, idle timeouts, per-server limits, proxies with tunnels, and streamed bodies are all possible.
- The transport speaks HTTP/1.0 and 1.1; HTTP/2 requests are downgraded or refused by policy.
- Client certificates are not offered:
Std.Tlsin 0.1.3 has no way to present one.
Rejected
Std.Http.Client.sendper request: no reuse, no limits, no streaming.
Referenced by
[[CHANGELOG]] · [[decisions/_MOC]] · [[domain/Connection]] · [[handoffs/2026-10-06-initial-package]] · [[src/PuduLangHttpClient/Transport]] · [[subsystems/Transport]]