Skip to content

docs: Document the transport-hook contract and the built-in HTTPX client - #1013

Draft
vdusek wants to merge 1 commit into
add-httpx-clientfrom
docs-custom-http-client-guide
Draft

docs: Document the transport-hook contract and the built-in HTTPX client#1013
vdusek wants to merge 1 commit into
add-httpx-clientfrom
docs-custom-http-client-guide

Conversation

@vdusek

@vdusek vdusek commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Rewrites the HTTP clients concepts page around the three-layer hierarchy and the transport hooks, documents the built-in HTTPX client from #1004 (installation, sync/async examples, timeout semantics), and replaces the old HTTPX guide with "Build a custom HTTP client", which implements full AIOHTTP and requests clients including response adapters for the HttpResponse protocol.

Stack: #1022 (pipeline) → #1004 (HTTPX client) → #1013 (this). Split out of #1006.

✍️ Drafted by Claude Code

@vdusek vdusek added adhoc Ad-hoc unplanned task added during the sprint. t-tooling Issues with this label are in the ownership of the tooling team. labels Aug 17, 2026
@vdusek vdusek self-assigned this Aug 17, 2026
@codecov

codecov Bot commented Aug 17, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.97%. Comparing base (2760925) to head (e51e3bd).

Additional details and impacted files
@@                Coverage Diff                @@
##           add-httpx-client    #1013   +/-   ##
=================================================
  Coverage             94.97%   94.97%           
=================================================
  Files                    59       59           
  Lines                  5469     5469           
=================================================
  Hits                   5194     5194           
  Misses                  275      275           
Flag Coverage Δ
integration 91.97% <ø> (ø)
unit 85.44% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@vdusek
vdusek force-pushed the docs-custom-http-client-guide branch from 424c3f0 to 7d38520 Compare August 17, 2026 20:30
@vdusek
vdusek changed the base branch from fix-transport-retry-classification to master August 18, 2026 18:23
@vdusek
vdusek force-pushed the docs-custom-http-client-guide branch from 7d38520 to 71bfaa3 Compare August 19, 2026 06:25
@github-actions github-actions Bot added this to the 147th sprint - Tooling team milestone Aug 19, 2026
@vdusek
vdusek force-pushed the docs-custom-http-client-guide branch from 71bfaa3 to e51e3bd Compare August 19, 2026 06:57
@github-actions github-actions Bot added the tested Temporary label used only programatically for some analytics. label Aug 19, 2026
@vdusek vdusek changed the title docs: Rewrite the custom HTTP client guide around the transport-hook contract docs: Document the transport-hook contract and the built-in HTTPX client Aug 19, 2026
@vdusek
vdusek changed the base branch from master to add-httpx-client August 19, 2026 06:57
@vdusek
vdusek marked this pull request as ready for review August 19, 2026 07:07
@vdusek
vdusek requested a review from szaganek as a code owner August 19, 2026 07:07
@vdusek
vdusek marked this pull request as draft August 19, 2026 07:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

adhoc Ad-hoc unplanned task added during the sprint. t-tooling Issues with this label are in the ownership of the tooling team. tested Temporary label used only programatically for some analytics.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants