feat: add Python type hints to generator modules

- Add type hints to dashboard.py functions
- Add type hints to rss.py functions
- Add type hints to schema.py functions
- Enable mypy checking for generator modules

Improves code quality and IDE support across generators.

Author: aledlie

src/generators/dashboard.py

@@ -6,7 +6,7 @@
 import json
 import logging
 from pathlib import Path
-from typing import Dict, Any, List
+from typing import Dict, Any, List, Optional
 from datetime import datetime
 
 # Configure logging
@@ -20,9 +20,9 @@
 class DashboardGenerator:
     """Generates interactive code analysis dashboard"""
 
-    def __init__(self, schemas_path: Path, quality_path: Path = None,
-                 coverage_path: Path = None, dependency_path: Path = None,
-                 cache_dir: Path = None):
+    def __init__(self, schemas_path: Path, quality_path: Optional[Path] = None,
+                 coverage_path: Optional[Path] = None, dependency_path: Optional[Path] = None,
+                 cache_dir: Optional[Path] = None):
         self.schemas_path = schemas_path
         self.quality_path = quality_path
         self.coverage_path = coverage_path
@@ -38,11 +38,11 @@ def __init__(self, schemas_path: Path, quality_path: Path = None,
         # Load performance data
         self.performance_data = self._load_performance_data()
 
-    def _load_json(self, path: Path) -> Dict[str, Any]:
+    def _load_json(self, path: Optional[Path]) -> Dict[str, Any]:
         """Load JSON file"""
         if path and path.exists():
             with open(path, 'r') as f:
-                return json.load(f)
+                return json.load(f)  # type: ignore[no-any-return]
         return {}
 
     def _load_performance_data(self) -> Dict[str, Any]:
@@ -664,7 +664,7 @@ def _generate_performance_section(self) -> str:
         </div>
         """
 
-    def save_dashboard(self, output_path: Path):
+    def save_dashboard(self, output_path: Path) -> None:
         """Save dashboard to file"""
         html = self.generate_html()
 
@@ -674,7 +674,7 @@ def save_dashboard(self, output_path: Path):
         logger.info(f"✅ Dashboard saved to {output_path}")
         logger.info(f"   Open in browser: file://{output_path.absolute()}")
 
-def main():
+def main() -> None:
     import argparse
 
     parser = argparse.ArgumentParser(description='Dashboard Generator')

src/generators/rss.py

@@ -180,15 +180,15 @@ def _create_item(self, channel: ET.Element, commit: Dict[str, Any], link: str) -
         self._add_item_metadata(item, commit, link)
         self._add_item_content(item, commit, link)
 
-    def _add_item_metadata(self, item: ET.Element, commit: Dict[str, Any], link: str):
+    def _add_item_metadata(self, item: ET.Element, commit: Dict[str, Any], link: str) -> None:
         """Add basic item metadata"""
         ET.SubElement(item, 'title').text = commit['message']
         ET.SubElement(item, 'link').text = f"{link}/commit/{commit['hash']}"
         ET.SubElement(item, 'guid', isPermaLink='true').text = f"{link}/commit/{commit['hash']}"
         ET.SubElement(item, 'pubDate').text = datetime.fromisoformat(commit['date']).strftime('%a, %d %b %Y %H:%M:%S %z')
         ET.SubElement(item, 'author').text = f"{commit['email']} ({commit['author']})"
 
-    def _add_item_content(self, item: ET.Element, commit: Dict[str, Any], link: str):
+    def _add_item_content(self, item: ET.Element, commit: Dict[str, Any], link: str) -> None:
         """Add content to item with stats and schema.org markup"""
         stats = self.analyze_commit_changes(commit['hash'])
         description = self._build_description(commit, stats)
@@ -242,7 +242,7 @@ def _format_xml(self, rss: ET.Element) -> str:
         dom = minidom.parseString(xml_str)
         return dom.toprettyxml(indent='  ')
 
-    def save_rss(self, output_path: Path, **kwargs):
+    def save_rss(self, output_path: Path, **kwargs: Any) -> None:
         """Save RSS feed to file"""
         rss_xml = self.generate_rss_xml(**kwargs)
 
@@ -252,7 +252,7 @@ def save_rss(self, output_path: Path, **kwargs):
         logger.info(f"✅ RSS feed saved to {output_path}")
         logger.info(f"   {len(self.get_recent_commits())} commits included")
 
-def main():
+def main() -> None:
     import argparse
 
     parser = argparse.ArgumentParser(description='RSS Feed Generator')