README.md

edx-app-test

Automated testing for edX Android and iOS mobile applications.

Using Docker

• docker for Mac
• docker for Ubuntu

Manual Installations

• node
• appium
• pytest
• pytest-html
• Appium-Python-Client
• PyYAML

iOS(Simulator)

• Xcode with command line tools
• libimobiledevice
• ios_deploy

Android(Phone/Tablet/Simulator)

• Android SDK

Don't forget to set environment variables for adb, platform-tools etc.*

Setup

• connect/start Android/iOS Device/Simulator

• Browse tests/ directory

• Rename 'user_preferences_sample.yml' to 'user_preferences.yml' and set following values,

  • set `Android' to execute test cases on Android or 'iOS' to execute on iOS

    target_environment: Android
    

  • set above selected target_environment's OS Version(of specific running device/simulator) like below

    ios_platform_version: iOS emulator version 
    
    android_platform_version: Android device/emulator version
    

  • set valid credentials to login

    login_user_name: username 
    
    login_password: password 
    

• install edx(iOS/Android) app on specific device/simulator

Run

• Check out/download the source code, browse its directory

    git clone https://github.com/openedx/edx-app-test
  

• pytest - to run all test cases

• pytest -v tests/android/tests/ --html=report.html --self-contained-html - to run all android test screens

• pytest -v tests/ios/tests/ --html=report.html --self-contained-html - to run all ios test screens

• pytest -v <test case name> --self-contained-html to run specific test case

• pytest -v <test case name> --html=report.html --self-contained-html to run specific test case and create html report at end of execution