ipython 9.14.0__tar.gz → 9.14.1__tar.gz

{ipython-9.14.0 → ipython-9.14.1}/IPython/core/debugger.py

@@ -243,6 +243,8 @@ class Pdb(OldPdb):
         stdin=None,
         stdout=None,
         context: int | None | str = 5,
+        *,
+        mode: str | None = None,
         **kwargs,
     ):
         """Create a new IPython debugger.
@@ -258,6 +260,13 @@ class Pdb(OldPdb):
         context : int
             Number of lines of source code context to show when
             displaying stacktrace information.
+        mode : str, optional
+            How the debugger was invoked, one of ``'inline'`` (used by the
+            ``breakpoint()`` builtin), ``'cli'`` (used by the command line
+            invocation) or ``None`` (backwards compatible behaviour). This
+            argument was added to stdlib's ``pdb.Pdb`` in Python 3.14; it is
+            accepted on every supported Python version here but only forwarded
+            to the underlying ``pdb.Pdb`` when it is actually supported.
         **kwargs
             Passed to pdb.Pdb.
 
@@ -273,6 +282,15 @@ class Pdb(OldPdb):
             context = int(context)
         self.context = context
 
+        # The `mode` argument was added to `pdb.Pdb` in Python 3.14. We accept
+        # it on every supported Python version so that callers written against
+        # 3.14+ keep working, but only forward it to the underlying `pdb.Pdb`
+        # when it understands it.
+        if sys.version_info >= (3, 14):
+            kwargs["mode"] = mode
+        else:
+            self.mode = mode
+
         # `kwargs` ensures full compatibility with stdlib's `pdb.Pdb`.
         OldPdb.__init__(self, completekey, stdin, stdout, **kwargs)
         # Python 3.15+ should define this, so no need to initialize
@@ -351,11 +369,11 @@ class Pdb(OldPdb):
         self._theme_name = scheme.lower()
         self.parser.theme_name = scheme.lower()
 
-    def set_trace(self, frame=None):
+    def set_trace(self, frame=None, **kwargs):
         if frame is None:
             frame = sys._getframe().f_back
         self.initial_frame = frame
-        return super().set_trace(frame)
+        return super().set_trace(frame, **kwargs)
 
     def get_stack(self, *args, **kwargs):
         stack, pos = super().get_stack(*args, **kwargs)

{ipython-9.14.0 → ipython-9.14.1}/IPython/core/release.py

@@ -17,7 +17,7 @@
 # version
 _version_major = 9
 _version_minor = 14
-_version_patch = 0
+_version_patch = 1
 _version_extra = ".dev"
 # _version_extra = "b2"
 _version_extra = ""  # Uncomment this for full releases

{ipython-9.14.0 → ipython-9.14.1}/IPython/utils/_sysinfo.py

@@ -1,2 +1,2 @@
 # GENERATED BY setup.py
-commit = "9d1f24b"
+commit = "352c35b"

{ipython-9.14.0/ipython.egg-info → ipython-9.14.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ipython
-Version: 9.14.0
+Version: 9.14.1
 Summary: IPython: Productive Interactive Computing
 Author: The IPython Development Team
 Author-email: ipython-dev@python.org

{ipython-9.14.0 → ipython-9.14.1/ipython.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ipython
-Version: 9.14.0
+Version: 9.14.1
 Summary: IPython: Productive Interactive Computing
 Author: The IPython Development Team
 Author-email: ipython-dev@python.org

{ipython-9.14.0 → ipython-9.14.1}/tests/test_debugger.py

@@ -950,3 +950,64 @@ def test_ignore_module_all_commands():
 
         child.sendline("continue")
         child.close()
+
+
+# -----------------------------------------------------------------------------
+# Signature compatibility with stdlib's ``pdb.Pdb``
+# -----------------------------------------------------------------------------
+
+import inspect
+import pdb as _stdlib_pdb
+
+from IPython.terminal.debugger import TerminalPdb
+
+_PDB_SUBCLASSES = [debugger.Pdb, debugger.InterruptiblePdb, TerminalPdb]
+
+# TerminalPdb instantiates a prompt_toolkit session, which needs a real
+# console and cannot be created on Windows CI (NoConsoleScreenBufferError),
+# so we skip instantiating it there.
+_PDB_SUBCLASSES_INSTANTIABLE = [
+    debugger.Pdb,
+    debugger.InterruptiblePdb,
+    pytest.param(TerminalPdb, marks=skip_win32),
+]
+
+
+@pytest.mark.parametrize(
+    "cls", _PDB_SUBCLASSES, ids=lambda c: c.__name__
+)
+def test_pdb_subclass_signature_compatible(cls):
+    """IPython debuggers derived from ``pdb.Pdb`` should be drop-in
+    replacements, i.e. accept every keyword argument that the stdlib
+    ``pdb.Pdb`` accepts (directly or via ``**kwargs``)."""
+    assert issubclass(cls, _stdlib_pdb.Pdb)
+
+    stdlib_params = inspect.signature(_stdlib_pdb.Pdb.__init__).parameters
+    ip_params = inspect.signature(cls.__init__).parameters
+    accepts_var_keyword = any(
+        p.kind is inspect.Parameter.VAR_KEYWORD for p in ip_params.values()
+    )
+
+    for name, param in stdlib_params.items():
+        if name == "self":
+            continue
+        if param.kind in (
+            inspect.Parameter.VAR_POSITIONAL,
+            inspect.Parameter.VAR_KEYWORD,
+        ):
+            continue
+        assert accepts_var_keyword or name in ip_params, (
+            f"{cls.__name__} does not accept the {name!r} argument "
+            "supported by stdlib pdb.Pdb"
+        )
+
+
+@pytest.mark.parametrize(
+    "cls", _PDB_SUBCLASSES_INSTANTIABLE, ids=lambda c: c.__name__
+)
+@pytest.mark.parametrize("mode", [None, "inline", "cli"])
+def test_pdb_subclass_accepts_mode(cls, mode):
+    """The ``mode`` argument (added to ``pdb.Pdb`` in Python 3.14) should be
+    accepted on every supported Python version and stored on the instance."""
+    inst = cls(mode=mode)
+    assert inst.mode == mode