Just like WinActivate in AutoHotkey, this module lets you easily activate and focus an opened window.
Examples
frompyWinActivateimportwin_activate, win_wait_active# Activate window with partial winTitle string.win_activate(window_title="Book1", partial_match=True)
# Activate window with exact winTitle string.win_activate(window_title="Book1.xlsx - Excel", partial_match=False)
# Wait for the specified window to be active.# You can pass an exception for a popup window's title. If not needed leave as None or skip entirely.# Note: works only with a full titlewin_wait_active(win_to_wait=Book1.xlsx-Excel, exception="potential popup window", message=False)
Changes
1.2.0
Refactored win_activate()
It now takes window_title and partial_match(T/F) as arguments instead of window and titlematchmode(0/1)
1.1.1
Changed function names to follow PEP8 guidelines
Changed get_app_list() to not use mutable deafults
Added argument to win_wait_active() to turn off the message while waiting. Its True by default.
Changed some function argument names to be more desriptive.
Special thanks to reddit user u/JohnnyJordaan with help on the code simplification.
The Tidelift Subscription provides access to a continuously curated stream of human-researched and maintainer-verified data on open source packages and their licenses, releases, vulnerabilities, and development practices.