Skip to content

KdeEcoTest proposal: Adding support for windows

Project abstract

I aim to provide windows support for KdeEcoTest. It will be done using win32gui module of python. This will provide support for Windows and ensure compatibility, allowing the same scripts to be used for testing on both GNU/Linux and Windows platforms.

Proposal

Adding py32gui will enable KdeEcoTest to be used on Windows operating systems, which will fix issue !7. For windows systems, py32gui will replace python-libxdo. The files at KdeEcoTest/core will be updated.

import win32gui
gcompris_handle = win32gui.FindWindow(None, "GCompris")
win32gui.SetActiveWindow(gcompris_handle)
win32gui.SetForegroundWindow(gcompris_handle)
import win32gui 
import win32con
gcompris_handle = win32gui.FindWindow(None, "GCompris")
win32gui.SetWindowPos(gcompris_handle, win32con.HWND_TOP, x, y, width, height, win32con.SWP_SHOWWINDOW)
import win32api
win32api.SetCursorPos((x, y))
import win32api
win32api.mouse_event(win32con.MOUSEEVENTF_LEFTDOWN, 0, 0, 0, 0)
time.sleep(0.005)
win32api.mouse_event(win32con.MOUSEEVENTF_LEFTUP, 0, 0, 0, 0)

import win32gui
win32gui.SendMessage(hwnd, win32con.WM_LBUTTONDOWN, win32con.MK_LBUTTON, win32api.MAKELONG(x, y))
win32gui.SendMessage(hwnd, win32con.WM_LBUTTONUP, 0, win32api.MAKELONG(x, y))

Timeline

Week Start End Milestone
1 17/01/24 24/01/24
  • Understanding the current codebase, list the areas that are unclear and request clarification in KdeEcoTest room
  • List the functions of xdotool used in the current codebase and document their equivalents from the win32gui module.
2 25/01/24 31/01/24
  • Introduce an additional layer of abstraction to ensure that test scripts utilize the same function regardless of the platform, whether it's kwin for GNU/Linux or pywin32 for Windows. This will be done in coordination with other contributors who are working on kwin integration.
3 01/02/24 07/02/24 Add support for window management:
  • Window Resizing
  • Window Positioning
  • Target Window Selection
4 & 5 08/02/24 21/02/24 Add support for emulating mouse inputs:
  • Left Mouse Click
  • Cursor Positioning
  • Mouse Dragging
6 & 7 22/02/24 06/03/24 Add support for emulating keyboard inputs:
  • A single keydown
  • A stream of characters as input
8 & 9 07/03/24 20/03/24
  • Testing using the test scripts from KdeEcoTest/tests
  • Adding Documentation
10 21/03/24 30/03/24 Bug Fixing and Finalizing

References / relevant background info

  • I was tasked with issue !11, which I completed.(KdeEcoTest)
  • Added GitHub-action workflow for welcoming first-time-contributor on raising the PR.(CircuitVerse

How to reach you

email: amartya.3654@gmail.com element: @camartya:matrix.org

Note: we don't need (yet) your personal address/phone, it will be necessary only if you succeed the SoK and wants to get goodies.

/cc @teams/season-of-kde

Edited by Amartya Chakraborty