README.md

openedx-app-test

This repository serves as a collection of automated end-to-end test cases for the Open edX mobile applications designed for both Android and iOS platforms. It aims to ensure the reliability and functionality of the Open edX mobile apps by automating the testing process and providing a comprehensive suite of test cases.

Installations

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

iOS(Simulator)

• Xcode with command line tools

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 the 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/openedx-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