How to Build a Data Helper for Production Deployment in Python

import json
from pathlib import Path
from typing import Any, Dict

class DataHelper:
    """Common data processing patterns for production deployment."""
    
    def __init__(self, config_path: str | Path):
        self.config_path = Path(config_path)
        self.config = self._load_config()
    
    def _load_config(self) -> Dict[str, Any]:
        """Load JSON config with error handling."""
        if not self.config_path.exists():
            raise FileNotFoundError(f"Config not found: {self.config_path}")
        with self.config_path.open("r") as f:
            return json.load(f)
    
    def validate_required(self, data: Dict[str, Any], required_keys: list[str]) -> bool:
        """Validate that all required keys exist in data."""
        missing = [key for key in required_keys if key not in data]
        if missing:
            print(f"Missing keys: {missing}")
            return False
        return True
    
    def normalize(self, data: Dict[str, Any]) -> Dict[str, Any]:
        """Strip whitespace from all string values."""
        return {
            k: v.strip() if isinstance(v, str) else v
            for k, v in data.items()
        }
    
    def log_processed(self, data: Dict[str, Any]) -> None:
        """Log data details for observability."""
        schema = {k: type(v).__name__ for k, v in data.items()}
        print(json.dumps({"record_count": 1, "schema": schema}, indent=2))

if __name__ == "__main__":
    # Create sample config and test deployment pattern
    config = {"app_name": "data-pipeline", "env": "production"}
    with Path("config.json").write_text(json.dumps(config))
    
    helper = DataHelper("config.json")
    sample = {"name": "  Alice  ", "age": 30, "email": "alice@example.com"}
    
    if helper.validate_required(sample, ["name", "email"]):
        cleaned = helper.normalize(sample)
        helper.log_processed(cleaned)