burhanh / automaton-v14

Automation testing framework (UI) - an example. Based on Java, Junit, Cucumber, Selenium, PageFactory

Automaton-v14

Automation testing framework (UI) - an example. Based on Java, Junit, Cucumber, Selenium, PageFactory

Quick review

This is an almost fully functional testing framework based on Java programming language, Cucumber, and Selenium.

Main points:

1. Uses POM (Page Object Model), PageFactory, DriverFactoryUtil.
2. Automatically adds a screenshot into a test report if there is a failure in a scenario.
3. Supports by default 2 most popular browsers, you may extend this behavior via adding new driver into DriverFactoryUtil class.
4. Automatically by default generates a test report in HTML format, you may extend or change this behavior in RunCucumberTest class.

Requirements

JDK 12, Junit 4.12, Cucumber 4.2.6,
Selenium 3.141.59, gekodriver 0.26.0, chromedriver 77.0.3865.40,
Mozilla Firefox 70.0, Google Chrome 77.0.3865.120,
Maven (software project management)

Project structure

-- automaton-v14
   |-- .gitignore
   |-- .travis.yml
   |-- LICENSE
   |-- pom.xml
   |-- README.md
   `-- src
       `-- test
           `-- java
               `-- cucumberselenium
                  |-- RunCucumberTest.java
                  |-- Steps.java
                  |-- DriverFactoryUtil.java
               `-- pages
                  |-- Page.java
                  |-- DuckDuckGoPage.java
                  |-- DuckDuckGoResultPage.java
           `-- resources
               `-- cucumberselenium
                  |-- DuckDuckGoTest.feature

How to prepare an environment

1. Install Java
2. Install and configure IDE
3. Create a project folder
4. Clone or copy (download) the repository into the project folder
5. Install Firefox or/and Chrome web browser/s
6. Download, extract and move geckodriver/chromedriver into a specific folder
7. Point proper path to drivers folder (step 6) in pom.xml file properties section (lines 17-18)

How to run tests

1. Open a terminal session
2. Move to the project folder
3. Execute mvn clean test - will run tests for Firefox browser (by default)
4. Execute mvn clean test -D browser=chrome - will run tests for Chrome browser
5. Check a test report (by default a test report generates into src/target/SystemTestReport/html folder)

How to add tests

1. Create a feature file in src/test/resources/cucumberselenium folder
2. Add content into the feature file (follow Gerkin syntax language)
3. Add step definitions into Steps.java class
4. Add pages (follow an example for DuckDuckGo)
5. Run tests

How to debug / troubleshoot

Under construction

automaton-v14's Issues

Add more tests

Add more tests with different variants of use

Replace travis CI to Git Hub Actions

Make the solution easy to use

Make the solution easy to use.
e.g.:
Add tags and how to use them
A user should able just add new feature file, extend or add steps definition into Steps or create a new class with steps, extend or add more pages.
Add a schema about POM, PageFactory, DriverFactory into readme file.