Application

Use the Application object to launch your application and establish a connection with the Slint UI testing framework.

Construct the Application with the following parameters:

• args: The elements of the command line to lauch. This will be passed to subprocess.Popen.
• ssh_destination: Set to a user@hostname like string to launch the application on a remote host via SSH. The Application takes care of setting up the entire ssh command line and assumes that the program that’s the first element of args exists on the remote machine. If None, the application is launched locally without SSH.
• env: A dictionary of optional environment variables as key/value pairs to set when launching.
• launch_timeout: A value in seconds that Application will wait for the program to launch.

Use Application with Python’s with statement ↗ to ensure propery lifecycle management of the sub-process and the network connection from within Python.

import slint_testing

with slint_testing.Application(["/path/to/app"]) as aut:
   # ...

# After leaving the above block, the application is terminated.

Properties

first_window

first_window: Optional[Window]

Read-only property that holds a reference to the first visible Slint Window. Use this as the entry point to obtain UI elements and test their state and interaction.

windows

windows: List[Window]

Read-only property that returns a list of all visible Slint windows. Pick an element from the returned list and use this as the entry point to obtain UI elements and test their state and interaction.

Methods

wait

wait(timeout = None) -> int | None

Wait until the AUT exits. Returns the exit code. Use this when you instructed the process to terminate through your own means.