gh-86519: Add prefixmatch APIs to the re module #31137
Draft
+265
−134
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
These alleviate common confusion around what "match" means as Python is different than other popular languages in our use of the term as an API name. The original "match" names are NOT being deprecated. Source tooling like linters are expected to suggest using prefixmatch instead of match to improve code health and reduce cognitive burden of understanding the intent when reading code. See the documentation changes within this PR for a better description.
|
All commit authors signed the Contributor License Agreement. |
554bb41 to
54c77ca
Compare
`match = prefixmatch`
54c77ca to
149f6e4
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Adds
prefixmatchAPIs to the re module as an alternate name for our long existingmatchAPIs to help alleviate a common Python confusion for those coming from other languages regular expression libraries.These alleviate common confusion around what "match" means as Python is different than other popular languages regex libraries in our use of the term as an API name. The original
matchnames are NOT being deprecated. Source tooling like linters, IDEs, and LLMs could suggest usingprefixmatchinstead of match to improve code health and reduce cognitive burden of understanding the intent of code when configured for a modern minimum Python version.See the documentation changes within this PR for a better description.
Documentation Preview: https://cpython-previews--31137.org.readthedocs.build/en/31137/