Coverage for faststream/_internal/cli/supervisors/multiprocess.py: 51%
29 statements
« prev ^ index » next coverage.py v7.17.3, created at 2026-11-17 21:20 +0000
« prev ^ index » next coverage.py v7.17.3, created at 2026-11-17 21:20 +0000
1import signal
2from typing import TYPE_CHECKING
4from faststream._internal.cli.supervisors.basereload import BaseReload
5from faststream._internal.cli.supervisors.utils import stop_process
6from faststream._internal.logger import logger
8SIGKILL: int | None = getattr(signal, "SIGKILL", None)
10if TYPE_CHECKING:
11 from multiprocessing.context import SpawnProcess
13 from faststream._internal.cli.dto import RunArgs, RunFunction
16class Multiprocess(BaseReload):
17 """A class to represent a multiprocess."""
19 __slots__ = (
20 "processes",
21 "workers",
22 )
24 def __init__(
25 self,
26 target: "RunFunction",
27 args: "RunArgs",
28 workers: int,
29 reload_delay: float = 0.5,
30 ) -> None:
31 super().__init__(target, args, reload_delay)
33 self.workers = workers
34 self.processes: list[SpawnProcess] = []
36 def startup(self) -> None:
37 logger.info("Started parent process [%s]", self.pid)
39 for worker_id in range(self.workers):
40 process = self.start_process(worker_id=worker_id)
41 logger.info("Started child process %s [%s]", worker_id, process.pid)
42 self.processes.append(process)
44 def shutdown(self) -> None:
45 for worker_id, process in enumerate(self.processes):
46 logger.info("Stopping child process %s [%s]", worker_id, process.pid)
47 stop_process(process)
49 logger.info("Stopping parent process [%s]", self.pid)
51 def restart(self) -> None:
52 active_processes = []
54 for worker_id, process in enumerate(self.processes):
55 if process.is_alive():
56 active_processes.append(process)
57 continue
59 log_msg = "Worker %s (pid:%s) exited with code %s."
60 if (
61 SIGKILL is not None
62 and process.exitcode
63 and abs(process.exitcode) == SIGKILL
64 ):
65 log_msg += " Perhaps out of memory?"
66 logger.error(log_msg, worker_id, process.pid, process.exitcode)
68 process.kill()
70 new_process = self.start_process(worker_id=worker_id)
71 logger.info("Started child process [%s]", new_process.pid)
72 active_processes.append(new_process)
74 self.processes = active_processes
76 def should_restart(self) -> bool:
77 return not all(p.is_alive() for p in self.processes)