Selenium with Java and BDD on Mitigram website

Mitigram is a digital platform for trade financing. More info at https://mitigram.com/

Overview

• The repository contains browser based regression tests written in Ghekrin style(Given-When-Then) using Cucumber Java library
• The Gherkin style feature tests are located at src/test/resources/com/mitigram/web/features
• Pre-requisites to run the tests: Chrome browser, JDK installed
• To execute all the tests, open commandline -> go to this directory -> run ./gradlew(Linux or Mac OS) or gradlew(Windows OS)
• After running the tests, the generated test reports can be viewed at build/reports/tests/test/index.html and Cucumber generated test reports can be viewed at build/cucumber-reports

Priority of regression tests

• The priority of the regression tests in this repository are based on the critical functionalities(which I think) of the application
• Based on the criticality, they have been classified as 'high' or 'low' priority using Cucumber tags and these tags used in TestNG suite XML configuration
• 'high' priority tests defined in this repository means that these tests test the critical flow of the application and must pass as part of quality check
• 'low' priority tests defined in this repository means that these tests test functionality that are 'good to have' but may not block a release

Running high priority tests

To run only high priority tests use the command use the Gradle task highPriorityRegressionTests E.g., In Linux or Mac, open command-line and use this command

./gradlew highPriorityRegressionTests

Running low priority tests

To run only low priority tests use the command use the Gradle task lowPriorityRegressionTests E.g., In Linux or Mac, open command-line and use this command

./gradlew lowPriorityRegressionTests

For Windows, open command-line like powershell and use this command

gradlew lowPriorityRegressionTests

Build system, libraries used

• Gradle is used as the build system. Build file - build.gradle
• TestNG library is used as the test library because it provides better way of handling parallel execution, order of execution
• TestNG suite XML configuration located at src/test/resources/com/mitigram/web/testngrunners files have been used in the build.gradle file to run tests based on priority
• Cucumber library is used for writing BDD style specification tests
• Selenium library is used for browser based automation
• Webdrivermanager library is used for managing Selenium driver executables for various browsers
• Hamcrest is used as the assertion library
• Apache Commons configuration is used to retrieve configuration. Currently, only type of browser can be configured through src/test/resources/com/mitigram/web/browser.properties file. This library can be further used to use system properties, XML configuration and more when needed

Test framework

• Page object model is used
• The pages package defines the functionality to be performed in a web page
• The framework package defines the Selenium based framework to perform actions in the browser
• The regressiontests package provides the glue code for Cucumber tests based on priority

Browsers supported

• Chrome, Firefox, Edge browsers are supported
• The browser can be configured through browser.properties located at src/test/resources/com/mitigram/web/browser.properties file

Running tests in IDE

To run tests in any Java based IDE,

1. Make sure TestNG IDE plugin is installed(mostly IDEs have this plugin by default)
2. Go to the glue code directory
3. Right-click the file you would like to run based on priority and select a context action which says like Run tests