README.md

Demo Test Automation Project - Trello

Navigation

• Tech stack
• How to run tests
  • Run Tests Locally
    • Precondition
    • 1. Run tests and reporting using terminal
    • 2. Run tests and reporting using gradle tasks in IntelliJ IDEA
  • Run tests remotely using Jenkins
    • 1. Setup environment with Docker
    • 2. Setup Jenkins job
    • 3. Run Jenkins job and get results
  • Run tests remotely using Github Actions
• Reporting with Allure
• Telegram Notification

Tech stack

This project is written in Java
Selenide is used for UI tests and Rest-Assured for API

Selenoid is employed to launch browsers within Docker containers, providing an isolated testing environment.

Allure Report is integrated into the project to generate comprehensive test run reports,

Gradle is used for automated project build.

JUnit 5 is used as a unit testing library.

Jenkins runs the tests.

Upon completion of a test run, notifications are dispatched via a Telegram bot for seamless communication.

How to run tests

Run tests locally

Precondition

For success tests running you need to add 2 files apiAuth.properties and uiAuth.properties and put them into src/test/resources

apiAuth.properties example

uri=https://api.trello.com
key=83048509344509c03449583
token=ATTA36da17ab56cd0frje48b9b7c43dd5b6311a7e7baf977e7a9b35c54mfk78a246B69F7CD

uiAuth.properties example

userLogin[email protected]
userPassword=somePassword

There are 2 options to run tests locally

1. Run tests and reporting using terminal

To run tests put this command in terminal

gradle clean {task}

Task options:

test, regressionTests, apiTests, uiTests

To open Allure report

allure serve build/allure-results

2. Run tests and reporting using gradle tasks in IntelliJ IDEA

To open Allure report run task allure-serve

Run tests remotely using Jenkins

1. Setup environment with Docker

• Put files docker-compose.yaml and browsers.json in target directory.
• Download necessary docker images

docker pull {image}

• Open terminal in this directory and run the command

docker-compose up -d

Docker container should be created and running

2. Setup Jenkins job

Create Freestyle project and create following steps:

Source Code Management

Create file for telegram notification

Create file apiAuth.properties

Create file uiAuth.properties

Gradle script

clean test
-Dbrowser=${BROWSER}
-DbrowserVersion=${BROWSER_VERSION}
-DbrowserSize=${BROWSER_SIZE}
-DbrowserMobileView="${BROWSER_MOBILE}"
-DremoteDriverUrl=https://user1:1234@${REMOTE_DRIVER_URL}/wd/hub/
-DvideoStorage=https://${REMOTE_DRIVER_URL}/video/
-Dthreads=${THREADS}

Allure Report

Telegram notification post-build task

3. Run Jenkins job and get results

Run tests remotely using Github Actions

The GitHub workflow has been set up, and the Allure Report is published on GitHub Pages. Example: Allure Report.

Reporting with Allure

Main Page

Suite view

Behavior view

Filtering by tag

Telegram Notification