burhanh / automaton-v9

Automation testing framework (UI, Visual) - an example. Based on Python, OpenCV, Selenium, and Unittest

Automaton-v9

Automation testing framework (UI, Visual) - an example. Based on Python, OpenCV (Open Source Computer Vision Library), Selenium, and Unittest

Requirements

Python 3.7.*, Selenium 3.141.0, Unittest, Open CV 4.1.*
virtualenv (virtual environment manager),
Firefox 75.0, geckodriver 0.26.0,
Chrome 81.0.4044.122, chromedriver 81.0.4044.69

Project structure

-- automaton-v9
   |-- .gitattributes
   |-- .gitignore
   |-- LICENSE
   |-- README.md
   |-- requirements.txt
   |-- utils.py
   |-- bad_template.png
   |-- google_template.png
   |-- buttons_template.png
   |-- search_template.png
   `-- tests
       |-- test.py
   `-- results_example
       |-- home_page.png
       |-- google_template_result.png
       |-- buttons_template_result.png
       |-- search_template_result.png

How to prepare environment

1. Install Python
2. Install and configure virtualenv
3. Clone or copy (download) the repository into your virtual environment
4. Activate virtual environment, move to automaton-v9 folder, and execute command pip install -r requirements.txt
5. Install Firefox
6. Download, extract and move geckodriver into bin folder for Mac/Linux, Scripts folder for Windows on virtual environment

How to run tests

1. Open terminal window
2. Move to virtual environment folder
3. Activate virtual environment
4. Move to automaton-v9 folder
5. Execute python -m unittest discover tests "*.py" -v

How to run test/s in Chrome browser

Go to any UI scenario and change the value of the BROWSER variable from firefox to chrome.
Note! Before execution read steps 5-6 from How to prepare environment section

Technology stack and helpful info

Python 3.7
virtualenv
GitHub, cloning repository
OpenCV, Open Source Computer Vision Library
unittest
Selenium
Firefox
geckodriver
Chrome
ChromeDriver

Actual result (taken screenshot)

Visual searching result for google template (google logo)

Visual searching result for buttons template

Visual searching result for search template