spotify_utils.py

import spotipy
from spotipy.oauth2 import SpotifyOAuth
import datetime
from dotenv import load_dotenv
import os

# Load environment variables from .env file
load_dotenv()

def create_spotify_client():
    """Create and return a Spotify client with proper authentication"""
    if not all([os.getenv('SPOTIPY_CLIENT_ID'), 
                os.getenv('SPOTIPY_CLIENT_SECRET'), 
                os.getenv('SPOTIPY_REDIRECT_URI')]):
        raise Exception("Missing Spotify credentials in .env file")
        
    scope = "streaming user-read-playback-state user-modify-playback-state"
    cache_path = ".spotify_cache"
    
    auth_manager = SpotifyOAuth(
        scope=scope,
        cache_path=cache_path,
        open_browser=False  # Prevent automatic browser opening
    )
    
    return spotipy.Spotify(auth_manager=auth_manager)

def timestamp_to_ms(timestamp):
    """Convert timestamp string (MM:SS) to milliseconds"""
    time_parts = timestamp.split(':')
    minutes = int(time_parts[0])
    seconds = int(time_parts[1])
    return (minutes * 60 + seconds) * 1000

def search_track(sp, song, artist):
    """Search for a track on Spotify"""
    print(f"Searching for track: {song} by {artist}")  # Debug log
    query = f"track:{song} artist:{artist}"
    results = sp.search(q=query, type='track', limit=1)
    
    if results['tracks']['items']:
        print(f"Found track: {song}")  # Debug log
        return results['tracks']['items'][0]
    print(f"No results found for: {song}")  # Debug log
    return None

def create_medley_queue(sp, mixtape_data):
    """Create a queue of tracks with their start and stop times"""
    print("Starting medley queue creation...")  # Debug log
    medley_queue = []
    
    for song in mixtape_data['songs']:
        print(f"Processing song: {song['song']}")  # Debug log
        track = search_track(sp, song['song'], song['artist'])
        if track:
            # Convert timestamps to milliseconds
            start_ms = timestamp_to_ms(song['start_timestamp'])
            stop_ms = timestamp_to_ms(song['stop_timestamp'])
            
            # Validate timestamps
            track_duration_ms = track['duration_ms']
            if start_ms >= track_duration_ms:
                print(f"Warning: Start time {song['start_timestamp']} exceeds track duration for {song['song']}")
                continue
            if stop_ms > track_duration_ms:
                print(f"Warning: Adjusting stop time to track duration for {song['song']}")
                stop_ms = track_duration_ms
            
            medley_queue.append({
                'uri': track['uri'],
                'start_ms': start_ms,
                'stop_ms': stop_ms,
                'song': song['song'],
                'artist': song['artist']
            })
    
    print(f"Completed medley queue creation with {len(medley_queue)} tracks")  # Debug log
    return medley_queue