src/source_finding/__init__.py

"""
Source finding module for discovering and downloading college football game videos.

This module provides functionality to:
1. Search nfl-video.com for college football games by team name(s)
2. Return matching games with metadata (title, teams, date, event)
3. Generate download commands or extract direct video URLs for downloading

Example usage:
    from source_finding import search_games, get_download_command, extract_direct_video_url

    # Search for games
    results = search_games(team_a="Ohio State", team_b="Oregon", max_pages=3)

    # Get download command for offline use
    cmd = get_download_command(results.games[0])

    # Or extract direct URL for browser download
    url = extract_direct_video_url(results.games[0])
"""

from .models import GameResult, SearchResults
from .scraper import search_games, list_available_teams, get_team_index
from .downloader import get_download_command, extract_direct_video_url, get_suggested_filename

__all__ = [
    "GameResult",
    "SearchResults",
    "search_games",
    "list_available_teams",
    "get_team_index",
    "get_download_command",
    "extract_direct_video_url",
    "get_suggested_filename",
]