{"id":14978840,"url":"https://github.com/startrug/selenium-python-framework","last_synced_at":"2025-07-02T02:04:36.079Z","repository":{"id":37720955,"uuid":"223257506","full_name":"startrug/selenium-python-framework","owner":"startrug","description":"Selenium WebDriver with Python","archived":false,"fork":false,"pushed_at":"2022-12-08T07:43:51.000Z","size":507,"stargazers_count":149,"open_issues_count":1,"forks_count":110,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-13T08:29:18.562Z","etag":null,"topics":["allure","automated-testing","page-object-model","pytest","selenium-python","selenium-webdriver"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/startrug.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-11-21T20:16:39.000Z","updated_at":"2025-03-24T19:26:59.000Z","dependencies_parsed_at":"2022-07-12T16:43:49.915Z","dependency_job_id":null,"html_url":"https://github.com/startrug/selenium-python-framework","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/startrug/selenium-python-framework","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/startrug%2Fselenium-python-framework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/startrug%2Fselenium-python-framework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/startrug%2Fselenium-python-framework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/startrug%2Fselenium-python-framework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/startrug","download_url":"https://codeload.github.com/startrug/selenium-python-framework/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/startrug%2Fselenium-python-framework/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263061405,"owners_count":23407606,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["allure","automated-testing","page-object-model","pytest","selenium-python","selenium-webdriver"],"created_at":"2024-09-24T13:58:30.595Z","updated_at":"2025-07-02T02:04:36.052Z","avatar_url":"https://github.com/startrug.png","language":"Python","readme":"![Last commit](https://img.shields.io/github/last-commit/startrug/selenium-python-framework?color=9cf\u0026logo=git)\n![GitHub top language](https://img.shields.io/github/languages/top/startrug/selenium-python-framework?color=blue)\n\n# :warning: Important notice\nI would like to inform everyone who is interested in this project that I decided to go back to working on it.\nI 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.\nThank you guys for forking and giving stars for this project. I appreciate it a lot!\n\n# Test Automation Project\n\nThis 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.\nThe collection of tests contains:\n- user login tests (correct / incorrect login and password)\n- hotels search tests\n- flights search tests\n- tours search tests\n- transfers search tests\n\n## Project Structure\nHere you can find a short description of main directories and it's content\n- [locators](locators) - there are locators of web elements in locators.py grouped in classes\n- [pages](pages) - there are sets of method for each test step (notice: some repeated methods were moved to [functions.py](utils/functions.py))\n- [tests](tests) - there are sets of tests for main functionalities of website\n- [reports](reports) - if you run tests with Allure, tests reports will be saved in this directory\n- [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\n\n## Project Features\n- framework follows page object pattern\n- data-driven tests - in most tests the option of loading data from an xlsx file has been implemented\n- logger has been implemented in each step of test cases, e.g.\n```\n@allure.step(\"Setting destination to '{1}'\")\n    def set_destination(self, destination):\n        self.logger.info(f\"Setting destination: {destination}\")\n        self.driver.find_element(*SearchHotelsFormLocators.destination_inactive).click()\n```\n![Logs screenshot](https://raw.githubusercontent.com/startrug/phptravels-selenium-py/screenshots/logger.png \"Logs screenshot\")\n- 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)\n- 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.\n```\n@pytest.fixture()\ndef setup(request):\n    driver = DriverFactory.get_driver(\"chrome\")\n```\n\n\n## Getting Started\n\nTo 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.\nRun the command below in terminal:\n\n```\n$ pip install -r requirements.txt\n```\n\n## Run Automated Tests\n\nTo run selected test without Allure report you need to set pytest as default test runner in Pycharm first\n```\nFile \u003e Settings \u003e Tools \u003e Python Integrated Tools \u003e Testing\n```\nAfter 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. \n\n## Generate Test Report\n\nTo generate all tests report using Allure you need to run tests by command first:\n```\n$ pytest --alluredir=\u003creports directory path\u003e\n```\nAfter that you need to use command:\n```\n$ allure serve \u003creports directory path\u003e\n```\n![Allure report screenshot](https://raw.githubusercontent.com/startrug/phptravels-selenium-py/screenshots/allure_report.png \"Allure report screenshot\")\n\nReport is generated in Chrome browser.\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstartrug%2Fselenium-python-framework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstartrug%2Fselenium-python-framework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstartrug%2Fselenium-python-framework/lists"}