Parallel Web Automation Template Using Cucumber, Selenium, and JUnit.

Example.web.mp4

This project is a Java test automation framework made using Selenium, Cucumber, and JUnit. It uses the Page Object Model (POM) design pattern for better test maintainability and readability.

For parallel testing capabilities, this repo leverages the help of CourgetteJVM library.

This repo also has a DockerFile for setting up JDK 17 and Allure reporter which you can run your tests from.

The scenarios on Example.feature file uses the Swag Labs website. You can change the target website via the environment variable MAIN_URL located at .env file that you must create.

Table of Contents

• Prerequisites
• Project Structure
• Setup
• Running Tests
• Reporting
• License

Prerequisites

Before setting up the project, ensure you have the following installed:

• Java JDK 17 or higher
  • Set up JAVA_HOME environment variable to point to the JDK home directory
• Selenium Server (Grid)

If using Docker:

• Docker Engine

If not using Docker:

• Allure Reporter
• Bash shell

Project Structure

The project is structured as follows:

Parallel Automation
    ├── README.md                           # README file
    ├── LICENSE                             # License file
    ├── .env                                # Environment variables (make your own locally)
    ├── .env.example                        # Environment variables template
    ├── build.gradle                        # Build script for this Gradle project
    ├── run_test.sh                         # Bash script to run test and generate report
    ├── build
    │   ├── allure-results/                 # Raw report data
    │   ├── allure-report/                  # Final HTML report
    │   └── cucumber.json                   # Cucumber JSON file
    │
    └── src
        └── test
            ├── java
            │   │
            │   ├── page_objects
            │   │   ├── BasePage.java       # Abstract class containing common page methods
            │   │   ├── pages/              # Contains page objects
            │   │   └── fragments/          # Contains page objects for smaller elements like widgets, components, etc.
            │   │
            │   ├── step_definitions/       # Contains Cucumber step definitions
            │   │
            │   └── utils
            │       ├── Constants.java      # List of fixed constants
            │       ├── Helpers.java        # List of helper methods
            │       ├── drivers/            # Contains Appium Drivers
            │       ├── hooks/              # Contains Cucumber Hooks
            │       └── runners/            # Contains Cucumber Test Runners
            │
            └── resources/
                ├── allure.properties       # Allure configs
                ├── .test_data              # Test data (make your own locally)
                ├── .test_data.example      # Test data template
                └── features/               # Contains Cucumber feature files

Setup

1. Clone the Repository:

   git clone https://github.com/your-username/your-repo-name.git
   cd your-repo-name

2. Wait for gradle to install its dependencies.
3. Selenium Server setup (Optional)
   • Run this command to start Selenium server in standalone mode.

      java -jar <PATH_TO_SELENIUM_JAR>/selenium-server.jar standalone

4. Environment and Test Data variables setup.
   • There are 2 files named .env.example and .test_data.example (located in src/test/resources/)
   • Base both of your .env and .test_data files from here.
   • Setting values:

     USE_GRID= #Set to "true" if you want to use Selenium Grid
     SELENIUM_GRID_URL= #(OPTIONAL) Set the Selenium Grid URL if USE_GRID=true
     MAIN_URL= #URL of the website you want to test

5. If you're using Docker, follow the Docker setup steps after this.

Docker setup (if you're running using Docker)

1. Turn on Docker Engine.
2. Open terminal, go to the root of your project
3. Build the docker image from the DockerFile by running:

   docker build -t <name_of_your_image> .

4. After the image is built, run:

   docker run -v $(pwd):/app -it --rm <name_of_your_image>

   This will mount our working directory as a volume inside our Docker container with all proper dependencies installed.

Running Tests

To run the test on 1 parallel thread, run:

bash run_test.sh

To run the test on multiple parallel threads, run:

bash run_test.sh <NUMBER_OF_THREADS>

You can also set the number of threads in src/test/java/utils/runners/WebRunner.java.

Reporting

After test execution, you can find the reports in the build/ folder. Allure reports and cucumber.json file are stored here.

License

Distributed under the MIT License. See LICENSE for more information.

---

© Bryan Ramaputra Purnama (2024). All rights reserved.