Sample
httpx 0.28.1: Configure httpx timeouts across connect, read, write, and pool phases without falling for requests-style unbounded defaults, partial kwarg ValueError traps, or 2-tuple unlimited-write surprises
Verified sample for pypi httpx 0.28.1: Configure httpx timeouts across connect, read, write, and pool phases without falling for requests-style unbounded…
sha256:1ddf2062ed8d42a754be36dfc77a7d14fc9f7b8e095bca0e0a8323388c1e63dd
This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured.
How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people.
MIT-0
Execution evidence
The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.
- Evidence basis
- Signed contract pass
- Verification receipts
- 2
- Signing keys that built it
- 2
Declared environment
python linux x64 python python pip
Verification-run environments
| Environment | Contract | Stages | Run |
|---|---|---|---|
| python 3.12 · linux alpine/x64 · docker ed25519:ac1544ece1e22594 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · python@1 |
2026-08-15 |
| python 3.12 · linux alpine/x64 · docker ed25519:d91480838ac982c9 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · python@1 |
2026-08-18 |
Case
HOW- Goal
- Configure httpx timeouts across connect, read, write, and pool phases without falling for requests-style unbounded defaults, partial kwarg ValueError traps, or 2-tuple unlimited-write surprises
- Packages
- Symbols
-
- httpx.Timeout
- httpx.Client
- httpx.ConnectTimeout
- httpx.ReadTimeout
- httpx.WriteTimeout
- httpx.PoolTimeout
- httpx.TimeoutException
- httpx.USE_CLIENT_DEFAULT
- Environment
- python
- Created
- 2026-08-15T08:26:26Z
Contract
- assert httpx.Client default timeout is 5.0 seconds across all 4 phases (connect, read, write, pool), unlike requests which defaults to None
- assert httpx.Timeout() with no arguments raises ValueError rather than returning the 5.0 default configuration
- assert httpx.Timeout(read=10.0) raises ValueError without a positional default argument or all four explicit kwargs
- assert httpx.Timeout(5.0, read=10.0) sets read to 10.0 and keeps connect, write, and pool at 5.0
- assert passing a 2-tuple (connect, read) sets write and pool to None (unlimited), not 5.0
- assert passing a 4-tuple sets connect, read, write, and pool in explicit positional order
- assert timeout=None at the request level explicitly disables all timeouts even when the client has a positive timeout configured
- assert request.extensions['timeout'] carries the resolved 4-phase dictionary into the transport layer
- assert ConnectTimeout, ReadTimeout, WriteTimeout, and PoolTimeout all subclass TimeoutException and RequestError, but not HTTPStatusError
Files
- NOTES.md
- csx.json
- requirements.lock
- requirements.txt
- src/__init__.py
- src/timeouts.py
- test/__init__.py
- test/contract.py