Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/startrug/selenium-python-framework

Selenium WebDriver with Python
https://github.com/startrug/selenium-python-framework

allure automated-testing page-object-model pytest selenium-python selenium-webdriver

Last synced: 3 days ago
JSON representation

Selenium WebDriver with Python

Awesome Lists containing this project

README 

        
![Last commit](https://img.shields.io/github/last-commit/startrug/selenium-python-framework?color=9cf&logo=git)

![GitHub top language](https://img.shields.io/github/languages/top/startrug/selenium-python-framework?color=blue)



# :warning: Important notice

I would like to inform everyone who is interested in this project that I decided to go back to working on it.

I am planning to implement some major changes like separating framework from tests, adding sample tests for another website than phptravels.com and removing tests implemented before.

Thank you guys for forking and giving stars for this project. I appreciate it a lot!



# Test Automation Project



This is my first test automation project based on Selenium-Webdriver with Python. It's still developing package of automated tests of [phptravels.net](https://phptravels.net) demo website.

The collection of tests contains:

- user login tests (correct / incorrect login and password)

- hotels search tests

- flights search tests

- tours search tests

- transfers search tests



## Project Structure

Here you can find a short description of main directories and it's content

- [locators](locators) - there are locators of web elements in locators.py grouped in classes

- [pages](pages) - there are sets of method for each test step (notice: some repeated methods were moved to [functions.py](utils/functions.py))

- [tests](tests) - there are sets of tests for main functionalities of website

- [reports](reports) - if you run tests with Allure, tests reports will be saved in this directory

- [utils](utils) - this directory contains files responsible for configuration, e.g. driver_factory.py for webdriver management or [read_xlsx.py](utils/read_xlsx.py) for reading input data from xlsx files included in project



## Project Features

- framework follows page object pattern

- data-driven tests - in most tests the option of loading data from an xlsx file has been implemented

- logger has been implemented in each step of test cases, e.g.

```

@allure.step("Setting destination to '{1}'")

    def set_destination(self, destination):

        self.logger.info(f"Setting destination: {destination}")

        self.driver.find_element(*SearchHotelsFormLocators.destination_inactive).click()

```

![Logs screenshot](https://raw.githubusercontent.com/startrug/phptravels-selenium-py/screenshots/logger.png "Logs screenshot")

- the ability to easily generate legible and attractive test reports using Allure (for more look [Generate Test Report](README.md#generate-test-report) section below)

- tests can be run on popular browsers - Chrome and Firefox are preconfigured in DriverFactory class and both can be select in [conftest.py](tests/conftest.py), e.g.

```

@pytest.fixture()

def setup(request):

    driver = DriverFactory.get_driver("chrome")

```



## Getting Started



To enjoy the automated tests, develop the framework or adapt it to your own purposes, just download the project or clone repository. You need to install packages using pip according to requirements.txt file.

Run the command below in terminal:



```

$ pip install -r requirements.txt

```



## Run Automated Tests



To run selected test without Allure report you need to set pytest as default test runner in Pycharm first

```

File > Settings > Tools > Python Integrated Tools > Testing

```

After that you just need to choose one of the tests from "tests" directory and click "Run test" green arrow. There are 2 versions of test in each test file. In general test cases you can easily modify test inputs. Data-driven tests base on xlsx files from [utils](utils) directory. 



## Generate Test Report



To generate all tests report using Allure you need to run tests by command first:

```

$ pytest --alluredir=

```

After that you need to use command:

```

$ allure serve 

```

![Allure report screenshot](https://raw.githubusercontent.com/startrug/phptravels-selenium-py/screenshots/allure_report.png "Allure report screenshot")



Report is generated in Chrome browser.