implement centralized environment configuration management

Author: yhAutomationQA

.env.dev

@@ -0,0 +1,14 @@
+ENV=dev
+BROWSER=chrome
+HEADLESS=false
+BROWSER_TIMEOUT=30
+IMPLICIT_WAIT=5
+EXPLICIT_WAIT=10
+PAGE_LOAD_TIMEOUT=30
+BASE_URL=https://dev.example.com
+API_URL=https://api.dev.example.com
+SCREENSHOT_ON_FAILURE=true
+LOG_LEVEL=DEBUG
+RETRY_COUNT=0
+PARALLEL_WORKERS=1
+ALLURE_DIR=allure-results

.env.example

@@ -0,0 +1,32 @@
+# ──────────────────────────────────────────────
+# Selenium Python Framework - Environment Config
+# ──────────────────────────────────────────────
+# Copy this file:  cp .env.example .env.<env>
+# Usage:           ENV=qa pytest
+# ──────────────────────────────────────────────
+
+# Environment: dev | qa | staging | prod
+ENV=qa
+
+# ── Browser ───────────────────────────────────
+BROWSER=chrome
+HEADLESS=false
+BROWSER_TIMEOUT=30
+IMPLICIT_WAIT=10
+EXPLICIT_WAIT=15
+PAGE_LOAD_TIMEOUT=30
+
+# ── Application URLs ─────────────────────────
+BASE_URL=https://qa.example.com
+API_URL=https://api.qa.example.com
+
+# ── WebDriver ─────────────────────────────────
+WEBDRIVER_REMOTE_URL=
+WEBDRIVER_DOWNLOAD_PATH=
+
+# ── Reporting ─────────────────────────────────
+SCREENSHOT_ON_FAILURE=true
+LOG_LEVEL=INFO
+RETRY_COUNT=0
+PARALLEL_WORKERS=1
+ALLURE_DIR=allure-results

.env.qa

@@ -0,0 +1,14 @@
+ENV=qa
+BROWSER=chrome
+HEADLESS=false
+BROWSER_TIMEOUT=30
+IMPLICIT_WAIT=10
+EXPLICIT_WAIT=15
+PAGE_LOAD_TIMEOUT=30
+BASE_URL=https://qa.example.com
+API_URL=https://api.qa.example.com
+SCREENSHOT_ON_FAILURE=true
+LOG_LEVEL=INFO
+RETRY_COUNT=0
+PARALLEL_WORKERS=1
+ALLURE_DIR=allure-results

.env.staging

@@ -0,0 +1,14 @@
+ENV=staging
+BROWSER=chrome
+HEADLESS=true
+BROWSER_TIMEOUT=30
+IMPLICIT_WAIT=15
+EXPLICIT_WAIT=20
+PAGE_LOAD_TIMEOUT=60
+BASE_URL=https://staging.example.com
+API_URL=https://api.staging.example.com
+SCREENSHOT_ON_FAILURE=true
+LOG_LEVEL=INFO
+RETRY_COUNT=1
+PARALLEL_WORKERS=4
+ALLURE_DIR=allure-results

.gitignore

@@ -39,7 +39,7 @@ results/
 docker-compose*.yml
 Dockerfile
 
-# Environment
+# Environment (local only; .env.dev, .env.qa, .env.staging are tracked)
 .env
 .env.local
 .env.production

api/api_client.py

@@ -1,19 +1,20 @@
 from .base_api import BaseAPI
-from config.environments import ENV_CONFIG
+from config.config_loader import load_settings
 
 
 class APIClient(BaseAPI):
     _instances: dict = {}
 
-    def __new__(cls, env: str = "qa"):
+    def __new__(cls, env: str | None = None):
+        env = env or "qa"
         if env not in cls._instances:
             instance = super().__new__(cls)
             instance._initialized = False
             cls._instances[env] = instance
         return cls._instances[env]
 
-    def __init__(self, env: str = "qa"):
+    def __init__(self, env: str | None = None):
         if not getattr(self, "_initialized", False):
-            config = ENV_CONFIG.get(env, ENV_CONFIG["qa"])
-            super().__init__(base_url=config["api_url"])
+            settings = load_settings(env)
+            super().__init__(base_url=settings.api_url)
             self._initialized = True

config/__init__.py

@@ -1,3 +1,15 @@
-from .environments import ENV_CONFIG
+from config.constants import Browser, Environment, Timeout, LogLevel, Directory
+from config.settings import Settings
+from config.config_loader import load_settings, reload_settings, resolve_env
 
-__all__ = ["ENV_CONFIG"]
+__all__ = [
+    "Browser",
+    "Environment",
+    "Timeout",
+    "LogLevel",
+    "Directory",
+    "Settings",
+    "load_settings",
+    "reload_settings",
+    "resolve_env",
+]

config/config_loader.py

@@ -0,0 +1,47 @@
+import os
+from pathlib import Path
+from dotenv import load_dotenv
+
+from config.settings import Settings
+
+
+_CONFIG_CACHE: dict[str, Settings] = {}
+
+_SUPPORTED_ENVS = frozenset({"dev", "qa", "staging", "prod"})
+
+
+def resolve_env(env: str | None = None) -> str:
+    env = env or os.getenv("ENV") or "qa"
+    env = env.lower().strip()
+    if env not in _SUPPORTED_ENVS:
+        raise ValueError(
+            f"Unsupported environment: '{env}'. Must be one of {sorted(_SUPPORTED_ENVS)}"
+        )
+    return env
+
+
+def load_settings(env: str | None = None) -> Settings:
+    env = resolve_env(env)
+
+    if env in _CONFIG_CACHE:
+        return _CONFIG_CACHE[env]
+
+    env_file = Path(f".env.{env}")
+
+    if not env_file.exists():
+        raise FileNotFoundError(
+            f"Environment file not found: {env_file.resolve()}\n"
+            f"Create it from .env.example:  cp .env.example .env.{env}"
+        )
+
+    load_dotenv(dotenv_path=env_file, override=True)
+
+    settings = Settings()
+    _CONFIG_CACHE[env] = settings
+    return settings
+
+
+def reload_settings(env: str | None = None) -> Settings:
+    env = resolve_env(env)
+    _CONFIG_CACHE.pop(env, None)
+    return load_settings(env)

config/constants.py

@@ -0,0 +1,45 @@
+from enum import Enum
+
+
+class Browser(str, Enum):
+    CHROME = "chrome"
+    FIREFOX = "firefox"
+    EDGE = "edge"
+    SAFARI = "safari"
+
+
+class Environment(str, Enum):
+    DEV = "dev"
+    QA = "qa"
+    STAGING = "staging"
+    PROD = "prod"
+
+
+class Timeout(float, Enum):
+    IMPLICIT_WAIT = 10
+    EXPLICIT_WAIT = 15
+    PAGE_LOAD = 30
+    POLL_FREQUENCY = 0.5
+
+
+class LogLevel(str, Enum):
+    DEBUG = "DEBUG"
+    INFO = "INFO"
+    WARNING = "WARNING"
+    ERROR = "ERROR"
+    CRITICAL = "CRITICAL"
+
+
+class DriverPath(str, Enum):
+    CHROME = "chrome"
+    FIREFOX = "gecko"
+    EDGE = "edge"
+
+
+class Directory:
+    REPORTS = "reports"
+    SCREENSHOTS = "screenshots"
+    LOGS = "logs"
+    ALLURE_RESULTS = "allure-results"
+    ALLURE_REPORT = "allure-report"
+    DOWNLOADS = "downloads"