ipython 9.12.0__tar.gz → 9.14.0__tar.gz

{ipython-9.12.0 → ipython-9.14.0}/IPython/__init__.py

@@ -27,11 +27,10 @@ import warnings
 #-----------------------------------------------------------------------------
 
 # Don't forget to also update setup.py when this changes!
-if sys.version_info < (3, 12):
+if sys.version_info < (3, 11):
     raise ImportError(
         """
-IPython 9.x supports Python 3.12 and above, following SPEC0
-IPython 8.31+ supports Python 3.11 and above, following SPEC0
+IPython 9.x supports Python 3.11 and above, following SPEC0
 IPython 8.19+ supports Python 3.10 and above, following SPEC0.
 IPython 8.13+ supports Python 3.9 and above, following NEP 29.
 When using Python 2.7, please install IPython 5.x LTS Long Term Support version.

{ipython-9.12.0 → ipython-9.14.0}/IPython/core/completer.py

@@ -243,7 +243,11 @@ import __main__
 
 from typing import cast
 
-from typing import TypedDict, NotRequired, Protocol, TypeAlias, TypeGuard
+if sys.version_info < (3, 12):
+    from typing_extensions import TypedDict, Protocol
+    from typing import NotRequired, TypeAlias, TypeGuard
+else:
+    from typing import TypedDict, NotRequired, Protocol, TypeAlias, TypeGuard
 
 
 # skip module docstests

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

@@ -515,6 +515,12 @@ class Pdb(OldPdb):
                 else:
                     self.error("No exception with that number")
 
+        def do_exception(self, arg):
+            """exception [number]
+            Alias for the ``exceptions`` command.
+            """
+            return self.do_exceptions(arg)
+
     def interaction(self, frame, tb_or_exc):
         try:
             if CHAIN_EXCEPTIONS:
@@ -874,9 +880,9 @@ class Pdb(OldPdb):
             try:
                 x = eval(arg, {}, {})
                 if type(x) == type(()):
-                    first, last = x
-                    first = int(first)
-                    last = int(last)
+                    first, last = x  # type: ignore[misc]
+                    first = int(first)  # type: ignore[call-overload]
+                    last = int(last)  # type: ignore[call-overload]
                     if last < first:
                         # Assume it's a count
                         last = first + last

{ipython-9.12.0 → ipython-9.14.0}/IPython/core/guarded_eval.py

@@ -32,7 +32,10 @@ from IPython.utils.decorators import undoc
 import types
 from typing import Self, LiteralString, get_type_hints
 
-from typing import TypeAliasType
+if sys.version_info < (3, 12):
+    from typing_extensions import TypeAliasType
+else:
+    from typing import TypeAliasType
 
 
 @undoc

{ipython-9.12.0 → ipython-9.14.0}/IPython/core/history.py

@@ -47,7 +47,7 @@ from weakref import ref, WeakSet
 
 if TYPE_CHECKING:
     from IPython.core.interactiveshell import InteractiveShell
-    from IPython.config.Configuration import Configuration
+    from traitlets.config import Config as Configuration
 
 try:
     from sqlite3 import DatabaseError, OperationalError
@@ -696,7 +696,7 @@ class HistoryManager(HistoryAccessor):
                 self.hist_file,
                 exc_info=True,
             )
-            self.hist_file = ":memory:"
+            self._switch_to_memory_history()
 
         self.using_thread = False
         if self.enabled and self.hist_file != ":memory:":
@@ -708,7 +708,8 @@ class HistoryManager(HistoryAccessor):
                     "Failed to start history saving thread. History will not be saved.",
                     exc_info=True,
                 )
-                self.hist_file = ":memory:"
+                self._switch_to_memory_history()
+                self.save_thread = None
             else:
                 self.using_thread = True
         self._instances.add(self)
@@ -717,6 +718,16 @@ class HistoryManager(HistoryAccessor):
             HistoryManager._max_inst,
         )
 
+    def _switch_to_memory_history(self) -> None:
+        """Switch history storage to an in-memory SQLite database."""
+        try:
+            self.db.close()
+        except Exception:
+            pass
+        self.hist_file = ":memory:"
+        self.init_db()
+        self.new_session()
+
     def __del__(self) -> None:
         if self.save_thread is not None:
             self.save_thread.stop()
@@ -1176,7 +1187,7 @@ class HistorySavingThread(threading.Thread):
 
         self.save_flag.set()
         self._stopped = True
-        if self != threading.current_thread():
+        if self.ident is not None and self != threading.current_thread():
             self.join()
 
     def __del__(self) -> None:

{ipython-9.12.0 → ipython-9.14.0}/IPython/core/inputtransformer2.py

@@ -356,8 +356,24 @@ class MagicAssign(TokenTransformBase):
 class SystemAssign(TokenTransformBase):
     """Transformer for assignments from system commands (a = !foo)"""
     @classmethod
-    def find(cls, tokens_by_line):
-        """Find the first system assignment (a = !foo) in the cell."""
+    def find_pre_312(cls, tokens_by_line):
+        for line in tokens_by_line:
+            assign_ix = _find_assign_op(line)
+            if (assign_ix is not None) \
+                    and not line[assign_ix].line.strip().startswith('=') \
+                    and (len(line) >= assign_ix + 2) \
+                    and (line[assign_ix + 1].type == tokenize.ERRORTOKEN):
+                ix = assign_ix + 1
+
+                while ix < len(line) and line[ix].type == tokenize.ERRORTOKEN:
+                    if line[ix].string == '!':
+                        return cls(line[ix].start)
+                    elif not line[ix].string.isspace():
+                        break
+                    ix += 1
+
+    @classmethod
+    def find_post_312(cls, tokens_by_line):
         for line in tokens_by_line:
             assign_ix = _find_assign_op(line)
             if (
@@ -369,6 +385,13 @@ class SystemAssign(TokenTransformBase):
             ):
                 return cls(line[assign_ix + 1].start)
 
+    @classmethod
+    def find(cls, tokens_by_line):
+        """Find the first system assignment (a = !foo) in the cell."""
+        if sys.version_info < (3, 12):
+            return cls.find_pre_312(tokens_by_line)
+        return cls.find_post_312(tokens_by_line)
+
     def transform(self, lines: List[str]):
         """Transform a system assignment found by the ``find()`` classmethod.
         """

{ipython-9.12.0 → ipython-9.14.0}/IPython/core/interactiveshell.py

@@ -1024,19 +1024,19 @@ class InteractiveShell(SingletonConfigurable):
 
     @property
     def banner(self):
-        if (when := os.environ.get("SOURCE_DATE_EPOCH", None)) is not None:
+        banner = self.banner1
+        # Only use SOURCE_DATE_EPOCH if the user hasn't set a custom banner (default starts with "Python")
+        if banner is self.banner1 and (when := os.environ.get("SOURCE_DATE_EPOCH", None)) is not None:
             from datetime import datetime
-
             date = datetime.fromtimestamp(int(when))
-            return textwrap.dedent(
+            banner = textwrap.dedent(
                 f"""
-            Python 3.y.z | Packaged with love | (main, {date.strftime("%A, %d %B %Y")}) [Compiler]
-            Type 'copyright', 'credits' or 'license' for more information
-            IPython 9.y.z -- An enhanced Interactive Python. Type '?' for help.
-            Tip: unset SOURCE_DATE_EPOCH to restore dynamic banner.
-            """
+                Python 3.y.z | Packaged with love | (main, {date.strftime("%A, %d %B %Y")}) [Compiler]
+                Type 'copyright', 'credits' or 'license' for more information
+                IPython 9.y.z -- An enhanced Interactive Python. Type '?' for help.
+                Tip: unset SOURCE_DATE_EPOCH to restore dynamic banner.
+                """
             ).lstrip()
-        banner = self.banner1
         if self.profile and self.profile != 'default':
             banner += '\nIPython profile: %s\n' % self.profile
         if self.banner2:
@@ -2140,7 +2140,8 @@ class InteractiveShell(SingletonConfigurable):
         sys.last_type = etype
         sys.last_value = value
         sys.last_traceback = tb
-        sys.last_exc = value
+        if sys.version_info >= (3, 12):
+            sys.last_exc = value
 
         return etype, value, tb
 

ipython-9.14.0/IPython/core/kitty.py

@@ -0,0 +1,74 @@
+# Implements https://sw.kovidgoyal.net/kitty/graphics-protocol/
+
+from base64 import b64encode, b64decode
+import sys
+from typing import Union
+
+def _supports_kitty_graphics() -> bool:
+    import platform
+
+    if platform.system() not in ("Darwin", "Linux"):
+        return False
+
+    isatty = getattr(sys.stdout, "isatty", None)
+    if not callable(isatty) or not isatty():
+        return False
+    # Hardcoding process names instead of using
+    # https://sw.kovidgoyal.net/kitty/graphics-protocol/#querying-support-and-available-transmission-mediums
+    # to avoid startup slowdown
+    supported_terminals = {
+        "ghostty",
+        "iTerm2",
+        "kitty",
+        "konsole",
+        "warp",
+        "wayst",
+        "wezterm-gui",
+    }
+    import psutil
+
+    process = psutil.Process()
+    while process := process.parent():
+        if process.name() in supported_terminals:
+            return True
+    return False
+
+
+supports_kitty_graphics = _supports_kitty_graphics()
+
+
+def png_to_kitty_ansi(png: bytes) -> str:
+    if not png.startswith(b"\x89PNG\r\n\x1a\n"):
+        raise ValueError
+    # This simplicity resembles
+    # https://sw.kovidgoyal.net/kitty/graphics-protocol/#a-minimal-example
+    # but if we need tmux support, we can switch to Unicode like
+    # https://github.com/hzeller/timg/blob/main/src/kitty-canvas.cc
+    result = ["\033_Ga=T,f=100,", "m=1;"]
+    encoded = b64encode(png)
+    for i in range(0, len(encoded), 4096):
+        result.append(encoded[i : i + 4096].decode("ascii"))
+        result.append("\033\\")
+        result.append("\033_G")
+        result.append("m=1;")
+    del result[-2:]
+    result[-3] = "m=0;"
+    return "".join(result)
+
+
+def kitty_png_render(png: Union[bytes, str], _md_dict: object) -> None:
+    if isinstance(png, str):
+        png = png_to_kitty_ansi(b64decode(png))
+    else:
+        png = png_to_kitty_ansi(png)
+    print(png)
+
+
+display_formatter_default_active_types = [
+    "text/plain",
+    *(["image/png"] if supports_kitty_graphics else []),
+]
+
+terminal_default_mime_renderers = {
+    "image/png": kitty_png_render,
+}

{ipython-9.12.0 → ipython-9.14.0}/IPython/core/oinspect.py

@@ -1093,7 +1093,7 @@ class Inspector(Configurable):
         """
         Check whether the source *src* contains the docstring *doc*.
 
-        This is is helper function to skip displaying the docstring if the
+        This is a helper function to skip displaying the docstring if the
         source already contains it, avoiding repetition of information.
         """
         try:

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

@@ -16,7 +16,7 @@
 # release.  'dev' as a _version_extra string means this is a development
 # version
 _version_major = 9
-_version_minor = 12
+_version_minor = 14
 _version_patch = 0
 _version_extra = ".dev"
 # _version_extra = "b2"

{ipython-9.12.0 → ipython-9.14.0}/IPython/core/tips.py

@@ -1,5 +1,6 @@
 from datetime import datetime
 import os
+import sys
 from random import choice
 from typing import Any
 
@@ -107,6 +108,11 @@ else:
         ]
     )
 
+if sys.version_info < (3, 12):
+    _tips["random"].append(
+        "IPython support for Python versions outside of SPEC-0 is funded by the D.E. Shaw group: https://deshaw.com"
+    )
+
 # Check if argcomplete is installed and add tip
 try:
     import argcomplete

{ipython-9.12.0 → ipython-9.14.0}/IPython/core/ultratb.py

@@ -817,8 +817,10 @@ class VerboseTB(TBTools):
         after = context // 2
         before = context - after
         if self.has_colors:
-            base_style = theme_table[self._theme_name].as_pygments_style()
-            style = stack_data.style_with_executing_node(base_style, self.tb_highlight)
+            theme = theme_table[self._theme_name]
+            base_style = theme.as_pygments_style()
+            tb_highlight = theme.extra_style.get(Token.TbHighlight, self.tb_highlight)
+            style = stack_data.style_with_executing_node(base_style, tb_highlight)
             formatter = Terminal256Formatter(style=style)
         else:
             formatter = None
@@ -994,7 +996,11 @@ class VerboseTB(TBTools):
                 self.pdb.botframe = etb.tb_frame
                 # last_value should be deprecated, but last-exc sometimme not set
                 # please check why later and remove the getattr.
-                exc = getattr(sys, "last_exc", sys.last_value)
+                exc = (
+                    sys.last_value
+                    if sys.version_info < (3, 12)
+                    else getattr(sys, "last_exc", sys.last_value)
+                )  # type: ignore[attr-defined]
                 if exc:
                     self.pdb.interaction(None, exc)
                 else:

{ipython-9.12.0 → ipython-9.14.0}/IPython/core/usage.py

@@ -46,7 +46,7 @@ Usage
     This file is typically installed in the `IPYTHONDIR` directory, and there
     is a separate configuration directory for each profile. The default profile
     directory will be located in $IPYTHONDIR/profile_default. IPYTHONDIR
-    defaults to to `$HOME/.ipython`.  For Windows users, $HOME resolves to
+    defaults to `$HOME/.ipython`.  For Windows users, $HOME resolves to
     C:\\Users\\YourUserName in most instances.
 
     To initialize a profile with the default configuration file, do::

{ipython-9.12.0 → ipython-9.14.0}/IPython/terminal/interactiveshell.py

@@ -8,6 +8,10 @@ from typing import Union as UnionType, Optional
 
 from IPython.core.async_helpers import get_asyncio_loop
 from IPython.core.interactiveshell import InteractiveShell, InteractiveShellABC
+from IPython.core.kitty import (
+    display_formatter_default_active_types,
+    terminal_default_mime_renderers,
+)
 from IPython.utils.py3compat import input
 from IPython.utils.PyColorize import theme_table
 from IPython.utils.terminal import toggle_set_term_title, set_term_title, restore_term_title
@@ -397,7 +401,7 @@ class TerminalInteractiveShell(InteractiveShell):
 
     term_title_format = Unicode("IPython: {cwd}",
         help="Customize the terminal title format.  This is a python format string. " +
-             "Available substitutions are: {cwd}."
+             "Available substitutions include {cwd}."
     ).tag(config=True)
 
     display_completions = Enum(('column', 'multicolumn','readlinelike'),
@@ -741,13 +745,13 @@ class TerminalInteractiveShell(InteractiveShell):
 
     prompt_line_number_format = Unicode(
         "",
-        help="The format for line numbering, will be passed `line` (int, 1 based)"
-        " the current line number and `rel_line` the relative line number."
-        " for example to display both you can use the following template string :"
-        " c.TerminalInteractiveShell.prompt_line_number_format='{line: 4d}/{rel_line:+03d} | '"
-        " This will display the current line number, with leading space and a width of at least 4"
-        " character, as well as the relative line number 0 padded and always with a + or - sign."
-        " Note that when using Emacs mode the prompt of the first line may not update.",
+        help="The format for line numbering. Will be passed the current line number"
+        " ``line`` (int, 1 based), and the relative line number ``rel_line``."
+        " For example to display both, you can use the following template string:"
+        " ``c.TerminalInteractiveShell.prompt_line_number_format = '{line: 4d}/{rel_line:+03d} | '``"
+        " This will display the current line number, with a leading space and a width of at least 4"
+        " characters, as well as the relative line number, 0-padded and always with a + or - sign."
+        " Note that when using Emacs mode, the prompt of the first line may not update.",
     ).tag(config=True)
 
     @observe('term_title')
@@ -771,7 +775,12 @@ class TerminalInteractiveShell(InteractiveShell):
             "DisplayFormatter" in config
             and "active_types" in config["DisplayFormatter"]
         ):
-            self.display_formatter.active_types = ["text/plain"]
+            self.display_formatter.active_types = display_formatter_default_active_types
+            if not (
+                "TerminalInteractiveShell" in config
+                and "mime_renderers" in config["TerminalInteractiveShell"]
+            ):
+                self.mime_renderers = terminal_default_mime_renderers
 
     def init_prompt_toolkit_cli(self):
         if self.simple_prompt:

{ipython-9.12.0 → ipython-9.14.0}/IPython/utils/PyColorize.py

@@ -138,6 +138,7 @@ linux_theme = Theme(
         Token.PromptNum: "ansigreen bold",
         Token.OutPrompt: "ansibrightred",
         Token.OutPromptNum: "ansired bold",
+        Token.TbHighlight: "ansiblack bg:ansiyellow",
     },
 )
 
@@ -170,6 +171,7 @@ neutral_pygments_equiv = {
     Token.Name.Variable.Magic: "ansiblue",
     Token.Prompt: "ansigreen",
     Token.OutPrompt: "ansired",
+    Token.TbHighlight: "ansiblack bg:ansiyellow",
 }
 
 
@@ -227,6 +229,7 @@ lightbg_theme = Theme(
         Token.PromptNum: "ansiblue bold",
         Token.OutPrompt: "ansibrightred",
         Token.OutPromptNum: "ansired bold",
+        Token.TbHighlight: "ansired bg:ansiyellow",
     },
 )
 
@@ -268,6 +271,7 @@ pride_theme = Theme(
         Token.PromptNum: "ansiblue bold",
         Token.OutPrompt: "ansibrightred",
         Token.OutPromptNum: "ansired bold",
+        Token.TbHighlight: f"bg:{PRIDE_YELLOW}",
     },
     symbols={"arrow_body": "\u2500", "arrow_head": "\u25b6", "top_line": "\u2500"},
 )
@@ -368,6 +372,7 @@ gruvbox_dark_theme = Theme(
         Token.PromptNum: f"{GRUVBOX_PROMPT_NUM} bold",
         Token.OutPrompt: GRUVBOX_OUT_PROMPT,
         Token.OutPromptNum: f"{GRUVBOX_OUT_PROMPT_NUM} bold",
+        Token.TbHighlight: f"bg:{GRUVBOX_TOPLINE}",
     },
     symbols={"arrow_body": "\u2500", "arrow_head": "\u25b6", "top_line": "\u2500"},
 )

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

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

{ipython-9.12.0 → ipython-9.14.0}/IPython/utils/capture.py

@@ -74,7 +74,12 @@ class CapturedIO:
     above in the same order, and can be invoked simply via ``c()``.
     """
 
-    def __init__(self, stdout: StringIO, stderr: StringIO, outputs: Optional[List[Any]]=None):
+    def __init__(
+        self,
+        stdout: Optional[StringIO],
+        stderr: Optional[StringIO],
+        outputs: Optional[List[Any]] = None,
+    ):
         self._stdout = stdout
         self._stderr = stderr
         if outputs is None:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ipython
-Version: 9.12.0
+Version: 9.14.0
 Summary: IPython: Productive Interactive Computing
 Author: The IPython Development Team
 Author-email: ipython-dev@python.org
@@ -22,7 +22,7 @@ Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: System :: Shells
-Requires-Python: >=3.12
+Requires-Python: >=3.11
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 License-File: COPYING.rst
@@ -33,9 +33,11 @@ Requires-Dist: jedi>=0.18.2
 Requires-Dist: matplotlib-inline>=0.1.6
 Requires-Dist: pexpect>4.6; sys_platform != "win32" and sys_platform != "emscripten"
 Requires-Dist: prompt_toolkit<3.1.0,>=3.0.41
+Requires-Dist: psutil>=7; sys_platform != "emscripten"
 Requires-Dist: pygments>=2.14.0
 Requires-Dist: stack_data>=0.6.0
 Requires-Dist: traitlets>=5.13.0
+Requires-Dist: typing_extensions>=4.6; python_version < "3.12"
 Provides-Extra: black
 Requires-Dist: black; extra == "black"
 Provides-Extra: doc

{ipython-9.12.0 → ipython-9.14.0}/README.rst

@@ -31,7 +31,10 @@ IPython (Interactive Python) is a command shell for interactive computing in mul
 
 **Python Support**
 
-Starting after IPython 8.16, we progressively transition to `Spec-0000 <https://scientific-python.org/specs/spec-0000/>`_.
+Starting after IPython 8.16, we follow `SPEC-0 <https://scientific-python.org/specs/spec-0000/>`_
+for determining the minimum supported Python version. Python 3.11 support is
+additionally maintained thanks to funding from the
+`D. E. Shaw group <https://deshaw.com/>`_.
 
 IPython requires Python 3.11 or newer.
 

{ipython-9.12.0 → ipython-9.14.0}/docs/requirements.txt

@@ -10,3 +10,4 @@ docrepr
 prompt_toolkit
 ipykernel
 intersphinx_registry
+sphinx_toml

{ipython-9.12.0 → ipython-9.14.0}/docs/source/_templates/breadcrumbs.html

@@ -2,6 +2,8 @@
 
 {% block breadcrumbs_aside %}
 {% if not meta or meta.get('github_url') != 'hide' %}
-{{ super() }}
+  {% if not pagename.startswith('api/generated/') %}
+    {{ super() }}
+  {% endif %}
 {% endif %}
-{% endblock %}
+{% endblock %}

{ipython-9.12.0 → ipython-9.14.0}/docs/source/config/details.rst

@@ -26,7 +26,7 @@ multiple configuration options to be set to properly work:
 
  - Configure said provider with models, API keys, etc – this will depend on the
    provider, and you will have to refer to Jupyter-AI documentation, and/or your
-   LLM documenatation.
+   LLM documentation.
 
 
 While setting up IPython to use a real LLM, you can refer to
@@ -88,7 +88,7 @@ by setting the ``llm_construction_kwargs`` traitlet.
 
     c.TerminalInteractiveShell.llm_constructor_kwargs = {"model": "skynet"}
 
-This will depdend on the provider you chose, and you will have to refer to
+This will depend on the provider you chose, and you will have to refer to
 the provider documentation.
 
 Extra configuration may be needed by setting environment variables, this will
@@ -166,7 +166,8 @@ in the input prompt:
 
 .. code-block:: python
 
-    from IPython.terminal.prompts import Prompts, Token
+    from IPython.terminal.prompts import Prompts
+    from pygments.token import Token
     import os
 
     class MyPrompt(Prompts):

{ipython-9.12.0 → ipython-9.14.0}/docs/source/interactive/autoawait.rst

@@ -312,7 +312,7 @@ task is running, if and only if the foreground task is async::
    In [4]: await asyncio.sleep(3)
    background 4
    background 5
-   background 6g
+   background 6
 
 In a Notebook, QtConsole, or any other frontend using IPykernel, background
 tasks should behave as expected.

{ipython-9.12.0 → ipython-9.14.0}/docs/source/whatsnew/version0.11.rst

@@ -200,7 +200,7 @@ requests and 285 regular issues (:ref:`a full list with links
 pull requests are a fantastic mechanism for reviewing code and building a
 shared ownership of the project, and we are making enthusiastic use of it.
 
-.. Note::
+.. note::
 
    This undercounts the number of issues closed in this development cycle,
    since we only moved to github for issue tracking in May 2010, but we have no