gh-102296 Document that inspect.Parameter kinds support ordering

[Gouvernathor]

• Issue: Documenting that inspect.Parameter.kind attributes support ordering #102296

Automerge-Triggered-By: GH:AlexWaygood

[AlexWaygood]

It doesn't look like we currently have any tests asserting that the inspect.Parameter kinds support ordering. I'm not sure we should document it if it's untested, as that means that it could break in the future without anybody noticing. Would you be interested in adding a test to https://github.com/python/cpython/blob/main/Lib/test/test_inspect.py as part of this PR?

[Gouvernathor]

@AlexWaygood I was about to, but actually there is !

cpython/Lib/test/test_inspect.py

Lines 3725 to 3726 in e3c3f9f

	self.assertTrue(P.POSITIONAL_ONLY < P.POSITIONAL_OR_KEYWORD < \
	P.VAR_POSITIONAL < P.KEYWORD_ONLY < P.VAR_KEYWORD)

[AlexWaygood]

@AlexWaygood I was about to, but actually there is !

cpython/Lib/test/test_inspect.py

Lines 3725 to 3726 in e3c3f9f

	self.assertTrue(P.POSITIONAL_ONLY < P.POSITIONAL_OR_KEYWORD < \
	P.VAR_POSITIONAL < P.KEYWORD_ONLY < P.VAR_KEYWORD)

Thanks, not sure how I missed that!

[AlexWaygood]

Thanks, LGTM

[miss-islington]

Status check is done, and it's a success ✅.

[miss-islington]

Thanks @Gouvernathor for the PR 🌮🎉.. I'm working now to backport this PR to: 3.10, 3.11.
🐍🍒⛏🤖

[bedevere-bot]

GH-102298 is a backport of this pull request to the 3.11 branch.

[bedevere-bot]

GH-102299 is a backport of this pull request to the 3.10 branch.