This repository contains a project with automated website testing framework using Python and Selenium WebDriver. This framework is designed to test the functionalities of the demoqa.com. It is inspired by a YouTube course project Автоматизация тестирования python by ARTVLAD | Automation Craft

• Installation
• Usage
• Project Structure
• Requirements
• License
• Author
• Notes

1. Clone the repository:

git clone https://github.com/torshin5ergey/automation_qa.git

2. Navigate to the project directory:

cd automation-qa

3. Install the required dependencies using pip:

pip install -r requirements.txt

1. Update the conftest.py file to initialize the WebDriver instance with the appropriate driver using webdriver-manager.
2. Run the tests using pytest:

pytest

$PROJECT_ROOT
├── data # Module for storing test data
│   └── data.py # Data class definition
├── generator # Module for generating test data
│   └── generator.py # Script for generating mock data for tests
├── locators # Module for storing element locators
│   └── elements_page_locators.py # Locators for elements on test pages
├── pages # Module for defining page objects
│   ├── base_page.py # BasePage class for common page functionalities
│   └── element_page.py # Page classes for individual web pages
├── tests # Module for test cases
│   └── elements_test.py # Test cases for website elements
├── conftest.py # Pytest configuration and fixture definition
├── README.md # This README file
└── requirements.txt # File containing project dependencies

• data: Test data classes.
• generator: Generating fake data script.
• locators: Web pages element locators.
• pages: Page objects representing individual web pages.
• tests: Test cases for website objects.
  • elements_test.py: Test cases for Elements pages.
    • TestTextBox Text Box page test case. It fills all text fields with fake user data and asserts that the filled data matches the expected data for each field.
    • TestCheckBox Check Box page test case. It toggles all items, selects a random checkboxes, retrieves the checked checkboxes, and asserts that the selected checkboxes match the output result.
    • TestRadioButton Radio Button page test case. It selects all radio buttons and asserts that the expected output matches the selected radio button for each option.
    • TestWebTable Web Table page test cases. It contains: Add person, Search person by random its random data, Edit person's random data field, Delete person by email, Change number of rows displayed per page.
    • TestButtonsPage Buttons pge test cases. It contains: Double-click button, Right-click (context-click) button, Left-click dynamic ID button.
    • TestLinksPage Links page test cases. It contains: Simple link (200 OK, to home), Dynamic simple link (200 OK, to home), Created link (201 Created), No content (204 No Content),Moved link (301 Moved Permanently), Bad request link(400 Bad Request), Unauthorized link (401 Unauthorized), Forbidden link (403 Forbidden), Not Found link (404 Not Found).
    • TestUploadDownload Upload and Download files page test cases. It contains: Upload and download file.
    • TestDynamicProperties Dynamic Properties page test case. It contains: The "Enable After 5 Seconds" button becomes clickable within a timeout, The color of the "Color Change" button changes after a 5 seconds delay, The "Visible After 5 Seconds" button becomes visible after a 5 seconds delay. This tests may not work correctly with the webdriver_manager library, because in that case the test startup will be much later than the change of dynamic properties.
• conftest.py: Pytest configuration file and fixture definitions.
• requirements.txt: Project dependencies.

• Test creation algorythm:
  1. Create locators.
  2. Create page and load locators.
  3. Create page methods.
  4. Create test class and its methods.
• Page Object Model (POM) is used in this project. POM is a design pattern in test automation that separates the logic of testing from the logic of managing web elements. Each web page is represented as a Page Object containing methods to interact with page elements (e.g., clicks, text inputs, etc.) and properties to access these elements. By implementing POM, tests become more stable, readable, and easily maintainable. It reduces code duplication and enhances modularity, allowing development and testing teams to efficiently handle changes in the application.
• Faker library is used in this project. Faker is a Python library that generates fake data, such as names, addresses, and phone numbers. By using Faker you can populate data, create mock user profiles, and simulate realistic scenarios without relying on actual sensitive or confidential information. Faker enhances test automation by providing a convenient way to generate diverse and customizable test data, improving test coverage and accuracy.
• Requests library is used for making HTTP requests (GET, POST), checking response content.
• Automated file download check. The process of checking and creating a file. This methos is used in the download_file method of the UploadDownloadPage class in the elements_page.py file. It creates a temporary .jpg file, then decodes base64 data and writes it to the file starting from the JPEG header. After this, the existence of the file is checked using os.path.exists, and the file is deleted after successful verification.
• This project uses Google style inspired docstrings.

• pytest (8.2.0 used)
• selenium (4.20.0 used)
• webdriver-manager (4.0.1 used)
• Faker (25.1.0 used)
• requests (2.31.0 used)

This project is licensed under the MIT License.

Sergey Torshin @torshin5ergey