Fluent waits in Selenium Python - Framework Patterns

Framework Mode - Fluent waits

Folder Structure

selenium_python_project/
├── tests/
│   ├── test_login.py
│   ├── test_search.py
│   └── test_checkout.py
├── pages/
│   ├── base_page.py
│   ├── login_page.py
│   └── search_page.py
├── utils/
│   ├── wait_utils.py
│   └── logger.py
├── config/
│   ├── config.yaml
│   └── credentials.yaml
├── conftest.py
└── requirements.txt
    

Test Framework Layers

• Driver Layer: Manages WebDriver setup and teardown (in conftest.py using pytest fixtures).
• Page Objects: Classes representing web pages with methods to interact with elements (in pages/).
• Wait Utilities: Contains fluent wait implementations to wait for elements with polling and timeout (in utils/wait_utils.py).
• Tests: Test cases using pytest that call page objects and wait utilities (in tests/).
• Configuration: Stores environment settings, URLs, credentials (in config/).
• Logging & Helpers: Utility functions like logging to track test execution (in utils/logger.py).

Configuration Patterns

Use YAML files in config/ to store environment variables, browser types, and credentials.

Load these configs in conftest.py to initialize WebDriver accordingly.

Example snippet in conftest.py:

import yaml
import pytest
from selenium import webdriver

@pytest.fixture(scope='session')
def config():
    with open('config/config.yaml') as f:
        return yaml.safe_load(f)

@pytest.fixture(scope='function')
def driver(config):
    browser = config.get('browser', 'chrome')
    if browser == 'chrome':
        driver = webdriver.Chrome()
    else:
        driver = webdriver.Firefox()
    driver.maximize_window()
    yield driver
    driver.quit()
    

Test Reporting and CI/CD Integration

• Use pytest with pytest-html plugin to generate HTML reports after test runs.
• Integrate with CI/CD tools like GitHub Actions or Jenkins to run tests on code push.
• Configure CI to install dependencies, run tests, and publish reports automatically.
• Example GitHub Actions step runs tests and uploads report as artifact.

Best Practices for Fluent Waits Framework

• Centralize Wait Logic: Put fluent wait code in utility functions to reuse and maintain easily.
• Use Explicit Polling: Fluent waits poll at intervals until condition met or timeout, avoiding fixed sleeps.
• Handle Exceptions Gracefully: Ignore exceptions like NoSuchElementException during wait polling.
• Keep Page Objects Clean: Page objects call wait utilities instead of embedding wait code directly.
• Parameterize Waits: Allow timeout and polling interval to be configurable for flexibility.

Self Check Question

Where in this folder structure would you add a new fluent wait function to wait for an element's visibility with custom polling?

Key Result

Organize fluent waits in utility modules to enable reusable, configurable, and robust element waiting in Selenium Python tests.