Add production improvements: error handling, config management, utility functions

- Add comprehensive error handling and logging
- Add configuration management system
- Add utility functions for common operations
- Improve README with better structure
- Add type hints and better documentation

Co-Authored-By: Claude <noreply@anthropic.com>

Author: KlementMultiverse

1_setup.py

@@ -1,3 +1,28 @@
+
+# Add comprehensive error handling
+import logging
+import sys
+from functools import wraps
+
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+)
+logger = logging.getLogger(__name__)
+
+
+def handle_errors(func):
+    """Decorator for error handling"""
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        try:
+            return func(*args, **kwargs)
+        except Exception as e:
+            logger.error(f"Error in {func.__name__}: {e}")
+            raise
+    return wrapper
+
+
 import os
 from openai import OpenAI
 from dotenv import load_dotenv

config.py

@@ -0,0 +1,35 @@
+"""
+Configuration management
+"""
+
+import os
+from pathlib import Path
+from typing import Dict, Any
+from dotenv import load_dotenv
+
+load_dotenv()
+
+
+class Config:
+    """Application configuration"""
+
+    def __init__(self):
+        self.env = os.getenv('ENV', 'development')
+        self.debug = os.getenv('DEBUG', 'False').lower() == 'true'
+        self.log_level = os.getenv('LOG_LEVEL', 'INFO')
+
+    def get(self, key: str, default: Any = None) -> Any:
+        """Get configuration value"""
+        return os.getenv(key, default)
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert config to dictionary"""
+        return {
+            'env': self.env,
+            'debug': self.debug,
+            'log_level': self.log_level
+        }
+
+
+# Global config instance
+config = Config()

utils.py

@@ -0,0 +1,49 @@
+"""
+Utility functions
+"""
+
+import json
+import logging
+from pathlib import Path
+from typing import Any, Dict, List
+from datetime import datetime
+
+logger = logging.getLogger(__name__)
+
+
+def load_json(filepath: str) -> Dict:
+    """Load JSON file safely"""
+    try:
+        with open(filepath, 'r') as f:
+            return json.load(f)
+    except FileNotFoundError:
+        logger.error(f"File not found: {filepath}")
+        return {}
+    except json.JSONDecodeError as e:
+        logger.error(f"Invalid JSON in {filepath}: {e}")
+        return {}
+
+
+def save_json(data: Dict, filepath: str):
+    """Save data to JSON file"""
+    try:
+        Path(filepath).parent.mkdir(parents=True, exist_ok=True)
+        with open(filepath, 'w') as f:
+            json.dump(data, f, indent=2)
+    except Exception as e:
+        logger.error(f"Error saving JSON to {filepath}: {e}")
+        raise
+
+
+def get_timestamp() -> str:
+    """Get current timestamp"""
+    return datetime.now().strftime('%Y-%m-%d %H:%M:%S')
+
+
+def format_size(bytes: int) -> str:
+    """Format bytes to human readable size"""
+    for unit in ['B', 'KB', 'MB', 'GB']:
+        if bytes < 1024.0:
+            return f"{bytes:.2f} {unit}"
+        bytes /= 1024.0
+    return f"{bytes:.2f} TB"