fortrace.utility.desktop_environments.Windows package

Submodules

fortrace.utility.desktop_environments.Windows.Windows module

class fortrace.utility.desktop_environments.Windows.Windows.Windows(desktop_env: DesktopEnvironmentType, qemu_monitor_session: QEMUMonitorSession)[source]

Bases: DesktopEnvironment, ABC

Abstract class to implement general Windows behavior.

focus_application(application: GenericApplication)[source]

Bring the given application into focus so that it can receive input commands.

Parameters:

application – application object to focus

Returns:

login(username: str, password: str | None)[source]

Perform a login for the given user.

Parameters:

  • username – name of the user to login

  • password – password of the given user or None if there is none

Note

This call blocks until the desktop environment is ready to receive input.

minimize_all_unfocused()[source]

Minimize all except the active desktop window (restores all windows on second stroke).

open_application(application_type: ApplicationType, application_name: str, **kwargs) → GenericApplication[source]

Open the specified application and move focus to it.

Implementation has to add application to list of applications.

Parameters:

  • application_type – Type of application to filter for correct sub-factory

  • application_name – Name of the application to open

  • **kwargs – Desktop environment specific arguments, e.g. fortrace.utility.desktop_environments.Windows.Windows

Returns:

handle to newly opened application

run_command(command: str, run_as_administrator: bool = False)[source]

Opens Windows’ run dialog box and executes the provided command.

Is NOT aware of which application is potentially opened

Parameters:

  • command – command to be executed

  • run_as_administrator – should command be executed with administrative privileges

system_power_down()[source]

Powers down the system via the desktop environment.

This method uses the Windows left-bottom corner menu to power down the system.

fortrace.utility.desktop_environments.Windows.Windows_10 module

class fortrace.utility.desktop_environments.Windows.Windows_10.Windows10(qemu_monitor_session: QEMUMonitorSession)[source]

Bases: Windows

Explicit class to interact with Windows 10 domains.

fortrace.utility.desktop_environments.Windows.Windows_11 module

class fortrace.utility.desktop_environments.Windows.Windows_11.Windows11(qemu_monitor_session: QEMUMonitorSession)[source]

Bases: Windows

Explicit class to interact with Windows 11 domains.

Module contents