ledgrab/server/src/ledgrab/__main__.py

"""Entry point for ``python -m ledgrab``.

Starts the uvicorn server and, on Windows when *pystray* is installed,
shows a system-tray icon with **Show UI** / **Exit** actions.
"""

import asyncio
import os
import socket
import sys
import threading
import time
import webbrowser
from pathlib import Path
from urllib.error import URLError
from urllib.request import urlopen


def _fix_embedded_tcl_paths() -> None:
    """Point TCL_LIBRARY/TK_LIBRARY at the bundled tcl/tk dirs.

    The Windows installer ships embedded Python with tcl8.6/ and tk8.6/
    next to python.exe, but Tcl's auto-detection searches ``<exe>/../lib/tcl8.6``
    and similar paths that don't exist in our layout. Without these env vars,
    ``tkinter.Tk()`` fails with "Can't find a usable init.tcl", which breaks
    both the screen overlay and tray messageboxes.
    """
    exe_dir = Path(sys.executable).parent
    tcl_dir = exe_dir / "tcl8.6"
    tk_dir = exe_dir / "tk8.6"
    if (tcl_dir / "init.tcl").is_file():
        os.environ.setdefault("TCL_LIBRARY", str(tcl_dir))
    if (tk_dir / "tk.tcl").is_file():
        os.environ.setdefault("TK_LIBRARY", str(tk_dir))


_fix_embedded_tcl_paths()

import uvicorn  # noqa: E402

from ledgrab.config import get_config  # noqa: E402
from ledgrab.server_ref import set_server, set_tray  # noqa: E402
from ledgrab.tray import PYSTRAY_AVAILABLE, TrayManager  # noqa: E402
from ledgrab.utils import setup_logging, get_logger  # noqa: E402

setup_logging()
logger = get_logger(__name__)

_ICON_PATH = Path(__file__).parent / "static" / "icons" / "icon-192.png"


def _run_server(server: uvicorn.Server) -> None:
    """Run uvicorn in a dedicated asyncio event loop (background thread)."""
    loop = asyncio.new_event_loop()
    asyncio.set_event_loop(loop)
    loop.run_until_complete(server.serve())


def _wait_for_server(port: int, timeout: float = 30.0, interval: float = 0.25) -> bool:
    """Poll /health until the server responds or *timeout* seconds elapse."""
    url = f"http://localhost:{port}/health"
    deadline = time.monotonic() + timeout
    while time.monotonic() < deadline:
        try:
            with urlopen(url, timeout=1) as resp:  # noqa: S310 - localhost only
                if 200 <= resp.status < 500:
                    return True
        except (URLError, ConnectionError, OSError, TimeoutError):
            pass
        time.sleep(interval)
    return False


def _open_browser(port: int) -> None:
    """Open the UI in the default browser once the server is ready."""
    if not _wait_for_server(port):
        logger.warning("Server did not become ready in time; opening browser anyway")
    webbrowser.open(f"http://localhost:{port}")


def _is_restart() -> bool:
    """Detect if this is a restart (vs first launch)."""
    return os.environ.get("LEDGRAB_RESTART", "") == "1"


def _is_autostart() -> bool:
    """Detect if launched via the Windows autostart shortcut."""
    return os.environ.get("LEDGRAB_AUTOSTART", "") == "1"


def _should_skip_browser() -> bool:
    """Skip auto-opening the browser on restarts and on Windows login autostart."""
    return _is_restart() or _is_autostart()


def _check_port(host: str, port: int) -> None:
    """Exit with a clear message if the port is already in use."""
    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as sock:
        sock.settimeout(1)
        try:
            sock.bind((host, port))
        except OSError:
            logger.error("Port %d is already in use on %s", port, host)
            sys.exit(1)


def main() -> None:
    config = get_config()
    _check_port(config.server.host, config.server.port)

    uv_config = uvicorn.Config(
        "ledgrab.main:app",
        host=config.server.host,
        port=config.server.port,
        log_level=config.server.log_level.lower(),
    )
    server = uvicorn.Server(uv_config)
    set_server(server)

    use_tray = PYSTRAY_AVAILABLE and (sys.platform == "win32" or _force_tray())

    if use_tray:
        logger.info("Starting with system tray icon")

        # Uvicorn in a background thread
        server_thread = threading.Thread(
            target=_run_server,
            args=(server,),
            daemon=True,
        )
        server_thread.start()

        # Browser after a short delay (skip on restart and on Windows login autostart)
        if not _should_skip_browser():
            threading.Thread(
                target=_open_browser,
                args=(config.server.port,),
                daemon=True,
            ).start()

        # Tray on main thread (blocking)
        tray = TrayManager(
            icon_path=_ICON_PATH,
            port=config.server.port,
            on_exit=lambda: _request_shutdown(server),
        )
        set_tray(tray)
        tray.run()

        # Tray exited — wait for server to finish its graceful shutdown
        server_thread.join(timeout=10)
    else:
        if not PYSTRAY_AVAILABLE:
            logger.info("System tray not available (install pystray for tray support)")
        server.run()


def _request_shutdown(server: uvicorn.Server) -> None:
    """Signal uvicorn to perform a graceful shutdown."""
    server.should_exit = True


def _force_tray() -> bool:
    """Allow forcing tray on non-Windows via LEDGRAB_TRAY=1."""
    import os

    return os.environ.get("LEDGRAB_TRAY", "").strip() in ("1", "true", "yes")


if __name__ == "__main__":
    main()