ipython 9.15.0__tar.gz → 9.16.0__tar.gz

{ipython-9.15.0 → ipython-9.16.0}/.mailmap

@@ -33,7 +33,7 @@ David P. Sanders <dpsanders@gmail.com> David P. Sanders <dpsanders@ciencias.unam
 David Warde-Farley <wardefar@iro.umontreal.ca> David Warde-Farley <>
 Dan Green-Leipciger <dangreen.tlv@gmail.com> <dangreen.tlv@gmail.com>
 Doug Blank <dblank@cs.brynmawr.edu> Doug Blank <doug.blank@gmail.com>
-Eugene Van den Bulke <eugene.van-den-bulke@gmail.com> Eugene Van den Bulke <eugene.vandenbulke@gmail.com> 
+Eugene Van den Bulke <eugene.van-den-bulke@gmail.com> Eugene Van den Bulke <eugene.vandenbulke@gmail.com>
 Evan Patterson <epatters@enthought.com> <epatters@EPattersons-MacBook-Pro.local>
 Evan Patterson <epatters@enthought.com> <epatters@evan-laptop.localdomain>
 Evan Patterson <epatters@enthought.com> <epatters@caltech.edu>
@@ -153,7 +153,7 @@ Juan Luis Cano Rodríguez <juanlu@readthedocs.org> <hello@juanlu.space>
 Tamir Bahar <tamir@north-bit.com> Tamir Bahar <tmr232@users.noreply.github.com>
 Ted Drain <ted.drain@gmail.com> TD22057 <ted.drain@gmail.com>
 Théophile Studer <theo.studer@gmail.com> Théophile Studer <studer@users.noreply.github.com>
-Thomas A Caswell <tcaswell@gmail.com> Thomas A Caswell <tcaswell@bnl.gov> 
+Thomas A Caswell <tcaswell@gmail.com> Thomas A Caswell <tcaswell@bnl.gov>
 Thomas Kluyver <thomas@kluyver.me.uk> Thomas <takowl@gmail.com>
 Thomas Kluyver <thomas@kluyver.me.uk> Thomas Kluyver <takowl@gmail.com>
 Thomas Spura <tomspur@fedoraproject.org> Thomas Spura <thomas.spura@gmail.com>
@@ -171,4 +171,3 @@ Walter Doerwald <walter@livinglogic.de> Walter Doerwald <>
 Wieland Hoffmann <themineo@gmail.com> Wieland Hoffmann <mineo@users.noreply.github.com>
 W. Trevor King <wking@tremily.us> W. Trevor King <wking@drexel.edu>
 Yoval P. <yoval@gmx.com> y-p <yoval@gmx.com>
-

{ipython-9.15.0 → ipython-9.16.0}/.pre-commit-config.yaml

@@ -2,15 +2,17 @@
 # See https://pre-commit.com/hooks.html for more hooks
 repos:
 -   repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.4.0
+    rev: v6.0.0
     hooks:
     -   id: trailing-whitespace
+        exclude: 'tests/test_ipunittest\.py'
     -   id: end-of-file-fixer
     -   id: check-yaml
     -   id: check-added-large-files
 
 -   repo: https://github.com/akaihola/darker
-    rev: 1.7.2
+    rev: v3.0.0
     hooks:
     -   id: darker
-        additional_dependencies: [isort, mypy, flake8]
+        args: [--formatter=ruff]
+        additional_dependencies: [ruff, isort, mypy, flake8]

{ipython-9.15.0 → ipython-9.16.0}/COPYING.rst

@@ -14,7 +14,7 @@ Fernando Perez began IPython in 2001 based on code from Janko Hauser
 the project lead.
 
 The IPython Development Team is the set of all contributors to the IPython
-project.  This includes all of the IPython subprojects. 
+project.  This includes all of the IPython subprojects.
 
 The core team that coordinates development on GitHub can be found here:
 https://github.com/ipython/.
@@ -32,7 +32,7 @@ changes/contributions they have specific copyright on, they should indicate
 their copyright in the commit message of the change, when they commit the
 change to one of the IPython repositories.
 
-With this in mind, the following banner should be used in any source code file 
+With this in mind, the following banner should be used in any source code file
 to indicate the copyright and license terms:
 
 ::

{ipython-9.15.0 → ipython-9.16.0}/IPython/__init__.py

@@ -21,35 +21,19 @@ https://ipython.org
 
 import sys
 import warnings
+from typing import Any
 
 #-----------------------------------------------------------------------------
 # Setup everything
 #-----------------------------------------------------------------------------
 
 # Don't forget to also update setup.py when this changes!
-if sys.version_info < (3, 11):
-    raise ImportError(
-        """
-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.
-Python 3.3 and 3.4 were supported up to IPython 6.x.
-Python 3.5 was supported with IPython 7.0 to 7.9.
-Python 3.6 was supported with IPython up to 7.16.
-Python 3.7 was still supported with the 7.x branch.
-
-See IPython `README.rst` file for more information:
-
-    https://github.com/ipython/ipython/blob/main/README.rst
-
-"""
-    )
-
-#-----------------------------------------------------------------------------
-# Setup the top level names
-#-----------------------------------------------------------------------------
-
+#
+# NOTE: these imports look like they could be made lazy (PEP 562) to speed up
+# `import IPython` considerably, but downstream projects (pyflyby at least)
+# rely on the transitive side effects: they do `import IPython` and then
+# access attribute chains like `IPython.terminal.ipapp.TerminalIPythonApp`,
+# which only resolve because the imports below load those submodules.
 from .core.getipython import get_ipython
 from .core import release
 from .core.application import Application
@@ -62,7 +46,7 @@ from .utils.frame import extract_module_locals
 __all__ = ["start_ipython", "embed", "embed_kernel"]
 
 # Release data
-__author__ = '%s <%s>' % (release.author, release.author_email)
+__author__ = '{} <{}>'.format(release.author, release.author_email)
 __license__  = release.license
 __version__  = release.version
 version_info = release.version_info
@@ -109,12 +93,12 @@ def embed_kernel(module=None, local_ns=None, **kwargs):
         module = caller_module
     if local_ns is None:
         local_ns = dict(**caller_locals)
-    
+
     # Only import .zmq when we really need it
     from ipykernel.embed import embed_kernel as real_embed_kernel
     real_embed_kernel(module=module, local_ns=local_ns, **kwargs)
 
-def start_ipython(argv=None, **kwargs):
+def start_ipython(argv: list[str] | None = None, **kwargs: Any) -> Any:
     """Launch a normal IPython instance (as opposed to embedded)
 
     `IPython.embed()` puts a shell in a particular calling scope,

{ipython-9.15.0 → ipython-9.16.0}/IPython/__main__.py

@@ -1,5 +1,4 @@
 # PYTHON_ARGCOMPLETE_OK
-# encoding: utf-8
 """Terminal-based IPython entry point."""
 # -----------------------------------------------------------------------------
 #  Copyright (c) 2012, IPython Development Team.

{ipython-9.15.0 → ipython-9.16.0}/IPython/core/alias.py

@@ -1,4 +1,3 @@
-# encoding: utf-8
 """
 System command aliases.
 
@@ -7,6 +6,7 @@ Authors:
 * Fernando Perez
 * Brian Granger
 """
+from __future__ import annotations
 
 #-----------------------------------------------------------------------------
 #  Copyright (C) 2008-2011  The IPython Development Team
@@ -30,8 +30,6 @@ from .error import UsageError
 from traitlets import List, Instance
 from logging import error
 
-import typing as t
-
 
 #-----------------------------------------------------------------------------
 # Utilities
@@ -40,7 +38,7 @@ import typing as t
 # This is used as the pattern for calls to split_user_input.
 shell_line_split = re.compile(r'^(\s*)()(\S+)(.*$)')
 
-def default_aliases() -> t.List[t.Tuple[str, str]]:
+def default_aliases() -> list[tuple[str, str]]:
     """Return list of shell aliases to auto-define.
     """
     # Note: the aliases defined here should be safe to use on a kernel
@@ -134,7 +132,7 @@ class Alias:
         self.shell = shell
         self.name = name
         self.cmd = cmd
-        self.__doc__ = "Alias for `!{}`".format(cmd)
+        self.__doc__ = f"Alias for `!{cmd}`"
         self.nargs = self.validate()
 
     def validate(self):
@@ -156,7 +154,7 @@ class Alias:
                                     "got: %r" % self.cmd)
 
         nargs = self.cmd.count('%s') - self.cmd.count('%%s')
-  
+
         if (nargs > 0) and (self.cmd.find('%l') >= 0):
             raise InvalidAliasError('The %s and %l specifiers are mutually '
                                     'exclusive in alias definitions.')
@@ -164,7 +162,7 @@ class Alias:
         return nargs
 
     def __repr__(self):
-        return "<alias {} for {!r}>".format(self.name, self.cmd)
+        return f"<alias {self.name} for {self.cmd!r}>"
 
     def __call__(self, rest=''):
         cmd = self.cmd
@@ -173,19 +171,19 @@ class Alias:
         if cmd.find('%l') >= 0:
             cmd = cmd.replace('%l', rest)
             rest = ''
-        
+
         if nargs==0:
             if cmd.find('%%s') >= 1:
                 cmd = cmd.replace('%%s', '%s')
             # Simple, argument-less aliases
-            cmd = '%s %s' % (cmd, rest)
+            cmd = '{} {}'.format(cmd, rest)
         else:
             # Handle aliases with positional arguments
             args = rest.split(None, nargs)
             if len(args) < nargs:
                 raise UsageError('Alias <%s> requires %s arguments, %s given.' %
                       (self.name, nargs, len(args)))
-            cmd = '%s %s' % (cmd % tuple(args[:nargs]),' '.join(args[nargs:]))
+            cmd = '{} {}'.format(cmd % tuple(args[:nargs]),' '.join(args[nargs:]))
 
         self.shell.system(cmd)
 
@@ -201,7 +199,7 @@ class AliasManager(Configurable):
     )
 
     def __init__(self, shell=None, **kwargs):
-        super(AliasManager, self).__init__(shell=shell, **kwargs)
+        super().__init__(shell=shell, **kwargs)
         # For convenient access
         if self.shell is not None:
             self.linemagics = self.shell.magics_manager.magics["line"]

{ipython-9.15.0 → ipython-9.16.0}/IPython/core/application.py

@@ -1,4 +1,3 @@
-# encoding: utf-8
 """
 An application for IPython.
 
@@ -121,7 +120,7 @@ class ProfileAwareConfigLoader(PyFileConfigLoader):
             except ProfileDirError:
                 return
             path = profile_dir.location
-        return super(ProfileAwareConfigLoader, self).load_subconfig(fname, path=path)
+        return super().load_subconfig(fname, path=path)
 
 class BaseIPythonApplication(Application):
     name = "ipython"
@@ -131,7 +130,7 @@ class BaseIPythonApplication(Application):
     aliases = base_aliases
     flags = base_flags
     classes = List([ProfileDir])
-    
+
     # enable `load_subconfig('cfg.py', profile='name')`
     python_config_loader_class = ProfileAwareConfigLoader
 
@@ -142,7 +141,7 @@ class BaseIPythonApplication(Application):
     config_file_name = Unicode()
     @default('config_file_name')
     def _config_file_name_default(self):
-        return self.name.replace('-','_') + u'_config.py'
+        return self.name.replace('-','_') + '_config.py'
     @observe('config_file_name')
     def _config_file_name_changed(self, change):
         if change['new'] != change['old']:
@@ -150,17 +149,16 @@ class BaseIPythonApplication(Application):
 
     # The directory that contains IPython's builtin profiles.
     builtin_profile_dir = Unicode(
-        os.path.join(get_ipython_package_dir(), u'config', u'profile', u'default')
+        os.path.join(get_ipython_package_dir(), 'config', 'profile', 'default')
     )
-    
+
     config_file_paths = List(Unicode())
     @default('config_file_paths')
     def _config_file_paths_default(self):
         return []
 
-    extra_config_file = Unicode(
-    help="""Path to an extra config file to load.
-    
+    extra_config_file = Unicode(help="""Path to an extra config file to load.
+
     If specified, load this config file in addition to any other IPython config.
     """).tag(config=True)
     @observe('extra_config_file')
@@ -174,14 +172,14 @@ class BaseIPythonApplication(Application):
         self.config_file_specified.add(new)
         self.config_files.append(new)
 
-    profile = Unicode(u'default',
+    profile = Unicode('default',
         help="""The IPython profile to use."""
     ).tag(config=True)
-    
+
     @observe('profile')
     def _profile_changed(self, change):
         self.builtin_profile_dir = os.path.join(
-                get_ipython_package_dir(), u'config', u'profile', change['new']
+                get_ipython_package_dir(), 'config', 'profile', change['new']
         )
 
     add_ipython_dir_to_sys_path = Bool(
@@ -212,7 +210,7 @@ class BaseIPythonApplication(Application):
             'new': d,
         })
         return d
-    
+
     _in_init_profile_dir = False
 
     profile_dir = Instance(ProfileDir, allow_none=True)
@@ -246,7 +244,7 @@ class BaseIPythonApplication(Application):
         profile, then they will be staged into the new directory.  Otherwise,
         default config files will be automatically generated.
         """).tag(config=True)
-    
+
     verbose_crash = Bool(False,
         help="""Create a massive crash report when IPython encounters what may be an
         internal error.  The default is to append a short message to the
@@ -257,11 +255,11 @@ class BaseIPythonApplication(Application):
 
     @catch_config_error
     def __init__(self, **kwargs):
-        super(BaseIPythonApplication, self).__init__(**kwargs)
+        super().__init__(**kwargs)
         # ensure current working directory exists
         try:
             os.getcwd()
-        except:
+        except OSError:
             # exit if cwd doesn't exist
             self.log.error("Current working directory doesn't exist.")
             self.exit(1)
@@ -269,7 +267,7 @@ class BaseIPythonApplication(Application):
     #-------------------------------------------------------------------------
     # Various stages of Application creation
     #-------------------------------------------------------------------------
-    
+
     def init_crash_handler(self):
         """Create a crash handler, typically setting sys.excepthook to it."""
         self.crash_handler = self.crash_handler_class(self)
@@ -277,14 +275,14 @@ class BaseIPythonApplication(Application):
         def unset_crashhandler():
             sys.excepthook = sys.__excepthook__
         atexit.register(unset_crashhandler)
-    
+
     def excepthook(self, etype, evalue, tb):
         """this is sys.excepthook after init_crashhandler
 
         set self.verbose_crash=True to use our full crashhandler, instead of
         a regular traceback with a short message (crash_handler_lite)
         """
-        
+
         if self.verbose_crash:
             return self.crash_handler(etype, evalue, tb)
         else:
@@ -355,7 +353,7 @@ class BaseIPythonApplication(Application):
             pass
         if suppress_errors is not None:
             Application.raise_config_file_errors = old_value
-        
+
         for config_file_name in self.config_files:
             if not config_file_name or config_file_name == base_config:
                 continue

{ipython-9.15.0 → ipython-9.16.0}/IPython/core/async_helpers.py

@@ -15,7 +15,7 @@ import asyncio
 import inspect
 from functools import wraps
 
-_asyncio_event_loop = None
+_asyncio_event_loop: asyncio.AbstractEventLoop | None = None
 
 
 def get_asyncio_loop():
@@ -131,7 +131,7 @@ def _pseudo_sync_runner(coro):
     else:
         # TODO: do not raise but return an execution result with the right info.
         raise RuntimeError(
-            "{coro_name!r} needs a real async loop".format(coro_name=coro.__name__)
+            f"{coro.__name__!r} needs a real async loop"
         )
 
 

{ipython-9.15.0 → ipython-9.16.0}/IPython/core/autocall.py

@@ -1,4 +1,3 @@
-# encoding: utf-8
 """
 Autocall capabilities for IPython.core.
 
@@ -29,8 +28,8 @@ Notes
 #-----------------------------------------------------------------------------
 
 class IPyAutocall:
-    """ Instances of this class are always autocalled
-    
+    """Instances of this class are always autocalled
+
     This happens regardless of 'autocall' variable state. Use this to
     develop macro-like mechanisms.
     """
@@ -38,7 +37,7 @@ class IPyAutocall:
     rewrite = True
     def __init__(self, ip=None):
         self._ip = ip
-    
+
     def set_ip(self, ip):
         """Will be used to set _ip point to current ipython instance b/f call
 
@@ -52,13 +51,14 @@ class ExitAutocall(IPyAutocall):
     """An autocallable object which will be added to the user namespace so that
     exit, exit(), quit or quit() are all valid ways to close the shell."""
     rewrite = False
-    
+
     def __call__(self):
         self._ip.ask_exit()
-        
+
+
 class ZMQExitAutocall(ExitAutocall):
     """Exit IPython. Autocallable, so it needn't be explicitly called.
-    
+
     Parameters
     ----------
     keep_kernel : bool

{ipython-9.15.0 → ipython-9.16.0}/IPython/core/builtin_trap.py

@@ -3,12 +3,18 @@ A context manager for managing things injected into :mod:`builtins`.
 """
 # Copyright (c) IPython Development Team.
 # Distributed under the terms of the Modified BSD License.
+from __future__ import annotations
+
 import builtins as builtin_mod
+from typing import Any, Literal, TYPE_CHECKING
 
 from traitlets.config.configurable import Configurable
 
 from traitlets import Instance
 
+if TYPE_CHECKING:
+    from types import TracebackType
+
 
 class __BuiltinUndefined:
     pass
@@ -29,35 +35,36 @@ class BuiltinTrap(Configurable):
     shell = Instance('IPython.core.interactiveshell.InteractiveShellABC',
                      allow_none=True)
 
-    def __init__(self, shell=None):
-        super(BuiltinTrap, self).__init__(shell=shell, config=None)
-        self._orig_builtins = {}
+    def __init__(self, shell: Any = None) -> None:
+        super().__init__(shell=shell, config=None)
+        self._orig_builtins: dict[str, Any] = {}
         # We define this to track if a single BuiltinTrap is nested.
         # Only turn off the trap when the outermost call to __exit__ is made.
         self._nested_level = 0
         self.shell = shell
         # builtins we always add - if set to HideBuiltin, they will just
         # be removed instead of being replaced by something else
-        self.auto_builtins = {'exit': HideBuiltin,
-                              'quit': HideBuiltin,
-                              'get_ipython': self.shell.get_ipython,
-                              }
+        self.auto_builtins: dict[str, Any] = {
+            'exit': HideBuiltin,
+            'quit': HideBuiltin,
+            'get_ipython': self.shell.get_ipython,
+        }
 
-    def __enter__(self):
+    def __enter__(self) -> BuiltinTrap:
         if self._nested_level == 0:
             self.activate()
         self._nested_level += 1
         # I return self, so callers can use add_builtin in a with clause.
         return self
 
-    def __exit__(self, type, value, traceback):
+    def __exit__(self, type: type[BaseException] | None, value: BaseException | None, traceback: TracebackType | None) -> Literal[False]:
         if self._nested_level == 1:
             self.deactivate()
         self._nested_level -= 1
         # Returning False will cause exceptions to propagate
         return False
 
-    def add_builtin(self, key, value):
+    def add_builtin(self, key: str, value: Any) -> None:
         """Add a builtin and save the original."""
         bdict = builtin_mod.__dict__
         orig = bdict.get(key, BuiltinUndefined)
@@ -69,25 +76,24 @@ class BuiltinTrap(Configurable):
             self._orig_builtins[key] = orig
             bdict[key] = value
 
-    def remove_builtin(self, key, orig):
+    def remove_builtin(self, key: str, orig: Any) -> None:
         """Remove an added builtin and re-set the original."""
         if orig is BuiltinUndefined:
             del builtin_mod.__dict__[key]
         else:
             builtin_mod.__dict__[key] = orig
 
-    def activate(self):
+    def activate(self) -> None:
         """Store ipython references in the __builtin__ namespace."""
 
         add_builtin = self.add_builtin
         for name, func in self.auto_builtins.items():
             add_builtin(name, func)
 
-    def deactivate(self):
+    def deactivate(self) -> None:
         """Remove any builtins which might have been added by add_builtins, or
         restore overwritten ones to their previous values."""
         remove_builtin = self.remove_builtin
         for key, val in self._orig_builtins.items():
             remove_builtin(key, val)
         self._orig_builtins.clear()
-        self._builtins_added = False

{ipython-9.15.0 → ipython-9.16.0}/IPython/core/compilerop.py

@@ -26,6 +26,10 @@ Authors
 # Imports
 #-----------------------------------------------------------------------------
 
+from __future__ import annotations
+
+import ast
+
 # Stdlib imports
 import __future__
 from ast import PyCF_ONLY_AST
@@ -34,8 +38,8 @@ import functools
 import hashlib
 import linecache
 import operator
-import time
 from contextlib import contextmanager
+from collections.abc import Generator
 
 #-----------------------------------------------------------------------------
 # Constants
@@ -51,16 +55,16 @@ PyCF_MASK = functools.reduce(operator.or_,
 # Local utilities
 #-----------------------------------------------------------------------------
 
-def code_name(code, number=0) -> str:
+def code_name(code: str, number: int = 0) -> str:
     """ Compute a (probably) unique name for code for caching.
 
     This now expects code to be unicode.
     """
-    hash_digest = hashlib.sha1(code.encode("utf-8")).hexdigest()
+    hash_digest = hashlib.sha1(code.encode("utf-8"), usedforsecurity=False).hexdigest()
     # Include the number and 12 characters of the hash in the name.  It's
     # pretty much impossible that in a single session we'll have collisions
     # even with truncated hashes, and the full one makes tracebacks too long
-    return '<ipython-input-{0}-{1}>'.format(number, hash_digest[:12])
+    return f'<ipython-input-{number}-{hash_digest[:12]}>'
 
 #-----------------------------------------------------------------------------
 # Classes and functions
@@ -78,26 +82,26 @@ class CachingCompiler(codeop.Compile):
         # argument used for the builtins.compile function.
         self._filename_map = {}
 
-    def ast_parse(self, source, filename='<unknown>', symbol='exec'):
+    def ast_parse(self, source: str, filename: str = '<unknown>', symbol: str = 'exec') -> ast.AST:
         """Parse code to an AST with the current compiler flags active.
 
         Arguments are exactly the same as ast.parse (in the standard library),
         and are passed to the built-in compile function."""
         return compile(source, filename, symbol, self.flags | PyCF_ONLY_AST, 1)
 
-    def reset_compiler_flags(self):
+    def reset_compiler_flags(self) -> None:
         """Reset compiler flags to default state."""
         # This value is copied from codeop.Compile.__init__, so if that ever
         # changes, it will need to be updated.
         self.flags = codeop.PyCF_DONT_IMPLY_DEDENT
 
     @property
-    def compiler_flags(self):
+    def compiler_flags(self) -> int:
         """Flags currently active in the compilation process.
         """
         return self.flags
 
-    def get_code_name(self, raw_code, transformed_code, number):
+    def get_code_name(self, raw_code: str, transformed_code: str, number: int) -> str:
         """Compute filename given the code, and the cell number.
 
         Parameters
@@ -116,7 +120,7 @@ class CachingCompiler(codeop.Compile):
         """
         return code_name(transformed_code, number)
 
-    def format_code_name(self, name) -> str:
+    def format_code_name(self, name: str) -> tuple[str, str] | None:
         """Return a user-friendly label and name for a code block.
 
         Parameters
@@ -131,7 +135,7 @@ class CachingCompiler(codeop.Compile):
         if name in self._filename_map:
             return "Cell", "In[%s]" % self._filename_map[name]
 
-    def cache(self, transformed_code, number=0, raw_code=None):
+    def cache(self, transformed_code: str, number: int = 0, raw_code: str | None = None) -> str:
         """Make a name for a block of code, and cache the code.
 
         Parameters
@@ -178,7 +182,7 @@ class CachingCompiler(codeop.Compile):
         return name
 
     @contextmanager
-    def extra_flags(self, flags):
+    def extra_flags(self, flags: int) -> Generator[None, None, None]:
         ## bits that we'll set to 1
         turn_on_bits = ~self.flags & flags