Test functions and classes in Selenium Python - Framework Patterns

Framework Mode - Test functions and classes

Folder Structure

tests/
├── test_login.py
├── test_search.py
├── conftest.py
page_objects/
├── login_page.py
├── search_page.py
utilities/
├── browser_factory.py
├── helpers.py
configs/
├── config.yaml
reports/
├── latest_report.html

Test Framework Layers

• Test Functions and Classes: Located in tests/. Use pytest test functions or classes to organize tests logically. Classes group related tests; functions are individual test cases.
• Page Objects: In page_objects/. Encapsulate page elements and actions as classes with methods. This keeps tests clean and readable.
• Utilities: Helper functions and browser setup in utilities/. For example, browser_factory.py manages WebDriver creation.
• Configurations: Store environment variables, URLs, credentials in configs/config.yaml. Load them in tests or fixtures.

Configuration Patterns

• Use a config.yaml file to store environment URLs, browser types, and credentials.
• Load config in conftest.py using fixtures to provide test data and browser setup.
• Allow command-line options in pytest to select browser or environment dynamically.
• Keep sensitive data out of code by using environment variables or secure vaults.

Test Reporting and CI/CD Integration

• Use pytest with plugins like pytest-html to generate readable HTML reports in reports/.
• Integrate tests into CI/CD pipelines (e.g., GitHub Actions, Jenkins) to run tests on each code push.
• Fail tests clearly when assertions fail inside test functions or classes.
• Use logs and screenshots on failure for easier debugging.

Best Practices for Test Functions and Classes

• Use descriptive test names: Name test functions and classes clearly to describe what they verify.
• Group related tests in classes: Use test classes to organize tests by feature or page.
• Keep tests independent: Each test function should run alone without relying on others.
• Use fixtures for setup/teardown: Manage browser and test data setup in conftest.py fixtures.
• Assert meaningful outcomes: Use clear assertions inside test functions to verify expected behavior.

Self Check

Where would you add a new test class for the "Checkout" feature in this framework structure?

Key Result

Organize Selenium Python tests using test functions and classes in the tests/ folder with page objects and fixtures for clean, maintainable automation.