main.py

"""Entry point for running the hydroponics system."""

from __future__ import annotations

import logging
import os

from hydroponics.app.runner import run_configured_system
from hydroponics.config.registry import validate_startup_configuration
from hydroponics.storage.runtime_mode_store import (
    check_hardware_runtime_support,
    read_runtime_mode_state,
    write_runtime_mode_state,
)
from hydroponics.support.errors import ControlError, build_error_message
from hydroponics.support.runtime import ShutdownSignal


def main() -> None:
    """
    Summary:
        Launch the hydroponics system using the configured mode.
    Inputs:
        None.
    Outputs:
        None. Runs the configured system until interrupted.
    Side effects:
        Installs signal handlers and starts long running control loops.
    Error handling:
        ControlError: If the configured system fails to start.
    Ties to other methods:
        Called when running the repository entry point script.
    Why this exists:
        Centralized entry point keeps runtime behavior consistent.
    """
    try:
        validate_startup_configuration()
        target_mode = read_runtime_mode_state().target_mode
        if target_mode == "hardware":
            supported, reason = check_hardware_runtime_support()
            if not supported:
                os.environ["HYDROPONICS_SIM"] = "1"
                detail = reason or "Hardware mode is unavailable on this host."
                logging.warning(
                    build_error_message(
                        "main",
                        "main",
                        f"Requested hardware mode is not supported: {detail}",
                        hint="Falling back to simulator mode.",
                    )
                )
                try:
                    write_runtime_mode_state(target_mode="simulator")
                except Exception:
                    pass
            else:
                os.environ.pop("HYDROPONICS_SIM", None)
        else:
            os.environ["HYDROPONICS_SIM"] = "1"
        shutdown = ShutdownSignal()
        shutdown.install()
        try:
            run_configured_system(shutdown=shutdown)
        finally:
            shutdown.restore()
    except Exception as exc:
        raise ControlError(
            build_error_message(
                "main",
                "main",
                f"Failed to run configured system: {exc}",
            )
        ) from exc


if __name__ == "__main__":
    main()