Testing Mobile Template PY

This project contains a template for mobile test automation.

Project technologies

The project is developed with the Python programming language and the Appium mobile automation framework.

• Python 3.11.6

• Appium Server 2.1.3

• PIP 23.3.1

The following are the dependencies of the project:

Dependency	Version
Allure Behave	2.13.2
Allure Python Commons	2.13.2
Appium Python Client	3.1.0
Behave	1.2.6
Selenium	4.14.0

Project structure

testing-mobile-template
│ behave.ini
│ run.sh
│ requirements.txt └─apps
| | *.apk
| | *.app
| | *.ipa
└─features
| | _*.feature
| | environment.py
| └─pages
| | | base_page.py
| | └─android
| | | | *_page.py
| | └─ios
| | | | *_page.py
| └─steps
| | base_steps.py
| | click_steps.py
| | compound_steps.py
| | send_keys_steps.py
| | swipe_steps.py
| | validation_steps.py
└─utils
| | mobile_capabilities.py
| | mobile_driver.py

Setting up the project before execution

The mobile_capabilities.py file located in the /utils path must be modified, adding the capabilities for each device used for testing.

ios-simulator: {
"platformName": "iOS",
"platformVersion": "16.1",
"automationName": "XCUITest",
"deviceName": "iPhone 14"
}
ios-real: {
"platformName": "iOS",
"platformVersion": "15.4",
"automationName": "XCUITest",
"deviceName": "iPhone XS Max",
"udid": "XXXXXXXX-XXXXXXXXXXXXXXXX",
"xcodeOrgId": "XXXXXXXXXX",
"xcodeSigningId": "iPhone Developer"
}
android-simulator: {
"platformName": "Android",
"appium:avd": "Android_8",
"automationName": "UiAutomator2",
"appium:deviceName": "Android_8"
}
android-real: {
"platformName": "Android",
"automationName": "UiAutomator2",
"appium:deviceName": "XXXXXXXXX"
}

Executing the project

The project is executed by running the run.sh file in Terminal.

> /run.sh

Or by running the following command in Terminal

behave -f allure -o ./reports/report/ ./features/

Generating report

By default, the allure report folder will be generated in the ROOT_DIR/reports/report path.

If you want to change the report path, modify the ./reports/report line in the run.sh file or the behave command.