gh-153309 Add HTTP QUERY method (RFC 10008) to http library

[mbeijen]

RFC 10008: The HTTP QUERY Method is now a finalized RFC on the Standards track, and the method name has been added to the IANA registry

Add it to http library HTTPMethod enum, too

• Issue: Add RFC 10008: The HTTP QUERY Method #153309

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #33510988 | 📁 Comparing e8477c5 against main (aa533dc)

  🔍 Preview build  

13 files changed · + 1 added · ± 12 modified

+ Added

• library/asyncio-tools.html

± Modified

• library/asyncio-graph.html
• library/asyncio.html
• library/codecs.html
• library/http.client.html
• library/http.html
• library/ipaddress.html
• library/string.html
• library/tkinter.font.html
• library/urllib.parse.html
• reference/import.html
• and 2 more...

[picnixz]

Don't we need something like do_QUERY in HTTP client etcs? please also check if we need tests for that.

[mbeijen]

Don't we need something like do_QUERY in HTTP client etcs? please also check if we need tests for that.

We have these do_ methods in server, not in the client. And we do not need to add QUERY there, we have this code

cpython/Lib/http/server.py

Line 455 in 1051384

mname = 'do_' + self.command

that automatically parses the method names. We also do not have explicit methods there for do_DELETE and so on.

[sobolevn]

(not a full review)

[sobolevn]

Suggested change

	Add the HTTP QUERY method (RFC 10008) to http.HTTPMethod.
	Add the HTTP QUERY method
	(`RFC 10008 <https://www.rfc-editor.org/info/rfc10008/>`_)
	to :class:`http.HTTPMethod`.

[picnixz]

I suggest using the rfc role (it can link sections as well)

[sobolevn]

Oh, even better. TIL

[mbeijen]

Good suggestion @picnixz I added that in 6230654

[picnixz]

(I will do a review tomorrow while I am commuting)

[picnixz]

Overall good.

[picnixz]

Suggested change

	Add the HTTP QUERY method (:rfc:`10008`) to :class:`http.HTTPMethod`.
	:mod:`http`: Add the HTTP QUERY method (:rfc:`10008`) to :class:`~http.HTTPMethod`.

You can also add a What's New entry. It makes users aware of the RFC itself (e.g. I was not aware of this new method)

[mbeijen]

done

[picnixz]

Please add a versionchanged:: next indicating the addition of PATCH.

[mbeijen]

Good, I added this