setup_real_api_validation.py

#!/usr/bin/env python3
"""
Real API Validation Study Setup Script
Helps you get started with the validation study
"""

import os
import sys
import subprocess
import shutil
from pathlib import Path

def print_header():
    """Print setup header"""
    print("🚀 Real API Validation Study - Setup Script")
    print("=" * 60)
    print("This script will help you set up the real API validation study.")
    print("Follow the steps to get your environment ready for testing.")
    print()

def check_python_version():
    """Check if Python version is compatible"""
    print("🐍 Checking Python version...")
    
    if sys.version_info < (3, 7):
        print("❌ Python 3.7+ required. Current version:", sys.version)
        return False
    
    print(f"✅ Python {sys.version.split()[0]} - Compatible")
    return True

def install_requirements():
    """Install required Python packages"""
    print("\n📦 Installing required packages...")
    
    required_packages = [
        "aiohttp",
        "asyncio", 
        "python-dotenv",
        "cryptography",
        "numpy",
        "pandas"
    ]
    
    try:
        for package in required_packages:
            print(f"   Installing {package}...")
            subprocess.check_call([sys.executable, "-m", "pip", "install", package], 
                                stdout=subprocess.DEVNULL, 
                                stderr=subprocess.DEVNULL)
        
        print("✅ All packages installed successfully")
        return True
        
    except subprocess.CalledProcessError as e:
        print(f"❌ Failed to install packages: {e}")
        print("Please run: pip install aiohttp python-dotenv cryptography numpy pandas")
        return False

def setup_environment_file():
    """Set up the .env file"""
    print("\n🔧 Setting up environment file...")
    
    if os.path.exists('.env'):
        print("⚠️  .env file already exists")
        response = input("Do you want to backup and replace it? (y/n): ").lower()
        if response == 'y':
            shutil.copy('.env', '.env.backup')
            print("✅ Existing .env backed up to .env.backup")
        else:
            print("📝 Keeping existing .env file")
            return True
    
    # Copy template to .env
    if os.path.exists('.env.real_api_template'):
        shutil.copy('.env.real_api_template', '.env')
        print("✅ Created .env file from template")
        print("📝 Please edit .env and add your API keys")
        return True
    else:
        print("❌ Template file not found")
        return False

def create_directory_structure():
    """Create necessary directories"""
    print("\n📁 Creating directory structure...")
    
    directories = [
        "results",
        "results/raw_data",
        "results/processed", 
        "results/comparisons",
        "logs"
    ]
    
    for directory in directories:
        Path(directory).mkdir(parents=True, exist_ok=True)
        print(f"   ✅ Created: {directory}/")
    
    print("✅ Directory structure created")

def print_next_steps():
    """Print next steps for the user"""
    print("\n🎯 NEXT STEPS:")
    print("=" * 60)
    
    print("\n1. 🔑 GET API KEYS (Start with Tier 1):")
    print("   • OpenWeatherMap: https://openweathermap.org/api")
    print("   • WeatherAPI: https://www.weatherapi.com/signup.aspx")
    print("   • NewsAPI: https://newsapi.org/register")
    print("   • Guardian: https://open-platform.theguardian.com/access/")
    print("   • Fixer.io: https://fixer.io/signup")
    
    print("\n2. 📝 EDIT .env FILE:")
    print("   • Open .env in your text editor")
    print("   • Replace 'your_*_api_key_here' with actual API keys")
    print("   • Save the file")
    
    print("\n3. 🧪 TEST API ACCESS:")
    print("   • Run: python quick_api_validation_test.py")
    print("   • This will test all your API keys")
    print("   • Make sure at least 3 APIs are working")
    
    print("\n4. 🚀 START VALIDATION STUDY:")
    print("   • Once APIs are working, proceed with the full study")
    print("   • Follow the timeline in REAL_API_VALIDATION_ACTION_PLAN.md")
    
    print("\n📚 HELPFUL FILES:")
    print("   • IMMEDIATE_ACTION_CHECKLIST.md - Day-by-day guide")
    print("   • api_provider_selection_matrix.md - All API details")
    print("   • quick_api_validation_test.py - Test your setup")

def main():
    """Main setup function"""
    print_header()
    
    # Check Python version
    if not check_python_version():
        return False
    
    # Install requirements
    if not install_requirements():
        return False
    
    # Setup environment
    if not setup_environment_file():
        return False
    
    # Create directories
    create_directory_structure()
    
    # Print next steps
    print_next_steps()
    
    print("\n🎉 SETUP COMPLETE!")
    print("You're ready to start the real API validation study.")
    print("Begin by getting your API keys and testing them.")
    
    return True

if __name__ == "__main__":
    success = main()
    if not success:
        sys.exit(1)