Home

Pudu HTTP Client

pudu-lang-httpclient gives Pudu programs named, configured HTTP clients, written in Pudu. A factory holds the configuration of every client — base address, default headers, timeout, delegating handlers, and the transport underneath — and hands out cheap clients over handler pipelines it owns, pools, and renews. Every request answers an Outcome: the response, or a Failure saying why there is none. Nothing is thrown.

This wiki documents the 0.1.0 API. Every program in it was checked with pudu check and run with pudu run against @chrismichaelps/pudu-lang-httpclient@0.1.0 on Pudu 0.1.3. The versioned design notes live in the repository wiki/ directory.

Reading the book

The chapters follow the order in which you meet the API. New readers should begin with Getting Started. The Reference Index lists every module on one page.

Part I — Sending

1. Getting Started
2. Requests And Responses
3. Clients

Part II — Configuring

4. Named And Typed Clients
5. Handlers And Pipelines
6. The Transport
7. Lifetimes And Events

Part III — Beyond one request

8. Resilience
9. Logging, Propagation, And Metrics
10. Endpoints And JSON
11. Testing With Stubs

The Worked Programs appendix lists the complete programs in the repository's examples/ directory, ready to run.

Repository

• Source
• Release 0.1.0
• Pudu language