simvx.editor.panels.console

Console Panel – Interactive Python console with log capture.

Provides a read-only output area for log messages and print statements, a single-line input for executing Python commands, command history navigation via up/down arrows, and a clear button.

Module Contents

Classes

ConsoleRecord	Canonical record stored alongside each rendered output line.
ConsolePanel	Interactive Python console with log output and command input.

API

class simvx.editor.panels.console.ConsoleRecord

Canonical record stored alongside each rendered output line.

One record exists per entry in ConsolePanel._output_lines so the upcoming filter UI (G2) can decide visibility per line. Multi-line log messages (e.g. tracebacks) produce one record per visible line, all sharing the originating level/source/created values.

source distinguishes between the standard logging channel ("log") and writes that came through sys.stdout ("stdout"); G2 will surface this as a filter facet. stdout entries are stored as synthetic INFO-level records – there is no real LogRecord for them, so we use a single dataclass for all entries to keep one canonical representation.

level: str

None

name: str

None

message: str

None

created: float

None

source: str

None

class simvx.editor.panels.console.ConsolePanel(editor_state=None, capture_stdout: bool = False, **kwargs)

Bases: simvx.core.Control

Interactive Python console with log output and command input.

Features: - Read-only output area showing log and print output - Single-line input with enter-to-execute - Command history (up/down arrow) - eval/exec execution with shared namespace - Logging handler that captures Python log messages - Optional sys.stdout redirect for print() capture - 1000-line output cap (oldest lines discarded) - Clear button to reset output

Initialization

property worst_severity: int

reset_severity()

Reset severity tracking (call when Console tab is viewed).

start_stdout_capture()

Begin capturing sys.stdout into the console output.

stop_stdout_capture()

Restore sys.stdout to its original value.

inject(name: str, value)

Add a name into the console execution namespace.

clear()

Clear all output lines.

property records: list[simvx.editor.panels.console.ConsoleRecord]

Return the parallel list of ConsoleRecord entries.

Always the same length as _output_lines; index i describes the origin/level of the line at _output_lines[i].

record_at(index: int) → simvx.editor.panels.console.ConsoleRecord

Return the ConsoleRecord for output line index.

property visible_records: list[simvx.editor.panels.console.ConsoleRecord]

Return records currently passing the filter (in display order).

process(dt: float)

draw(renderer)

enter_tree()

Re-attach log handler and error signal when (re-)entering the tree.

exit_tree()

Remove log handler, disconnect error signal, and restore stdout on removal from tree.

size_x

‘Property(…)’

size_y

‘Property(…)’

anchor_left

‘Property(…)’

anchor_top

‘Property(…)’

anchor_right

‘Property(…)’

anchor_bottom

‘Property(…)’

margin_left

‘Property(…)’

margin_top

‘Property(…)’

margin_right

‘Property(…)’

margin_bottom

‘Property(…)’

property size: simvx.core.math.types.Vec2

touch_mode: str

‘mouse’

property theme: simvx.core.ui.types.Theme | None

property mouse_over: bool

property focused: bool

property disabled: bool

get_theme() → simvx.core.ui.types.Theme

queue_redraw()

get_minimum_size() → simvx.core.math.types.Vec2

get_rect() → tuple[float, float, float, float]

get_global_rect() → tuple[float, float, float, float]

is_point_inside(point) → bool

set_anchor_preset(preset: simvx.core.ui.enums.AnchorPreset)

set_focus()

grab_focus()

release_focus()

has_focus() → bool

focus_next_control()

focus_previous_control()

grab_mouse()

release_mouse()

set_drag_preview(control: simvx.core.ui.core.Control)

draw_popup(renderer)

is_popup_point_inside(point) → bool

popup_input(event)

dismiss_popup()

z_index

‘Property(…)’

z_as_relative

‘Property(…)’

render_layer

‘Property(…)’

set_render_layer(index: int, enabled: bool = True) → None

is_on_render_layer(index: int) → bool

property absolute_z_index: int

property position: simvx.core.math.types.Vec2

property rotation: float

property rotation_degrees: float

property scale: simvx.core.math.types.Vec2

property world_position: simvx.core.math.types.Vec2

property world_rotation: float

property world_scale: simvx.core.math.types.Vec2

property forward: simvx.core.math.types.Vec2

property right: simvx.core.math.types.Vec2

translate(offset: tuple[float, float] | numpy.ndarray)

rotate(radians: float)

rotate_deg(degrees: float)

look_at(target: tuple[float, float] | numpy.ndarray)

transform_points(points: list[simvx.core.math.types.Vec2]) → list[simvx.core.math.types.Vec2]

draw_polygon(renderer, points: list[simvx.core.math.types.Vec2], closed=True, colour=None)

wrap_screen(margin: float = 20)

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(node_type: type, 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

ready() → None

physics_process(dt: float) → None

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

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

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__()