euporie.core.tabs.kernel

Contain kernel tab base class.

Functions

add_cmd(**kwargs)	Add a command to the centralized command system.
autosuggest_factory(kind, history)	Generate autosuggesters.
get_app()	Get the current active (running) Application.
list_kernels()	Get specifications for all available kernel types.
lru_cache([maxsize, typed])	Least-recently-used cache decorator.
open_comm(comm_container, content, buffers)	Create a new object respsenting a Comm.

Classes

ABCMeta(name, bases, namespace, /, **kwargs)	Metaclass for defining Abstract Base Classes (ABCs).
DeduplicateCompleter(completer)	Asynchronous wrapper around a completer that removes duplicates.
DummyAutoSuggest()	AutoSuggest class that doesn't return any suggestion.
DummyHistory()	History object that doesn't remember anything.
DynamicAutoSuggest(get_auto_suggest)	Validator class that can dynamically returns any Validator.
DynamicCompleter(get_completer)	Completer class that can dynamically returns any Completer.
FirstInspector(inspectors)	Return results of the first inspector to respond.
InMemoryHistory([history_strings])	History class that keeps a list of all strings in memory.
KernelCompleter(kernel)	A prompt_toolkit completer which provides completions from a kernel.
KernelHistory(kernel[, n])	Load the kernel's command history.
KernelInspector(kernel)	Inspector which retrieves contextual help from a kernel.
KernelTab(app[, path, kernel, comms, ...])	A Tab which connects to a kernel.
LspCompleter(lsp, path)	A completer for documents using an LSP.
LspFormatter(lsp, path[, languages])	Format a document using a LSP server.
LspInspector(lsp, path)	Inspector which retrieves contextual help from a Language Server.
NoKernel(kernel_tab[, default_callbacks, ...])	A None kernel.
Report([iterable])	Class for storing a diagnostic report.
Tab(app[, path])	Base class for interface tabs.
WeakKeyDictionary([dict])	Mapping class that references keys weakly.
deque	A list-like sequence optimized for data accesses near its endpoints.
partial(func, /, *args, **keywords)	Create a new function with partial application of the given arguments and keywords.

class euporie.core.tabs.kernel.KernelTab(app: BaseApp, path: Path | None = None, kernel: BaseKernel | None = None, comms: dict[str, Comm] | None = None, use_kernel_history: bool = False, connection_file: Path | None = None)

Bases: Tab

A Tab which connects to a kernel.

allow_stdin: bool

bg_init = False

change_kernel(msg: str | None = None, startup: bool = False) → None

Prompt the user to select a new kernel.

close(cb: Callable | None = None) → None

Shut down kernel when tab is closed.

comm_close(content: dict, buffers: Sequence[bytes]) → None

Close a notebook Comm.

comm_msg(content: dict, buffers: Sequence[bytes]) → None

Respond to a Comm message from the kernel.

comm_open(content: dict, buffers: Sequence[bytes]) → None

Register a new kernel Comm object in the notebook.

container: AnyContainer

property current_input: KernelInput

Return the currently active kernel input, if any.

default_callbacks: MsgCallbacks

file_extensions: ClassVar[dict[str, None]] = {}

focus() → None

Focus the tab (or make it visible).

init_kernel(kernel: BaseKernel | None = None, comms: dict[str, Comm] | None = None, use_kernel_history: bool = False, connection_file: Path | None = None) → None

Set up the tab’s kernel and related components.

interrupt_kernel() → None

Interrupt the current Notebook’s kernel.

kernel_died() → None

Call if the kernel dies.

property kernel_display_name: str

Return the display name of the kernel defined in the notebook JSON.

property kernel_lang_file_ext: str

Return the display name of the kernel defined in the notebook JSON.

kernel_language: str

property kernel_name: str

Return the name of the kernel defined in the notebook JSON.

kernel_started(result: dict[str, Any] | None = None) → None

Task to run when the kernel has started.

property language: str

Return the name of the kernel defined in the notebook JSON.

async load_history() → None

Load kernel history.

async load_lsps() → None

Load the LSP clients.

lsp_after_save_handler(lsp: LspClient) → None

Tell the the LSP we saved a document.

lsp_before_save_handler(lsp: LspClient) → None

Tell the the LSP we are about to save a document.

lsp_change_handler(lsp: LspClient) → None

Tell the LSP server a file has changed.

lsp_close_handler(lsp: LspClient) → None

Tell the LSP we opened a file.

lsp_open_handler(lsp: LspClient) → None

Tell the LSP we opened a file.

lsp_update_diagnostics(lsp: LspClient) → None

Process a new diagnostic report from the LSP.

property metadata: dict[str, Any]

Return a dictionary to hold notebook / kernel metadata.

mime_types: ClassVar[set[str]] = {}

name: str | None = None

post_init_kernel() → None

Run stuff after the kernel is loaded.

pre_init_kernel() → None

Run stuff before the kernel is loaded.

report() → Report

Return the current diagnostic reports.

report_kernel_error(error: Exception | None) → None

Report a kernel error to the user.

reset() → None

Reset the state of the tab.

restart_kernel(cb: Callable | None = None) → None

Restart the current Notebook’s kernel.

save(path: Path | None = None, cb: Callable | None = None) → None

Save the current file.

set_kernel_info(info: dict) → None

Handle kernel info requests.

switch_kernel(factory: KernelFactory) → None

Shut down the current kernel and change to another.

property title: str

Return the tab title.

weight: int = 0

write_file(path: Path) → None

Write the tab’s data to a path.

Not implement in the base tab.

Parameters:

path – An path at which to save the file

euporie.core.tabs.kernel.autosuggest_factory(kind: str, history: History) → AutoSuggest

Generate autosuggesters.