First Init

scripts/lighthouse_audit.py

@@ -0,0 +1,154 @@
+#!/usr/bin/env python3
+"""
+Lighthouse Performance Audit Script
+Runs Lighthouse audits on specified URLs and reports results
+"""
+
+import subprocess
+import json
+import sys
+from pathlib import Path
+
+def run_lighthouse(url, output_file=None):
+    """Run Lighthouse audit on a URL"""
+    cmd = [
+        'npx', 'lighthouse', url,
+        '--output=json',
+        '--output-path=stdout',
+        '--chrome-flags="--headless --no-sandbox"',
+        '--quiet'
+    ]
+
+    try:
+        result = subprocess.run(cmd, capture_output=True, text=True, timeout=60)
+        if result.returncode != 0:
+            print(f"Error running Lighthouse on {url}: {result.stderr}")
+            return None
+
+        data = json.loads(result.stdout)
+        return data
+    except subprocess.TimeoutExpired:
+        print(f"Timeout running Lighthouse on {url}")
+        return None
+    except json.JSONDecodeError:
+        print(f"Failed to parse Lighthouse output for {url}")
+        return None
+    except Exception as e:
+        print(f"Unexpected error for {url}: {e}")
+        return None
+
+def extract_scores(lighthouse_data):
+    """Extract key scores from Lighthouse data"""
+    if not lighthouse_data or 'categories' not in lighthouse_data:
+        return None
+
+    categories = lighthouse_data['categories']
+    return {
+        'performance': int(categories.get('performance', {}).get('score', 0) * 100),
+        'accessibility': int(categories.get('accessibility', {}).get('score', 0) * 100),
+        'best-practices': int(categories.get('best-practices', {}).get('score', 0) * 100),
+        'seo': int(categories.get('seo', {}).get('score', 0) * 100),
+    }
+
+def get_issues(lighthouse_data):
+    """Extract issues from Lighthouse audit"""
+    if not lighthouse_data or 'audits' not in lighthouse_data:
+        return []
+
+    issues = []
+    audits = lighthouse_data['audits']
+
+    # Key audits to check
+    important_audits = [
+        'first-contentful-paint',
+        'largest-contentful-paint',
+        'cumulative-layout-shift',
+        'total-blocking-time',
+        'speed-index',
+        'interactive',
+        'image-alt',
+        'document-title',
+        'meta-description',
+        'link-text',
+        'crawlable-anchors',
+        'color-contrast',
+        'tap-targets',
+        'viewport',
+        'uses-responsive-images',
+        'modern-image-formats',
+        'offscreen-images',
+        'render-blocking-resources',
+        'unminified-css',
+        'unminified-javascript',
+        'unused-css-rules',
+        'unused-javascript',
+    ]
+
+    for audit_id in important_audits:
+        if audit_id in audits:
+            audit = audits[audit_id]
+            if audit.get('score') is not None and audit['score'] < 0.9:
+                issues.append({
+                    'id': audit_id,
+                    'title': audit.get('title', audit_id),
+                    'score': audit.get('score'),
+                    'displayValue': audit.get('displayValue', ''),
+                    'description': audit.get('description', ''),
+                })
+
+    return issues
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python lighthouse_audit.py <url>")
+        sys.exit(1)
+
+    url = sys.argv[1]
+    print(f"\n🔍 Running Lighthouse audit on: {url}\n")
+
+    data = run_lighthouse(url)
+    if not data:
+        print("❌ Failed to run Lighthouse audit")
+        sys.exit(1)
+
+    scores = extract_scores(data)
+    if not scores:
+        print("❌ Failed to extract scores")
+        sys.exit(1)
+
+    # Print results
+    print("=" * 60)
+    print("LIGHTHOUSE SCORES")
+    print("=" * 60)
+
+    for category, score in scores.items():
+        emoji = "✅" if score >= 90 else "⚠️" if score >= 50 else "❌"
+        print(f"{emoji} {category.upper():20s}: {score:3d}/100")
+
+    print("\n" + "=" * 60)
+    print("ISSUES FOUND")
+    print("=" * 60 + "\n")
+
+    issues = get_issues(data)
+    if issues:
+        for issue in issues[:10]:  # Show top 10 issues
+            score_str = f"{int(issue['score'] * 100)}/100" if issue['score'] is not None else "N/A"
+            print(f"⚠️  {issue['title']}")
+            print(f"   Score: {score_str}")
+            if issue['displayValue']:
+                print(f"   Value: {issue['displayValue']}")
+            print()
+    else:
+        print("✅ No major issues found!\n")
+
+    # Check if all scores >= 90
+    all_passed = all(score >= 90 for score in scores.values())
+    if all_passed:
+        print("🎉 All scores are 90+! Great job!\n")
+        sys.exit(0)
+    else:
+        print("⚠️  Some scores are below 90. Review issues above.\n")
+        sys.exit(1)
+
+if __name__ == '__main__':
+    main()