Struct ProcessManager 

pub struct ProcessManager { /* private fields */ }

Manages external child processes with graceful shutdown and dependency ordering

ProcessManager tracks and manages child processes spawned as external binaries. It provides:

• Process tracking with PIDs
• Dependency-based shutdown ordering
• Graceful shutdown with configurable timeout
• Force kill fallback
• Integration with runtime’s ShutdownHandle

Implementations

impl ProcessManager

pub fn new() -> Self

Create a new process manager

pub fn with_shutdown_handle(shutdown_handle: ShutdownHandle) -> Self

Create a new process manager with shutdown handle

pub fn set_shutdown_timeout(&mut self, timeout: Duration)

Set the default shutdown timeout

pub fn track(&mut self, name: String, child: Child)

Add a process to track

Arguments

• name - Process name/identifier
• child - Child process handle

pub fn remove(&mut self, name: &str) -> Option<Child>

Remove and return a process by name

pub fn add_dependency(&mut self, node: String, dependency: String)

Add a dependency relationship

Specifies that node depends on dependency and should be stopped before it.

Arguments

• node - The node that depends on another
• dependency - The node that is depended upon

pub fn list(&self) -> Vec<String>

Get list of all tracked process names

pub fn len(&self) -> usize

Get the number of tracked processes

pub fn is_empty(&self) -> bool

Check if any processes are being tracked

pub fn status_all(&mut self) -> HashMap<String, ProcessStatus>

Get status of all processes

pub fn processes(&mut self) -> Vec<ProcessInfo>

Get information about all tracked processes

pub fn shutdown_order(&self) -> Vec<String>

Calculate shutdown order based on dependency graph

Returns nodes in the order they should be stopped (dependents before dependencies).

pub fn stop_graceful(&mut self, name: &str, timeout: Duration) -> Result<()>

Stop a specific process gracefully with timeout

Arguments

• name - Name of the process to stop
• timeout - How long to wait for graceful shutdown before force killing

Returns

Ok(()) if stopped successfully (graceful or force), Err if not found or error

pub fn force_kill(&mut self, name: &str) -> Result<()>

Force kill a process immediately

pub fn shutdown_all(&mut self)

Stop all processes in dependency order with graceful shutdown

pub fn is_running(&mut self, name: &str) -> bool

Check if a specific process is running

Trait Implementations

impl Default for ProcessManager

fn default() -> Self

Returns the “default value” for a type.

impl Drop for ProcessManager

fn drop(&mut self)

Executes the destructor for this type.