Add NCAA football logo download script and update team abbreviations

- Added download_espn_ncaa_fb_logos.py script to download logos from ESPN API
- Downloaded 50 NCAA football team logos to test/ncaaFBlogos/
- Updated all_team_abbreviations.txt with current ESPN team data
- Updated various team logo files (MLB, NBA, NFL, NHL, NCAAF)

test/download_espn_ncaa_fb_logos.py

@@ -0,0 +1,192 @@
+#!/usr/bin/env python3
+"""
+Script to download all NCAA Football team logos from ESPN API
+and update the all_team_abbreviations.txt file with current ESPN abbreviations.
+"""
+
+import os
+import requests
+import json
+from pathlib import Path
+import time
+
+def create_logo_directory():
+    """Create the ncaaFBlogos directory if it doesn't exist."""
+    logo_dir = Path("test/ncaaFBlogos")
+    logo_dir.mkdir(parents=True, exist_ok=True)
+    return logo_dir
+
+def fetch_teams_data():
+    """Fetch team data from ESPN API."""
+    url = "https://site.api.espn.com/apis/site/v2/sports/football/college-football/teams"
+    
+    try:
+        response = requests.get(url, timeout=30)
+        response.raise_for_status()
+        return response.json()
+    except requests.exceptions.RequestException as e:
+        print(f"Error fetching teams data: {e}")
+        return None
+
+def download_logo(url, filepath, team_name):
+    """Download a logo from URL and save to filepath."""
+    try:
+        response = requests.get(url, timeout=30)
+        response.raise_for_status()
+        
+        with open(filepath, 'wb') as f:
+            f.write(response.content)
+        
+        print(f"✓ Downloaded: {team_name} -> {filepath.name}")
+        return True
+        
+    except requests.exceptions.RequestException as e:
+        print(f"✗ Failed to download {team_name}: {e}")
+        return False
+
+def normalize_abbreviation(abbreviation):
+    """Normalize team abbreviation to lowercase for filename."""
+    return abbreviation.lower()
+
+def update_abbreviations_file(teams_data, abbreviations_file_path):
+    """Update the all_team_abbreviations.txt file with current ESPN abbreviations."""
+    print(f"\nUpdating abbreviations file: {abbreviations_file_path}")
+    
+    # Read existing file
+    existing_content = []
+    if os.path.exists(abbreviations_file_path):
+        with open(abbreviations_file_path, 'r', encoding='utf-8') as f:
+            existing_content = f.readlines()
+    
+    # Find the NCAAF section
+    ncaaf_start = -1
+    ncaaf_end = -1
+    
+    for i, line in enumerate(existing_content):
+        if line.strip() == "NCAAF":
+            ncaaf_start = i
+        elif ncaaf_start != -1 and line.strip() and not line.startswith("  "):
+            ncaaf_end = i
+            break
+    
+    if ncaaf_start == -1:
+        print("Warning: Could not find NCAAF section in abbreviations file")
+        return
+    
+    if ncaaf_end == -1:
+        ncaaf_end = len(existing_content)
+    
+    # Extract teams from ESPN data
+    espn_teams = []
+    for team_data in teams_data:
+        team = team_data.get('team', {})
+        abbreviation = team.get('abbreviation', '')
+        display_name = team.get('displayName', '')
+        
+        if abbreviation and display_name:
+            espn_teams.append((abbreviation, display_name))
+    
+    # Sort teams by abbreviation
+    espn_teams.sort(key=lambda x: x[0])
+    
+    # Create new NCAAF section
+    new_ncaaf_section = ["NCAAF\n"]
+    for abbreviation, display_name in espn_teams:
+        new_ncaaf_section.append(f"  {abbreviation} => {display_name}\n")
+    new_ncaaf_section.append("\n")
+    
+    # Reconstruct the file
+    new_content = (
+        existing_content[:ncaaf_start] + 
+        new_ncaaf_section + 
+        existing_content[ncaaf_end:]
+    )
+    
+    # Write updated file
+    with open(abbreviations_file_path, 'w', encoding='utf-8') as f:
+        f.writelines(new_content)
+    
+    print(f"✓ Updated abbreviations file with {len(espn_teams)} NCAAF teams")
+
+def main():
+    """Main function to download all NCAA FB team logos and update abbreviations."""
+    print("Starting NCAA Football logo download and abbreviations update...")
+    
+    # Create directory
+    logo_dir = create_logo_directory()
+    print(f"Created/verified directory: {logo_dir}")
+    
+    # Fetch teams data
+    print("Fetching teams data from ESPN API...")
+    data = fetch_teams_data()
+    
+    if not data:
+        print("Failed to fetch teams data. Exiting.")
+        return
+    
+    # Extract teams
+    teams = []
+    try:
+        sports = data.get('sports', [])
+        for sport in sports:
+            leagues = sport.get('leagues', [])
+            for league in leagues:
+                teams = league.get('teams', [])
+                break
+    except (KeyError, IndexError) as e:
+        print(f"Error parsing teams data: {e}")
+        return
+    
+    print(f"Found {len(teams)} teams")
+    
+    # Download logos
+    downloaded_count = 0
+    failed_count = 0
+    
+    for team_data in teams:
+        team = team_data.get('team', {})
+        
+        # Extract team information
+        abbreviation = team.get('abbreviation', '')
+        display_name = team.get('displayName', 'Unknown')
+        logos = team.get('logos', [])
+        
+        if not abbreviation or not logos:
+            print(f"⚠ Skipping {display_name}: missing abbreviation or logos")
+            continue
+        
+        # Get the default logo (first one is usually default)
+        logo_url = logos[0].get('href', '')
+        if not logo_url:
+            print(f"⚠ Skipping {display_name}: no logo URL")
+            continue
+        
+        # Create filename
+        filename = f"{normalize_abbreviation(abbreviation)}.png"
+        filepath = logo_dir / filename
+        
+        # Skip if already exists
+        if filepath.exists():
+            print(f"⏭ Skipping {display_name}: {filename} already exists")
+            continue
+        
+        # Download logo
+        if download_logo(logo_url, filepath, display_name):
+            downloaded_count += 1
+        else:
+            failed_count += 1
+        
+        # Small delay to be respectful to the API
+        time.sleep(0.1)
+    
+    print(f"\nDownload complete!")
+    print(f"✓ Successfully downloaded: {downloaded_count} logos")
+    print(f"✗ Failed downloads: {failed_count}")
+    print(f"📁 Logos saved in: {logo_dir}")
+    
+    # Update abbreviations file
+    abbreviations_file_path = "assets/sports/all_team_abbreviations.txt"
+    update_abbreviations_file(teams, abbreviations_file_path)
+
+if __name__ == "__main__":
+    main()