Add extend_query method

[bdraco]

What do these changes do?

Adds a new method called extend_query that will add additional keys instead of replacing them like update_query. The goal is to replace the hand rolled version in aiohttp

Are there changes in behavior for the user?

no

Related issue number

#1127

[codecov]

Codecov Report

Attention: Patch coverage is 98.41270% with 1 line in your changes missing coverage. Please review.

Project coverage is 95.20%. Comparing base (48bdc87) to head (d1baa7f).
Report is 281 commits behind head on master.

Files with missing lines	Patch %	Lines
tests/test_update_query.py	97.95%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1128      +/-   ##
==========================================
+ Coverage   95.15%   95.20%   +0.04%     
==========================================
  Files          30       30              
  Lines        4646     4709      +63     
  Branches      411      417       +6     
==========================================
+ Hits         4421     4483      +62     
- Misses        199      200       +1     
  Partials       26       26              

Flag	Coverage Δ
CI-GHA	95.15% <98.41%> (+0.04%)	⬆️
MyPy	40.78% <19.04%> (-0.32%)	⬇️
OS-Linux	99.39% <100.00%> (+<0.01%)	⬆️
OS-Windows	99.48% <100.00%> (+<0.01%)	⬆️
OS-macOS	99.09% <100.00%> (+0.01%)	⬆️
Py-3.10.11	98.99% <100.00%> (+0.01%)	⬆️
Py-3.10.14	99.23% <100.00%> (+0.01%)	⬆️
Py-3.11.9	99.23% <100.00%> (+0.01%)	⬆️
Py-3.12.5	99.23% <100.00%> (+0.01%)	⬆️
Py-3.13.0-rc.1	99.23% <100.00%> (+0.01%)	⬆️
Py-3.8.10	98.94% <100.00%> (+0.01%)	⬆️
Py-3.8.18	99.17% <100.00%> (+0.01%)	⬆️
Py-3.9.13	98.94% <100.00%> (+0.01%)	⬆️
Py-3.9.19	99.17% <100.00%> (+0.01%)	⬆️
Py-pypy7.3.11	99.23% <100.00%> (+0.01%)	⬆️
Py-pypy7.3.16	99.23% <100.00%> (+0.01%)	⬆️
Py-pypy7.3.17	99.26% <100.00%> (+0.01%)	⬆️
VM-macos-latest	99.09% <100.00%> (+0.01%)	⬆️
VM-ubuntu-latest	99.39% <100.00%> (+<0.01%)	⬆️
VM-windows-latest	99.48% <100.00%> (+<0.01%)	⬆️
pytest	99.39% <100.00%> (+<0.01%)	⬆️

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

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

[bdraco]

Verified this works as expected in aiohttp with this change

diff --git a/aiohttp/client_reqrep.py b/aiohttp/client_reqrep.py
index 6eaba561b..6e0f76a2e 100644
--- a/aiohttp/client_reqrep.py
+++ b/aiohttp/client_reqrep.py
@@ -229,10 +229,7 @@ class ClientRequest:
         # assert session is not None
         self._session = cast("ClientSession", session)
         if params:
-            q = MultiDict(url.query)
-            url2 = url.with_query(params)
-            q.extend(url2.query)
-            url = url.with_query(q)
+            url = url.extend_query(params)
         self.original_url = url
         self.url = url.with_fragment(None)
         self.method = method.upper()

[bdraco]

Doing a bit of production testing before merge. If that all goes well, I'll bump the version, do a release and than open a PR to aiohttp to replace the hand rolled method

[bdraco]

In turns out I didn't need to split update_query so I can split this PR up a bit