From 995dae0e1d705c7b5248720cea4817a8a4b1adf8 Mon Sep 17 00:00:00 2001 From: Adorilson Bezerra Date: Fri, 9 Jan 2026 15:22:50 +0000 Subject: [PATCH] gh-106318: Improve str.removeprefix() and str.removesuffix() docs (GH-143580) Add doctest role and 'See also'. (cherry picked from commit 6d6c7ed73786915d16f6ac3d8b6e6d67f404209f) Co-authored-by: Adorilson Bezerra --- Doc/library/stdtypes.rst | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst index 3efe8ede5cc83f..527717b8deb31c 100644 --- a/Doc/library/stdtypes.rst +++ b/Doc/library/stdtypes.rst @@ -2231,7 +2231,9 @@ expression support in the :mod:`re` module). If the string starts with the *prefix* string, return ``string[len(prefix):]``. Otherwise, return a copy of the original - string:: + string: + + .. doctest:: >>> 'TestHook'.removeprefix('Test') 'Hook' @@ -2240,12 +2242,16 @@ expression support in the :mod:`re` module). .. versionadded:: 3.9 + See also :meth:`removesuffix` and :meth:`startswith`. + .. method:: str.removesuffix(suffix, /) If the string ends with the *suffix* string and that *suffix* is not empty, return ``string[:-len(suffix)]``. Otherwise, return a copy of the - original string:: + original string: + + .. doctest:: >>> 'MiscTests'.removesuffix('Tests') 'Misc' @@ -2254,6 +2260,8 @@ expression support in the :mod:`re` module). .. versionadded:: 3.9 + See also :meth:`removeprefix` and :meth:`endswith`. + .. method:: str.replace(old, new, /, count=-1)