test(pytest) Import squish as a python module. (#11421)

#66
This commit is contained in:
Vladimir Druzhinin 2023-07-10 17:55:10 +02:00 committed by GitHub
commit 13af133ab6
25 changed files with 317 additions and 0 deletions

153
test/e2e/README.md Normal file
View File

@ -0,0 +1,153 @@
# Status desktop ui-tests
# Setup:
Skip any of the steps, if sure that you have the correct version of the required tool.
## All Platforms
### 1. Install Qt 5.15
https://doc.qt.io/qt-6/get-and-install-qt.html
### 2. Setup Squish License Server
https://hackmd.io/@status-desktop/HkbWpk2e5
### 3. Install PyCharm
Download and install:
https://www.jetbrains.com/pycharm/download/other.html
Please, select any build depending on OS, but NOT an Apple Silicon (dmg)
How to: https://www.jetbrains.com/help/pycharm/installation-guide.html
## Windows
### 4. Install Squish
https://status-misc.ams3.digitaloceanspaces.com/squish/squish-7.1-20230301-1424-qt515x-win64-msvc142.exe
### 5. Install Python
Download and install for all users: https://www.python.org/ftp/python/3.10.11/python-3.10.11-amd64.exe
### 6. Install Requirements
```
YOUR_PYTHON_PATH/pip3.exe install -r ./requirements.txt
```
### 7. Setup Environment Variables
Add in system environment variables:
```
SQUISH_DIR=PATH_TO_THE_SQUISH_ROOT_FOLDER
PYTHONPATH=%SQUISH_DIR%/lib;%SQUISH_DIR%/lib/python;%PYTHONPATH%
```
RESTART PC
### 8. Verify environment variables
```
echo %SQUISH_DIR%
echo %PYTHONPATH%
```
### 9. Setup Python for Squish
Download 'PythonChanger.py' in %SQUISH_DIR%:
https://kb.froglogic.com/squish/howto/changing-python-installation-used-squish-binary-packages/PythonChanger.py
```
YOUR_PYTHON_PATH/python3.10 SQUISH_DIR/PythonChanger.py --revert
YOUR_PYTHON_PATH/python3.10 SQUISH_DIR/PythonChanger.py
```
- Replace "YOUR PYTHON PATH" on to Python3.10 file location path
- Replace "SQUISH DIR" on to the Squish root folder path
### 10 Test:
Executing tests located in 'test_self.py' file
```
pytest ./tests/test_self.py
```
Executing test 'test_import_squish' from 'test_self.py' file
```
pytest ./tests/test_self.py::test_import_squish
```
Executing all tests with 'import_squish' in test name
```
pytest -k import_squish
```
Executing all tests with tag 'self'
```
pytest -m self
```
## Linux
### 4. Install Squish
https://status-misc.ams3.digitaloceanspaces.com/squish/squish-7.1-20230222-1555-qt515x-linux64.run
### 5. Install Python
```bash
sudo apt-get install software-properties-common
```
```bash
sudo add-apt-repository ppa:deadsnakes/ppa
```
```bash
sudo apt-get update
```
```bash
sudo apt-get install python3.10
```
```bash
sudo apt install python3-pip
```
### 6. Install Requirements
```bash
sudo pip3 install -r ./requirements.txt
```
### 7. Setup Environment Variables
```bash
gedit ~/.profile
```
```
export SQUISH_DIR=PATH_TO_THE_SQUISH_ROOT_FOLDER
export PYTHONPATH=$SQUISH_DIR/lib:$SQUISH_DIR/lib/python:$PYTHONPATH
export LD_LIBRARY_PATH=$SQUISH_DIR/lib:$SQUISH_DIR/python3/lib:$LD_LIBRARY_PATH
```
RESTART PC
## Mac
### 4. Install Squish
https://status-misc.ams3.digitaloceanspaces.com/squish/squish-7.1-20230328-1608-qt515x-macaarch64.dmg
### 5. Install Python
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
```bash
brew update --auto-update
brew install wget
brew install python@3.10
```
### 6. Install Requirements
```bash
sudo pip3 install -r ./requirements.txt
```
### 7. Setup Environment Variables
```bash
touch ~/.zprofile
open ~/.zprofile
```
```
export SQUISH_DIR=PATH_TO_THE_SQUISH_ROOT_FOLDER
export PYTHONPATH=$SQUISH_DIR/lib:$SQUISH_DIR/lib/python:$PYTHONPATH
export LD_LIBRARY_PATH=$SQUISH_DIR/lib:$LD_LIBRARY_PATH
```
RESTART PC
## Linux or MAC:
### 8. Verify environment variables
```bash
echo $USERNAME
echo $PYTHONPATH
echo $LD_LIBRARY_PATH
```
### 9. Setup Python for Squish
https://kb.froglogic.com/squish/howto/changing-python-installation-used-squish-binary-packages/
```bash
brew install wget
wget -O $SQUISH_DIR/PythonChanger.py https://kb.froglogic.com/squish/howto/changing-python-installation-used-squish-binary-packages/PythonChanger.py
python3.10 $SQUISH_DIR/PythonChanger.py --revert
python3.10 $SQUISH_DIR/PythonChanger.py
```
### 10 Test:
```bash
echo "Executing tests located in 'test_self.py' file"
pytest ./tests/test_self.py
echo "Executing test 'test_import_squish' from 'test_self.py' file"
pytest ./tests/test_self.py::test_import_squish
echo "Executing all tests with 'import_squish' in test name"
pytest -k import_squish
echo "Executing all tests with tag 'self'"
pytest -m self
```
For more info, read: https://docs.pytest.org/en/latest/getting-started.html

View File

@ -0,0 +1,14 @@
import logging
from . import testpath, timeouts
_logger = logging.getLogger(__name__)
try:
from ._local import *
except ImportError:
exit(
'Config file: "_local.py" not found in "./configs".\n'
'Please use template "_.local.py.default" to create file or execute command: \n'
rf'cp {testpath.ROOT}/configs/_local.py.default {testpath.ROOT}/configs/_local.py'
)

View File

@ -0,0 +1,7 @@
import os
from scripts.utils.system_path import SystemPath
LOCAL_RUN = False
APP_DIR = SystemPath(os.getenv('APP_DIR')

View File

@ -0,0 +1,3 @@
LOCAL_RUN = True
APP_DIR = None

View File

@ -0,0 +1,15 @@
import os
from datetime import datetime
from scripts.utils.system_path import SystemPath
ROOT: SystemPath = SystemPath(__file__).resolve().parent.parent
# Test Directories
RUN_ID = os.getenv('RUN_DIR', f'run_{datetime.now():%d%m%Y_%H%M%S}')
TEMP: SystemPath = ROOT / 'tmp'
RESULTS: SystemPath = TEMP / 'results'
RUN: SystemPath = RESULTS / RUN_ID
# Driver Directories
SQUISH_DIR = os.getenv('RUN_DIR')

View File

@ -0,0 +1,3 @@
# Timoeuts before raising errors
UI_LOAD_TIMEOUT_MSEC = 5000

17
test/e2e/conftest.py Normal file
View File

@ -0,0 +1,17 @@
import pytest
pytest_plugins = [
'tests.fixtures.path',
]
@pytest.fixture(scope='session', autouse=True)
def setup_session_scope(
run_dir,
):
yield
def pytest_exception_interact(node):
"""Handles test on fail."""
pass

View File

17
test/e2e/driver/__init__.py Executable file
View File

@ -0,0 +1,17 @@
import squishtest # noqa
import configs
imports = {module.__name__: module for module in [
# import any modules from driver folder
]}
def __getattr__(name):
if name in imports:
return imports[name]
return getattr(squishtest, name)
squishtest.testSettings.waitForObjectTimeout = configs.timeouts.UI_LOAD_TIMEOUT_MSEC
squishtest.setHookSubprocesses(True)

0
test/e2e/gui/__init__.py Normal file
View File

View File

View File

@ -0,0 +1 @@

View File

@ -0,0 +1,9 @@
import logging
_logger = logging.getLogger(__name__)
class MainWindow:
def __init__(self):
pass

View File

@ -0,0 +1,5 @@
from .component_names import *
from .main_window_names import *
from .messages_names import *
from .onboarding_names import *
from .settings_names import *

View File

7
test/e2e/pytest.ini Normal file
View File

@ -0,0 +1,7 @@
[pytest]
log_format = %(asctime)s.%(msecs)03d %(levelname)7s %(name)s %(message).5000s
log_cli = true
log_cli_level = INFO
markers =
self: framework tests

View File

@ -0,0 +1 @@
pytest==7.4.0

View File

View File

View File

View File

@ -0,0 +1,14 @@
import logging
import os
import pathlib
import shutil
_logger = logging.getLogger(__name__)
class SystemPath(pathlib.Path):
_accessor = pathlib._normal_accessor # noqa
_flavour = pathlib._windows_flavour if os.name == 'nt' else pathlib._posix_flavour # noqa
def rmtree(self, ignore_errors=False):
shutil.rmtree(self, ignore_errors=ignore_errors)

View File

0
test/e2e/tests/fixtures/__init__.py vendored Normal file
View File

38
test/e2e/tests/fixtures/path.py vendored Normal file
View File

@ -0,0 +1,38 @@
import logging
import re
import pytest
import configs
from scripts.utils.system_path import SystemPath
_logger = logging.getLogger(__name__)
@pytest.fixture
def generate_test_data(request):
test_path, test_name, test_params = generate_test_info(request.node)
configs.testpath.TEST = configs.testpath.RUN / test_path / test_name
_logger.info(f'Start test: {test_name}')
def generate_test_info(node):
pure_path = SystemPath(node.location[0]).parts[1:]
test_path = SystemPath(*pure_path).with_suffix('')
test_name = node.originalname
test_params = re.sub('[^a-zA-Z0-9\n\-_]', '', node.name.strip(test_name))
return test_path, test_name, test_params
@pytest.fixture(scope='session')
def run_dir():
keep_results = 5
run_name_pattern = 'run_????????_??????'
runs = list(sorted(configs.testpath.RESULTS.glob(run_name_pattern)))
if len(runs) > keep_results:
del_runs = runs[:len(runs) - keep_results]
for run in del_runs:
SystemPath(run).rmtree(ignore_errors=True)
_logger.info(f"Remove old test run directory: {run.relative_to(configs.testpath.ROOT)}")
configs.testpath.RUN.mkdir(parents=True, exist_ok=True)
_logger.info(f"Created new test run directory: {configs.testpath.RUN.relative_to(configs.testpath.ROOT)}")

13
test/e2e/tests/test_self.py Executable file
View File

@ -0,0 +1,13 @@
import logging
import pytest
import driver
_logger = logging.getLogger(__name__)
@pytest.mark.self
def test_import_squish():
_logger.info(str(driver.__dict__))
driver.snooze(1)