Skip to content

gh-86519: Add prefixmatch APIs to the re module #31137

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
gpshead merged 19 commits into from
Feb 16, 2026
Merged

gh-86519: Add prefixmatch APIs to the re module #31137

Changes from 1 commit
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
587dc4d
bpo-42353: Add prefixmatch APIs to the re module.
gpshead Feb 5, 2022
c7d1581
Merge branch 'main' into prefixmatch-b42353
gpshead Jan 30, 2023
fa2885e
fix editor fat finger typo during the merge. #vim
gpshead Jan 30, 2023
6195ad7
3.12
gpshead Jan 30, 2023
0296f29
Merge branch 'main' into prefixmatch-b42353
hauntsaninja Feb 26, 2023
bab8e8b
Merge main and modernize the relevant docs.
gpshead Apr 18, 2025
149f6e4
Simplify, don't have duplicate definitions.
gpshead Apr 19, 2025
e176692
Merge main into prefixmatch-b42353
gpshead Jan 31, 2026
58d8f57
Update match name removal language to be definitive
gpshead Jan 31, 2026
3cd9d71
Fix re.rst examples after match to search conversion
gpshead Jan 31, 2026
d6090bb
Replace name-parsing examples with Monty Python references
gpshead Feb 1, 2026
341972f
Address reviewer docs feedback: prefer prefixmatch throughout
gpshead Feb 9, 2026
cd8d85d
Statically alias match to prefixmatch instead of runtime memcpy
gpshead Feb 9, 2026
74d51b3
Merge main into prefixmatch-b42353
gpshead Feb 9, 2026
4abdff0
Fix whatsnew 3.15 RST heading that matches git conflict marker
gpshead Feb 9, 2026
6bacfb0
docs, remove errant "if ever"
gpshead Feb 9, 2026
40e6a2a
doc wording tweaks jf clarity
gpshead Feb 9, 2026
b3c6948
Extract do_test_match_getitem helper to preserve git blame
gpshead Feb 9, 2026
b277981
tweak news to match docs
gpshead Feb 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Extract do_test_match_getitem helper to preserve git blame 
Refactor test_match_getitem to use a helper method instead of a
for loop, keeping the assertion lines at their original indentation
to preserve git line attribution history.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
  • Loading branch information
@gpshead @claude
gpshead and claude committed Feb 9, 2026
commit b3c694858de5d67b18aee9481085e4e5559a121b
88 changes: 46 additions & 42 deletions Lib/test/test_re.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -564,51 +564,55 @@ def __index__(self):
self.assertEqual(m.group(2, 1), ('b', 'a'))
self.assertEqual(m.group(Index(2), Index(1)), ('b', 'a'))

def do_test_match_getitem(self, match_fn):
m = match_fn('a')
self.assertEqual(m['a1'], 'a')
self.assertEqual(m['b2'], None)
self.assertEqual(m['c3'], None)
self.assertEqual('a1={a1} b2={b2} c3={c3}'.format_map(m), 'a1=a b2=None c3=None')
self.assertEqual(m[0], 'a')
self.assertEqual(m[1], 'a')
self.assertEqual(m[2], None)
self.assertEqual(m[3], None)
with self.assertRaisesRegex(IndexError, 'no such group'):
m['X']
with self.assertRaisesRegex(IndexError, 'no such group'):
m[-1]
with self.assertRaisesRegex(IndexError, 'no such group'):
m[4]
with self.assertRaisesRegex(IndexError, 'no such group'):
m[0, 1]
with self.assertRaisesRegex(IndexError, 'no such group'):
m[(0,)]
with self.assertRaisesRegex(IndexError, 'no such group'):
m[(0, 1)]
with self.assertRaisesRegex(IndexError, 'no such group'):
'a1={a2}'.format_map(m)

m = match_fn('ac')
self.assertEqual(m['a1'], 'a')
self.assertEqual(m['b2'], None)
self.assertEqual(m['c3'], 'c')
self.assertEqual('a1={a1} b2={b2} c3={c3}'.format_map(m), 'a1=a b2=None c3=c')
self.assertEqual(m[0], 'ac')
self.assertEqual(m[1], 'a')
self.assertEqual(m[2], None)
self.assertEqual(m[3], 'c')

# Cannot assign.
with self.assertRaises(TypeError):
m[0] = 1

# No len().
self.assertRaises(TypeError, len, m)

def test_match_getitem(self):
pat = re.compile('(?:(?P<a1>a)|(?P<b2>b))(?P<c3>c)?')
self.do_test_match_getitem(pat.match)

for match_fn in pat.match, pat.prefixmatch:
with self.subTest(match_fn.__name__):
m = match_fn('a')
self.assertEqual(m['a1'], 'a')
self.assertEqual(m['b2'], None)
self.assertEqual(m['c3'], None)
self.assertEqual('a1={a1} b2={b2} c3={c3}'.format_map(m), 'a1=a b2=None c3=None')
self.assertEqual(m[0], 'a')
self.assertEqual(m[1], 'a')
self.assertEqual(m[2], None)
self.assertEqual(m[3], None)
with self.assertRaisesRegex(IndexError, 'no such group'):
m['X']
with self.assertRaisesRegex(IndexError, 'no such group'):
m[-1]
with self.assertRaisesRegex(IndexError, 'no such group'):
m[4]
with self.assertRaisesRegex(IndexError, 'no such group'):
m[0, 1]
with self.assertRaisesRegex(IndexError, 'no such group'):
m[(0,)]
with self.assertRaisesRegex(IndexError, 'no such group'):
m[(0, 1)]
with self.assertRaisesRegex(IndexError, 'no such group'):
'a1={a2}'.format_map(m)

m = match_fn('ac')
self.assertEqual(m['a1'], 'a')
self.assertEqual(m['b2'], None)
self.assertEqual(m['c3'], 'c')
self.assertEqual('a1={a1} b2={b2} c3={c3}'.format_map(m), 'a1=a b2=None c3=c')
self.assertEqual(m[0], 'ac')
self.assertEqual(m[1], 'a')
self.assertEqual(m[2], None)
self.assertEqual(m[3], 'c')

# Cannot assign.
with self.assertRaises(TypeError):
m[0] = 1

# No len().
self.assertRaises(TypeError, len, m)
def test_prefixmatch_getitem(self):
pat = re.compile('(?:(?P<a1>a)|(?P<b2>b))(?P<c3>c)?')
self.do_test_match_getitem(pat.prefixmatch)

def test_re_fullmatch(self):
# Issue 16203: Proposal: add re.fullmatch() method.
Expand Down
Loading