"""Report generator for creating comprehensive workout reports.""" import logging from pathlib import Path from typing import Dict, Any, List, Optional from datetime import datetime import jinja2 import pandas as pd from markdown import markdown from weasyprint import HTML, CSS import json from models.workout import WorkoutData logger = logging.getLogger(__name__) class ReportGenerator: """Generate comprehensive workout reports in various formats.""" def __init__(self, template_dir: Path = None): """Initialize report generator. Args: template_dir: Directory containing report templates """ self.template_dir = template_dir or Path(__file__).parent / 'templates' self.template_dir.mkdir(exist_ok=True) # Initialize Jinja2 environment self.jinja_env = jinja2.Environment( loader=jinja2.FileSystemLoader(self.template_dir), autoescape=jinja2.select_autoescape(['html', 'xml']) ) # Add custom filters self.jinja_env.filters['format_duration'] = self._format_duration self.jinja_env.filters['format_distance'] = self._format_distance self.jinja_env.filters['format_speed'] = self._format_speed self.jinja_env.filters['format_power'] = self._format_power self.jinja_env.filters['format_heart_rate'] = self._format_heart_rate def generate_workout_report(self, workout: WorkoutData, analysis: Dict[str, Any], format: str = 'html') -> str: """Generate comprehensive workout report. Args: workout: WorkoutData object analysis: Analysis results from WorkoutAnalyzer format: Report format ('html', 'pdf', 'markdown') Returns: Path to generated report """ # Prepare report data report_data = self._prepare_report_data(workout, analysis) # Generate report based on format if format == 'html': return self._generate_html_report(report_data) elif format == 'pdf': return self._generate_pdf_report(report_data) elif format == 'markdown': return self._generate_markdown_report(report_data) else: raise ValueError(f"Unsupported format: {format}") def _prepare_report_data(self, workout: WorkoutData, analysis: Dict[str, Any]) -> Dict[str, Any]: """Prepare data for report generation. Args: workout: WorkoutData object analysis: Analysis results Returns: Dictionary with report data """ return { 'workout': { 'metadata': workout.metadata, 'summary': analysis.get('summary', {}), 'power_analysis': analysis.get('power_analysis', {}), 'heart_rate_analysis': analysis.get('heart_rate_analysis', {}), 'speed_analysis': analysis.get('speed_analysis', {}), 'elevation_analysis': analysis.get('elevation_analysis', {}), 'intervals': analysis.get('intervals', []), 'zones': analysis.get('zones', {}), 'efficiency': analysis.get('efficiency', {}) }, 'report': { 'generated_at': datetime.now().isoformat(), 'version': '1.0.0', 'tool': 'Garmin Analyser' } } def _generate_html_report(self, report_data: Dict[str, Any]) -> str: """Generate HTML report. Args: report_data: Report data Returns: Path to generated HTML report """ template = self.jinja_env.get_template('workout_report.html') html_content = template.render(**report_data) output_path = Path('reports') / f"workout_report_{datetime.now().strftime('%Y%m%d_%H%M%S')}.html" output_path.parent.mkdir(exist_ok=True) with open(output_path, 'w', encoding='utf-8') as f: f.write(html_content) return str(output_path) def _generate_pdf_report(self, report_data: Dict[str, Any]) -> str: """Generate PDF report. Args: report_data: Report data Returns: Path to generated PDF report """ # First generate HTML html_path = self._generate_html_report(report_data) # Convert to PDF pdf_path = html_path.replace('.html', '.pdf') HTML(html_path).write_pdf(pdf_path) return pdf_path def _generate_markdown_report(self, report_data: Dict[str, Any]) -> str: """Generate Markdown report. Args: report_data: Report data Returns: Path to generated Markdown report """ template = self.jinja_env.get_template('workout_report.md') markdown_content = template.render(**report_data) output_path = Path('reports') / f"workout_report_{datetime.now().strftime('%Y%m%d_%H%M%S')}.md" output_path.parent.mkdir(exist_ok=True) with open(output_path, 'w', encoding='utf-8') as f: f.write(markdown_content) return str(output_path) def generate_summary_report(self, workouts: List[WorkoutData], analyses: List[Dict[str, Any]]) -> str: """Generate summary report for multiple workouts. Args: workouts: List of WorkoutData objects analyses: List of analysis results Returns: Path to generated summary report """ # Aggregate data summary_data = self._aggregate_workout_data(workouts, analyses) # Generate summary report template = self.jinja_env.get_template('summary_report.html') html_content = template.render(**summary_data) output_path = Path('reports') / f"summary_report_{datetime.now().strftime('%Y%m%d_%H%M%S')}.html" output_path.parent.mkdir(exist_ok=True) with open(output_path, 'w', encoding='utf-8') as f: f.write(html_content) return str(output_path) def _aggregate_workout_data(self, workouts: List[WorkoutData], analyses: List[Dict[str, Any]]) -> Dict[str, Any]: """Aggregate data from multiple workouts. Args: workouts: List of WorkoutData objects analyses: List of analysis results Returns: Dictionary with aggregated data """ # Create DataFrame for analysis workout_data = [] for workout, analysis in zip(workouts, analyses): data = { 'date': workout.metadata.start_time, 'activity_type': workout.metadata.activity_type, 'duration_minutes': analysis.get('summary', {}).get('duration_minutes', 0), 'distance_km': analysis.get('summary', {}).get('distance_km', 0), 'avg_power': analysis.get('summary', {}).get('avg_power', 0), 'avg_heart_rate': analysis.get('summary', {}).get('avg_heart_rate', 0), 'avg_speed': analysis.get('summary', {}).get('avg_speed_kmh', 0), 'elevation_gain': analysis.get('summary', {}).get('elevation_gain_m', 0), 'calories': analysis.get('summary', {}).get('calories', 0), 'tss': analysis.get('summary', {}).get('training_stress_score', 0) } workout_data.append(data) df = pd.DataFrame(workout_data) # Calculate aggregations aggregations = { 'total_workouts': len(workouts), 'total_duration_hours': df['duration_minutes'].sum() / 60, 'total_distance_km': df['distance_km'].sum(), 'total_elevation_m': df['elevation_gain'].sum(), 'total_calories': df['calories'].sum(), 'avg_workout_duration': df['duration_minutes'].mean(), 'avg_power': df['avg_power'].mean(), 'avg_heart_rate': df['avg_heart_rate'].mean(), 'avg_speed': df['avg_speed'].mean(), 'total_tss': df['tss'].sum(), 'weekly_tss': df['tss'].sum() / 4, # Assuming 4 weeks 'workouts_by_type': df['activity_type'].value_counts().to_dict(), 'weekly_volume': df.groupby(pd.Grouper(key='date', freq='W'))['duration_minutes'].sum().to_dict() } return { 'workouts': workouts, 'analyses': analyses, 'aggregations': aggregations, 'report': { 'generated_at': datetime.now().isoformat(), 'version': '1.0.0', 'tool': 'Garmin Analyser' } } def _format_duration(self, seconds: float) -> str: """Format duration in seconds to human-readable format. Args: seconds: Duration in seconds Returns: Formatted duration string """ hours = int(seconds // 3600) minutes = int((seconds % 3600) // 60) seconds = int(seconds % 60) if hours > 0: return f"{hours}h {minutes}m {seconds}s" elif minutes > 0: return f"{minutes}m {seconds}s" else: return f"{seconds}s" def _format_distance(self, meters: float) -> str: """Format distance in meters to human-readable format. Args: meters: Distance in meters Returns: Formatted distance string """ if meters >= 1000: return f"{meters/1000:.2f} km" else: return f"{meters:.0f} m" def _format_speed(self, kmh: float) -> str: """Format speed in km/h to human-readable format. Args: kmh: Speed in km/h Returns: Formatted speed string """ return f"{kmh:.1f} km/h" def _format_power(self, watts: float) -> str: """Format power in watts to human-readable format. Args: watts: Power in watts Returns: Formatted power string """ return f"{watts:.0f} W" def _format_heart_rate(self, bpm: float) -> str: """Format heart rate in bpm to human-readable format. Args: bpm: Heart rate in bpm Returns: Formatted heart rate string """ return f"{bpm:.0f} bpm" def create_report_templates(self): """Create default report templates.""" self.template_dir.mkdir(exist_ok=True) # HTML template html_template = """ Workout Report - {{ workout.metadata.activity_name }}

Workout Report: {{ workout.metadata.activity_name }}

Date: {{ workout.metadata.start_time }}

Activity Type: {{ workout.metadata.activity_type }}

Summary

Duration

{{ workout.summary.duration_minutes|format_duration }}

Distance

{{ workout.summary.distance_km|format_distance }}

Avg Power

{{ workout.summary.avg_power|format_power }}

Avg Heart Rate

{{ workout.summary.avg_heart_rate|format_heart_rate }}

Avg Speed

{{ workout.summary.avg_speed_kmh|format_speed }}

Calories

{{ workout.summary.calories|int }}

Detailed Analysis

Power Analysis

Metric Value
Average Power {{ workout.power_analysis.avg_power|format_power }}
Maximum Power {{ workout.power_analysis.max_power|format_power }}
Normalized Power {{ workout.summary.normalized_power|format_power }}
Intensity Factor {{ "%.2f"|format(workout.summary.intensity_factor) }}

Heart Rate Analysis

Metric Value
Average Heart Rate {{ workout.heart_rate_analysis.avg_heart_rate|format_heart_rate }}
Maximum Heart Rate {{ workout.heart_rate_analysis.max_heart_rate|format_heart_rate }}

Speed Analysis

Metric Value
Average Speed {{ workout.speed_analysis.avg_speed|format_speed }}
Maximum Speed {{ workout.speed_analysis.max_speed|format_speed }}

Report generated on {{ report.generated_at }} using {{ report.tool }} v{{ report.version }}

""" with open(self.template_dir / 'workout_report.html', 'w') as f: f.write(html_template) # Markdown template md_template = """# Workout Report: {{ workout.metadata.activity_name }} **Date:** {{ workout.metadata.start_time }} **Activity Type:** {{ workout.metadata.activity_type }} ## Summary | Metric | Value | |--------|--------| | Duration | {{ workout.summary.duration_minutes|format_duration }} | | Distance | {{ workout.summary.distance_km|format_distance }} | | Average Power | {{ workout.summary.avg_power|format_power }} | | Average Heart Rate | {{ workout.summary.avg_heart_rate|format_heart_rate }} | | Average Speed | {{ workout.summary.avg_speed_kmh|format_speed }} | | Calories | {{ workout.summary.calories|int }} | ## Detailed Analysis ### Power Analysis - **Average Power:** {{ workout.power_analysis.avg_power|format_power }} - **Maximum Power:** {{ workout.power_analysis.max_power|format_power }} - **Normalized Power:** {{ workout.summary.normalized_power|format_power }} - **Intensity Factor:** {{ "%.2f"|format(workout.summary.intensity_factor) }} ### Heart Rate Analysis - **Average Heart Rate:** {{ workout.heart_rate_analysis.avg_heart_rate|format_heart_rate }} - **Maximum Heart Rate:** {{ workout.heart_rate_analysis.max_heart_rate|format_heart_rate }} ### Speed Analysis - **Average Speed:** {{ workout.speed_analysis.avg_speed|format_speed }} - **Maximum Speed:** {{ workout.speed_analysis.max_speed|format_speed }} --- *Report generated on {{ report.generated_at }} using {{ report.tool }} v{{ report.version }}*""" with open(self.template_dir / 'workout_report.md', 'w') as f: f.write(md_template) logger.info("Report templates created successfully")