pyautotest

pyautotest supports UI/API automated testing.

java implementation: javautotest

English | 中文

Get Start

pyauto.py

pyautotest supports multi-device concurrency. Just set all the tests in dict tests, notice that the device should be found in device.yml

from app.core.parallel import run
from app.main import Pyauto

tests = {
    'XiaoMi 6': {
        'test module':
            [
                'android/test_example.py',
                'android/test_sample.py::TestAndroidSample'
            ],
        'service address': '',
        'pytest args': [],
    },
    'iPhone7': {
        'test module': '',
        'service address': '127.0.0.1:4723',
        'pytest args': [],

    },
    'Chrome88-win': {
        'test module': ['smoke chrome/test_example.py'],
        'pytest args': [],
    },
}

tests_dir = 'tests'
pytest_args = ()
pytest_kwargs = {}
separate = False
allure_report = True
clean = True


pyauto = Pyauto(
    tests=tests, tests_dir=tests_dir,
    separate=separate, allure_report=allure_report, clean=clean,
    args=pytest_args,
    **pytest_kwargs
)


def start_test(d):
    pyauto.start_test(d)


if __name__ == '__main__':
    amount = len(pyauto.params)
    args = [(p, ) for p in pyauto.params]
    run(start_test, args, amount)

commandline

• --test: test module
• --device: test device

--test/--device will directly replace tests, and just testing on --device. To change some info of device, use environment variable instead.

python pyauto.py --test <module> --device <device>

--help to show all pyautotest options. But pyautotest actually accepts all pytest arguments. check pytest --help for pytest.

$python pyauto.py --help

Dependencies

• pytest
• allure-pytest
• PyYAML
• requests

app/browser

• Appium-Python-Client

windows

• appium/appium-windows-driver
• pywinauto/pywinauto [optional]
• yinkaisheng/Python-UIAutomation-for-Windows [optional]

macOS

• appium/appium-for-mac
• appium/appium-mac-driver [<10.15]
• appium/appium-mac2-driver [>=10.15]

Other tools [optional]

pytest

• pytest-bdd
• pytest-xdist
• pytest-cov
• pytest-html
• pytest-django

performance

• locust
• jmeter

Example

from app.core.drivers.mobile import Mobile

settings = {
        'bluetooth': (MobileBy.IOS_CLASS_CHAIN, '**/XCUIElementTypeCell[`label == "蓝牙"`]'),
}
bt = {
    'back_button': (MobileBy.IOS_CLASS_CHAIN, '**/XCUIElementTypeButton[`label == "设置"`]'),
    'bluetooth_switch': (MobileBy.IOS_PREDICATE, 'type == "XCUIElementTypeSwitch" AND label == "蓝牙"'),
}
page = Mobile(driver) # 'settings' page

print(page.bluetooth.text)
page.bluetooth.click()

page.wait(1)
page.container(bt)  # switch to 'bt' page
assert page.bluetooth_switch.found() is True
page.bluetooth_switch.click()
page.back_button.click()

page.wait(1).container(settings)  # switch back to 'settings' page
page['bluetooth'].click()

page.wait(1).container(bt)
page['bluetooth_switch'].found.click() # click if element found