python · iritkatriel · May 11, 2023 · May 9, 2023 · May 9, 2023 · May 9, 2023
@@ -602,9 +602,17 @@ can be overridden by the local file.

   Execute the (one-line) *statement* in the context of the current stack frame.
   The exclamation point can be omitted unless the first word of the statement
-   resembles a debugger command.  To set a global variable, you can prefix the
-   assignment command with a :keyword:`global` statement on the same line,
-   e.g.::
+   resembles a debugger command, e.g.:
+
+   .. code-block:: none
+
+      (Pdb) ! n=42
+      (Pdb)
+
+   To set a global variable, you can prefix the assignment command with a
+   :keyword:`global` statement on the same line, e.g.:
+
+   .. code-block:: none

      (Pdb) global list_options; list_options = ['-l']
      (Pdb)

@@ -440,7 +440,7 @@ def displayhook(self, obj):
            self.message(repr(obj))

    def default(self, line):
-        if line[:1] == '!': line = line[1:]
+        if line[:1] == '!': line = line[1:].strip()
        locals = self.curframe_locals
        globals = self.curframe.f_globals
        try:
@@ -1642,9 +1642,12 @@ def help_exec(self):

        Execute the (one-line) statement in the context of the current
        stack frame.  The exclamation point can be omitted unless the
-        first word of the statement resembles a debugger command.  To
-        assign to a global variable you must always prefix the command
-        with a 'global' command, e.g.:
+        first word of the statement resembles a debugger command, e.g.:
+        (Pdb) ! n=42
+        (Pdb)
+
+        To assign to a global variable you must always prefix the command with
+        a 'global' command, e.g.:
        (Pdb) global list_options; list_options = ['-l']
        (Pdb)
        """

diff --git a/Lib/pydoc_data/topics.py b/Lib/pydoc_data/topics.py
@@ -5283,11 +5283,14 @@
             'current\n'
             '   stack frame. The exclamation point can be omitted unless the '
             'first\n'
-             '   word of the statement resembles a debugger command.  To set '
-             'a\n'
-             '   global variable, you can prefix the assignment command with '
-             'a\n'
-             '   "global" statement on the same line, e.g.:\n'
+             '   word of the statement resembles a debugger command, e.g.:'
+             '\n'
+             '      (Pdb) ! n=42\n'
+             '      (Pdb)\n'
+             '\n'
+             '   To set a global variable, you can prefix the assignment command '
+             '   with \n'
+             '   a "global" statement on the same line, e.g.:\n'
             '\n'
             "      (Pdb) global list_options; list_options = ['-l']\n"
             '      (Pdb)\n'

@@ -1798,6 +1798,29 @@ def test_pdb_issue_gh_101517():
    (Pdb) continue
    """

+def test_pdb_issue_gh_104301():
+    """See GH-104301
+
+    Make sure that ambiguous statements prefixed by '!' are properly disambiguated
+
+    >>> with PdbTestInput([
+    ...     '! n = 42',  # disambiguated statement: reassign the name n
+    ...     'n',         # advance the debugger into the print()
+    ...     'continue'
+    ... ]):
+    ...     n = -1
+    ...     import pdb; pdb.Pdb(nosigint=True, readrc=False).set_trace()
+    ...     print(n)
+    > <doctest test.test_pdb.test_pdb_issue_gh_104301[0]>(8)<module>()
+    -> print(n)
+    (Pdb) ! n = 42
+    (Pdb) n
+    42
+    > <doctest test.test_pdb.test_pdb_issue_gh_104301[0]>(1)<module>()
+    -> with PdbTestInput([
+    (Pdb) continue
+    """
+

 @support.requires_subprocess()
 class PdbTestCase(unittest.TestCase):

diff --git a/Misc/NEWS.d/next/Library/2023-05-09-18-46-24.gh-issue-104301.gNnbId.rst b/Misc/NEWS.d/next/Library/2023-05-09-18-46-24.gh-issue-104301.gNnbId.rst
@@ -0,0 +1 @@
+Allow leading whitespace in disambiguated statements in :mod:`pdb`.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Allow leading whitespace in disambiguated statements in :mod:`pdb`.