simvx.core.testing.input_sim

InputSimulator – simulate keyboard/mouse/touch input for headless testing.

Module Contents

Classes

InputSimulator

Simulate input events for headless testing.

Data

__all__

API

simvx.core.testing.input_sim.__all__

[‘InputSimulator’]

class simvx.core.testing.input_sim.InputSimulator

Simulate input events for headless testing.

Works by directly manipulating the Input singleton state, the same mechanism that platform adapters (GLFW, SDL3) use.

Usage: from simvx.core.input import Key sim = InputSimulator() sim.press_key(Key.SPACE) runner.advance_frames(1) sim.release_key(Key.SPACE)

press_key(key) → None

Simulate a key press. Accepts Key enum or int.

release_key(key) → None

Simulate a key release.

tap_key(key) → None

Press and release a key in one call (instant).

press_mouse(button: int = 1, position: tuple[float, float] | None = None) → None

Simulate mouse button press, optionally at a position.

release_mouse(button: int = 1) → None

Simulate mouse button release.

click(position: tuple[float, float], button: int = 1) → None

Click at a screen position (press + release).

move_mouse(x: float, y: float) → None

Move the mouse cursor to (x, y).

scroll(dx: float = 0.0, dy: float = -1.0) → None

Simulate scroll wheel. dy < 0 = scroll down, dy > 0 = scroll up.

touch_down(finger_id: int = 0, position: tuple[float, float] = (0, 0), pressure: float = 1.0) → None

Simulate a touch press (finger down).

touch_move(finger_id: int = 0, position: tuple[float, float] = (0, 0), pressure: float = 1.0) → None

Simulate a touch move (finger drag).

touch_up(finger_id: int = 0, position: tuple[float, float] = (0, 0)) → None

Simulate a touch release (finger up).

reset() → None

Reset all input state to defaults.