HTTPX -> HTTPX2 Migration

[paultiq]

httpx project has been closed by the maintainer.

Pydantic has stepped in with a fork: httpx2.

I'm opening this issue to suggest migrating to httpx2:

• update httpxthrottlecache to latest (0.5.0), to switch to httpx2
• edgartools: change httpx to httpx2
• edgartools: review code - there's a number of small mentions / references to httpx. These would need to change to httpx2.

Note:

• httpx2 and httpx can coexist: httpx2 has a separate namespace (doesn't touch httpx) so users can use both side by side. Alias 'httpx2' as 'httpx' pydantic/httpx2#963

[dgunning]

Confirmed, and we are already feeling this. pyproject.toml currently pins:

# Cap below 0.5.0: that release migrated from httpx to the httpx2 fork, which
# breaks edgartools (we import plain httpx throughout httprequests.py and our
# tests mock httpx). 0.3.5 is the latest version still on plain httpx.
"httpxthrottlecache>=0.3.0,<0.5.0",

So every httpxthrottlecache release from 0.5.0 onward is unreachable until this migration lands — the cap is a stopgap, not a position.

Footprint is moderate: 104 httpx references across 17 files under edgar/ (concentrated in httprequests.py) and 142 across 10 test files, mostly mocks and monkeypatching.

Two things I want to settle before starting, and I would value your read on both:

1. vcrpy. We already pin vcrpy<8.2 because 8.2.0 reintroduced an httpx stub that broke replay; 8.1.1 intercepts via httpcore_stubs.py. Cassette replay is load-bearing for our network suite, so I need to know whether vcrpy intercepts httpx2 at all before committing. If it does not, that becomes the gating work rather than the import swap.
2. Exception types are public surface. Users catch httpx.HTTPStatusError, httpx.TimeoutException and friends around our calls. Swapping the namespace changes what they have to catch. Leaning toward re-exporting the exception types we actually raise through, so user code keeps working, plus a prominent changelog note — but happy to be argued out of it.

Tracked as edgartools-q2iz (P1). Thanks for flagging it early with the concrete step list.

[paultiq]

** This is a lot easier now since httpx2 added a helpful "alias_httpx" pydantic/httpx2#1077

Good point. I just shipped httpxthrottlecache 0.6.0 which makes httpx2 / httpx optional-dependencies so you / user can decide which lib to use.

I'd suggest edgartools do the same... maybe add a documentation and/or warning around httpx.