ipython 9.8.0__tar.gz → 9.9.0__tar.gz

{ipython-9.8.0 → ipython-9.9.0}/IPython/core/async_helpers.py

@@ -136,20 +136,15 @@ def _pseudo_sync_runner(coro):
 
 
 def _should_be_async(cell: str) -> bool:
-    """Detect if a block of code need to be wrapped in an `async def`
+    """Detect if a block of code needs to be wrapped in an `async def`
 
-    Attempt to parse the block of code, it it compile we're fine.
-    Otherwise we  wrap if and try to compile.
-
-    If it works, assume it should be async. Otherwise Return False.
-
-    Not handled yet: If the block of code has a return statement as the top
-    level, it will be seen as async. This is a know limitation.
+    If the code block has a top-level return statement or is otherwise
+    invalid, `False` will be returned.
     """
     try:
         code = compile(
             cell, "<>", "exec", flags=getattr(ast, "PyCF_ALLOW_TOP_LEVEL_AWAIT", 0x0)
         )
         return inspect.CO_COROUTINE & code.co_flags == inspect.CO_COROUTINE
-    except (SyntaxError, MemoryError):
+    except (SyntaxError, ValueError, MemoryError):
         return False

{ipython-9.8.0 → ipython-9.9.0}/IPython/core/completer.py

@@ -2608,8 +2608,8 @@ class IPCompleter(Completer):
         if re.search(r"(?<!\w)(?<!\d\.)([-+]?\d+\.(\d+)?)(?!\w)$", line):
             return self._CompletionContextType.GLOBAL
 
-        # Handle all other attribute matches np.ran, d[0].k, (a,b).count
-        chain_match = re.search(r".*(.+(?<!\s)\.(?:[a-zA-Z]\w*)?)$", line)
+        # Handle all other attribute matches np.ran, d[0].k, (a,b).count, obj._private
+        chain_match = re.search(r".*(.+(?<!\s)\.(?:[a-zA-Z_]\w*)?)$", line)
         if chain_match:
             return self._CompletionContextType.ATTRIBUTE
 

{ipython-9.8.0 → ipython-9.9.0}/IPython/core/interactiveshell.py

@@ -2141,7 +2141,7 @@ class InteractiveShell(SingletonConfigurable):
 
     def showtraceback(
         self,
-        exc_tuple: tuple[type[BaseException], BaseException, Any] | None = None,
+        exc_tuple: tuple[type[BaseException], BaseException, AnyType] | None = None,
         filename: str | None = None,
         tb_offset: int | None = None,
         exception_only: bool = False,

{ipython-9.8.0 → ipython-9.9.0}/IPython/core/prefilter.py

@@ -498,7 +498,7 @@ class AutocallChecker(PrefilterChecker):
         if not self.shell.autocall:
             return None
 
-        oinfo = line_info.ofind(self.shell) # This can mutate state via getattr
+        oinfo = self.shell._ofind(line_info.ifun)  # This can mutate state via getattr
         if not oinfo.found:
             return None
 
@@ -610,7 +610,7 @@ class AutoHandler(PrefilterHandler):
         the_rest = line_info.the_rest
         esc     = line_info.esc
         continue_prompt = line_info.continue_prompt
-        obj = line_info.ofind(self.shell).obj
+        obj = self.shell._ofind(line_info.ifun).obj
 
         # This should only be active for single-line input!
         if continue_prompt:

{ipython-9.8.0 → ipython-9.9.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 = 8
+_version_minor = 9
 _version_patch = 0
 _version_extra = ".dev"
 # _version_extra = "b2"

{ipython-9.8.0 → ipython-9.9.0}/IPython/core/splitinput.py

@@ -1,35 +1,21 @@
-# encoding: utf-8
 """
 Simple utility for splitting user input. This is used by both inputsplitter and
 prefilter.
-
-Authors:
-
-* Brian Granger
-* Fernando Perez
 """
 
-#-----------------------------------------------------------------------------
-#  Copyright (C) 2008-2011  The IPython Development Team
-#
-#  Distributed under the terms of the BSD License.  The full license is in
-#  the file COPYING, distributed as part of this software.
-#-----------------------------------------------------------------------------
-
-#-----------------------------------------------------------------------------
+# -----------------------------------------------------------------------------
 # Imports
-#-----------------------------------------------------------------------------
+# -----------------------------------------------------------------------------
 
 import re
 import sys
+import warnings
 
-from IPython.utils import py3compat
-from IPython.utils.encoding import get_stream_enc
 from IPython.core.oinspect import OInfo
 
-#-----------------------------------------------------------------------------
+# -----------------------------------------------------------------------------
 # Main function
-#-----------------------------------------------------------------------------
+# -----------------------------------------------------------------------------
 
 # RegExp for splitting line contents into pre-char//first word-method//rest.
 # For clarity, each group in on one line.
@@ -42,22 +28,25 @@ from IPython.core.oinspect import OInfo
 # ! and !! trigger if they are first char(s) *or* follow an indent
 # ? triggers as first or last char.
 
-line_split = re.compile(r"""
+line_split = re.compile(
+    r"""
              ^(\s*)               # any leading space
              ([,;/%]|!!?|\?\??)?  # escape character or characters
              \s*(%{0,2}[\w\.\*]*)     # function/method, possibly with leading %
                                   # to correctly treat things like '?%magic'
              (.*?$|$)             # rest of line
-             """, re.VERBOSE)
+             """,
+    re.VERBOSE,
+)
 
 
-def split_user_input(line, pattern=None):
+def split_user_input(
+    line: str, pattern: re.Pattern[str] | None = None
+) -> tuple[str, str, str, str]:
     """Split user input into initial whitespace, escape character, function part
     and the rest.
     """
-    # We need to ensure that the rest of this routine deals only with unicode
-    encoding = get_stream_enc(sys.stdin, 'utf-8')
-    line = py3compat.cast_unicode(line, encoding)
+    assert isinstance(line, str)
 
     if pattern is None:
         pattern = line_split
@@ -65,11 +54,11 @@ def split_user_input(line, pattern=None):
     if not match:
         # print("match failed for line '%s'" % line)
         try:
-            ifun, the_rest = line.split(None,1)
+            ifun, the_rest = line.split(None, 1)
         except ValueError:
             # print("split failed for line '%s'" % line)
-            ifun, the_rest = line, u''
-        pre = re.match(r'^(\s*)(.*)',line).groups()[0]
+            ifun, the_rest = line, ""
+        pre = re.match(r"^(\s*)(.*)", line).groups()[0]
         esc = ""
     else:
         pre, esc, ifun, the_rest = match.groups()
@@ -111,15 +100,27 @@ class LineInfo:
     raw_the_rest
       the_rest without whitespace stripped.
     """
-    def __init__(self, line, continue_prompt=False):
-        self.line            = line
+
+    line: str
+    continue_prompt: bool
+    pre: str
+    esc: str
+    ifun: str
+    raw_the_rest: str
+    the_rest: str
+    pre_char: str
+    pre_whitespace: str
+
+    def __init__(self, line: str, continue_prompt: bool = False) -> None:
+        assert isinstance(line, str)
+        self.line = line
         self.continue_prompt = continue_prompt
         self.pre, self.esc, self.ifun, self.raw_the_rest = split_user_input(line)
         self.the_rest = self.raw_the_rest.lstrip()
 
-        self.pre_char       = self.pre.strip()
+        self.pre_char = self.pre.strip()
         if self.pre_char:
-            self.pre_whitespace = '' # No whitespace allowed before esc chars
+            self.pre_whitespace = ""  # No whitespace allowed before esc chars
         else:
             self.pre_whitespace = self.pre
 
@@ -135,11 +136,20 @@ class LineInfo:
 
         Does cache the results of the call, so can be called multiple times
         without worrying about *further* damaging state.
+
+        .. deprecated:: 9.8
+            Use ``shell._ofind(line_info.ifun)`` directly instead.
         """
+        warnings.warn(
+            "LineInfo.ofind() is deprecated since IPython 9.9. "
+            "Use shell._ofind(line_info.ifun) directly instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         return ip._ofind(self.ifun)
 
-    def __str__(self):
-        return "LineInfo [%s|%s|%s|%s]" %(self.pre, self.esc, self.ifun, self.the_rest)
+    def __str__(self) -> str:
+        return "LineInfo [%s|%s|%s|%s]" % (self.pre, self.esc, self.ifun, self.the_rest)
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return "<" + str(self) + ">"

{ipython-9.8.0 → ipython-9.9.0}/IPython/core/tips.py

@@ -107,6 +107,16 @@ else:
         ]
     )
 
+# Check if argcomplete is installed and add tip
+try:
+    import argcomplete
+
+    _tips["random"].append(
+        "Run `activate-global-python-argcomplete` from your shell to enable CLI completion for IPython"
+    )
+except ModuleNotFoundError:
+    pass
+
 
 def pick_tip() -> str:
     current_date = datetime.now()

{ipython-9.8.0 → ipython-9.9.0}/IPython/extensions/deduperreload/deduperreload_patching.py

@@ -7,12 +7,7 @@ NOT_FOUND: object = object()
 NULL: object = object()
 _MAX_FIELD_SEARCH_OFFSET = 50
 
-if sys.maxsize > 2**32:
-    WORD_TYPE: type[ctypes.c_int32] | type[ctypes.c_int64] = ctypes.c_int64
-    WORD_N_BYTES = 8
-else:
-    WORD_TYPE = ctypes.c_int32
-    WORD_N_BYTES = 4
+POINTER_N_BYTES = ctypes.sizeof(ctypes.c_void_p)
 
 
 class DeduperReloaderPatchingMixin:
@@ -32,7 +27,7 @@ class DeduperReloaderPatchingMixin:
         for offset in range(1, _MAX_FIELD_SEARCH_OFFSET):
             if (
                 ctypes.cast(
-                    obj_addr + WORD_N_BYTES * offset, ctypes.POINTER(WORD_TYPE)
+                    obj_addr + POINTER_N_BYTES * offset, ctypes.POINTER(ctypes.c_void_p)
                 ).contents.value
                 == field_addr
             ):
@@ -69,7 +64,7 @@ class DeduperReloaderPatchingMixin:
         if new_value not in (None, NULL):
             ctypes.pythonapi.Py_IncRef(ctypes.py_object(new_value))
         ctypes.cast(
-            obj_addr + WORD_N_BYTES * offset, ctypes.POINTER(WORD_TYPE)
+            obj_addr + POINTER_N_BYTES * offset, ctypes.POINTER(ctypes.c_void_p)
         ).contents.value = new_value_addr
 
     @classmethod

{ipython-9.8.0 → ipython-9.9.0}/IPython/lib/pretty.py

@@ -109,6 +109,14 @@ from IPython.utils.py3compat import PYPY
 
 from typing import Dict
 
+# Allow pretty-printing of functions with PEP-649 annotations
+if sys.version_info >= (3, 14):
+    from annotationlib import Format
+    from functools import partial
+
+    signature = partial(signature, annotation_format=Format.FORWARDREF)
+
+
 __all__ = ['pretty', 'pprint', 'PrettyPrinter', 'RepresentationPrinter',
     'for_type', 'for_type_by_name', 'RawText', 'RawStringLiteral', 'CallExpression']
 

{ipython-9.8.0 → ipython-9.9.0}/IPython/terminal/shortcuts/__init__.py

@@ -635,4 +635,5 @@ UNASSIGNED_ALLOWED_COMMANDS = [
     nc.forward_char,
     nc.forward_word,
     nc.unix_line_discard,
+    nc.unix_word_rubout,
 ]

{ipython-9.8.0 → ipython-9.9.0}/IPython/utils/_sysinfo.py

@@ -1,2 +1,2 @@
 # GENERATED BY setup.py
-commit = "2fc1f45"
+commit = "0c28fe5"

{ipython-9.8.0/ipython.egg-info → ipython-9.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ipython
-Version: 9.8.0
+Version: 9.9.0
 Summary: IPython: Productive Interactive Computing
 Author: The IPython Development Team
 Author-email: ipython-dev@python.org
@@ -70,7 +70,8 @@ Requires-Dist: trio>=0.1.0; extra == "test-extra"
 Provides-Extra: matplotlib
 Requires-Dist: matplotlib>3.9; extra == "matplotlib"
 Provides-Extra: all
-Requires-Dist: ipython[doc,matplotlib,test,test_extra]; extra == "all"
+Requires-Dist: ipython[doc,matplotlib,terminal,test,test_extra]; extra == "all"
+Requires-Dist: argcomplete>=3.0; extra == "all"
 Dynamic: author
 Dynamic: author-email
 Dynamic: license-file

{ipython-9.8.0 → ipython-9.9.0}/docs/source/conf.py

@@ -92,6 +92,12 @@ intersphinx_mapping = get_intersphinx_mapping(
     }
 )
 
+# External links configuration (replaces custom github extension)
+extlinks = {
+    "ghissue": ("https://github.com/ipython/ipython/issues/%s/", "#%s"),
+    "ghpull": ("https://github.com/ipython/ipython/pull/%s/", "PR #%s"),
+}
+
 
 # Options for HTML output
 # -----------------------

{ipython-9.8.0 → ipython-9.9.0}/docs/source/install/install.rst

@@ -78,6 +78,32 @@ The quickest way to get up and running with IPython is to install it with pip:
 That's it.
 
 
+Optional: Command-line completion
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+IPython supports command-line completion via the ``argcomplete`` package.
+To enable tab completion for IPython and other Python programs that support
+argcomplete, install IPython with the ``terminal`` extra:
+
+.. code-block:: bash
+
+    $ pip install ipython[all]
+    $ activate-global-python-argcomplete
+
+Alternatively, you can install argcomplete separately:
+
+.. code-block:: bash
+
+    $ pip install argcomplete
+    $ activate-global-python-argcomplete
+
+This will enable shell completion for all Python programs that support argcomplete,
+including IPython. Note that you may need to restart your shell for the changes
+to take effect.
+
+For more information, see the `argcomplete documentation <https://github.com/kislyuk/argcomplete>`_.
+
+
 .. _devinstall:
 
 Installing the development version

{ipython-9.8.0 → ipython-9.9.0}/docs/source/sphinx.toml

@@ -13,11 +13,11 @@ extensions = [
     "sphinx.ext.inheritance_diagram",
     "sphinx.ext.intersphinx",
     "sphinx.ext.graphviz",
+    "sphinx.ext.extlinks",  # for easy GitHub links
     "sphinxcontrib.jquery",
     "IPython.sphinxext.ipython_console_highlighting",
     "IPython.sphinxext.ipython_directive",
     "sphinx.ext.napoleon",  # to preprocess docstrings
-    "github",  # for easy GitHub links
     "magics",
     "configtraits",
 ]

{ipython-9.8.0 → ipython-9.9.0}/docs/source/whatsnew/version9.rst

@@ -3,6 +3,55 @@
 ============
 
 
+.. _version 9.9:
+
+IPython 9.9
+===========
+
+This release includes several bug fixes and improvements across completions, type annotations, and developer experience.
+
+- :ghpull:`15092` Fix formatting for completion suggestions section
+- :ghpull:`15057` Reduce types in splitinput.py
+- :ghpull:`15096` Use Any type in traceback tuple
+- :ghpull:`15099` Fix filename of CVE test
+- :ghpull:`15091` Skip downstream CI if only docs changes
+- :ghpull:`15093` Replace sphinxext/github with extlink configuration
+- :ghpull:`15103` Tips and docs about argcomplete
+- :ghpull:`15105` Add prompt_toolkit's unix_word_rubout to assignable commands for shortcuts
+- :ghpull:`15095` Enable pretty-printing for PEP-649 annotated functions
+- :ghpull:`15106` Fix completions for methods starting with ``_``
+- :ghpull:`15111` Stop assuming that memory addresses are signed
+- :ghpull:`15102` Bump macOS runner version in GitHub Actions
+- :ghpull:`15101` Fix crash on literal with surrogate
+
+Improvements to PEP-649 Support
+-------------------------------
+
+IPython now properly pretty-prints functions with PEP-649 style annotations. This improves the display of functions in interactive sessions when using Python 3.14+ annotation semantics.
+
+
+Shell Shortcuts Enhancement
+-----------------------------
+
+The ``unix_word_rubout`` command from prompt_toolkit is now available as an assignable command for terminal shortcuts, giving users more flexibility in customizing their keybindings.
+
+
+Type Annotation Improvements
+----------------------------
+
+Various type annotation improvements have been made throughout the codebase for better static analysis support, including fixes for tracebacks and improved type inference in the completion engine.
+
+
+Thanks
+------
+
+Thanks as well to the `D. E. Shaw group <https://deshaw.com/>`_ for sponsoring
+work on IPython.
+
+As usual, you can find the full list of PRs on GitHub under `the 9.9
+<https://github.com/ipython/ipython/milestone/157?closed=1>`__ milestone.
+
+
 .. _version 9.8:
 
 IPython 9.8
@@ -59,10 +108,13 @@ disabled:
   attribute completions.
 
 - File path completions are now strictly suppressed when completing attributes,
-  preventing confusion when typing patterns like ``obj.file``. - Union types in
-  annotations (e.g., ``x: int | str``) are now properly handled for completion
-  suggestions. - The completer now falls back to type annotations when runtime
-  evaluation is not available, improving completion accuracy for typed code.
+  preventing confusion when typing patterns like ``obj.file``.
+
+- Union types in annotations (e.g., ``x: int | str``) are now properly handled
+  for completion suggestions.
+
+- The completer now falls back to type annotations when runtime evaluation is
+  not available, improving completion accuracy for typed code.
 
 
 Thanks

{ipython-9.8.0 → ipython-9.9.0/ipython.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ipython
-Version: 9.8.0
+Version: 9.9.0
 Summary: IPython: Productive Interactive Computing
 Author: The IPython Development Team
 Author-email: ipython-dev@python.org
@@ -70,7 +70,8 @@ Requires-Dist: trio>=0.1.0; extra == "test-extra"
 Provides-Extra: matplotlib
 Requires-Dist: matplotlib>3.9; extra == "matplotlib"
 Provides-Extra: all
-Requires-Dist: ipython[doc,matplotlib,test,test_extra]; extra == "all"
+Requires-Dist: ipython[doc,matplotlib,terminal,test,test_extra]; extra == "all"
+Requires-Dist: argcomplete>=3.0; extra == "all"
 Dynamic: author
 Dynamic: author-email
 Dynamic: license-file

{ipython-9.8.0 → ipython-9.9.0}/ipython.egg-info/SOURCES.txt

@@ -326,7 +326,6 @@ docs/source/whatsnew/pr/antigravity-feature.rst
 docs/source/whatsnew/pr/incompat-switching-to-perl.rst
 docs/sphinxext/apigen.py
 docs/sphinxext/configtraits.py
-docs/sphinxext/github.py
 docs/sphinxext/magics.py
 examples/auto_suggest_llm.py
 examples/Embedding/embed_class_long.py
@@ -357,7 +356,6 @@ tests/2x2.png
 tests/__init__.py
 tests/bad_all.py
 tests/conftest.py
-tests/cve.py
 tests/fake_llm.py
 tests/nonascii.py
 tests/nonascii2.py
@@ -376,6 +374,7 @@ tests/test_clipboard.py
 tests/test_compilerop.py
 tests/test_completer.py
 tests/test_completerlib.py
+tests/test_cve.py
 tests/test_debug_magic.py
 tests/test_debugger.py
 tests/test_decorators.py

{ipython-9.8.0 → ipython-9.9.0}/ipython.egg-info/requires.txt

@@ -17,7 +17,8 @@ pexpect>4.3
 colorama>=0.4.4
 
 [all]
-ipython[doc,matplotlib,test,test_extra]
+ipython[doc,matplotlib,terminal,test,test_extra]
+argcomplete>=3.0
 
 [black]
 black

{ipython-9.8.0 → ipython-9.9.0}/pyproject.toml

@@ -91,7 +91,8 @@ matplotlib = [
    "matplotlib>3.9"
 ]
 all = [
-    "ipython[doc,matplotlib,test,test_extra]",
+    "ipython[doc,matplotlib,terminal,test,test_extra]",
+    "argcomplete>=3.0",
 ]
 
 

{ipython-9.8.0 → ipython-9.9.0}/tests/test_async_helpers.py

@@ -4,6 +4,7 @@ Test for async helpers.
 Should only trigger on python 3.5+ or will have syntax errors.
 """
 
+import sys
 from itertools import chain, repeat
 from textwrap import dedent, indent
 from typing import TYPE_CHECKING
@@ -44,6 +45,16 @@ class AsyncTest(TestCase):
             )
         )
 
+        self.assertFalse(_should_be_async("return await foo()"))
+        self.assertFalse(_should_be_async("return bar()"))
+        self.assertFalse(_should_be_async("some invalid Python code"))
+
+        self.assertFalse(_should_be_async("'\\ud800'"))
+        
+        if sys.version_info >= (3, 13):
+            # Note: the next assert assumes the tests run without the `-OO` flag
+            self.assertFalse(_should_be_async("'\\ud800'\nawait foo"))
+
     def _get_top_level_cases(self):
         # These are test cases that should be valid in a function
         # but invalid outside of a function.

{ipython-9.8.0 → ipython-9.9.0}/tests/test_completer.py

@@ -2068,6 +2068,27 @@ class TestCompleter(unittest.TestCase):
             a_matcher.matcher_priority = 3
             _(["completion_a"])
 
+    def test_private_attr_completions(self):
+        ip = get_ipython()
+        ip.user_ns["Test"] = type("Test", (), {"_test1": 1, "__test2": 2})
+        ip.user_ns["t"] = ip.user_ns["Test"]()
+        ip.Completer.use_jedi = False
+
+        try:
+            with provisionalcompleter():
+                completions = list(ip.Completer.completions(text="t._", offset=3))
+                completion_texts = [c.text for c in completions]
+
+                assert (
+                    "._test1" in completion_texts
+                ), f"_test1 not found in {completion_texts}"
+                assert (
+                    ".__test2" in completion_texts
+                ), f"__test2 not found in {completion_texts}"
+        finally:
+            del ip.user_ns["Test"]
+            del ip.user_ns["t"]
+
 
 @pytest.mark.parametrize(
     "use_jedi,evaluation",
@@ -2739,6 +2760,8 @@ def test_no_file_completions_in_attr_access(code):
         ("dict_with_dots = {'key.with.dots': value.attr", "attribute"),
         ("d[f'{a}']['{a.", "global"),
         ("ls .", "global"),
+        ("t._", "attribute"),
+        ("t.__a", "attribute"),
     ],
 )
 def test_completion_context(line, expected):

{ipython-9.8.0 → ipython-9.9.0}/tests/test_pretty.py

@@ -543,6 +543,31 @@ def test_function_pretty():
     assert "meaning_of_life(question=None)" in pretty.pretty(meaning_of_life)
 
 
+def test_annotated_function_pretty():
+    "Test pretty print of a function with PEP-649 annotations"
+    # Confirm that the name is not in scope
+    try:
+        b
+    except NameError:
+        pass
+    else:
+        assert False, "Unexpected 'b' found in scope"
+    try:
+        def f(a: b): pass
+    except NameError as e:
+        if e.name == 'b':
+            # PEP-649 not available
+            return
+        raise
+    # Check whether __future__.annotations is in effect
+    # It probably shouldn't be, but to be sure:
+    import __future__
+    if f.__code__.co_flags & __future__.annotations.compiler_flag:
+        assert "f(a: 'b')" in pretty.pretty(f)
+    else:
+        assert "f(a: b)" in pretty.pretty(f)
+
+
 class OrderedCounter(Counter, OrderedDict):
     "Counter that remembers the order elements are first encountered"