ipython 9.2.0__tar.gz → 9.3.0__tar.gz

{ipython-9.2.0 → ipython-9.3.0}/IPython/core/completer.py

@@ -203,15 +203,11 @@ from types import SimpleNamespace
 from typing import (
     Iterable,
     Iterator,
-    List,
-    Tuple,
     Union,
     Any,
     Sequence,
-    Dict,
     Optional,
     TYPE_CHECKING,
-    Set,
     Sized,
     TypeVar,
     Literal,
@@ -236,10 +232,12 @@ from traitlets import (
     List as ListTrait,
     Unicode,
     Dict as DictTrait,
+    DottedObjectName,
     Union as UnionTrait,
     observe,
 )
 from traitlets.config.configurable import Configurable
+from traitlets.utils.importstring import import_item
 
 import __main__
 
@@ -987,7 +985,7 @@ class Completer(Configurable):
 
         - ``forbidden``: no evaluation of code is permitted,
         - ``minimal``: evaluation of literals and access to built-in namespace;
-          no item/attribute evaluationm no access to locals/globals,
+          no item/attribute evaluation, no access to locals/globals,
           no evaluation of any operations or comparisons.
         - ``limited``: access to all namespaces, evaluation of hard-coded methods
           (for example: :any:`dict.keys`, :any:`object.__getattr__`,
@@ -995,7 +993,9 @@ class Completer(Configurable):
           :any:`dict`, :any:`list`, :any:`tuple`, ``pandas.Series``),
         - ``unsafe``: evaluation of all methods and function calls but not of
           syntax with side-effects like `del x`,
-        - ``dangerous``: completely arbitrary evaluation.
+        - ``dangerous``: completely arbitrary evaluation; does not support auto-import.
+
+        To override specific elements of the policy, you can use ``policy_overrides`` trait.
         """,
     ).tag(config=True)
 
@@ -1031,6 +1031,35 @@ class Completer(Configurable):
         """,
     ).tag(config=True)
 
+    policy_overrides = DictTrait(
+        default_value={},
+        key_trait=Unicode(),
+        help="""Overrides for policy evaluation.
+
+        For example, to enable auto-import on completion specify:
+
+        .. code-block::
+
+            ipython --Completer.policy_overrides='{"allow_auto_import": True}' --Completer.use_jedi=False
+
+        """,
+    ).tag(config=True)
+
+    auto_import_method = DottedObjectName(
+        default_value="importlib.import_module",
+        allow_none=True,
+        help="""\
+        Provisional:
+              This is a provisional API in IPython 9.3, it may change without warnings.
+
+        A fully qualified path to an auto-import method for use by completer.
+        The function should take a single string and return `ModuleType` and
+        can raise `ImportError` exception if module is not found.
+
+        The default auto-import implementation does not populate the user namespace with the imported module.
+        """,
+    ).tag(config=True)
+
     def __init__(self, namespace=None, global_namespace=None, **kwargs):
         """Create a new completer for the command line.
 
@@ -1134,6 +1163,48 @@ class Completer(Configurable):
     # we simple attribute matching with normal identifiers.
     _ATTR_MATCH_RE = re.compile(r"(.+)\.(\w*)$")
 
+    def _strip_code_before_operator(self, code: str) -> str:
+        o_parens = {"(", "[", "{"}
+        c_parens = {")", "]", "}"}
+
+        # Dry-run tokenize to catch errors
+        try:
+            _ = list(tokenize.generate_tokens(iter(code.splitlines()).__next__))
+        except tokenize.TokenError:
+            # Try trimming the expression and retrying
+            trimmed_code = self._trim_expr(code)
+            try:
+                _ = list(
+                    tokenize.generate_tokens(iter(trimmed_code.splitlines()).__next__)
+                )
+                code = trimmed_code
+            except tokenize.TokenError:
+                return code
+
+        tokens = _parse_tokens(code)
+        encountered_operator = False
+        after_operator = []
+        nesting_level = 0
+
+        for t in tokens:
+            if t.type == tokenize.OP:
+                if t.string in o_parens:
+                    nesting_level += 1
+                elif t.string in c_parens:
+                    nesting_level -= 1
+                elif t.string != "." and nesting_level == 0:
+                    encountered_operator = True
+                    after_operator = []
+                    continue
+
+            if encountered_operator:
+                after_operator.append(t.string)
+
+        if encountered_operator:
+            return "".join(after_operator)
+        else:
+            return code
+
     def _attr_matches(
         self, text: str, include_prefix: bool = True
     ) -> tuple[Sequence[str], str]:
@@ -1141,9 +1212,12 @@ class Completer(Configurable):
         if not m2:
             return [], ""
         expr, attr = m2.group(1, 2)
+        try:
+            expr = self._strip_code_before_operator(expr)
+        except tokenize.TokenError:
+            pass
 
         obj = self._evaluate_expr(expr)
-
         if obj is not_found:
             return [], ""
 
@@ -1234,6 +1308,8 @@ class Completer(Configurable):
                         globals=self.global_namespace,
                         locals=self.namespace,
                         evaluation=self.evaluation,
+                        auto_import=self._auto_import,
+                        policy_overrides=self.policy_overrides,
                     ),
                 )
                 done = True
@@ -1247,6 +1323,14 @@ class Completer(Configurable):
                 expr = self._trim_expr(expr)
         return obj
 
+    @property
+    def _auto_import(self):
+        if self.auto_import_method is None:
+            return None
+        if not hasattr(self, "_auto_import_func"):
+            self._auto_import_func = import_item(self.auto_import_method)
+        return self._auto_import_func
+
 def get__all__entries(obj):
     """returns the strings in the __all__ attribute"""
     try:
@@ -2787,6 +2871,8 @@ class IPCompleter(Completer):
                 locals=self.namespace,
                 evaluation=self.evaluation,  # type: ignore
                 in_subscript=True,
+                auto_import=self._auto_import,
+                policy_overrides=self.policy_overrides,
             ),
         )
 

{ipython-9.2.0 → ipython-9.3.0}/IPython/core/guarded_eval.py

@@ -1,19 +1,15 @@
+from copy import copy
 from inspect import isclass, signature, Signature
-from pygments.formatters.terminal256 import Terminal256Formatter
 from typing import (
     Annotated,
     AnyStr,
     Callable,
-    Dict,
     Literal,
     NamedTuple,
     NewType,
     Optional,
     Protocol,
-    Set,
     Sequence,
-    Tuple,
-    Type,
     TypeGuard,
     Union,
     get_args,
@@ -97,6 +93,7 @@ class EvaluationPolicy:
     allow_builtins_access: bool = False
     allow_all_operations: bool = False
     allow_any_calls: bool = False
+    allow_auto_import: bool = False
     allowed_calls: set[Callable] = field(default_factory=set)
 
     def can_get_item(self, value, item):
@@ -330,6 +327,10 @@ class EvaluationContext(NamedTuple):
     #: Whether the evaluation of code takes place inside of a subscript.
     #: Useful for evaluating ``:-1, 'col'`` in ``df[:-1, 'col']``.
     in_subscript: bool = False
+    #: Auto import method
+    auto_import: Callable[list[str], ModuleType] | None = None
+    #: Overrides for evaluation policy
+    policy_overrides: dict = {}
 
 
 class _IdentitySubscript:
@@ -463,6 +464,17 @@ def _find_dunder(node_op, dunders) -> Union[tuple[str, ...], None]:
     return dunder
 
 
+def get_policy(context: EvaluationContext) -> EvaluationPolicy:
+    policy = copy(EVALUATION_POLICIES[context.evaluation])
+
+    for key, value in context.policy_overrides.items():
+        if hasattr(policy, key):
+            setattr(policy, key, value)
+        else:
+            print(f"Incorrect policy override key: {key}")
+    return policy
+
+
 def eval_node(node: Union[ast.AST, None], context: EvaluationContext):
     """Evaluate AST node in provided context.
 
@@ -490,7 +502,8 @@ def eval_node(node: Union[ast.AST, None], context: EvaluationContext):
     The purpose of this function is to guard against unwanted side-effects;
     it does not give guarantees on protection from malicious code execution.
     """
-    policy = EVALUATION_POLICIES[context.evaluation]
+    policy = get_policy(context)
+
     if node is None:
         return None
     if isinstance(node, ast.Expression):
@@ -711,7 +724,7 @@ def _resolve_annotation(
 
 
 def _eval_node_name(node_id: str, context: EvaluationContext):
-    policy = EVALUATION_POLICIES[context.evaluation]
+    policy = get_policy(context)
     if policy.allow_locals_access and node_id in context.locals:
         return context.locals[node_id]
     if policy.allow_globals_access and node_id in context.globals:
@@ -719,6 +732,8 @@ def _eval_node_name(node_id: str, context: EvaluationContext):
     if policy.allow_builtins_access and hasattr(builtins, node_id):
         # note: do not use __builtins__, it is implementation detail of cPython
         return getattr(builtins, node_id)
+    if policy.allow_auto_import and context.auto_import:
+        return context.auto_import(node_id)
     if not policy.allow_globals_access and not policy.allow_locals_access:
         raise GuardRejection(
             f"Namespace access not allowed in {context.evaluation} mode"
@@ -728,7 +743,7 @@ def _eval_node_name(node_id: str, context: EvaluationContext):
 
 
 def _eval_or_create_duck(duck_type, node: ast.Call, context: EvaluationContext):
-    policy = EVALUATION_POLICIES[context.evaluation]
+    policy = get_policy(context)
     # if allow-listed builtin is on type annotation, instantiate it
     if policy.can_call(duck_type) and not node.keywords:
         args = [eval_node(arg, context) for arg in node.args]

{ipython-9.2.0 → ipython-9.3.0}/IPython/core/interactiveshell.py

@@ -290,7 +290,7 @@ class ExecutionResult:
     """
 
     execution_count: Optional[int] = None
-    error_before_exec: Optional[bool] = None
+    error_before_exec: Optional[BaseException] = None
     error_in_exec: Optional[BaseException] = None
     info = None
     result = None
@@ -314,6 +314,7 @@ class ExecutionResult:
         return '<%s object at %x, execution_count=%s error_before_exec=%s error_in_exec=%s info=%s result=%s>' %\
                 (name, id(self), self.execution_count, self.error_before_exec, self.error_in_exec, repr(self.info), repr(self.result))
 
+
 @functools.wraps(io_open)
 def _modified_open(file, *args, **kwargs):
     if file in {0, 1, 2}:
@@ -331,7 +332,7 @@ class InteractiveShell(SingletonConfigurable):
 
     _instance = None
     _user_ns: dict
-    _sys_modules_keys: set[str, AnyType]
+    _sys_modules_keys: set[str]
 
     inspector: oinspect.Inspector
 
@@ -1572,7 +1573,7 @@ class InteractiveShell(SingletonConfigurable):
             if isinstance(variables, str):
                 vlist = variables.split()
             else:
-                vlist = variables
+                vlist = list(variables)
             vdict = {}
             cf = sys._getframe(1)
             for name in vlist:
@@ -1887,11 +1888,12 @@ class InteractiveShell(SingletonConfigurable):
         with self.builtin_trap:
             info = self._object_find(oname)
             if info.found:
-                docformat = (
-                    sphinxify(self.object_inspect(oname))
-                    if self.sphinxify_docstring
-                    else None
-                )
+                if self.sphinxify_docstring:
+                    if sphinxify is None:
+                        raise ImportError("Module ``docrepr`` required but missing")
+                    docformat = sphinxify(self.object_inspect(oname))
+                else:
+                    docformat = None
                 return self.inspector._get_info(
                     info.obj,
                     oname,
@@ -2196,7 +2198,7 @@ class InteractiveShell(SingletonConfigurable):
         except KeyboardInterrupt:
             print('\n' + self.get_exception_only(), file=sys.stderr)
 
-    def _showtraceback(self, etype, evalue, stb: str):
+    def _showtraceback(self, etype, evalue, stb: list[str]):
         """Actually show a traceback.
 
         Subclasses may override this method to put the traceback on a different
@@ -3599,7 +3601,7 @@ class InteractiveShell(SingletonConfigurable):
                 if mode == "exec":
                     mod = Module([node], [])
                 elif mode == "single":
-                    mod = ast.Interactive([node])  # type: ignore
+                    mod = ast.Interactive([node])
                 with compiler.extra_flags(
                     getattr(ast, "PyCF_ALLOW_TOP_LEVEL_AWAIT", 0x0)
                     if self.autoawait

{ipython-9.2.0 → ipython-9.3.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 = 2
+_version_minor = 3
 _version_patch = 0
 _version_extra = ".dev"
 # _version_extra = "b2"

{ipython-9.2.0 → ipython-9.3.0}/IPython/terminal/interactiveshell.py

@@ -475,7 +475,7 @@ class TerminalInteractiveShell(InteractiveShell):
         allow_none=True,
         help="""\
         Provisional:
-            This is a provisinal API in IPython 8.32, before stabilisation
+            This is a provisional API in IPython 8.32, before stabilisation
             in 9.0, it may change without warnings.
 
         class to use for the `NavigableAutoSuggestFromHistory` to request
@@ -507,13 +507,16 @@ class TerminalInteractiveShell(InteractiveShell):
         elif provider == "NavigableAutoSuggestFromHistory":
             # LLM stuff are all Provisional in 8.32
             if self._llm_provider_class:
-                llm_provider_constructor = import_item(self._llm_provider_class)
-                llm_provider = llm_provider_constructor(**self.llm_constructor_kwargs)
+
+                def init_llm_provider():
+                    llm_provider_constructor = import_item(self._llm_provider_class)
+                    return llm_provider_constructor(**self.llm_constructor_kwargs)
+
             else:
-                llm_provider = None
+                init_llm_provider = None
             self.auto_suggest = NavigableAutoSuggestFromHistory()
             # Provisinal in 8.32
-            self.auto_suggest._llm_provider = llm_provider
+            self.auto_suggest._init_llm_provider = init_llm_provider
 
             name = self.llm_prefix_from_history
 

{ipython-9.2.0 → ipython-9.3.0}/IPython/terminal/shortcuts/auto_suggest.py

@@ -171,16 +171,19 @@ class NavigableAutoSuggestFromHistory(AutoSuggestFromHistory):
     # another request.
     _llm_task: asyncio.Task | None = None
 
-    # This is the instance of the LLM provider from jupyter-ai to which we forward the request
-    # to generate inline completions.
-    _llm_provider: Any | None
+    # This is the constructor of the LLM provider from jupyter-ai
+    # to which we forward the request to generate inline completions.
+    _init_llm_provider: Callable | None
+
+    _llm_provider_instance: Any | None
     _llm_prefixer: Callable = lambda self, x: "wrong"
 
     def __init__(self):
         super().__init__()
         self.skip_lines = 0
         self._connected_apps = []
-        self._llm_provider = None
+        self._llm_provider_instance = None
+        self._init_llm_provider = None
         self._request_number = 0
 
     def reset_history_position(self, _: Buffer) -> None:
@@ -317,6 +320,16 @@ class NavigableAutoSuggestFromHistory(AutoSuggestFromHistory):
                     "LLM task not cancelled, does your provider support cancellation?"
                 )
 
+    @property
+    def _llm_provider(self):
+        """Lazy-initialized instance of the LLM provider.
+
+        Do not use in the constructor, as `_init_llm_provider` can trigger slow side-effects.
+        """
+        if self._llm_provider_instance is None and self._init_llm_provider:
+            self._llm_provider_instance = self._init_llm_provider()
+        return self._llm_provider_instance
+
     async def _trigger_llm(self, buffer) -> None:
         """
         This will ask the current llm provider a suggestion for the current buffer.
@@ -325,14 +338,14 @@ class NavigableAutoSuggestFromHistory(AutoSuggestFromHistory):
         """
         # we likely want to store the current cursor position, and cancel if the cursor has moved.
         try:
-            import jupyter_ai.completions.models as jai_models
+            import jupyter_ai_magics
         except ModuleNotFoundError:
-            jai_models = None
+            jupyter_ai_magics = None
         if not self._llm_provider:
             warnings.warn("No LLM provider found, cannot trigger LLM completions")
             return
-        if jai_models is None:
-            warnings.warn("LLM Completion requires `jupyter_ai` to be installed")
+        if jupyter_ai_magics is None:
+            warnings.warn("LLM Completion requires `jupyter_ai_magics` to be installed")
 
         self._cancel_running_llm_task()
 
@@ -359,7 +372,7 @@ class NavigableAutoSuggestFromHistory(AutoSuggestFromHistory):
         provider to stream it's response back to us iteratively setting it as
         the suggestion on the current buffer.
 
-        Unlike with JupyterAi, as we do not have multiple cell, the cell id
+        Unlike with JupyterAi, as we do not have multiple cells, the cell id
         is always set to `None`.
 
         We set the prefix to the current cell content, but could also insert the

{ipython-9.2.0 → ipython-9.3.0}/IPython/utils/_sysinfo.py

@@ -1,2 +1,2 @@
 # GENERATED BY setup.py
-commit = "40eaac2d4"
+commit = "e87cb2a40"

{ipython-9.2.0/ipython.egg-info → ipython-9.3.0}/PKG-INFO

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

{ipython-9.2.0 → ipython-9.3.0}/docs/source/api/generated/IPython.core.guarded_eval.rst

@@ -21,11 +21,14 @@ Module: :mod:`core.guarded_eval`
   :members:
   :show-inheritance:
 
-2 Functions
+3 Functions
 -----------
 
 .. autofunction:: IPython.core.guarded_eval.guarded_eval
 
 
+.. autofunction:: IPython.core.guarded_eval.get_policy
+
+
 .. autofunction:: IPython.core.guarded_eval.eval_node
 

{ipython-9.2.0 → ipython-9.3.0}/docs/source/config/options/terminal.rst

@@ -1174,7 +1174,7 @@
 .. configtrait:: TerminalInteractiveShell.llm_provider_class
 
     Provisional:
-        This is a provisinal API in IPython 8.32, before stabilisation
+        This is a provisional API in IPython 8.32, before stabilisation
         in 9.0, it may change without warnings.
 
     class to use for the `NavigableAutoSuggestFromHistory` to request
@@ -1734,6 +1734,20 @@
     :trait type: Bool
     :default: ``False``
 
+.. configtrait:: Completer.auto_import_method
+
+    Provisional:
+          This is a provisional API in IPython 9.3, it may change without warnings.
+
+    A fully qualified path to an auto-import method for use by completer.
+    The function should take a single string and return `ModuleType` and
+    can raise `ImportError` exception if module is not found.
+
+    The default auto-import implementation does not populate the user namespace with the imported module.
+
+    :trait type: DottedObjectName
+    :default: ``'importlib.import_module'``
+
 .. configtrait:: Completer.backslash_combining_completions
 
     Enable unicode completions, e.g. \alpha<tab> . Includes completion of latex commands, unicode names, and expanding unicode characters back to latex commands.
@@ -1762,7 +1776,7 @@
 
     - ``forbidden``: no evaluation of code is permitted,
     - ``minimal``: evaluation of literals and access to built-in namespace;
-      no item/attribute evaluationm no access to locals/globals,
+      no item/attribute evaluation, no access to locals/globals,
       no evaluation of any operations or comparisons.
     - ``limited``: access to all namespaces, evaluation of hard-coded methods
       (for example: :any:`dict.keys`, :any:`object.__getattr__`,
@@ -1770,7 +1784,9 @@
       :any:`dict`, :any:`list`, :any:`tuple`, ``pandas.Series``),
     - ``unsafe``: evaluation of all methods and function calls but not of
       syntax with side-effects like `del x`,
-    - ``dangerous``: completely arbitrary evaluation.
+    - ``dangerous``: completely arbitrary evaluation; does not support auto-import.
+
+    To override specific elements of the policy, you can use ``policy_overrides`` trait.
 
     :options: ``'forbidden'``, ``'minimal'``, ``'limited'``, ``'unsafe'``, ``'dangerous'``
     :default: ``'limited'``
@@ -1799,6 +1815,18 @@
     :trait type: Int
     :default: ``400``
 
+.. configtrait:: Completer.policy_overrides
+
+    Overrides for policy evaluation.
+
+    For example, to enable auto-import on completion specify:
+
+    .. code-block::
+
+        ipython --Completer.policy_overrides='{"allow_auto_import": True}' --Completer.use_jedi=False
+
+    :trait type: Dict
+
 .. configtrait:: Completer.use_jedi
 
     Experimental: Use Jedi to generate autocompletions. Default to True if jedi is installed.
@@ -1818,6 +1846,20 @@
     :trait type: Bool
     :default: ``False``
 
+.. configtrait:: IPCompleter.auto_import_method
+
+    Provisional:
+          This is a provisional API in IPython 9.3, it may change without warnings.
+
+    A fully qualified path to an auto-import method for use by completer.
+    The function should take a single string and return `ModuleType` and
+    can raise `ImportError` exception if module is not found.
+
+    The default auto-import implementation does not populate the user namespace with the imported module.
+
+    :trait type: DottedObjectName
+    :default: ``'importlib.import_module'``
+
 .. configtrait:: IPCompleter.backslash_combining_completions
 
     Enable unicode completions, e.g. \alpha<tab> . Includes completion of latex commands, unicode names, and expanding unicode characters back to latex commands.
@@ -1854,7 +1896,7 @@
 
     - ``forbidden``: no evaluation of code is permitted,
     - ``minimal``: evaluation of literals and access to built-in namespace;
-      no item/attribute evaluationm no access to locals/globals,
+      no item/attribute evaluation, no access to locals/globals,
       no evaluation of any operations or comparisons.
     - ``limited``: access to all namespaces, evaluation of hard-coded methods
       (for example: :any:`dict.keys`, :any:`object.__getattr__`,
@@ -1862,7 +1904,9 @@
       :any:`dict`, :any:`list`, :any:`tuple`, ``pandas.Series``),
     - ``unsafe``: evaluation of all methods and function calls but not of
       syntax with side-effects like `del x`,
-    - ``dangerous``: completely arbitrary evaluation.
+    - ``dangerous``: completely arbitrary evaluation; does not support auto-import.
+
+    To override specific elements of the policy, you can use ``policy_overrides`` trait.
 
     :options: ``'forbidden'``, ``'minimal'``, ``'limited'``, ``'unsafe'``, ``'dangerous'``
     :default: ``'limited'``
@@ -1934,6 +1978,18 @@
     :options: ``0``, ``1``, ``2``
     :default: ``2``
 
+.. configtrait:: IPCompleter.policy_overrides
+
+    Overrides for policy evaluation.
+
+    For example, to enable auto-import on completion specify:
+
+    .. code-block::
+
+        ipython --Completer.policy_overrides='{"allow_auto_import": True}' --Completer.use_jedi=False
+
+    :trait type: Dict
+
 .. configtrait:: IPCompleter.profile_completions
 
     If True, emit profiling data for completion subsystem using cProfile.

{ipython-9.2.0 → ipython-9.3.0}/docs/source/interactive/magics-generated.txt

@@ -694,12 +694,9 @@ Line magics
       -n                  print line numbers for each input. This feature is only available if numbered prompts are in use.
       -o                  also print outputs for each input.
       -p                  print classic '>>>' python prompts before each input. This is useful for making documentation, and in conjunction with -o, for producing doctest-ready output.
-      -t                  print the 'translated' history, as IPython understands it. IPython filters your input and converts it all into valid Python source before executing it (things like magics or aliases are turned into function calls, for example).
-                          With this option, you'll see the native history instead of the user-entered version: '%cd /' will be seen as 'get_ipython().run_line_magic("cd", "/")' instead of '%cd /'.
-      -f FILENAME         FILENAME: instead of printing the output to the screen, redirect it to the given file. The file is always overwritten, though *when it can*, IPython asks for confirmation first. In particular, running the command 'history -f
-                          FILENAME' from the IPython Notebook interface will replace FILENAME even if it already exists *without* confirmation.
-      -g <[PATTERN ...]>  treat the arg as a glob pattern to search for in (full) history. This includes the saved history (almost all commands ever written). The pattern may contain '?' to match one unknown character and '*' to match any number of unknown
-                          characters. Use '%hist -g' to show full saved history (may be very long).
+      -t                  print the 'translated' history, as IPython understands it. IPython filters your input and converts it all into valid Python source before executing it (things like magics or aliases are turned into function calls, for example). With this option, you'll see the native history instead of the user-entered version: '%cd /' will be seen as 'get_ipython().run_line_magic("cd", "/")' instead of '%cd /'.
+      -f FILENAME         FILENAME: instead of printing the output to the screen, redirect it to the given file. The file is always overwritten, though *when it can*, IPython asks for confirmation first. In particular, running the command 'history -f FILENAME' from the IPython Notebook interface will replace FILENAME even if it already exists *without* confirmation.
+      -g <[PATTERN ...]>  treat the arg as a glob pattern to search for in (full) history. This includes the saved history (almost all commands ever written). The pattern may contain '?' to match one unknown character and '*' to match any number of unknown characters. Use '%hist -g' to show full saved history (may be very long).
       -l <[LIMIT]>        get the last n lines from all sessions. Specify n as a single arg, or the default is the last 10 lines.
       -u                  when searching history using `-g`, show only unique history.
 
@@ -2328,8 +2325,7 @@ Cell magics
     run the cell, capturing stdout, stderr, and IPython's rich display() calls.
     
     positional arguments:
-      output        The name of the variable in which to store output. This is a ``utils.io.CapturedIO`` object with stdout/err attributes for the text of the captured output. CapturedOutput also has a ``show()`` method for displaying the output, and
-                    ``__call__`` as well, so you can use that to quickly display the output. If unspecified, captured output is discarded.
+      output        The name of the variable in which to store output. This is a ``utils.io.CapturedIO`` object with stdout/err attributes for the text of the captured output. CapturedOutput also has a ``show()`` method for displaying the output, and ``__call__`` as well, so you can use that to quickly display the output. If unspecified, captured output is discarded.
     
     options:
       --no-stderr   Don't capture stderr.

{ipython-9.2.0 → ipython-9.3.0}/docs/source/whatsnew/version8.rst

@@ -2,6 +2,16 @@
  8.x Series
 ============
 
+.. _version 8.37:
+
+IPython 8.37
+============
+
+This release includes fixes for the tab completer and LLM completer backported from IPython 9.4:
+
+- :ghpull:`14910` Eliminate startup delay when LLM completion provider is configured
+- :ghpull:`14898` Fix attribute completion for expressions with comparison operators
+
 .. _version 8.36:
 
 IPython 8.36