run.py

"""
Test Harness Entry Point (tests/run.py)

Purpose:
This script orchestrates the testing workflow for the GoDarda site.
It validates the runtime environment, executes verification tests,
performs code compilation, and generates a summary report.

Key Features:
1. Orchestration: Coordinates title verification and code compilation steps.
2. Environment Validation: Checks Python version and directory structure.
3. Reporting: Calculates execution time and displays final results.
"""

import os
import sys
import time
import shutil
from pathlib import Path

# Automatically switch to the virtual environment if available
repo_root = Path(__file__).resolve().parent.parent
venv_dir = repo_root / ".venv"

if venv_dir.exists():
    python_exe = venv_dir / ("Scripts/python.exe" if sys.platform == "win32" else "bin/python")

    # If not running from the venv, re-execute using the venv's interpreter
    if python_exe.exists() and Path(sys.prefix).resolve() != venv_dir.resolve():
        os.execv(str(python_exe), [str(python_exe)] + sys.argv)

from compile import compile_snippets
from unittesting import TitleVerificationTest
from smoke import verify_page_titles
from report import print_report
from stats import STATS
from config import CONFIG


def main() -> None:
    """
    Executes the test suite, including environment checks, verification, and reporting.
    """
    # Ensure the Python runtime meets the minimum version requirement.
    if sys.version_info < (3, 7):
        print("Python 3.7 or later is needed for execution.")
        return

    # Check available memory (require at least 1GB)
    if CONFIG.AVAILABLE_RAM_GB < 1.0:
        print(f"Error: Insufficient memory. At least 1GB of available RAM is required. (Available: {CONFIG.AVAILABLE_RAM_GB:.2f} GB)")
        return

    start = time.time()
    interrupted = False
    try:
        cwd = os.getcwd()
        source = os.path.join(cwd, "pages")
        destination = os.path.join(cwd, ".codes")

        # Verify that the source directory exists.
        if not os.path.exists(source):
            print(f"Source path not found: {source}")
            return

        print(f"Starting test suite on {CONFIG.OS_NAME}.")
        print("Please wait, parallel execution in progress...")

        # Execute title verification.
        if CONFIG.IS_GITHUB_ACTIONS:
            TitleVerificationTest("test_site_titles").test_site_titles()
        else:
            verify_page_titles()

        # Execute snippet compilation if supported.
        if CONFIG.OS_NAME != "Windows":
            compile_snippets(source, destination)
            if os.path.exists(destination):
                shutil.rmtree(destination)

    except KeyboardInterrupt:
        interrupted = True

    except Exception as e:
        print("\n\033[91mExecution failed.\033[0m")
        print(f"Error details: {e}")
        print("\nPossible causes:")
        print(f"1. Local server not running at {CONFIG.BASE_URL}")
        print("2. Network connectivity issues.")
        print("3. Environment or configuration errors.")

    finally:
        print_report(
            STATS.matched,
            STATS.unmatched,
            STATS.compiled,
            STATS.uncompiled,
            interrupted,
        )

        end = time.time()
        total_seconds = round(end - start)
        m, s = divmod(total_seconds, 60)
        h, m = divmod(m, 60)

        print("-" * 100)
        time_str = (
            f"\033[91m{h:02d}:{m:02d}:{s:02d}\033[0m"
            if h >= 1
            else f"\033[92m{h:02d}:{m:02d}:{s:02d}\033[0m"
        )
        print(f"{'Total Execution Time':<25}: {time_str}")


if __name__ == "__main__":
    main()