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

@vdusekvdusek 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

@vdusekvdusek 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
@vdusekvdusek self-assigned this Aug 17, 2026
@codecov

codecovBot commented Aug 17, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.01%. Comparing base (4b5a50e) to head (ccfd59f).

Additional details and impacted files
@@ Coverage Diff @@## add-httpx-client #1013 +/- ##
=================================================
Coverage 95.01% 95.01% =================================================
Files 59 59 Lines 5501 5501 =================================================
Hits 5227 5227 Misses 274 274 
FlagCoverage Δ
integration92.05% <ø> (-0.02%)⬇️
unit85.96% <ø> (ø)

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
vdusekforce-pushed the docs-custom-http-client-guide branch from 424c3f0 to 7d38520CompareAugust 17, 2026 20:30
@vdusek
vdusek changed the base branch from fix-transport-retry-classification to masterAugust 18, 2026 18:23
@vdusek
vdusekforce-pushed the docs-custom-http-client-guide branch from 7d38520 to 71bfaa3CompareAugust 19, 2026 06:25
@vdusek
vdusekforce-pushed the docs-custom-http-client-guide branch from 71bfaa3 to e51e3bdCompareAugust 19, 2026 06:57
@github-actionsgithub-actionsBot added the tested Temporary label used only programatically for some analytics. label Aug 19, 2026
@vdusekvdusek changed the title docs: Rewrite the custom HTTP client guide around the transport-hook contractdocs: Document the transport-hook contract and the built-in HTTPX clientAug 19, 2026
@vdusek
vdusek changed the base branch from master to add-httpx-clientAugust 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 ownerAugust 19, 2026 07:07
@vdusek
vdusek marked this pull request as draft August 19, 2026 07:45
@vdusek
vdusekforce-pushed the docs-custom-http-client-guide branch from e51e3bd to ccfd59fCompareAugust 19, 2026 16:37
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

adhocAd-hoc unplanned task added during the sprint.t-toolingIssues with this label are in the ownership of the tooling team.testedTemporary label used only programatically for some analytics.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@vdusek@apify-service-account