@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-0003-factory-owned-pipelines.md
ADR-0003 — The factory builds, rotates, and closes pipelines
type: adr status: Accepted tags: [adr]
Context
A pipeline that lives forever keeps resolving a host to the addresses it found first; one built per request wastes connections. Pudu has no weak references or finalizers to learn when the last client of a pipeline is gone.
Decision
[[src/PuduLangHttpClient/Factory]] keeps one live pipeline per name for its handler lifetime (two minutes by default), then builds the next. A retired pipeline's transport is closed once it has outlived one more lifetime; a client still holding it keeps working, opening connections it closes. rotatingHandler gives long-lived code a sender that always uses the current pipeline.
Consequences
- Clients are cheap values made where needed.
withHandlerLifetime(INFINITE)pluswithPooledConnectionLifetimemoves renewal into the pool.
Rejected
- Never closing retired pipelines: their idle connections would leak.
- Closing them at once: clients made a moment before rotation would lose pooling immediately.
Referenced by
[[CHANGELOG]] · [[decisions/_MOC]] · [[domain/Lifetime]] · [[handoffs/2026-10-06-initial-package]] · [[subsystems/Factory]]