Point Test Automation project

This is the test automation project for Point test cases. This project includes the infrastructure needed to run all the test cases properly.

Technologies

The automated tests are build in Javascript and NodeJs. The framework is "WebdriverIO" and it uses also "Selenium" to interact with the web browser. There are some other dependencies as "wdio-html-reporter" for the HTML reports. As the project to test was build in Electron, the following dependencies are also used : electron-chromedriver, wdio-electron-service and geckodriver.

Requirements

Before running the automated tests, the user needs to have installed :

• NodeJS (It's recommended to install NVM to install NPM. Recommended version: 16.7.0)
• Point app installed
• Secret Words to login with your user

Installation

1. Download this project
2. Run command "npm install" in the root of this project
3. Run command "export PASS_ENCRYPT_AUTOMATION=passwordhere" --> Ask to Alexis or Brian for the password
4. Run command "npm run decrypt-credentials", this will generate a JSON file in the project that contains the sensitive information
5. Run any of the following commands according to the test cases that you want to execute :
   • "npm run test-macos-local" => Run all the tests (MacOS)
   • "npm run test-linux" => Run all the tests (MacOS)
   • "npm run simple-test-linux" => Just one test (MacOS)
   • "npm run simple-test-macos" => Just one test (MacOS)
6. Wait for the execution to be finished and don't touch anything in your machine. That can cause failures in the test if it loses the focus.

Reports

An HTML file with the test execution report is generated automatically and it's saved after every execution in tests/reports/html-reports/suite-0-0/0-0/report.html

Run in Github Actions

There are 2 jobs in Github Actions to run the tests remotely, the URL is : https://github.com/pointnetwork/point-automation/actions One of the jobs is to run the tests in Linux and the other one to run them in MacOS. These are the steps to run them :

1. Go to Github Actions URL
2. Click on any of the jobs on the left side Actions navigation bar
3. Click on "Run Workflow" button
4. Select the branch where the YML file is (Main branch is the one selected by default)
5. Select the branch where your tests are (Main branch is the one selected by default)
6. Click on "Run Workflow" button
7. Click on the new generated build
8. Wait for the tests execution to finish

Electron

As Point is an electron app that also opens a Firefox browser when the nodes are up, we have to open 2 browsers to interact with them :

• 1 Google Chrome instance with a special configuration to open Point
• 1 Firefox instance with a special configuration to load the same profile than Point app

The tests were developed to support both instances at the same time just specifying with which instance we want to interact.

Known Issues :

• Point App should be installed as a pre-condition before running the tests, if it's not installed the tests will fail
• Tests are not supported to run in Windows yet
• For some tests a lot of complex and high-level processes are executed, so it can take some time to finish all the test executions.
• Sometimes the tests fails if we have Point opened before running the test. Take care of this and close Point before running the tests.