https://github.com/burhanh/automaton-v9
Automation testing framework (UI, Visual) - an example. Based on Python, OpenCV, Selenium, and Unittest
https://github.com/burhanh/automaton-v9
automation opencv python selenium unittest
Last synced: 12 months ago
JSON representation
Automation testing framework (UI, Visual) - an example. Based on Python, OpenCV, Selenium, and Unittest
- Host: GitHub
- URL: https://github.com/burhanh/automaton-v9
- Owner: BurhanH
- License: mit
- Created: 2019-01-10T22:53:24.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-06-19T01:21:51.000Z (about 1 year ago)
- Last Synced: 2025-06-19T02:27:29.142Z (about 1 year ago)
- Topics: automation, opencv, python, selenium, unittest
- Language: Python
- Homepage:
- Size: 202 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Automaton-v9
Automation testing framework (UI, Visual) - an example. Based on Python, OpenCV (Open Source Computer Vision Library), Selenium, and Unittest
[](https://github.com/BurhanH/automaton-v9/blob/master/LICENSE)
[](https://app.codacy.com/app/BurhanH/automaton-v9?utm_source=github.com&utm_medium=referral&utm_content=BurhanH/automaton-v9&utm_campaign=Badge_Grade_Settings)
## 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
```text
-- 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](https://www.python.org/downloads/)
2) Install and configure [virtualenv](https://packaging.python.org/guides/installing-using-pip-and-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](https://github.com/BurhanH/automaton-v9#how-to-prepare-environment) section
## Technology stack and helpful info
[Python 3.7](https://docs.python.org/3.7/)
[virtualenv](https://packaging.python.org/guides/installing-using-pip-and-virtualenv/)
[GitHub, cloning repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository)
[OpenCV, Open Source Computer Vision Library](https://opencv.org/)
[unittest](https://docs.python.org/3.7/library/unittest.html)
[Selenium](https://www.selenium.dev/documentation/en/)
[Firefox](https://www.mozilla.org/en-US/firefox/)
[geckodriver](https://github.com/mozilla/geckodriver/releases)
[Chrome](https://www.google.com/chrome/)
[ChromeDriver](https://chromedriver.chromium.org/downloads)
### Actual result (taken screenshot)
### Visual searching result for google template (google logo)
### Visual searching result for buttons template
### Visual searching result for search template
