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

1import signal 

2from typing import TYPE_CHECKING 

3 

4from faststream._internal.cli.supervisors.basereload import BaseReload 

5from faststream._internal.cli.supervisors.utils import stop_process 

6from faststream._internal.logger import logger 

7 

8SIGKILL: int | None = getattr(signal, "SIGKILL", None) 

9 

10if TYPE_CHECKING: 

11 from multiprocessing.context import SpawnProcess 

12 

13 from faststream._internal.cli.dto import RunArgs, RunFunction 

14 

15 

16class Multiprocess(BaseReload): 

17 """A class to represent a multiprocess.""" 

18 

19 __slots__ = ( 

20 "processes", 

21 "workers", 

22 ) 

23 

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) 

32 

33 self.workers = workers 

34 self.processes: list[SpawnProcess] = [] 

35 

36 def startup(self) -> None: 

37 logger.info("Started parent process [%s]", self.pid) 

38 

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) 

43 

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) 

48 

49 logger.info("Stopping parent process [%s]", self.pid) 

50 

51 def restart(self) -> None: 

52 active_processes = [] 

53 

54 for worker_id, process in enumerate(self.processes): 

55 if process.is_alive(): 

56 active_processes.append(process) 

57 continue 

58 

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) 

67 

68 process.kill() 

69 

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) 

73 

74 self.processes = active_processes 

75 

76 def should_restart(self) -> bool: 

77 return not all(p.is_alive() for p in self.processes)