Hybrid Framework Design

# ══════════════════════════════════════════════════════════════
# PROFESSIONAL HYBRID FRAMEWORK STRUCTURE
# ══════════════════════════════════════════════════════════════
# framework/
#   ├── config/
#   │   ├── config.py          ← Environment configs (base URLs, timeouts)
#   │   └── test_config.json   ← Test-level settings
#   │
#   ├── pages/                 ← PAGE OBJECT MODEL layer
#   │   ├── base_page.py       ← Shared WebDriver utilities
#   │   ├── login_page.py
#   │   ├── dashboard_page.py
#   │   └── checkout_page.py
#   │
#   ├── test_data/             ← DATA-DRIVEN layer
#   │   ├── login_data.csv
#   │   ├── products.json
#   │   └── checkout_scenarios.xlsx
#   │
#   ├── features/              ← BDD layer (Gherkin)
#   │   ├── login.feature
#   │   └── checkout.feature
#   │
#   ├── step_definitions/      ← BDD step implementations
#   │   ├── auth_steps.py
#   │   └── common_steps.py
#   │
#   ├── tests/                 ← Direct pytest tests (non-BDD)
#   │   ├── test_api.py        ← API tests
#   │   └── test_regression.py ← Full regression suite
#   │
#   ├── utilities/
#   │   ├── api_client.py      ← HTTP request helper
#   │   ├── db_helper.py       ← Database setup/teardown
#   │   └── excel_reader.py    ← Excel test data reader
#   │
#   ├── reports/               ← Generated test reports
#   ├── screenshots/           ← Failure screenshots
#   ├── conftest.py            ← pytest fixtures (driver, base_url)
#   └── pytest.ini             ← Run configuration

# ── config/config.py ─────────────────────────────────────────
import os

class Config:
    BASE_URL = os.getenv("BASE_URL", "https://staging.myapp.com")
    TIMEOUT  = int(os.getenv("TIMEOUT", "15"))
    HEADLESS = os.getenv("HEADLESS", "true").lower() == "true"
    BROWSER  = os.getenv("BROWSER", "chrome")

class TestData:
    VALID_USER  = {"email": "alice@test.com",  "password": "Test@1234"}
    ADMIN_USER  = {"email": "admin@test.com",  "password": "Admin@1234"}
    LOCKED_USER = {"email": "locked@test.com", "password": "Test@1234"}

# ── utilities/api_client.py ───────────────────────────────────
import requests

class ApiClient:
    def __init__(self, base_url):
        self.base_url = base_url
        self.session = requests.Session()
    
    def login(self, email, password):
        """API login — sets session cookie, no UI needed"""
        response = self.session.post(
            f"{self.base_url}/api/auth/login",
            json={"email": email, "password": password}
        )
        response.raise_for_status()
        return response.json()["token"]
    
    def create_test_user(self, user_data):
        """Create test data via API before UI tests"""
        return self.session.post(f"{self.base_url}/api/test/users", json=user_data)

# ── conftest.py (hybrid approach) ────────────────────────────
import pytest
from selenium import webdriver
from config.config import Config
from utilities.api_client import ApiClient

@pytest.fixture(scope="session")
def api_client():
    """Session-scoped API client for test data setup"""
    return ApiClient(Config.BASE_URL)

@pytest.fixture(scope="function")
def authenticated_driver(api_client):
    """Driver with pre-authenticated session (skip UI login)"""
    options = webdriver.ChromeOptions()
    if Config.HEADLESS:
        options.add_argument("--headless")
    driver = webdriver.Chrome(options=options)
    
    # Login via API and set cookie in browser
    token = api_client.login("alice@test.com", "Test@1234")
    driver.get(Config.BASE_URL)
    driver.add_cookie({"name": "auth_token", "value": token})
    
    yield driver
    driver.quit()