running-process 4.4.0

Subprocess and PTY runtime for the running-process project
Documentation
#[cfg(unix)]
pub mod unix;
#[cfg(windows)]
pub mod windows;

use std::path::Path;

/// Write the current process ID to the given PID file, creating parent
/// directories as needed.
pub fn write_pid_file(path: &Path) -> std::io::Result<()> {
    if let Some(parent) = path.parent() {
        std::fs::create_dir_all(parent)?;
    }
    std::fs::write(path, std::process::id().to_string())
}

/// Read a PID from the given file, returning `None` if the file is missing
/// or its contents are not a valid `u32`.
pub fn read_pid_file(path: &Path) -> Option<u32> {
    std::fs::read_to_string(path).ok()?.trim().parse().ok()
}

/// Remove the PID file, ignoring errors (e.g. if it does not exist).
pub fn remove_pid_file(path: &Path) {
    let _ = std::fs::remove_file(path);
}

/// Check whether a process with the given PID is currently alive.
pub fn is_process_alive(pid: u32) -> bool {
    use sysinfo::System;

    let pid = sysinfo::Pid::from_u32(pid);
    let mut sys = System::new();
    sys.refresh_process(pid);
    sys.process(pid).is_some()
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn write_and_read_pid_file_round_trip() {
        let temp = tempfile::tempdir().unwrap();
        let pid_path = temp.path().join("nested").join("daemon.pid");

        write_pid_file(&pid_path).unwrap();

        assert!(pid_path.exists());
        assert_eq!(read_pid_file(&pid_path), Some(std::process::id()));
    }

    #[test]
    fn read_pid_file_returns_none_for_missing_or_invalid_content() {
        let temp = tempfile::tempdir().unwrap();
        let missing = temp.path().join("missing.pid");
        let invalid = temp.path().join("invalid.pid");
        std::fs::write(&invalid, "not-a-pid").unwrap();

        assert_eq!(read_pid_file(&missing), None);
        assert_eq!(read_pid_file(&invalid), None);
    }

    #[test]
    fn remove_pid_file_ignores_missing_files() {
        let temp = tempfile::tempdir().unwrap();
        let pid_path = temp.path().join("daemon.pid");
        std::fs::write(&pid_path, "1234").unwrap();

        remove_pid_file(&pid_path);
        remove_pid_file(&pid_path);

        assert!(!pid_path.exists());
    }

    #[test]
    fn is_process_alive_distinguishes_real_and_fake_pids() {
        assert!(is_process_alive(std::process::id()));
        assert!(!is_process_alive(4_000_000));
    }
}