Skip to content
Testudos Testudos Documentation

testudos.api.app_control

testudos.api.app_control

Application control: start and stop the application under test.

Requires an active session (setup_client). AUT binaries and profiles are configured in the engine (GUI, CLI/daemon addAUT, etc.), not via Python. Use select_aut to pick a profile.

select_aut

def select_aut(name: str) -> None

Select a named AUT profile (binary and workdir from engine persisted config).

Requires an active session (call setup_client first).

Raises:

  • TestudosError - If no session is active or engine reports failure.

start_app

def start_app(aut_name: str | None = None) -> None

Ask the engine to start the application under test.

If aut_name is set, the engine switches to that profile before starting (equivalent to select_aut then start_app()).

The AUT path must be configured for that profile unless overridden elsewhere. Requires an active session (call setup_client first).

Raises:

  • TestudosError - If no session is active or engine reports failure.

stop_app

def stop_app() -> None

Ask the engine to stop the application under test.

Requires an active session (call setup_client first).