simvx.core.testing.recorder

ScriptRecorder – records user input and generates replayable test scripts.

Module Contents

Classes

RecordedEvent

A single recorded input event.

ScriptRecorder

Records user input events and generates replayable test scripts.

Data

log

__all__

API

simvx.core.testing.recorder.log

‘getLogger(…)’

simvx.core.testing.recorder.__all__

[‘RecordedEvent’, ‘ScriptRecorder’]

class simvx.core.testing.recorder.RecordedEvent[source]

A single recorded input event.

button is a MouseButton enum for click events, None otherwise. Codegen emits explicit MouseButton.LEFT/RIGHT/MIDDLE so the generated tests stay readable.

timestamp: float

None

event_type: str

None

x: float

0.0

y: float

0.0

button: simvx.core.input.MouseButton | None

None

key: str = <Multiline-String>
char: str = <Multiline-String>
target_path: str = <Multiline-String>
class simvx.core.testing.recorder.ScriptRecorder(format: str = 'harness', **kwargs)[source]

Bases: simvx.core.node.Node

Records user input events and generates replayable test scripts.

Attach to a scene to record interactions. Call stop_recording() to get Python source code that replays the session using UITestHarness, DemoRunner steps, or raw InputSimulator API.

Toggle with F9 or programmatically via start/stop_recording().

Initialization

format: str

‘harness’

start_recording() → None[source]

Start capturing input events.

stop_recording() → str[source]

Stop recording and return generated test code in the current format.

save_recording(path: pathlib.Path, format: str | None = None) → None[source]

Save recorded script to a file.

property is_recording: bool[source]
property event_count: int[source]
record_event(event: simvx.core.testing.recorder.RecordedEvent) → None[source]

Manually inject a recorded event (for testing the recorder itself).

on_update(dt: float) → None[source]
strict_errors: ClassVar[bool]

True

dev_checks: ClassVar[bool]

None

script_error_raised

‘Signal(…)’

dynamic: bool

False

visible

‘Property(…)’

update_mode

‘Property(…)’

__properties__: ClassVar[dict[str, simvx.core.descriptors.Property]]

None

classmethod __init_subclass__(**kwargs)
property name: str
property visible_in_tree: bool
reset_error() → None
add_child(node: simvx.core.node.T) → simvx.core.node.T
remove_child(node: simvx.core.node.Node) → None
reparent(new_parent: simvx.core.node.Node)
node_at(path, default=_NO_DEFAULT)
find(target, *, direct: bool = False)
find_all(target, *, direct: bool = False)
expect(target, *, direct: bool = False)
ancestor(target)
walk(*, include_self: bool = True) → collections.abc.Iterator[simvx.core.node.Node]
property path: str
property is_scene_root: bool
add_to_group(group: str)
remove_from_group(group: str)
is_in_group(group: str) → bool
on_ready() → None
on_enter_tree() → None
on_exit_tree() → None
on_fixed_update(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)
queue_redraw() → None
property render_dirty: bool
clear_children()
destroy()
property destroying: bool
call_deferred(method: collections.abc.Callable[..., Any], *args: Any) → None
property app
property tree: simvx.core.scene_tree.SceneTree
property physics
property physics_2d
__getitem__(key: str)
classmethod get_properties() → dict[str, simvx.core.descriptors.Property]
__repr__()