Why test frameworks structure execution in Selenium Python - Framework Benefits

Framework Mode - Why test frameworks structure execution

Folder Structure

selenium-python-project/
├── tests/
│   ├── test_login.py
│   ├── test_checkout.py
│   └── __init__.py
├── pages/
│   ├── login_page.py
│   ├── checkout_page.py
│   └── __init__.py
├── utils/
│   ├── driver_factory.py
│   ├── wait_helpers.py
│   └── __init__.py
├── config/
│   ├── config.yaml
│   └── __init__.py
├── reports/
│   └── latest_report.html
├── conftest.py
└── pytest.ini

Test Framework Layers

• Driver Layer: Manages browser setup and teardown using Selenium WebDriver (e.g., driver_factory.py).
• Page Objects: Encapsulate page elements and actions (e.g., login_page.py).
• Test Cases: Actual test scripts using PyTest in tests/ folder.
• Utilities: Helper functions like waits, logging, and data handling.
• Configuration: Environment settings, URLs, credentials stored in config.yaml.

Configuration Patterns

Use a config.yaml file to store environment URLs, browser types, and credentials. Load these settings in conftest.py to provide fixtures for tests.

Example config.yaml snippet:

environment:
  url: "https://testsite.com"
  browser: "chrome"
credentials:
  username: "testuser"
  password: "password123"

This allows easy switching between test, staging, and production environments without changing code.

Test Reporting and CI/CD Integration

Use PyTest's built-in reporting with plugins like pytest-html to generate readable HTML reports saved in the reports/ folder.

Integrate the test suite with CI/CD tools (e.g., GitHub Actions, Jenkins) to run tests automatically on code changes. Reports help quickly see pass/fail results.

Best Practices

• Clear Separation: Keep page objects, tests, and utilities separate for easy maintenance.
• Reusable Components: Use page objects and utility functions to avoid repeating code.
• Configurable Settings: Store environment and browser info outside code for flexibility.
• Explicit Waits: Use waits to handle dynamic page loading and avoid flaky tests.
• Readable Reports: Generate clear test reports to understand results quickly.

Self Check

Where in this folder structure would you add a new page object for the user profile page?

Key Result

Test frameworks structure execution by separating concerns into layers like page objects, tests, utilities, and config to improve maintainability and clarity.