Cursor rule

1---
2description: Selenium + pytest framework architecture — configuration, fixtures, and dependency management
3globs: **/conftest.py,**/pytest.ini,**/requirements.txt,**/pyproject.toml
4alwaysApply: false
5---
6# Selenium Python Framework Architecture
7 
8## Modern Framework Foundation
9- **pytest Framework**: Leverage pytest's powerful fixture system and plugin ecosystem
10- **Modular Architecture**: Separate concerns with clear package structure
11- **Configuration Management**: Environment-specific settings with proper inheritance
12- **Dependency Management**: Pinned versions with regular security updates
13 
14## Project Structure Best Practices
15```
16selenium-project/
17├── tests/
18│   ├── conftest.py              # Global pytest configuration
19│   ├── pages/                   # Page Object Models
20│   ├── specs/                   # Test specifications
21│   ├── utils/                   # Helper utilities
22│   └── data/                    # Test data files
23├── config/
24│   ├── environments/            # Environment configurations
25│   └── browsers/                # Browser configurations
26├── reports/                     # Test execution reports
27├── logs/                        # Application logs
28├── requirements.txt             # Python dependencies
29└── pytest.ini                  # pytest configuration
30```
31 
32## pytest Configuration Excellence
33```python
34# conftest.py - Global configuration
35import pytest
36import os
37from selenium import webdriver
38from selenium.webdriver.chrome.options import Options as ChromeOptions
39from webdriver_manager.chrome import ChromeDriverManager
40 
41def pytest_addoption(parser):
42    """Command line options for flexible test execution."""
43    parser.addoption("--browser", action="store", default="chrome")
44    parser.addoption("--headless", action="store_true", default=False)
45    parser.addoption("--env", action="store", default="dev")
46    parser.addoption("--parallel", action="store", default="1")
47 
48@pytest.fixture(scope="session")
49def browser_config(request):
50    """Browser configuration based on command line arguments."""
51    return {
52        "browser": request.config.getoption("--browser"),
53        "headless": request.config.getoption("--headless"),
54        "environment": request.config.getoption("--env")
55    }
56```
57 
58## Environment Management
59```python
60# Environment-specific configuration loading
61import yaml
62import os
63from typing import Dict, Any
64 
65class ConfigManager:
66    """Centralized configuration management."""
67    
68    def __init__(self, environment: str = "dev"):
69        self.environment = environment
70        self.config = self._load_config()
71    
72    def _load_config(self) -> Dict[str, Any]:
73        """Load environment-specific configuration."""
74        config_file = f"config/environments/{self.environment}.yaml"
75        
76        if not os.path.exists(config_file):
77            raise FileNotFoundError(f"Configuration file not found: {config_file}")
78        
79        with open(config_file, 'r') as f:
80            config = yaml.safe_load(f)
81        
82        # Validate required keys
83        required_keys = ["base_url", "timeouts", "credentials"]
84        for key in required_keys:
85            if key not in config:
86                raise KeyError(f"Missing required configuration: {key}")
87        
88        return config
89    
90    def get(self, key: str, default=None):
91        """Get configuration value with dot notation support."""
92        keys = key.split('.')
93        value = self.config
94        
95        for k in keys:
96            if isinstance(value, dict) and k in value:
97                value = value[k]
98            else:
99                return default
100        
101        return value
102```
103 
104## Dependency Management
105```ini
106# requirements.txt - Pinned versions for stability
107selenium==4.15.0
108pytest==7.4.0
109pytest-html==4.1.1
110pytest-xdist==3.3.1
111webdriver-manager==4.0.1
112pyyaml==6.0.1
113allure-pytest==2.13.2
114python-dotenv==1.0.0
115 
116# Development dependencies
117black==23.9.1
118flake8==6.1.0
119mypy==1.6.0
120```
121