run.py

#!/usr/bin/env python
"""
QPDS Quick Start Script
Starts the QPDS backend server
"""

import os
import shutil
import sys
import subprocess
from datetime import datetime


def venv_executables(venv_path):
    """Return the platform-specific Python and pip paths for a venv."""
    scripts_dir = "Scripts" if sys.platform == "win32" else "bin"
    return (
        os.path.join(venv_path, scripts_dir, "python"),
        os.path.join(venv_path, scripts_dir, "pip"),
    )


def venv_is_usable(python):
    """Check that an existing venv still points to a runnable interpreter."""
    if not os.path.isfile(python):
        return False
    result = subprocess.run(
        [python, "--version"],
        stdout=subprocess.DEVNULL,
        stderr=subprocess.DEVNULL,
        check=False,
    )
    return result.returncode == 0


def dependencies_are_available(python):
    """Avoid network/package work when runtime dependencies already import."""
    result = subprocess.run(
        [python, "-c", "import flask, flask_cors, numpy"],
        stdout=subprocess.DEVNULL,
        stderr=subprocess.DEVNULL,
        check=False,
    )
    return result.returncode == 0

def main():
    print("=" * 50)
    print("🎯 QPDS - Quantitative Poker Decision System")
    print("=" * 50)
    print()

    # Check Python version
    if sys.version_info < (3, 8):
        print("❌ Error: Python 3.8+ is required")
        sys.exit(1)

    print(f"✅ Python {sys.version.split()[0]} detected")

    # Check whether the existing venv is usable, not just whether it exists.
    venv_path = "venv"
    python, pip = venv_executables(venv_path)
    if os.path.exists(venv_path) and not venv_is_usable(python):
        timestamp = datetime.now().strftime("%Y%m%d-%H%M%S")
        backup_path = f"{venv_path}.broken-{timestamp}"
        print(f"Existing virtual environment is unusable; moving it to {backup_path}")
        shutil.move(venv_path, backup_path)

    if not os.path.exists(venv_path):
        print("📦 Creating virtual environment...")
        subprocess.run([sys.executable, "-m", "venv", venv_path], check=True)
        python, pip = venv_executables(venv_path)

    if not os.path.exists(pip):
        print("📦 Bootstrapping pip inside virtual environment...")
        subprocess.run([python, "-m", "ensurepip", "--upgrade"], check=True)

    if dependencies_are_available(python):
        print("Runtime dependencies already installed")
    else:
        print("📦 Installing dependencies...")
        subprocess.run(
            [python, "-m", "pip", "install", "-q", "-r", "requirements.txt"],
            check=True,
        )

    port = os.environ.get("PORT", "8080")
    env = os.environ.copy()
    env["PORT"] = port

    print()
    print("🚀 Starting QPDS Backend...")
    print("=" * 50)
    print(f"API: http://localhost:{port}")
    print(f"Health Check: http://localhost:{port}/health")
    print()
    print("Open frontend/index.html in your browser to use the UI")
    print("Press Ctrl+C to stop the server")
    print("=" * 50)

    # Start the backend
    try:
        subprocess.run([python, "-m", "backend.api.app"], env=env)
    except KeyboardInterrupt:
        print("\n👋 QPDS stopped")

if __name__ == "__main__":
    main()