Add QUERY method support (RFC 10008)

[Diegorro98]

Summary

Implements the QUERY HTTP method as defined in RFC 10008 — a safe, idempotent method that carries a request body to express a query predicate.

Checklist

• I understand that this PR may be closed in case there was no previous discussion. (This doesn't apply to typos!)
• I've added a test for each change that was introduced, and I tried as much as possible to make a single atomic change.
• I've updated the documentation accordingly.

[codspeed-hq]

Merging this PR will not alter performance

✅ 15 untouched benchmarks
⏩ 7 skipped benchmarks¹

---

_{Comparing Diegorro98:implement-query-method-rfc10008 (cd0653a) with main (70fac53)}

Footnotes

1. 7 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

[cubic-dev-ai]

1 issue found across 9 files

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[mbeijen]

Nice, thanks. I think the biggest problem is this here:

httpx2/src/httpx2/httpx2/_client.py

Lines 483 to 486 in 70fac53

	# Do what the browsers do, despite standards...
	# Turn 302s into GETs.
	if response.status_code == codes.FOUND and method != "HEAD":
	method = "GET"

On HTTP 302 (and NOT on other "redirecty" codes) we turn requests into GET. This is done because "reasons". But QUERY is like a GET so I strongly think that the methods should be preserved here. I'd like to hear thoughts from @Kludex on this though.

[mbeijen]

this one is still 'see httpx.request' instead of httpx2.request

[mbeijen]

same