program 0.3.0

Program: provide a rust analogue to C's perror
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

//! Program provides a single divergent function (`perror`) to emulate C's `perror`

#![warn(clippy::pedantic)]

use std::ffi;
use std::io::{self, Write};
use std::process;

/// Print an error message to `stderr` and exit with an exit status of `1`.
///
/// While this function attempts to obtain and write the  name of the current process to `stderr`,
/// write `e` to `stderr`, and exit with an exit status of `1`, only exiting is guranteed.
/// Unfortunately a lot can go wrong when getting the name of the current process.
/// If  for any reason the name of the current process cannot be formed, just print
/// the error given by the user. If the error given by the use cannot be written to stderr just
/// exit with an exit status of 1.
pub fn perror<E: std::fmt::Display>(e: E) -> ! {
    if let Some(cmd) = process_name() {
        let _ = write!(io::stderr(), "{}: ", cmd.to_string_lossy());
    }

    let _ = writeln!(io::stderr(), "{}", e);
    process::exit(1)
}

/// Attempt to obtain the name of the current process.
///
/// Return `Some(process_name)` or `None` if it cannot be obtained.
fn process_name() -> Option<ffi::OsString> {
    let cmd = std::env::current_exe().ok()?;
    let process = cmd.file_name()?;
    Some(process.to_os_string())
}