Function main

ci/docs.py:151–188

()

def main() -> None:
    is_windows = platform.system() == "Windows"
    # is_macos = platform.system() == "Darwin"
    _, commit_msg = get_git_info()

    if is_windows:
        doxygen_bin = install_doxygen_windows()
        # add to path C:\Program Files\Graphviz\bin\
        os.environ["PATH"] += os.pathsep + r"C:\Program Files\Graphviz\bin"
    else:
        doxygen_bin = install_doxygen_unix()

    # install_theme()

    # install_graphviz()  # Work in progress

    # Verify Graphviz installation
    try:
        dot_version = run("dot -V", check=False)
        print(f"Graphviz detected: {dot_version}")
    except KeyboardInterrupt as ki:
        handle_keyboard_interrupt(ki)
        raise
    except Exception:
        warnings.warn(
            "Graphviz (dot) not found in PATH. Diagrams may not be generated."
        )

    # Check it graphviz is installed
    # if linux
    if not is_windows:
        run("dot -Tsvg -Kneato -Grankdir=LR", check=True)

    generate_docs(doxygen_bin=doxygen_bin)

    print(f"\n✅ Docs generated in: {HTML_OUTPUT_DIR}")
    print(f"📄 Commit message: {commit_msg}")
    print("✨ You can now manually deploy to GitHub Pages or automate this step.")


if __name__ == "__main__":