Package: ui-automation-tools-mbt
Web and mobile automated testing using a model based approach in PythonThis provides a starting point for automating web and mobile applications in Python using the pytest
framework. The tests are documented as drawio flow diagrams of action and validation steps.Required dependencies/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"(selenium, appium)brew tap AdoptOpenJDK/openjdk && brew install --cask adoptopenjdk8(selenium, appium)brew install usbmuxd --HEAD(appium)brew install libimobiledevice --HEAD(appium)brew install ideviceinstaller --HEAD(appium)brew install carthage(appium)brew install ios-webkit-debug-proxy(appium)brew install mitmproxy(selenium, appium)brew install wget(selenium, appium)brew install pyenv(selenium, appium)PYTHON_CONFIGURE_OPTS="--enable-framework" pyenv install 3.8.10 && pyenv global 3.8.10 && echo export PATH="$(pyenv root)/shims:$PATH" >> ~/.bash_profile && . ~/.bash_profile && pip install pipenv(selenium, appium)curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.1/install.sh | bash && . ~/.bash_profile && nvm install --lts(appium)npm install -g appium(appium)npm install -g appium-doctor(appium)graphwalker-cli(selenium, appium)chromedriverand/orgeckodriver(selenium,appium)Pip InstallationIn the terminal cd into the root of your main test projectIn the terminal runpip install ui-automation-tools-mbtLocal SetupClone this repoIn the terminal cd into the root of your main test projectIn the terminal runpip install -e path_to_uiautomationtoolsUsageHelpersimport uiautomationtools.helpers.decorator_helpers as dh
import uiautomationtools.helpers.dictionary_helpers as dh
import uiautomationtools.helpers.directory_helpers as dh
import uiautomationtools.helpers.list_helpers as ls
import uiautomationtools.helpers.string_helpers as shPytestThis class contains all the model reading and execution functionality - a proper test model is required.
There are class properties that can be set from your SomeBasePytest class. You can also add your own test
methods that will run before executing the test model steps. Thetargetis either a browser or mobile
device configurable through a pytest.ini.import pytest
from uiautomationtools.pytest import PytestHelper

class SomeBasePytest(PytestHelper):

    @pytest.fixture
    def test_app(self, target):
        self.app = PytestHelper.app = App(...)Selenium and AppiumCustom selenium actions in addition to the standard methods and properties.from uiautomationtools.selenium import SeleniumExtended

driver = SeleniumExtended(browser=browser)
element = driver.find_element_explicitly('button#buttonId', 'css selector')Custom appium actions in addition to the standard methods and properties. Depending on the
platform specified in the desired capabilities, an android or ios driver will be returned.from uiautomationtools.selenium import appium_factory

driver = appium_factory('http://localhost:4723/wd/hub', desired_capabilities)
selector = '//android.widget.TextView[@content-desc="something"]'
element = driver.find_element_explicitly(selector, 'xpath')ValidationsThis class validates dom scrapes and computes a list of mismatch dictionaries.from uiautomationtools.validations import Validations

validations = Validations(driver)
refs = validations.build_references_selenium()
driver.refresh()
mismatches = validations.validate_references(stored_references=refs)
mismatches => [{'key': 'class', 'd1': 'pre_refresh', 'd2': 'post_refresh'}, ...]Directory structureThis package requires the following base structure for the project..
├── credentials                         # Optional - credentials
│   └── credentials.json                # Optional - credentials as json
├── drivers                             # Required - webdrivers
│   ├── {platform}_chromedriver         # Required - darwin, linux, etc
│   └── {platform}_geckodriver          # Required - darwin, linux, etc
├── src                                 # Required - source code
│   └── app                             # Required - app under test (page objects/API's)
│       ├── ...                         # Required - app framework code
│       └── selectors                   # Required - selectors
│           └── selectors.py            # Required - selectors as a dictionary
├── tests                               # Required - test files
│   ├── data                            # Optional - test data
│   │   └── data.json                   # Optional - test data as json
│   └── app                             # Required - app under test (same name as /src/app)
│       ├── models                      # Required - test models
│       │   └── feature                 # Optional - feature of test models
│       │       └── test_file.drawio    # Required - test model as .drawio
│       └── ui_automation               # Required - test code
│           └── feature                 # Optional - feature of test code
│               └── test_file.py        # Required - pytest test 
│                                                    (same name as the 
│                                                     corresponding model file)
└── validations                         # Optional - validation data
    └── feature                         # Optional - feature of validations
        └── test_file.json              # Optional - validation data as json 
                                                     (same name as the 
                                                      corresponding model file)