|
|
"""IPython terminal interface using prompt_toolkit"""
|
|
|
|
|
|
import os
|
|
|
import sys
|
|
|
import inspect
|
|
|
from warnings import warn
|
|
|
from typing import Union as UnionType, Optional
|
|
|
|
|
|
from IPython.core.async_helpers import get_asyncio_loop
|
|
|
from IPython.core.interactiveshell import InteractiveShell, InteractiveShellABC
|
|
|
from IPython.utils.py3compat import input
|
|
|
from IPython.utils.PyColorize import theme_table
|
|
|
from IPython.utils.terminal import toggle_set_term_title, set_term_title, restore_term_title
|
|
|
from IPython.utils.process import abbrev_cwd
|
|
|
from traitlets import (
|
|
|
Any,
|
|
|
Bool,
|
|
|
Dict,
|
|
|
Enum,
|
|
|
Float,
|
|
|
Instance,
|
|
|
Integer,
|
|
|
List,
|
|
|
Type,
|
|
|
Unicode,
|
|
|
Union,
|
|
|
default,
|
|
|
observe,
|
|
|
validate,
|
|
|
DottedObjectName,
|
|
|
)
|
|
|
from traitlets.utils.importstring import import_item
|
|
|
|
|
|
|
|
|
from prompt_toolkit.auto_suggest import AutoSuggestFromHistory
|
|
|
from prompt_toolkit.enums import DEFAULT_BUFFER, EditingMode
|
|
|
from prompt_toolkit.filters import HasFocus, Condition, IsDone
|
|
|
from prompt_toolkit.formatted_text import PygmentsTokens
|
|
|
from prompt_toolkit.history import History
|
|
|
from prompt_toolkit.layout.processors import ConditionalProcessor, HighlightMatchingBracketProcessor
|
|
|
from prompt_toolkit.output import ColorDepth
|
|
|
from prompt_toolkit.patch_stdout import patch_stdout
|
|
|
from prompt_toolkit.shortcuts import PromptSession, CompleteStyle, print_formatted_text
|
|
|
from prompt_toolkit.styles import DynamicStyle, merge_styles
|
|
|
from prompt_toolkit.styles.pygments import style_from_pygments_cls, style_from_pygments_dict
|
|
|
from pygments.styles import get_style_by_name
|
|
|
from pygments.style import Style
|
|
|
|
|
|
from .debugger import TerminalPdb, Pdb
|
|
|
from .magics import TerminalMagics
|
|
|
from .pt_inputhooks import get_inputhook_name_and_func
|
|
|
from .prompts import Prompts, ClassicPrompts, RichPromptDisplayHook
|
|
|
from .ptutils import IPythonPTCompleter, IPythonPTLexer
|
|
|
from .shortcuts import (
|
|
|
KEY_BINDINGS,
|
|
|
UNASSIGNED_ALLOWED_COMMANDS,
|
|
|
create_ipython_shortcuts,
|
|
|
create_identifier,
|
|
|
RuntimeBinding,
|
|
|
add_binding,
|
|
|
)
|
|
|
from .shortcuts.filters import KEYBINDING_FILTERS, filter_from_string
|
|
|
from .shortcuts.auto_suggest import (
|
|
|
NavigableAutoSuggestFromHistory,
|
|
|
AppendAutoSuggestionInAnyLine,
|
|
|
)
|
|
|
|
|
|
|
|
|
class _NoStyle(Style):
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
def _backward_compat_continuation_prompt_tokens(
|
|
|
method, width: int, *, lineno: int, wrap_count: int
|
|
|
):
|
|
|
"""
|
|
|
Sagemath use custom prompt and we broke them in 8.19.
|
|
|
|
|
|
make sure to pass only width if method only support width
|
|
|
"""
|
|
|
sig = inspect.signature(method)
|
|
|
extra = {}
|
|
|
params = inspect.signature(method).parameters
|
|
|
if "lineno" in inspect.signature(method).parameters or any(
|
|
|
[p.kind == p.VAR_KEYWORD for p in sig.parameters.values()]
|
|
|
):
|
|
|
extra["lineno"] = lineno
|
|
|
if "line_number" in inspect.signature(method).parameters or any(
|
|
|
[p.kind == p.VAR_KEYWORD for p in sig.parameters.values()]
|
|
|
):
|
|
|
extra["line_number"] = lineno
|
|
|
|
|
|
if "wrap_count" in inspect.signature(method).parameters or any(
|
|
|
[p.kind == p.VAR_KEYWORD for p in sig.parameters.values()]
|
|
|
):
|
|
|
extra["wrap_count"] = wrap_count
|
|
|
return method(width, **extra)
|
|
|
|
|
|
|
|
|
def get_default_editor():
|
|
|
try:
|
|
|
return os.environ['EDITOR']
|
|
|
except KeyError:
|
|
|
pass
|
|
|
except UnicodeError:
|
|
|
warn("$EDITOR environment variable is not pure ASCII. Using platform "
|
|
|
"default editor.")
|
|
|
|
|
|
if os.name == 'posix':
|
|
|
return 'vi' # the only one guaranteed to be there!
|
|
|
else:
|
|
|
return "notepad" # same in Windows!
|
|
|
|
|
|
|
|
|
# conservatively check for tty
|
|
|
# overridden streams can result in things like:
|
|
|
# - sys.stdin = None
|
|
|
# - no isatty method
|
|
|
for _name in ('stdin', 'stdout', 'stderr'):
|
|
|
_stream = getattr(sys, _name)
|
|
|
try:
|
|
|
if not _stream or not hasattr(_stream, "isatty") or not _stream.isatty():
|
|
|
_is_tty = False
|
|
|
break
|
|
|
except ValueError:
|
|
|
# stream is closed
|
|
|
_is_tty = False
|
|
|
break
|
|
|
else:
|
|
|
_is_tty = True
|
|
|
|
|
|
|
|
|
_use_simple_prompt = ('IPY_TEST_SIMPLE_PROMPT' in os.environ) or (not _is_tty)
|
|
|
|
|
|
def black_reformat_handler(text_before_cursor):
|
|
|
"""
|
|
|
We do not need to protect against error,
|
|
|
this is taken care at a higher level where any reformat error is ignored.
|
|
|
Indeed we may call reformatting on incomplete code.
|
|
|
"""
|
|
|
import black
|
|
|
|
|
|
formatted_text = black.format_str(text_before_cursor, mode=black.FileMode())
|
|
|
if not text_before_cursor.endswith("\n") and formatted_text.endswith("\n"):
|
|
|
formatted_text = formatted_text[:-1]
|
|
|
return formatted_text
|
|
|
|
|
|
|
|
|
def yapf_reformat_handler(text_before_cursor):
|
|
|
from yapf.yapflib import file_resources
|
|
|
from yapf.yapflib import yapf_api
|
|
|
|
|
|
style_config = file_resources.GetDefaultStyleForDir(os.getcwd())
|
|
|
formatted_text, was_formatted = yapf_api.FormatCode(
|
|
|
text_before_cursor, style_config=style_config
|
|
|
)
|
|
|
if was_formatted:
|
|
|
if not text_before_cursor.endswith("\n") and formatted_text.endswith("\n"):
|
|
|
formatted_text = formatted_text[:-1]
|
|
|
return formatted_text
|
|
|
else:
|
|
|
return text_before_cursor
|
|
|
|
|
|
|
|
|
class PtkHistoryAdapter(History):
|
|
|
"""
|
|
|
Prompt toolkit has it's own way of handling history, Where it assumes it can
|
|
|
Push/pull from history.
|
|
|
|
|
|
"""
|
|
|
|
|
|
def __init__(self, shell):
|
|
|
super().__init__()
|
|
|
self.shell = shell
|
|
|
self._refresh()
|
|
|
|
|
|
def append_string(self, string):
|
|
|
# we rely on sql for that.
|
|
|
self._loaded = False
|
|
|
self._refresh()
|
|
|
|
|
|
def _refresh(self):
|
|
|
if not self._loaded:
|
|
|
self._loaded_strings = list(self.load_history_strings())
|
|
|
|
|
|
def load_history_strings(self):
|
|
|
last_cell = ""
|
|
|
res = []
|
|
|
for __, ___, cell in self.shell.history_manager.get_tail(
|
|
|
self.shell.history_load_length, include_latest=True
|
|
|
):
|
|
|
# Ignore blank lines and consecutive duplicates
|
|
|
cell = cell.rstrip()
|
|
|
if cell and (cell != last_cell):
|
|
|
res.append(cell)
|
|
|
last_cell = cell
|
|
|
yield from res[::-1]
|
|
|
|
|
|
def store_string(self, string: str) -> None:
|
|
|
pass
|
|
|
|
|
|
class TerminalInteractiveShell(InteractiveShell):
|
|
|
mime_renderers = Dict().tag(config=True)
|
|
|
|
|
|
min_elide = Integer(
|
|
|
30, help="minimum characters for filling with ellipsis in file completions"
|
|
|
).tag(config=True)
|
|
|
space_for_menu = Integer(
|
|
|
6,
|
|
|
help="Number of line at the bottom of the screen "
|
|
|
"to reserve for the tab completion menu, "
|
|
|
"search history, ...etc, the height of "
|
|
|
"these menus will at most this value. "
|
|
|
"Increase it is you prefer long and skinny "
|
|
|
"menus, decrease for short and wide.",
|
|
|
).tag(config=True)
|
|
|
|
|
|
pt_app: UnionType[PromptSession, None] = None
|
|
|
auto_suggest: UnionType[
|
|
|
AutoSuggestFromHistory,
|
|
|
NavigableAutoSuggestFromHistory,
|
|
|
None,
|
|
|
] = None
|
|
|
debugger_history = None
|
|
|
|
|
|
debugger_history_file = Unicode(
|
|
|
"~/.pdbhistory", help="File in which to store and read history"
|
|
|
).tag(config=True)
|
|
|
|
|
|
simple_prompt = Bool(_use_simple_prompt,
|
|
|
help="""Use `raw_input` for the REPL, without completion and prompt colors.
|
|
|
|
|
|
Useful when controlling IPython as a subprocess, and piping
|
|
|
STDIN/OUT/ERR. Known usage are: IPython's own testing machinery,
|
|
|
and emacs' inferior-python subprocess (assuming you have set
|
|
|
`python-shell-interpreter` to "ipython") available through the
|
|
|
built-in `M-x run-python` and third party packages such as elpy.
|
|
|
|
|
|
This mode default to `True` if the `IPY_TEST_SIMPLE_PROMPT`
|
|
|
environment variable is set, or the current terminal is not a tty.
|
|
|
Thus the Default value reported in --help-all, or config will often
|
|
|
be incorrectly reported.
|
|
|
""",
|
|
|
).tag(config=True)
|
|
|
|
|
|
@property
|
|
|
def debugger_cls(self):
|
|
|
return Pdb if self.simple_prompt else TerminalPdb
|
|
|
|
|
|
confirm_exit = Bool(True,
|
|
|
help="""
|
|
|
Set to confirm when you try to exit IPython with an EOF (Control-D
|
|
|
in Unix, Control-Z/Enter in Windows). By typing 'exit' or 'quit',
|
|
|
you can force a direct exit without any confirmation.""",
|
|
|
).tag(config=True)
|
|
|
|
|
|
editing_mode = Unicode('emacs',
|
|
|
help="Shortcut style to use at the prompt. 'vi' or 'emacs'.",
|
|
|
).tag(config=True)
|
|
|
|
|
|
emacs_bindings_in_vi_insert_mode = Bool(
|
|
|
True,
|
|
|
help="Add shortcuts from 'emacs' insert mode to 'vi' insert mode.",
|
|
|
).tag(config=True)
|
|
|
|
|
|
modal_cursor = Bool(
|
|
|
True,
|
|
|
help="""
|
|
|
Cursor shape changes depending on vi mode: beam in vi insert mode,
|
|
|
block in nav mode, underscore in replace mode.""",
|
|
|
).tag(config=True)
|
|
|
|
|
|
ttimeoutlen = Float(
|
|
|
0.01,
|
|
|
help="""The time in milliseconds that is waited for a key code
|
|
|
to complete.""",
|
|
|
).tag(config=True)
|
|
|
|
|
|
timeoutlen = Float(
|
|
|
0.5,
|
|
|
help="""The time in milliseconds that is waited for a mapped key
|
|
|
sequence to complete.""",
|
|
|
).tag(config=True)
|
|
|
|
|
|
autoformatter = Unicode(
|
|
|
None,
|
|
|
help="Autoformatter to reformat Terminal code. Can be `'black'`, `'yapf'` or `None`",
|
|
|
allow_none=True
|
|
|
).tag(config=True)
|
|
|
|
|
|
auto_match = Bool(
|
|
|
False,
|
|
|
help="""
|
|
|
Automatically add/delete closing bracket or quote when opening bracket or quote is entered/deleted.
|
|
|
Brackets: (), [], {}
|
|
|
Quotes: '', \"\"
|
|
|
""",
|
|
|
).tag(config=True)
|
|
|
|
|
|
mouse_support = Bool(False,
|
|
|
help="Enable mouse support in the prompt\n(Note: prevents selecting text with the mouse)"
|
|
|
).tag(config=True)
|
|
|
|
|
|
# We don't load the list of styles for the help string, because loading
|
|
|
# Pygments plugins takes time and can cause unexpected errors.
|
|
|
highlighting_style = Union(
|
|
|
[Unicode("legacy"), Type(klass=Style)],
|
|
|
help="""Deprecated, and has not effect, use IPython themes
|
|
|
|
|
|
The name or class of a Pygments style to use for syntax
|
|
|
highlighting. To see available styles, run `pygmentize -L styles`.""",
|
|
|
).tag(config=True)
|
|
|
|
|
|
@validate('editing_mode')
|
|
|
def _validate_editing_mode(self, proposal):
|
|
|
if proposal['value'].lower() == 'vim':
|
|
|
proposal['value']= 'vi'
|
|
|
elif proposal['value'].lower() == 'default':
|
|
|
proposal['value']= 'emacs'
|
|
|
|
|
|
if hasattr(EditingMode, proposal['value'].upper()):
|
|
|
return proposal['value'].lower()
|
|
|
|
|
|
return self.editing_mode
|
|
|
|
|
|
@observe('editing_mode')
|
|
|
def _editing_mode(self, change):
|
|
|
if self.pt_app:
|
|
|
self.pt_app.editing_mode = getattr(EditingMode, change.new.upper())
|
|
|
|
|
|
def _set_formatter(self, formatter):
|
|
|
if formatter is None:
|
|
|
self.reformat_handler = lambda x:x
|
|
|
elif formatter == 'black':
|
|
|
self.reformat_handler = black_reformat_handler
|
|
|
elif formatter == "yapf":
|
|
|
self.reformat_handler = yapf_reformat_handler
|
|
|
else:
|
|
|
raise ValueError
|
|
|
|
|
|
@observe("autoformatter")
|
|
|
def _autoformatter_changed(self, change):
|
|
|
formatter = change.new
|
|
|
self._set_formatter(formatter)
|
|
|
|
|
|
@observe('highlighting_style')
|
|
|
@observe('colors')
|
|
|
def _highlighting_style_changed(self, change):
|
|
|
assert change.new == change.new.lower()
|
|
|
if change.new != "legacy":
|
|
|
warn(
|
|
|
"highlighting_style is deprecated since 9.0 and have no effect, use themeing."
|
|
|
)
|
|
|
return
|
|
|
|
|
|
def refresh_style(self):
|
|
|
self._style = self._make_style_from_name_or_cls("legacy")
|
|
|
|
|
|
# TODO: deprecate this
|
|
|
highlighting_style_overrides = Dict(
|
|
|
help="Override highlighting format for specific tokens"
|
|
|
).tag(config=True)
|
|
|
|
|
|
true_color = Bool(False,
|
|
|
help="""Use 24bit colors instead of 256 colors in prompt highlighting.
|
|
|
If your terminal supports true color, the following command should
|
|
|
print ``TRUECOLOR`` in orange::
|
|
|
|
|
|
printf \"\\x1b[38;2;255;100;0mTRUECOLOR\\x1b[0m\\n\"
|
|
|
""",
|
|
|
).tag(config=True)
|
|
|
|
|
|
editor = Unicode(get_default_editor(),
|
|
|
help="Set the editor used by IPython (default to $EDITOR/vi/notepad)."
|
|
|
).tag(config=True)
|
|
|
|
|
|
prompts_class = Type(Prompts, help='Class used to generate Prompt token for prompt_toolkit').tag(config=True)
|
|
|
|
|
|
prompts = Instance(Prompts)
|
|
|
|
|
|
@default('prompts')
|
|
|
def _prompts_default(self):
|
|
|
return self.prompts_class(self)
|
|
|
|
|
|
# @observe('prompts')
|
|
|
# def _(self, change):
|
|
|
# self._update_layout()
|
|
|
|
|
|
@default('displayhook_class')
|
|
|
def _displayhook_class_default(self):
|
|
|
return RichPromptDisplayHook
|
|
|
|
|
|
term_title = Bool(True,
|
|
|
help="Automatically set the terminal title"
|
|
|
).tag(config=True)
|
|
|
|
|
|
term_title_format = Unicode("IPython: {cwd}",
|
|
|
help="Customize the terminal title format. This is a python format string. " +
|
|
|
"Available substitutions are: {cwd}."
|
|
|
).tag(config=True)
|
|
|
|
|
|
display_completions = Enum(('column', 'multicolumn','readlinelike'),
|
|
|
help= ( "Options for displaying tab completions, 'column', 'multicolumn', and "
|
|
|
"'readlinelike'. These options are for `prompt_toolkit`, see "
|
|
|
"`prompt_toolkit` documentation for more information."
|
|
|
),
|
|
|
default_value='multicolumn').tag(config=True)
|
|
|
|
|
|
highlight_matching_brackets = Bool(True,
|
|
|
help="Highlight matching brackets.",
|
|
|
).tag(config=True)
|
|
|
|
|
|
extra_open_editor_shortcuts = Bool(False,
|
|
|
help="Enable vi (v) or Emacs (C-X C-E) shortcuts to open an external editor. "
|
|
|
"This is in addition to the F2 binding, which is always enabled."
|
|
|
).tag(config=True)
|
|
|
|
|
|
handle_return = Any(None,
|
|
|
help="Provide an alternative handler to be called when the user presses "
|
|
|
"Return. This is an advanced option intended for debugging, which "
|
|
|
"may be changed or removed in later releases."
|
|
|
).tag(config=True)
|
|
|
|
|
|
enable_history_search = Bool(True,
|
|
|
help="Allows to enable/disable the prompt toolkit history search"
|
|
|
).tag(config=True)
|
|
|
|
|
|
autosuggestions_provider = Unicode(
|
|
|
"NavigableAutoSuggestFromHistory",
|
|
|
help="Specifies from which source automatic suggestions are provided. "
|
|
|
"Can be set to ``'NavigableAutoSuggestFromHistory'`` (:kbd:`up` and "
|
|
|
":kbd:`down` swap suggestions), ``'AutoSuggestFromHistory'``, "
|
|
|
" or ``None`` to disable automatic suggestions. "
|
|
|
"Default is `'NavigableAutoSuggestFromHistory`'.",
|
|
|
allow_none=True,
|
|
|
).tag(config=True)
|
|
|
_autosuggestions_provider: Any
|
|
|
|
|
|
llm_constructor_kwargs = Dict(
|
|
|
{},
|
|
|
help="""
|
|
|
Extra arguments to pass to `llm_provider_class` constructor.
|
|
|
|
|
|
This is used to – for example – set the `model_id`""",
|
|
|
).tag(config=True)
|
|
|
|
|
|
llm_prefix_from_history = DottedObjectName(
|
|
|
"input_history",
|
|
|
help="""\
|
|
|
Fully Qualifed name of a function that takes an IPython history manager and
|
|
|
return a prefix to pass the llm provider in addition to the current buffer
|
|
|
text.
|
|
|
|
|
|
You can use:
|
|
|
|
|
|
- no_prefix
|
|
|
- input_history
|
|
|
|
|
|
As default value. `input_history` (default), will use all the input history
|
|
|
of current IPython session
|
|
|
|
|
|
""",
|
|
|
).tag(config=True)
|
|
|
_llm_prefix_from_history: Any
|
|
|
|
|
|
@observe("llm_prefix_from_history")
|
|
|
def _llm_prefix_from_history_changed(self, change):
|
|
|
name = change.new
|
|
|
self._llm_prefix_from_history = name
|
|
|
self._set_autosuggestions()
|
|
|
|
|
|
llm_provider_class = DottedObjectName(
|
|
|
None,
|
|
|
allow_none=True,
|
|
|
help="""\
|
|
|
Provisional:
|
|
|
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
|
|
|
completions from a LLM, this should inherit from
|
|
|
`jupyter_ai_magics:BaseProvider` and implement
|
|
|
`stream_inline_completions`
|
|
|
""",
|
|
|
).tag(config=True)
|
|
|
_llm_provider_class: Any = None
|
|
|
|
|
|
@observe("llm_provider_class")
|
|
|
def _llm_provider_class_changed(self, change):
|
|
|
provider_class = change.new
|
|
|
self._llm_provider_class = provider_class
|
|
|
self._set_autosuggestions()
|
|
|
|
|
|
def _set_autosuggestions(self, provider=None):
|
|
|
if provider is None:
|
|
|
provider = self.autosuggestions_provider
|
|
|
# disconnect old handler
|
|
|
if self.auto_suggest and isinstance(
|
|
|
self.auto_suggest, NavigableAutoSuggestFromHistory
|
|
|
):
|
|
|
self.auto_suggest.disconnect()
|
|
|
if provider is None:
|
|
|
self.auto_suggest = None
|
|
|
elif provider == "AutoSuggestFromHistory":
|
|
|
self.auto_suggest = AutoSuggestFromHistory()
|
|
|
elif provider == "NavigableAutoSuggestFromHistory":
|
|
|
# LLM stuff are all Provisional in 8.32
|
|
|
if self._llm_provider_class:
|
|
|
|
|
|
def init_llm_provider():
|
|
|
llm_provider_constructor = import_item(self._llm_provider_class)
|
|
|
return llm_provider_constructor(**self.llm_constructor_kwargs)
|
|
|
|
|
|
else:
|
|
|
init_llm_provider = None
|
|
|
self.auto_suggest = NavigableAutoSuggestFromHistory()
|
|
|
# Provisinal in 8.32
|
|
|
self.auto_suggest._init_llm_provider = init_llm_provider
|
|
|
|
|
|
name = self.llm_prefix_from_history
|
|
|
|
|
|
if name == "no_prefix":
|
|
|
|
|
|
def no_prefix(history_manager):
|
|
|
return ""
|
|
|
|
|
|
fun = no_prefix
|
|
|
|
|
|
elif name == "input_history":
|
|
|
|
|
|
def input_history(history_manager):
|
|
|
return "\n".join([s[2] for s in history_manager.get_range()]) + "\n"
|
|
|
|
|
|
fun = input_history
|
|
|
|
|
|
else:
|
|
|
fun = import_item(name)
|
|
|
self.auto_suggest._llm_prefixer = fun
|
|
|
else:
|
|
|
raise ValueError("No valid provider.")
|
|
|
if self.pt_app:
|
|
|
self.pt_app.auto_suggest = self.auto_suggest
|
|
|
|
|
|
@observe("autosuggestions_provider")
|
|
|
def _autosuggestions_provider_changed(self, change):
|
|
|
provider = change.new
|
|
|
self._set_autosuggestions(provider)
|
|
|
|
|
|
shortcuts = List(
|
|
|
trait=Dict(
|
|
|
key_trait=Enum(
|
|
|
[
|
|
|
"command",
|
|
|
"match_keys",
|
|
|
"match_filter",
|
|
|
"new_keys",
|
|
|
"new_filter",
|
|
|
"create",
|
|
|
]
|
|
|
),
|
|
|
per_key_traits={
|
|
|
"command": Unicode(),
|
|
|
"match_keys": List(Unicode()),
|
|
|
"match_filter": Unicode(),
|
|
|
"new_keys": List(Unicode()),
|
|
|
"new_filter": Unicode(),
|
|
|
"create": Bool(False),
|
|
|
},
|
|
|
),
|
|
|
help="""
|
|
|
Add, disable or modifying shortcuts.
|
|
|
|
|
|
Each entry on the list should be a dictionary with ``command`` key
|
|
|
identifying the target function executed by the shortcut and at least
|
|
|
one of the following:
|
|
|
|
|
|
- ``match_keys``: list of keys used to match an existing shortcut,
|
|
|
- ``match_filter``: shortcut filter used to match an existing shortcut,
|
|
|
- ``new_keys``: list of keys to set,
|
|
|
- ``new_filter``: a new shortcut filter to set
|
|
|
|
|
|
The filters have to be composed of pre-defined verbs and joined by one
|
|
|
of the following conjunctions: ``&`` (and), ``|`` (or), ``~`` (not).
|
|
|
The pre-defined verbs are:
|
|
|
|
|
|
{filters}
|
|
|
|
|
|
To disable a shortcut set ``new_keys`` to an empty list.
|
|
|
To add a shortcut add key ``create`` with value ``True``.
|
|
|
|
|
|
When modifying/disabling shortcuts, ``match_keys``/``match_filter`` can
|
|
|
be omitted if the provided specification uniquely identifies a shortcut
|
|
|
to be modified/disabled. When modifying a shortcut ``new_filter`` or
|
|
|
``new_keys`` can be omitted which will result in reuse of the existing
|
|
|
filter/keys.
|
|
|
|
|
|
Only shortcuts defined in IPython (and not default prompt-toolkit
|
|
|
shortcuts) can be modified or disabled. The full list of shortcuts,
|
|
|
command identifiers and filters is available under
|
|
|
:ref:`terminal-shortcuts-list`.
|
|
|
|
|
|
Here is an example:
|
|
|
|
|
|
.. code::
|
|
|
|
|
|
c.TerminalInteractiveShell.shortcuts = [
|
|
|
{{
|
|
|
"new_keys": ["c-q"],
|
|
|
"command": "prompt_toolkit:named_commands.capitalize_word",
|
|
|
"create": True,
|
|
|
}},
|
|
|
{{
|
|
|
"new_keys": ["c-j"],
|
|
|
"command": "prompt_toolkit:named_commands.beginning_of_line",
|
|
|
"create": True,
|
|
|
}},
|
|
|
]
|
|
|
|
|
|
|
|
|
""".format(
|
|
|
filters="\n ".join([f" - ``{k}``" for k in KEYBINDING_FILTERS])
|
|
|
),
|
|
|
).tag(config=True)
|
|
|
|
|
|
@observe("shortcuts")
|
|
|
def _shortcuts_changed(self, change):
|
|
|
if self.pt_app:
|
|
|
self.pt_app.key_bindings = self._merge_shortcuts(user_shortcuts=change.new)
|
|
|
|
|
|
def _merge_shortcuts(self, user_shortcuts):
|
|
|
# rebuild the bindings list from scratch
|
|
|
key_bindings = create_ipython_shortcuts(self)
|
|
|
|
|
|
# for now we only allow adding shortcuts for a specific set of
|
|
|
# commands; this is a security precution.
|
|
|
allowed_commands = {
|
|
|
create_identifier(binding.command): binding.command
|
|
|
for binding in KEY_BINDINGS
|
|
|
}
|
|
|
allowed_commands.update(
|
|
|
{
|
|
|
create_identifier(command): command
|
|
|
for command in UNASSIGNED_ALLOWED_COMMANDS
|
|
|
}
|
|
|
)
|
|
|
shortcuts_to_skip = []
|
|
|
shortcuts_to_add = []
|
|
|
|
|
|
for shortcut in user_shortcuts:
|
|
|
command_id = shortcut["command"]
|
|
|
if command_id not in allowed_commands:
|
|
|
allowed_commands = "\n - ".join(allowed_commands)
|
|
|
raise ValueError(
|
|
|
f"{command_id} is not a known shortcut command."
|
|
|
f" Allowed commands are: \n - {allowed_commands}"
|
|
|
)
|
|
|
old_keys = shortcut.get("match_keys", None)
|
|
|
old_filter = (
|
|
|
filter_from_string(shortcut["match_filter"])
|
|
|
if "match_filter" in shortcut
|
|
|
else None
|
|
|
)
|
|
|
matching = [
|
|
|
binding
|
|
|
for binding in KEY_BINDINGS
|
|
|
if (
|
|
|
(old_filter is None or binding.filter == old_filter)
|
|
|
and (old_keys is None or [k for k in binding.keys] == old_keys)
|
|
|
and create_identifier(binding.command) == command_id
|
|
|
)
|
|
|
]
|
|
|
|
|
|
new_keys = shortcut.get("new_keys", None)
|
|
|
new_filter = shortcut.get("new_filter", None)
|
|
|
|
|
|
command = allowed_commands[command_id]
|
|
|
|
|
|
creating_new = shortcut.get("create", False)
|
|
|
modifying_existing = not creating_new and (
|
|
|
new_keys is not None or new_filter
|
|
|
)
|
|
|
|
|
|
if creating_new and new_keys == []:
|
|
|
raise ValueError("Cannot add a shortcut without keys")
|
|
|
|
|
|
if modifying_existing:
|
|
|
specification = {
|
|
|
key: shortcut[key]
|
|
|
for key in ["command", "filter"]
|
|
|
if key in shortcut
|
|
|
}
|
|
|
if len(matching) == 0:
|
|
|
raise ValueError(
|
|
|
f"No shortcuts matching {specification} found in {KEY_BINDINGS}"
|
|
|
)
|
|
|
elif len(matching) > 1:
|
|
|
raise ValueError(
|
|
|
f"Multiple shortcuts matching {specification} found,"
|
|
|
f" please add keys/filter to select one of: {matching}"
|
|
|
)
|
|
|
|
|
|
matched = matching[0]
|
|
|
old_filter = matched.filter
|
|
|
old_keys = list(matched.keys)
|
|
|
shortcuts_to_skip.append(
|
|
|
RuntimeBinding(
|
|
|
command,
|
|
|
keys=old_keys,
|
|
|
filter=old_filter,
|
|
|
)
|
|
|
)
|
|
|
|
|
|
if new_keys != []:
|
|
|
shortcuts_to_add.append(
|
|
|
RuntimeBinding(
|
|
|
command,
|
|
|
keys=new_keys or old_keys,
|
|
|
filter=(
|
|
|
filter_from_string(new_filter)
|
|
|
if new_filter is not None
|
|
|
else (
|
|
|
old_filter
|
|
|
if old_filter is not None
|
|
|
else filter_from_string("always")
|
|
|
)
|
|
|
),
|
|
|
)
|
|
|
)
|
|
|
|
|
|
# rebuild the bindings list from scratch
|
|
|
key_bindings = create_ipython_shortcuts(self, skip=shortcuts_to_skip)
|
|
|
for binding in shortcuts_to_add:
|
|
|
add_binding(key_bindings, binding)
|
|
|
|
|
|
return key_bindings
|
|
|
|
|
|
prompt_includes_vi_mode = Bool(True,
|
|
|
help="Display the current vi mode (when using vi editing mode)."
|
|
|
).tag(config=True)
|
|
|
|
|
|
prompt_line_number_format = Unicode(
|
|
|
"",
|
|
|
help="The format for line numbering, will be passed `line` (int, 1 based)"
|
|
|
" the current line number and `rel_line` the relative line number."
|
|
|
" for example to display both you can use the following template string :"
|
|
|
" c.TerminalInteractiveShell.prompt_line_number_format='{line: 4d}/{rel_line:+03d} | '"
|
|
|
" This will display the current line number, with leading space and a width of at least 4"
|
|
|
" character, as well as the relative line number 0 padded and always with a + or - sign."
|
|
|
" Note that when using Emacs mode the prompt of the first line may not update.",
|
|
|
).tag(config=True)
|
|
|
|
|
|
@observe('term_title')
|
|
|
def init_term_title(self, change=None):
|
|
|
# Enable or disable the terminal title.
|
|
|
if self.term_title and _is_tty:
|
|
|
toggle_set_term_title(True)
|
|
|
set_term_title(self.term_title_format.format(cwd=abbrev_cwd()))
|
|
|
else:
|
|
|
toggle_set_term_title(False)
|
|
|
|
|
|
def restore_term_title(self):
|
|
|
if self.term_title and _is_tty:
|
|
|
restore_term_title()
|
|
|
|
|
|
def init_display_formatter(self):
|
|
|
super(TerminalInteractiveShell, self).init_display_formatter()
|
|
|
# terminal only supports plain text if not explicitly configured
|
|
|
config = self.display_formatter._trait_values["config"]
|
|
|
if not (
|
|
|
"DisplayFormatter" in config
|
|
|
and "active_types" in config["DisplayFormatter"]
|
|
|
):
|
|
|
self.display_formatter.active_types = ["text/plain"]
|
|
|
|
|
|
def init_prompt_toolkit_cli(self):
|
|
|
if self.simple_prompt:
|
|
|
# Fall back to plain non-interactive output for tests.
|
|
|
# This is very limited.
|
|
|
def prompt():
|
|
|
prompt_text = "".join(x[1] for x in self.prompts.in_prompt_tokens())
|
|
|
lines = [input(prompt_text)]
|
|
|
prompt_continuation = "".join(
|
|
|
x[1] for x in self.prompts.continuation_prompt_tokens()
|
|
|
)
|
|
|
while self.check_complete("\n".join(lines))[0] == "incomplete":
|
|
|
lines.append(input(prompt_continuation))
|
|
|
return "\n".join(lines)
|
|
|
|
|
|
self.prompt_for_code = prompt
|
|
|
return
|
|
|
|
|
|
# Set up keyboard shortcuts
|
|
|
key_bindings = self._merge_shortcuts(user_shortcuts=self.shortcuts)
|
|
|
|
|
|
# Pre-populate history from IPython's history database
|
|
|
history = PtkHistoryAdapter(self)
|
|
|
|
|
|
self.refresh_style()
|
|
|
ptk_s = DynamicStyle(lambda: self._style)
|
|
|
|
|
|
editing_mode = getattr(EditingMode, self.editing_mode.upper())
|
|
|
|
|
|
self._use_asyncio_inputhook = False
|
|
|
self.pt_app = PromptSession(
|
|
|
auto_suggest=self.auto_suggest,
|
|
|
editing_mode=editing_mode,
|
|
|
key_bindings=key_bindings,
|
|
|
history=history,
|
|
|
completer=IPythonPTCompleter(shell=self),
|
|
|
enable_history_search=self.enable_history_search,
|
|
|
style=ptk_s,
|
|
|
include_default_pygments_style=False,
|
|
|
mouse_support=self.mouse_support,
|
|
|
enable_open_in_editor=self.extra_open_editor_shortcuts,
|
|
|
color_depth=self.color_depth,
|
|
|
tempfile_suffix=".py",
|
|
|
**self._extra_prompt_options(),
|
|
|
)
|
|
|
if isinstance(self.auto_suggest, NavigableAutoSuggestFromHistory):
|
|
|
self.auto_suggest.connect(self.pt_app)
|
|
|
|
|
|
def _make_style_from_name_or_cls(self, name_or_cls):
|
|
|
"""
|
|
|
Small wrapper that make an IPython compatible style from a style name
|
|
|
|
|
|
We need that to add style for prompt ... etc.
|
|
|
"""
|
|
|
assert name_or_cls == "legacy"
|
|
|
legacy = self.colors.lower()
|
|
|
|
|
|
theme = theme_table.get(legacy, None)
|
|
|
assert theme is not None, legacy
|
|
|
|
|
|
if legacy == "nocolor":
|
|
|
style_overrides = {}
|
|
|
style_cls = _NoStyle
|
|
|
else:
|
|
|
style_overrides = {**theme.extra_style, **self.highlighting_style_overrides}
|
|
|
if theme.base is not None:
|
|
|
style_cls = get_style_by_name(theme.base)
|
|
|
else:
|
|
|
style_cls = _NoStyle
|
|
|
|
|
|
style = merge_styles(
|
|
|
[
|
|
|
style_from_pygments_cls(style_cls),
|
|
|
style_from_pygments_dict(style_overrides),
|
|
|
]
|
|
|
)
|
|
|
|
|
|
return style
|
|
|
|
|
|
@property
|
|
|
def pt_complete_style(self):
|
|
|
return {
|
|
|
'multicolumn': CompleteStyle.MULTI_COLUMN,
|
|
|
'column': CompleteStyle.COLUMN,
|
|
|
'readlinelike': CompleteStyle.READLINE_LIKE,
|
|
|
}[self.display_completions]
|
|
|
|
|
|
@property
|
|
|
def color_depth(self):
|
|
|
return (ColorDepth.TRUE_COLOR if self.true_color else None)
|
|
|
|
|
|
def _ptk_prompt_cont(self, width: int, line_number: int, wrap_count: int):
|
|
|
return PygmentsTokens(
|
|
|
_backward_compat_continuation_prompt_tokens(
|
|
|
self.prompts.continuation_prompt_tokens,
|
|
|
width,
|
|
|
lineno=line_number,
|
|
|
wrap_count=wrap_count,
|
|
|
)
|
|
|
)
|
|
|
|
|
|
def _extra_prompt_options(self):
|
|
|
"""
|
|
|
Return the current layout option for the current Terminal InteractiveShell
|
|
|
"""
|
|
|
def get_message():
|
|
|
return PygmentsTokens(self.prompts.in_prompt_tokens())
|
|
|
|
|
|
if self.editing_mode == "emacs" and self.prompt_line_number_format == "":
|
|
|
# with emacs mode the prompt is (usually) static, so we call only
|
|
|
# the function once. With VI mode it can toggle between [ins] and
|
|
|
# [nor] so we can't precompute.
|
|
|
# here I'm going to favor the default keybinding which almost
|
|
|
# everybody uses to decrease CPU usage.
|
|
|
# if we have issues with users with custom Prompts we can see how to
|
|
|
# work around this.
|
|
|
get_message = get_message()
|
|
|
|
|
|
options = {
|
|
|
"complete_in_thread": False,
|
|
|
"lexer": IPythonPTLexer(),
|
|
|
"reserve_space_for_menu": self.space_for_menu,
|
|
|
"message": get_message,
|
|
|
"prompt_continuation": self._ptk_prompt_cont,
|
|
|
"multiline": True,
|
|
|
"complete_style": self.pt_complete_style,
|
|
|
"input_processors": [
|
|
|
# Highlight matching brackets, but only when this setting is
|
|
|
# enabled, and only when the DEFAULT_BUFFER has the focus.
|
|
|
ConditionalProcessor(
|
|
|
processor=HighlightMatchingBracketProcessor(chars="[](){}"),
|
|
|
filter=HasFocus(DEFAULT_BUFFER)
|
|
|
& ~IsDone()
|
|
|
& Condition(lambda: self.highlight_matching_brackets),
|
|
|
),
|
|
|
# Show auto-suggestion in lines other than the last line.
|
|
|
ConditionalProcessor(
|
|
|
processor=AppendAutoSuggestionInAnyLine(),
|
|
|
filter=HasFocus(DEFAULT_BUFFER)
|
|
|
& ~IsDone()
|
|
|
& Condition(
|
|
|
lambda: isinstance(
|
|
|
self.auto_suggest,
|
|
|
NavigableAutoSuggestFromHistory,
|
|
|
)
|
|
|
),
|
|
|
),
|
|
|
],
|
|
|
}
|
|
|
|
|
|
return options
|
|
|
|
|
|
def prompt_for_code(self):
|
|
|
if self.rl_next_input:
|
|
|
default = self.rl_next_input
|
|
|
self.rl_next_input = None
|
|
|
else:
|
|
|
default = ''
|
|
|
|
|
|
# In order to make sure that asyncio code written in the
|
|
|
# interactive shell doesn't interfere with the prompt, we run the
|
|
|
# prompt in a different event loop.
|
|
|
# If we don't do this, people could spawn coroutine with a
|
|
|
# while/true inside which will freeze the prompt.
|
|
|
|
|
|
with patch_stdout(raw=True):
|
|
|
if self._use_asyncio_inputhook:
|
|
|
# When we integrate the asyncio event loop, run the UI in the
|
|
|
# same event loop as the rest of the code. don't use an actual
|
|
|
# input hook. (Asyncio is not made for nesting event loops.)
|
|
|
asyncio_loop = get_asyncio_loop()
|
|
|
text = asyncio_loop.run_until_complete(
|
|
|
self.pt_app.prompt_async(
|
|
|
default=default, **self._extra_prompt_options()
|
|
|
)
|
|
|
)
|
|
|
else:
|
|
|
text = self.pt_app.prompt(
|
|
|
default=default,
|
|
|
inputhook=self._inputhook,
|
|
|
**self._extra_prompt_options(),
|
|
|
)
|
|
|
|
|
|
return text
|
|
|
|
|
|
def init_io(self):
|
|
|
if sys.platform not in {'win32', 'cli'}:
|
|
|
return
|
|
|
|
|
|
import colorama
|
|
|
colorama.init()
|
|
|
|
|
|
def init_magics(self):
|
|
|
super(TerminalInteractiveShell, self).init_magics()
|
|
|
self.register_magics(TerminalMagics)
|
|
|
|
|
|
def init_alias(self):
|
|
|
# The parent class defines aliases that can be safely used with any
|
|
|
# frontend.
|
|
|
super(TerminalInteractiveShell, self).init_alias()
|
|
|
|
|
|
# Now define aliases that only make sense on the terminal, because they
|
|
|
# need direct access to the console in a way that we can't emulate in
|
|
|
# GUI or web frontend
|
|
|
if os.name == 'posix':
|
|
|
for cmd in ('clear', 'more', 'less', 'man'):
|
|
|
self.alias_manager.soft_define_alias(cmd, cmd)
|
|
|
|
|
|
def __init__(self, *args, **kwargs) -> None:
|
|
|
super().__init__(*args, **kwargs)
|
|
|
self._set_autosuggestions(self.autosuggestions_provider)
|
|
|
self.init_prompt_toolkit_cli()
|
|
|
self.init_term_title()
|
|
|
self.keep_running = True
|
|
|
self._set_formatter(self.autoformatter)
|
|
|
|
|
|
def ask_exit(self):
|
|
|
self.keep_running = False
|
|
|
|
|
|
rl_next_input = None
|
|
|
|
|
|
def interact(self):
|
|
|
self.keep_running = True
|
|
|
while self.keep_running:
|
|
|
print(self.separate_in, end='')
|
|
|
|
|
|
try:
|
|
|
code = self.prompt_for_code()
|
|
|
except EOFError:
|
|
|
if (not self.confirm_exit) \
|
|
|
or self.ask_yes_no('Do you really want to exit ([y]/n)?','y','n'):
|
|
|
self.ask_exit()
|
|
|
|
|
|
else:
|
|
|
if code:
|
|
|
self.run_cell(code, store_history=True)
|
|
|
|
|
|
def mainloop(self):
|
|
|
# An extra layer of protection in case someone mashing Ctrl-C breaks
|
|
|
# out of our internal code.
|
|
|
while True:
|
|
|
try:
|
|
|
self.interact()
|
|
|
break
|
|
|
except KeyboardInterrupt as e:
|
|
|
print("\n%s escaped interact()\n" % type(e).__name__)
|
|
|
finally:
|
|
|
# An interrupt during the eventloop will mess up the
|
|
|
# internal state of the prompt_toolkit library.
|
|
|
# Stopping the eventloop fixes this, see
|
|
|
# https://github.com/ipython/ipython/pull/9867
|
|
|
if hasattr(self, '_eventloop'):
|
|
|
self._eventloop.stop()
|
|
|
|
|
|
self.restore_term_title()
|
|
|
|
|
|
# try to call some at-exit operation optimistically as some things can't
|
|
|
# be done during interpreter shutdown. this is technically inaccurate as
|
|
|
# this make mainlool not re-callable, but that should be a rare if not
|
|
|
# in existent use case.
|
|
|
|
|
|
self._atexit_once()
|
|
|
|
|
|
_inputhook = None
|
|
|
def inputhook(self, context):
|
|
|
warn(
|
|
|
"inputkook seem unused, and marked for deprecation/Removal as of IPython 9.0. "
|
|
|
"Please open an issue if you are using it.",
|
|
|
category=PendingDeprecationWarning,
|
|
|
stacklevel=2,
|
|
|
)
|
|
|
if self._inputhook is not None:
|
|
|
self._inputhook(context)
|
|
|
|
|
|
active_eventloop: Optional[str] = None
|
|
|
|
|
|
def enable_gui(self, gui: Optional[str] = None) -> None:
|
|
|
if gui:
|
|
|
from ..core.pylabtools import _convert_gui_from_matplotlib
|
|
|
|
|
|
gui = _convert_gui_from_matplotlib(gui)
|
|
|
|
|
|
if self.simple_prompt is True and gui is not None:
|
|
|
print(
|
|
|
f'Cannot install event loop hook for "{gui}" when running with `--simple-prompt`.'
|
|
|
)
|
|
|
print(
|
|
|
"NOTE: Tk is supported natively; use Tk apps and Tk backends with `--simple-prompt`."
|
|
|
)
|
|
|
return
|
|
|
|
|
|
if self._inputhook is None and gui is None:
|
|
|
print("No event loop hook running.")
|
|
|
return
|
|
|
|
|
|
if self._inputhook is not None and gui is not None:
|
|
|
newev, newinhook = get_inputhook_name_and_func(gui)
|
|
|
if self._inputhook == newinhook:
|
|
|
# same inputhook, do nothing
|
|
|
self.log.info(
|
|
|
f"Shell is already running the {self.active_eventloop} eventloop. Doing nothing"
|
|
|
)
|
|
|
return
|
|
|
self.log.warning(
|
|
|
f"Shell is already running a different gui event loop for {self.active_eventloop}. "
|
|
|
"Call with no arguments to disable the current loop."
|
|
|
)
|
|
|
return
|
|
|
if self._inputhook is not None and gui is None:
|
|
|
self.active_eventloop = self._inputhook = None
|
|
|
|
|
|
if gui and (gui not in {None, "webagg"}):
|
|
|
# This hook runs with each cycle of the `prompt_toolkit`'s event loop.
|
|
|
self.active_eventloop, self._inputhook = get_inputhook_name_and_func(gui)
|
|
|
else:
|
|
|
self.active_eventloop = self._inputhook = None
|
|
|
|
|
|
self._use_asyncio_inputhook = gui == "asyncio"
|
|
|
|
|
|
# Run !system commands directly, not through pipes, so terminal programs
|
|
|
# work correctly.
|
|
|
system = InteractiveShell.system_raw
|
|
|
|
|
|
def auto_rewrite_input(self, cmd):
|
|
|
"""Overridden from the parent class to use fancy rewriting prompt"""
|
|
|
if not self.show_rewritten_input:
|
|
|
return
|
|
|
|
|
|
tokens = self.prompts.rewrite_prompt_tokens()
|
|
|
if self.pt_app:
|
|
|
print_formatted_text(PygmentsTokens(tokens), end='',
|
|
|
style=self.pt_app.app.style)
|
|
|
print(cmd)
|
|
|
else:
|
|
|
prompt = ''.join(s for t, s in tokens)
|
|
|
print(prompt, cmd, sep='')
|
|
|
|
|
|
_prompts_before = None
|
|
|
def switch_doctest_mode(self, mode):
|
|
|
"""Switch prompts to classic for %doctest_mode"""
|
|
|
if mode:
|
|
|
self._prompts_before = self.prompts
|
|
|
self.prompts = ClassicPrompts(self)
|
|
|
elif self._prompts_before:
|
|
|
self.prompts = self._prompts_before
|
|
|
self._prompts_before = None
|
|
|
# self._update_layout()
|
|
|
|
|
|
|
|
|
InteractiveShellABC.register(TerminalInteractiveShell)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
|
TerminalInteractiveShell.instance().interact()
|