ipython 9.10.0__tar.gz → 9.12.0__tar.gz

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

@@ -27,13 +27,13 @@ import warnings
 #-----------------------------------------------------------------------------
 
 # Don't forget to also update setup.py when this changes!
-if sys.version_info < (3, 11):
+if sys.version_info < (3, 12):
     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 8.19+ supports Python 3.10 and above, following SPEC0.
 IPython 8.13+ supports Python 3.9 and above, following NEP 29.
-IPython 8.0-8.12 supports Python 3.8 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.

{ipython-9.10.0 → ipython-9.12.0}/IPython/core/alias.py

@@ -219,7 +219,7 @@ class AliasManager(Configurable):
             self.soft_define_alias(name, cmd)
 
     @property
-    def aliases(self):
+    def aliases(self) -> list:
         return [(n, func.cmd) for (n, func) in self.linemagics.items()
                             if isinstance(func, Alias)]
 

{ipython-9.10.0 → ipython-9.12.0}/IPython/core/application.py

@@ -33,10 +33,11 @@ from traitlets import (
 )
 
 if os.name == "nt":
+    # %PROGRAMDATA% is not safe by default, require opt-in to trust it
     programdata = os.environ.get("PROGRAMDATA", None)
-    if programdata is not None:
+    if os.environ.get("IPYTHON_USE_PROGRAMDATA") == "1" and programdata is not None:
         SYSTEM_CONFIG_DIRS = [str(Path(programdata) / "ipython")]
-    else:  # PROGRAMDATA is not defined by default on XP.
+    else:
         SYSTEM_CONFIG_DIRS = []
 else:
     SYSTEM_CONFIG_DIRS = [

{ipython-9.10.0 → ipython-9.12.0}/IPython/core/compilerop.py

@@ -51,7 +51,7 @@ PyCF_MASK = functools.reduce(operator.or_,
 # Local utilities
 #-----------------------------------------------------------------------------
 
-def code_name(code, number=0):
+def code_name(code, number=0) -> str:
     """ Compute a (probably) unique name for code for caching.
 
     This now expects code to be unicode.
@@ -116,7 +116,7 @@ class CachingCompiler(codeop.Compile):
         """
         return code_name(transformed_code, number)
 
-    def format_code_name(self, name):
+    def format_code_name(self, name) -> str:
         """Return a user-friendly label and name for a code block.
 
         Parameters

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

@@ -243,11 +243,7 @@ import __main__
 
 from typing import cast
 
-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
+from typing import TypedDict, NotRequired, Protocol, TypeAlias, TypeGuard
 
 
 # skip module docstests
@@ -274,7 +270,7 @@ except ImportError:
 # write this). With below range we cover them all, with a density of ~67%
 # biggest next gap we consider only adds up about 1% density and there are 600
 # gaps that would need hard coding.
-_UNICODE_RANGES = [(32, 0x323B0), (0xE0001, 0xE01F0)]
+_UNICODE_RANGES = [(32, 0x3347A), (0xE0001, 0xE01F0)]
 
 # Public API
 __all__ = ["Completer", "IPCompleter"]

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

@@ -444,7 +444,7 @@ class Pdb(OldPdb):
                         self.message(
                             f"More than {self.MAX_CHAINED_EXCEPTION_DEPTH}"
                             " chained exceptions found, not all exceptions"
-                            "will be browsable with `exceptions`."
+                            " will be browsable with `exceptions`."
                         )
                         break
             else:

{ipython-9.10.0 → ipython-9.12.0}/IPython/core/events.py

@@ -15,10 +15,14 @@ events and the arguments which will be passed to them.
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any, Callable, Iterable
+from typing import TYPE_CHECKING, Any, Callable, Iterable, TypeVar
 
 if TYPE_CHECKING:
-    from IPython.core.interactiveshell import InteractiveShell
+    from IPython.core.interactiveshell import (
+        ExecutionInfo,
+        ExecutionResult,
+        InteractiveShell,
+    )
 
 
 class EventManager:
@@ -106,7 +110,10 @@ class EventManager:
 # event_name -> prototype mapping
 available_events: dict[str, Callable[..., Any]] = {}
 
-def _define_event(callback_function: Callable[..., Any]) -> Callable[..., Any]:
+_CallbackT = TypeVar("_CallbackT", bound=Callable[..., Any])
+
+def _define_event(callback_function: _CallbackT) -> _CallbackT:
+    """Decorator to register a function as an available event prototype."""
     available_events[callback_function.__name__] = callback_function
     return callback_function
 
@@ -127,7 +134,7 @@ def pre_execute() -> None:
     pass
 
 @_define_event
-def pre_run_cell(info: Any) -> None:
+def pre_run_cell(info: ExecutionInfo) -> None:
     """Fires before user-entered code runs.
 
     Parameters
@@ -147,7 +154,7 @@ def post_execute() -> None:
     pass
 
 @_define_event
-def post_run_cell(result: Any) -> None:
+def post_run_cell(result: ExecutionResult) -> None:
     """Fires after user-entered code runs.
 
     Parameters

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

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

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

@@ -10,6 +10,7 @@ import atexit
 import datetime
 import os
 import re
+import weakref
 
 
 import threading
@@ -39,6 +40,8 @@ from IPython.utils.decorators import undoc
 from typing import Tuple, Optional, TYPE_CHECKING
 from collections.abc import Iterable
 import typing
+import typing as t
+from typing import cast
 from warnings import warn
 from weakref import ref, WeakSet
 
@@ -90,6 +93,9 @@ class DummyDB:
     def __exit__(self, *args, **kwargs):  # type: ignore [no-untyped-def]
         pass
 
+    def close(self, *args, **kwargs):  # type: ignore [no-untyped-def]
+        pass
+
 
 @decorator
 def only_when_enabled(f, self, *a, **kw):  # type: ignore [no-untyped-def]
@@ -317,12 +323,14 @@ class HistoryAccessor(HistoryAccessorBase):
         """Connect to the database, and create tables if necessary."""
         if not self.enabled:
             self.db = DummyDB()
+            self._finalizer = weakref.finalize(self, lambda db: db.close(), self.db)
             return
 
         # use detect_types so that timestamps return datetime objects
         kwargs = dict(detect_types=sqlite3.PARSE_DECLTYPES | sqlite3.PARSE_COLNAMES)
         kwargs.update(self.connection_options)
         self.db = sqlite3.connect(str(self.hist_file), **kwargs)  # type: ignore [call-overload]
+        self._finalizer = weakref.finalize(self, lambda db: db.close(), self.db)
         with self.db:
             self.db.execute(
                 """CREATE TABLE IF NOT EXISTS sessions (session integer
@@ -1131,7 +1139,7 @@ class HistorySavingThread(threading.Thread):
                 if hm() is not None:
                     self.db = sqlite3.connect(
                         str(hm().hist_file),  # type: ignore [union-attr]
-                        **hm().connection_options,  # type: ignore [union-attr]
+                        **cast(dict[str, t.Any], hm().connection_options),  # type: ignore [union-attr]
                     )
             while True:
                 self.save_flag.wait()

{ipython-9.10.0 → ipython-9.12.0}/IPython/core/historyapp.py

@@ -50,27 +50,26 @@ class HistoryTrim(BaseIPythonApplication):
     def start(self):
         profile_dir = Path(self.profile_dir.location)
         hist_file = profile_dir / "history.sqlite"
-        con = sqlite3.connect(hist_file)
-
-        # Grab the recent history from the current database.
-        inputs = list(con.execute('SELECT session, line, source, source_raw FROM '
-                                'history ORDER BY session DESC, line DESC LIMIT ?', (self.keep+1,)))
-        if len(inputs) <= self.keep:
-            print("There are already at most %d entries in the history database." % self.keep)
-            print("Not doing anything. Use --keep= argument to keep fewer entries")
-            return
-
-        print("Trimming history to the most recent %d entries." % self.keep)
-
-        inputs.pop() # Remove the extra element we got to check the length.
-        inputs.reverse()
-        if inputs:
-            first_session = inputs[0][0]
-            outputs = list(con.execute('SELECT session, line, output FROM '
-                                       'output_history WHERE session >= ?', (first_session,)))
-            sessions = list(con.execute('SELECT session, start, end, num_cmds, remark FROM '
-                                        'sessions WHERE session >= ?', (first_session,)))
-        con.close()
+        with sqlite3.connect(hist_file) as con:
+
+            # Grab the recent history from the current database.
+            inputs = list(con.execute('SELECT session, line, source, source_raw FROM '
+                                    'history ORDER BY session DESC, line DESC LIMIT ?', (self.keep+1,)))
+            if len(inputs) <= self.keep:
+                print("There are already at most %d entries in the history database." % self.keep)
+                print("Not doing anything. Use --keep= argument to keep fewer entries")
+                return
+
+            print("Trimming history to the most recent %d entries." % self.keep)
+
+            inputs.pop() # Remove the extra element we got to check the length.
+            inputs.reverse()
+            if inputs:
+                first_session = inputs[0][0]
+                outputs = list(con.execute('SELECT session, line, output FROM '
+                                        'output_history WHERE session >= ?', (first_session,)))
+                sessions = list(con.execute('SELECT session, start, end, num_cmds, remark FROM '
+                                            'sessions WHERE session >= ?', (first_session,)))
 
         # Create the new history database.
         new_hist_file = profile_dir / "history.sqlite.new"
@@ -79,26 +78,25 @@ class HistoryTrim(BaseIPythonApplication):
             # Make sure we don't interfere with an existing file.
             i += 1
             new_hist_file = profile_dir / ("history.sqlite.new" + str(i))
-        new_db = sqlite3.connect(new_hist_file)
-        new_db.execute("""CREATE TABLE IF NOT EXISTS sessions (session integer
-                            primary key autoincrement, start timestamp,
-                            end timestamp, num_cmds integer, remark text)""")
-        new_db.execute("""CREATE TABLE IF NOT EXISTS history
-                        (session integer, line integer, source text, source_raw text,
-                        PRIMARY KEY (session, line))""")
-        new_db.execute("""CREATE TABLE IF NOT EXISTS output_history
-                        (session integer, line integer, output text,
-                        PRIMARY KEY (session, line))""")
-        new_db.commit()
-
-
-        if inputs:
-            with new_db:
-                # Add the recent history into the new database.
-                new_db.executemany('insert into sessions values (?,?,?,?,?)', sessions)
-                new_db.executemany('insert into history values (?,?,?,?)', inputs)
-                new_db.executemany('insert into output_history values (?,?,?)', outputs)
-        new_db.close()
+        with sqlite3.connect(new_hist_file) as new_db:
+            new_db.execute("""CREATE TABLE IF NOT EXISTS sessions (session integer
+                                primary key autoincrement, start timestamp,
+                                end timestamp, num_cmds integer, remark text)""")
+            new_db.execute("""CREATE TABLE IF NOT EXISTS history
+                            (session integer, line integer, source text, source_raw text,
+                            PRIMARY KEY (session, line))""")
+            new_db.execute("""CREATE TABLE IF NOT EXISTS output_history
+                            (session integer, line integer, output text,
+                            PRIMARY KEY (session, line))""")
+            new_db.commit()
+
+
+            if inputs:
+                with new_db:
+                    # Add the recent history into the new database.
+                    new_db.executemany('insert into sessions values (?,?,?,?,?)', sessions)
+                    new_db.executemany('insert into history values (?,?,?,?)', inputs)
+                    new_db.executemany('insert into output_history values (?,?,?)', outputs)
 
         if self.backup:
             i = 1

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

@@ -356,24 +356,8 @@ class MagicAssign(TokenTransformBase):
 class SystemAssign(TokenTransformBase):
     """Transformer for assignments from system commands (a = !foo)"""
     @classmethod
-    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):
+    def find(cls, tokens_by_line):
+        """Find the first system assignment (a = !foo) in the cell."""
         for line in tokens_by_line:
             assign_ix = _find_assign_op(line)
             if (
@@ -385,13 +369,6 @@ 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.10.0 → ipython-9.12.0}/IPython/core/interactiveshell.py

@@ -22,6 +22,7 @@ import re
 import runpy
 import shutil
 import subprocess
+from subprocess import CalledProcessError
 import sys
 import tempfile
 import traceback
@@ -37,6 +38,7 @@ from typing import List as ListType, Any as AnyType
 from typing import Literal, Optional, Tuple
 from collections.abc import Sequence
 from warnings import warn
+import textwrap
 
 from IPython.external.pickleshare import PickleShareDB
 
@@ -90,7 +92,7 @@ from IPython.utils.decorators import undoc
 from IPython.utils.io import ask_yes_no
 from IPython.utils.ipstruct import Struct
 from IPython.utils.path import ensure_dir_exists, get_home_dir, get_py_filename
-from IPython.utils.process import getoutput, system
+from IPython.utils.process import get_output_error_code, getoutput, system
 from IPython.utils.strdispatch import StrDispatch
 from IPython.utils.syspathcontext import prepended_to_syspath
 from IPython.utils.text import DollarFormatter, LSString, SList, format_screen
@@ -538,6 +540,14 @@ class InteractiveShell(SingletonConfigurable):
 
     quiet = Bool(False).tag(config=True)
 
+    system_raise_on_error = Bool(False, help=
+        """
+        Raise an exception on non-zero exit status from shell commands executed
+        via the `!` operator. When set to True, shell commands that fail will raise
+        CalledProcessError, similar to the behavior of %%script magics.
+        """
+    ).tag(config=True)
+
     history_length = Integer(10000,
         help='Total length of command history'
     ).tag(config=True)
@@ -1014,6 +1024,18 @@ class InteractiveShell(SingletonConfigurable):
 
     @property
     def banner(self):
+        if (when := os.environ.get("SOURCE_DATE_EPOCH", None)) is not None:
+            from datetime import datetime
+
+            date = datetime.fromtimestamp(int(when))
+            return 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.
+            """
+            ).lstrip()
         banner = self.banner1
         if self.profile and self.profile != 'default':
             banner += '\nIPython profile: %s\n' % self.profile
@@ -2118,8 +2140,7 @@ class InteractiveShell(SingletonConfigurable):
         sys.last_type = etype
         sys.last_value = value
         sys.last_traceback = tb
-        if sys.version_info >= (3, 12):
-            sys.last_exc = value
+        sys.last_exc = value
 
         return etype, value, tb
 
@@ -2647,7 +2668,12 @@ class InteractiveShell(SingletonConfigurable):
         # we explicitly do NOT return the subprocess status code, because
         # a non-None value would trigger :func:`sys.displayhook` calls.
         # Instead, we store the exit_code in user_ns.
-        self.user_ns['_exit_code'] = system(self.var_expand(cmd, depth=1))
+        exit_code = system(self.var_expand(cmd, depth=1))
+        self.user_ns['_exit_code'] = exit_code
+
+        # Raise an exception if the command failed and system_raise_on_error is True
+        if self.system_raise_on_error and exit_code != 0:
+            raise CalledProcessError(exit_code, cmd)
 
     def system_raw(self, cmd):
         """Call the given cmd in a subprocess using os.system on Windows or
@@ -2713,6 +2739,10 @@ class InteractiveShell(SingletonConfigurable):
         # but raising SystemExit(_exit_code) will give status 254!
         self.user_ns['_exit_code'] = ec
 
+        # Raise an exception if the command failed and system_raise_on_error is True
+        if self.system_raise_on_error and ec != 0:
+            raise CalledProcessError(ec, cmd)
+
     # use piped system by default, because it is better behaved
     system = system_piped
 
@@ -2738,11 +2768,27 @@ class InteractiveShell(SingletonConfigurable):
         if cmd.rstrip().endswith('&'):
             # this is *far* from a rigorous test
             raise OSError("Background processes not supported.")
-        out = getoutput(self.var_expand(cmd, depth=depth+1))
+
+        # Get output and exit code
+        expanded_cmd = self.var_expand(cmd, depth=depth+1)
+        if self.system_raise_on_error:
+            # Use get_output_error_code to get the exit code
+            out_str, err_str, exit_code = get_output_error_code(expanded_cmd)
+            # Combine stdout and stderr as getoutput does
+            out_combined = out_str if not err_str else out_str + err_str
+            self.user_ns['_exit_code'] = exit_code
+
+            # Raise an exception if the command failed
+            if exit_code != 0:
+                raise CalledProcessError(exit_code, cmd)
+        else:
+            # Use the original getoutput for backward compatibility
+            out_combined = getoutput(expanded_cmd)
+
         if split:
-            out = SList(out.splitlines())
+            out = SList(out_combined.splitlines())
         else:
-            out = LSString(out)
+            out = LSString(out_combined)
         return out
 
     #-------------------------------------------------------------------------