msobczyk/handle signals in docker entrypoint

handle signals in docker entrypoint, handle exit in start_clive script (close container on terminal close), closes issue #274 (closed)

tests/functional/test_signals.py

+from __future__ import annotations
+
+import asyncio
+import os
+import signal
+import subprocess
+from typing import Final
+
+import pytest
+import test_tools as tt
+
+from clive.__private.core.constants.setting_identifiers import DATA_PATH
+from clive.__private.settings import clive_prefixed_envvar
+from clive_local_tools.waiters import wait_for
+
+
+@pytest.mark.parametrize("signal_number", [signal.SIGHUP, signal.SIGINT, signal.SIGQUIT, signal.SIGTERM])
+async def test_close_on_signal(signal_number: signal.Signals) -> None:
+    # ARRANGE
+    def get_process_return_code() -> int | None:
+        return process.returncode
+
+    working_directory = tt.context.get_current_directory()
+    entry_point: Final[str] = "clive"
+    envs = os.environ
+    envs[clive_prefixed_envvar(DATA_PATH)] = working_directory.as_posix()
+    beekeeper_pidfile = working_directory / "beekeeper" / "beekeeper.pid"
+    clive_output = working_directory / "clive_output.log"
+
+    # ACT
+    with clive_output.open("w") as out:
+        process = await asyncio.create_subprocess_exec(
+            entry_point, stdout=out, stderr=out, stdin=subprocess.PIPE, env=envs
+        )
+        await wait_for(lambda: beekeeper_pidfile.exists(), "Beekeeper did not spawn")
+        process.send_signal(signal_number)
+
+        # ASSERT
+        await wait_for(lambda: not beekeeper_pidfile.exists(), "Beekeeper did not close")
+        await wait_for(
+            lambda: get_process_return_code() == 0,
+            lambda: f"Clive tui process not closed properly. Return code is {get_process_return_code()}",
+        )