The FoxCommerce E2E UI automation test framework. Used for automating UI test scenarios across Store Admin and Storefront.
-
Install Java:
sudo apt-get install default-jdk -
Install SBT:
echo "deb https://dl.bintray.com/sbt/debian /" | sudo tee -a /etc/apt/sources.list.d/sbt.list sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 642AC823 sudo apt-get update sudo apt-get install sbt -
Install Scala:
sudo apt-get install scala -
Install Allure-CLI:
sudo apt-add-repository ppa:yandex-qatools/allure-framework sudo apt-get update sudo apt-get install allure-commandline -
Install Chrome:
Go download it!
-
Get Chromedriver:
Get the latest version at https://sites.google.com/a/chromium.org/chromedriver/downloads
-
Run configuration script:
make configure-linux
-
Install Java:
brew cask install java -
Install SBT:
brew install sbt -
Install Scala:
brew install scala -
Install Allure-CLI:
brew tap qatools/formulas brew install allure-commandline -
Install Chrome:
You already have it :)
-
Get Chromedriver:
Get the latest version at https://sites.google.com/a/chromium.org/chromedriver/downloads
-
Run configuration script:
make configure
Environment against which tests should run are configured through env variables: With the following values tests will run in Chrome, against FoxComm stage, with TPG storefront.
export ENV=stage
export API_URL__TESTS=https://stage.foxcommerce.com/api
export ASHES_URL=https://stage.foxcommerce.com/admin
export STOREFRONT_URL=https://stage.foxcommerce.com/perfect-gourmet
export STOREFRONT=perfect-gourmet
export SUITE=local
export BROWSER=chrome
export ALLURE_CONFIG=/home/userName/.../ui-automation/allure.properties
Once variables are configured, you can run them launching the following .sh script from project root dir:
./test_run.sh {X server} {test suite}
Parameters:
- You can run tests either in a browser using your current graphical server -
b, or using Xvfb (virtual graphical server) -x. I'd suggest using Xvfb - it grants faster runtime and browser won't bother you popping up on each test failure. - Test suite parameter. Available options are:
regression-- full test runashesstorefront-tpgproducts-- anything related to products and SKUs. Storefront part is run against TPG storefront.
Example:
./test_run.sh x regression
Once test run is complete, report will be generated and opened in default browser.
To open report again, run this from dir that contains allure-report dir:
allure report open
Reports generated from CI test runs are saved here: http://automation.foxcommerce.com/
Each environment can have up to 5 reports latest reports.
- Main Language: Java
- Frameworks: TestNG, Selenide
- API Interactions: okhttp
- Build Tool: SBT
- Reporting: Allure
┌──────────────┐ implements ┌───────────────┐
[wrappers, helpers, screenshoter] │ ConciseAPI ├────────────────►│ ScreenShooter │
└──────┬────┬──┘ └───────────────┘
│ │
│ │
│ └────────────────────────┐
extends │ │ extends
▼ ▼
┌─────────────┐ ┌──────────────┐
[all kind of configurations] │ BaseTest │ │ BasePage │
└──────┬──────┘ └──┬─────────┬─┘
┌─────────────┐ │ │ │
│ Phoenix API │◄─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐ │ │ │
└─────────────┘ ¦ │ │ │
¦ │ extends extends │ │ extends
▼ ▼ ▼ ▼
┌──────────────┐ ┌─────────────┐ ┌─────────────┐
│ DataProvider │ │ PageClass │ │ PageClass │
[fulfills test preconditions] └─────┬────────┘ └─┬───────────┘ └───────┬─────┘
▲ │ ¦ ¦
┌──────────────┐ │ │ ¦ ¦
│ bin/payloads ├────────┘ │ ¦ ¦
└──────────────┘ │ ¦ ¦
├─────────┐ ¦ ¦
│ extends │ ¦ ¦
┌─ │ ▼ ▼ ¦
│ │ ┌─────────────┐ ¦
│ │ │ TestClass │ ¦
┌────────────┐ │ extends │ └─────────────┘ ¦
│ testng.xml │◄───┤ ▼ ¦
└────────────┘ │ ┌─────────────┐ ¦
[test suite] │ │ TestClass │◄─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─┘
│ └─────────────┘ ┌ ┐
└─ │ page object │
│ is created in testMethod() │
│ inside of a TestClass │
└ ┘
└───────────────────┘
│ Event Listeners
┌───────────────┐
│ RetryAnalyzer │
└───────────────┘