qxf2-page-object-model

We've implemented some version of this framework at several clients. In all cases, this framework helped us write automated tests within the first week of our engagement. We hope you find this framework useful too!

Looking for ways to automate your UI and API tests quickly and effectively? You've come to the right place. By harnessing AI and code auto-generation capabilities, we've developed solutions that significantly decrease the time needed to create a fully functional test suite. For further information, please refer to the following links.

• Qxf2's Gen AI test automation service
• Qxf2's API test automation service

Setup

The setup for our open-sourced Python test automation framework is fairly simple. We have documented the setup instructions in detail so even beginners can get started.

The setup has four parts:

1. Prerequisites
2. Setup for GUI/Selenium automation
3. Setup for Mobile/Appium automation
4. Setup for API automation
5. Setup for Windows Automation

Above links redirects to our github wiki pages.

Optional steps for integrating with third-party tools:

• Integrate our Python test automation framework with Testrail
• Integration with ReportPortal
• Integrate our Python GUI/web automation framework with BrowserStack
• Integrate our Python Selenium automation framework with Sauce Labs
• Integrate our Python GUI/web automation framework with LambdaTest
• Run Python integration tests on Jenkins
• Run Python integration tests on CircleCI
• Post Python automation test results on Slack
• Email pytest report with Gmail

Repository details

Directory structure of our current Templates

   ./

   |_ conf: For all configurations files
   
   |_ core_helpers: Contains our web app and mobile app helpers and DriverFactory  

   |_ endpoints: Contains our Base Mechanize, different End Points, API Player, API Interface

   |_ integrations: Contains cross-browsers (BrowserStack, SauceLabs, Lambdatest), reporting tools (TestRail, Tesults) and reporting channel integrations (Slack, Gmail) 

   |_ log: Log files for all tests

   |_ page_objects: Contains our PageFactory, different Page Objects examples

   |_ screenshots: For screenshots

   |_ tests: Put your tests here

   |_ utils: All utility modules (ssh_util, compare csv, compare images, Base Logger, etc) are kept in this folder

   |_ conftest.py: Configuration file to add different fixtures used in py.test

   |_ .env and .env.remote: For credential details. Refer env_conf and env_remote file and rename it to .env and .env_conf. 

For more details about the structure, refer our wiki page here

COMMANDS FOR RUNNING TESTS

a) General Command

python -m pytest [options]

Options

• --app_url
  Runs against a specific URL.
  Example:
  python -m pytest --app_url http://YOUR_localhost_URL
  This will run against your local instance.

• --remote_flag
  Runs tests on Browserstack/LambdaTest/Sauce Labs.
  Example:
  python -m pytest -s --remote_flag Y --app_url https://qxf2.com

• --browser all
  Runs the tests against multiple browsers.
  Example:
  python -m pytest --browser all
  This will run each test against the list of browsers specified in the conf/browser_os_name_conf.py file (e.g., Firefox and Chrome).

• --ver / --os_name / --os_version
  Runs against different browser versions, OS platform and OS versions.
  Example:
  python -m pytest --ver 120 --os_name windows --os_version 11 --remote_flag y
  This will run each test with default browser (chrome) and provided combination (browser version 120 windows 11)

• -h
  Displays help for more options.
  Example:
  python -m pytest -h

• -k
  Runs tests matching the given substring expression.
  Example:
  python -m pytest -k table
  This will trigger tests that match the pattern, such as test_example_table.py.

• --slack_flag
  Posts pytest reports on the Slack channel.
  Example:
  python -m pytest --slack_flag Y -v > log/pytest_report.log
  This will send the pytest-report on configued slack channel at the end of test run.

• -n
  Runs tests in parallel.
  Example:
  python -m pytest -n 3 -v
  This will run three tests in parallel.

• --tesults
  Reports test results to Tesults.
  Example:
  python -m pytest tests/test_example_form.py --tesults Y

• --interactive_mode_flag
  Runs the tests interactively.
  Example:
  python -m pytest tests/test_example_form.py --interactive_mode_flag Y
  This option allows the user to pick the desired configuration to run the test from a menu displayed.

  Note: If you wish to run the test in interactive mode on Git Bash for Windows, set your bash alias by adding the following command to .bashrc:
  alias python='winpty python.exe'

• --summary
  Summarizes the pytest results in an HTML report.
  Example:
  python -m pytest -k example_table --summary y
  Note: You need to provide your OPENAI_API_KEY using export OPENAI_API_KEY=<your-key>.

b) Specific Commands

• Standalone Test
  python -m pytest tests/test_example_form.py

• Run Against Specific Browser
  python -m pytest tests/test_example_form.py --browser Chrome

• API Test
  python -m pytest tests/test_api_example.py
  Note: Ensure the sample cars-api is available at qxf2/cars-api repository before running the API test.

• Mobile Test Run on Browserstack/Sauce Labs
  python -m pytest tests/test_mobile_bitcoin_price --mobile_os_version <android version> --device_name <simulator> --app_path <.apk location on local> --remote_flag Y
  Note: For running tests on Browserstack/Sauce Labs, update the Browser_Plaform, Username and AccessKey in .env.remote from your Browserstack/Sauce Labs account. Refer our wiki page for more details: Integrate our Python Selenium automation framework with Cloud Services

• Run Test along with Tesults
  python -m pytest tests/test_example_form.py --tesults Y
  Note: For running the test along with Tesults, update the .env file with target_token and run the above command. Refer env_conf file for configuration.

• Run Tests along with ReportPortal
  python -m pytest -k example --reportportal
  Note: For running the test along with ReportPortal, update the .env file with ReportPortal credential details and run the above command. Refer our wiki page for more details: Integration with ReportPortal

• Run Tests along with TestRail
  python -m pytest -k example --testrail_flag Y --test_run_id <testrail run id>
  Note: For running the test along with TestRail, update the .env file with TestRail credential details and run the above command. Refer our wiki page for more details: Integrate our Python test automation framework with Testrail

• Post test results on Slack
  pytest -k example_form --slack_flag y -v > log/pytest_report.log
  Note: For setup and other details, refer our wiki page: Post Python automation test results on Slack

• Email pytest report with Gmail
  pytest -s -v --email_pytest_report y --html=log/pytest_report.html
  Note: For setup and other details, refer our wiki page: Email pytest report with Gmail

ISSUES?

a) If Python complains about an "Import" exception, please 'pip3 install $module_name'

b) If you don't have drivers set up for the web browsers, you will see a helpful error from Selenium telling you where to go and get them

c) If your are using firefox 47 and above, you need to set up Geckodriver. Refer following link for setup: htt