[POC] test(gui): gui test automation with appium

[saw-jan]

Part of #861

How to Run the Tests

1. Get the dependencies:

   sudo apt install xclip python3-pyatspi
   
   cd test/gui
   python3 -m venv venv --system-site-packages
   source venv/bin/activate
   pip install -r requirements.txt

2. Run the opencloud server
3. Run the webdriver
   Get the selenium-webdriver-at-spi: git clone https://invent.kde.org/sdk/selenium-webdriver-at-spi.git

   cd <desktop-repo-root>test/gui
   source venv/bin/activate
   FLASK_APP=<path-to-selenium-webdriver-at-spi>/selenium-webdriver-at-spi.py FLASK_ENV=production flask run --port 4723 --no-reload

4. Create test config file: test/gui/config.ini dir

   [DEFAULT]
   APP_PATH=<full-path-to>/opencloud # desktop app path
   BACKEND_HOST=https://localhost:9200

Important

desktop client MUST be built with qtbase that has QSpiAccessibleBridge implementation
Check: strings <path-to>/libQt6Gui.so | grep -i QSpiAccessibleBridge

5. Run the test:

   cd <desktop-repo-root>test/gui
   source venv/bin/activate
   behave --tags=smoke features/add-account/account.feature

[prashant-gurung899]

I faced the following issue while running the FLASK APP:

To resolve it, I had to change the following code in selenium-websdriver-at-spi.py file:

major, minor, _micro = pyatspi.Atspi.get_version()

to:

version = getattr(pyatspi.Atspi, "_version", "0.0.0")
major, minor, *_ = map(int, version.split("."))

[prashant-gurung899]

I faced the following issue while running the FLASK APP:

To resolve it, I had to change the following code in `selenium-websdriver-at-spi.py` file:

major, minor, _micro = pyatspi.Atspi.get_version()

to:

version = getattr(pyatspi.Atspi, "_version", "0.0.0")
major, minor, *_ = map(int, version.split("."))

I upgraded my ubuntu from 22 to ubuntu 24 and this issue is not there anymore.