simvx.core.py_console

PyConsoleNode – an in-process Python REPL that speaks the TerminalEmulator contract.

Where ShellNode wraps an OS subprocess (and needs a real PTY for line editing), PyConsoleNode runs an interactive interpreter inside the running app. It exposes the same duck-typed surface a TerminalEmulator attaches to – stdout_data / stderr_data / process_exited signals plus write() / start() / stop() / resize() – so the same widget drives either backend.

Because it is in-process it works identically on desktop and in the browser (Pyodide), where no subprocess or pty device exists. It also shares the host interpreter, so the namespace can expose live objects (the scene tree, nodes) for debugging – something an external python3 subprocess cannot do.

The flip side of in-process execution: a command that blocks (input(), a long loop, time.sleep) blocks the frame loop. input() is therefore replaced with a clear error; long-running work is the caller’s responsibility.

Module Contents

Classes

PyConsoleNode

Interactive in-process Python REPL, attachable to a TerminalEmulator.

Data

log

API

simvx.core.py_console.log

‘getLogger(…)’

class simvx.core.py_console.PyConsoleNode(namespace: dict | None = None, *, banner: str | None = None, **kwargs)

Bases: simvx.core.node.Node

Interactive in-process Python REPL, attachable to a TerminalEmulator.

Emits stdout_data(str) for results/prints and prompts, stderr_data(str) for tracebacks, and process_exited(int) when the console is closed (Ctrl-D on an empty line, exit(), or :meth:stop).

namespace seeds the interpreter globals; pass live objects here to inspect them from the console (e.g. {"root": my_scene}).

Initialization

property ps1: str

property ps2: str

property running: bool

start(*_args)

Print the banner and the first prompt.

stop()

Close the console, emitting process_exited once.

resize(cols: int, _rows: int)

write(data: str)

Feed terminal keystrokes (raw chars + escape sequences) to the line editor.

on_exit_tree()

strict_errors: ClassVar[bool]

True

script_error_raised

‘Signal(…)’

classmethod __init_subclass__(**kwargs)

property name: str

property process_mode: simvx.core.descriptors.ProcessMode

property visible: bool

reset_error() → None

add_child(node: simvx.core.node.Node) → simvx.core.node.Node

remove_child(node: simvx.core.node.Node)

reparent(new_parent: simvx.core.node.Node)

get_node(path: str) → simvx.core.node.Node

find_child(name: str, recursive: bool = False) → simvx.core.node.Node | None

find(target: type | str, recursive: bool = True) → simvx.core.node.Node | None

find_all(node_type: type, recursive: bool = True) → list

walk(*, include_self: bool = True) → collections.abc.Iterator[simvx.core.node.Node]

property path: str

add_to_group(group: str)

remove_from_group(group: str)

is_in_group(group: str) → bool

on_ready() → None

on_enter_tree() → None

on_process(dt: float) → None

on_physics_process(dt: float) → None

on_draw(renderer) → None

on_picked(event: simvx.core.events.InputEvent) → None

on_unhandled_input(event: simvx.core.events.TreeInputEvent) → None

start_coroutine(gen: simvx.core.descriptors.Coroutine) → simvx.core.descriptors.CoroutineHandle

stop_coroutine(gen_or_handle)

clear_children()

destroy()

property app

property tree: simvx.core.scene_tree.SceneTree

__getitem__(key: str)

classmethod get_properties() → dict[str, simvx.core.descriptors.Property]

__repr__()