modules/business-planning/scripts/check_dependencies.py

#!/usr/bin/env python3
"""Check declared Business Planning dependencies."""

from __future__ import annotations

import argparse
import importlib.util
import logging
import sys
from pathlib import Path

__all__ = ["main"]

LOGGER = logging.getLogger(__name__)
PLUGIN_ROOT = Path(__file__).resolve().parents[1]


def _activate_assurance() -> None:
    """Expose the packaged or repository Vera assurance module."""

    candidates = (
        PLUGIN_ROOT / "vendor" / "modules",
        PLUGIN_ROOT.parent / "_shared" / "vendor" / "modules",
    )
    for candidate in candidates:
        if (candidate / "vera_assurance" / "__init__.py").is_file():
            sys.path.insert(0, str(candidate))
            return
    raise RuntimeError("Vera assurance module is unavailable.")


def main(argv: list[str] | None = None) -> int:
    """Validate the exact published runtime requirements."""

    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument(
        "--requirements",
        type=Path,
        default=PLUGIN_ROOT / "requirements.txt",
    )
    args = parser.parse_args(argv)
    if not args.requirements.is_file():
        LOGGER.error("Requirements file not found: %s", args.requirements)
        return 1
    if importlib.util.find_spec("openpyxl") is None:
        LOGGER.error("Missing dependency: openpyxl")
        return 1
    if args.requirements.name == "requirements-pdf.txt":
        if importlib.util.find_spec("playwright") is None:
            LOGGER.error("Missing optional PDF dependency: playwright")
            return 1
        from playwright.sync_api import sync_playwright

        with sync_playwright() as runtime:
            if not Path(runtime.chromium.executable_path).is_file():
                LOGGER.error(
                    "Optional PDF export requires a provisioned Chromium browser"
                )
                return 1
    try:
        _activate_assurance()
        import vera_assurance  # noqa: F401
    except (ImportError, RuntimeError) as exc:
        LOGGER.error("Missing dependency: %s", exc)
        return 1
    LOGGER.info("OK: Business Planning dependencies are available.")
    return 0


if __name__ == "__main__":
    logging.basicConfig(level=logging.INFO, format="%(message)s")
    raise SystemExit(main())