Rust进程控制库proc-exit的使用：安全终止程序与自定义退出码管理

特性

• i32 新类型用于退出码
  • 可以表示任何有效的退出码
  • 类型安全，操作仅限于退出码的有效范围
• 包含标准退出码和信号退出码
• 可与 main、std::process 和 std::io::Error 集成
• 支持静默退出（通过其他方式报告错误消息）

安装

添加到你的 Cargo.toml:

proc-exit = "2.0.2"

使用示例

基本用法

use proc_exit::prelude::*;

fn main() {
    if some_condition() {
        // 使用标准退出码
        proc_exit::exit(proc_exit::Code::USAGE);
    }
    
    // 使用自定义退出码
    proc_exit::exit(42);
}

与main集成

use proc_exit::prelude::*;

fn main() -> proc_exit::ExitResult {
    // 你的程序逻辑
    if some_error_condition() {
        // 返回错误退出码
        return proc_exit::Code::DATA_ERR.to_result();
    }
    
    // 成功返回
    proc_exit::Code::SUCCESS.to_result()
}

与std::process和std::io::Error集成

use proc_exit::prelude::*;
use std::fs::File;
use std::io;

fn open_file() -> proc_exit::ExitResult {
    File::open("not_exist.txt")
        .map_err(|e| proc_exit::Code::NO_INPUT.with_message(e))?;
    Ok(())
}

fn main() -> proc_exit::ExitResult {
    open_file()?;
    Ok(())
}

完整示例

use proc_exit::prelude::*;

fn main() -> proc_exit::ExitResult {
    let args: Vec<String> = std::env::args().collect();
    
    if args.len() < 2 {
        eprintln!("Usage: {} <filename>", args[0]);
        return proc_exit::Code::USAGE.to_result();
    }
    
    let filename = &args[1];
    let content = std::fs::read_to_string(filename)
        .map_err(|e| proc_exit::Code::NO_INPUT.with_message(e))?;
        
    if content.is_empty() {
        eprintln!("Error: File is empty");
        return proc_exit::Code::DATA_ERR.to_result();
    }
    
    println!("File content: {}", content);
    
    // 成功退出
    proc_exit::Code::SUCCESS.to_result()
}

完整示例demo

下面是一个更完整的文件处理程序示例，展示了proc-exit库的各种用法：

use proc_exit::prelude::*;
use std::fs;
use std::path::Path;

// 检查文件是否存在且可读
fn check_file(filename: &str) -> proc_exit::ExitResult {
    if !Path::new(filename).exists() {
        eprintln!("Error: File '{}' does not exist", filename);
        return proc_exit::Code::NO_INPUT.to_result();
    }

    // 检查文件权限
    match fs::metadata(filename) {
        Ok(metadata) => {
            if metadata.permissions().readonly() {
                eprintln!("Error: File '{}' is read-only", filename);
                return proc_exit::Code::NO_PERM.to_result();
            }
        }
        Err(e) => {
            return proc_exit::Code::OS_ERR
                .with_message(format!("Failed to access file metadata: {}", e))
                .to_result();
        }
    }

    Ok(())
}

// 处理文件内容
fn process_file(filename: &str) -> proc_exit::ExitResult {
    let content = fs::read_to_string(filename)
        .map_err(|e| proc_exit::Code::IO_ERR.with_message(e))?;

    if content.trim().is_empty() {
        eprintln!("Warning: File '{}' is empty", filename);
        return proc_exit::Code::DATA_ERR.to_result();
    }

    println!("Processing file content...");
    println!("First 100 chars: {}", &content[..content.len().min(100)]);

    // 模拟处理过程
    if content.contains("error") {
        eprintln!("Error: File contains 'error' keyword");
        return proc_exit::Code::DATA_ERR.to_result();
    }

    // 模拟成功处理
    println!("File processed successfully");
    Ok(())
}

fn main() -> proc_exit::ExitResult {
    let args: Vec<String> = std::env::args().collect();

    // 参数检查
    if args.len() != 2 {
        eprintln!("Usage: {} <filename>", args[0]);
        return proc_exit::Code::USAGE.to_result();
    }

    let filename = &args[1];

    // 检查文件
    check_file(filename)?;

    // 处理文件
    process_file(filename)?;

    // 成功退出
    proc_exit::Code::SUCCESS.to_result()
}

相关库

其他可能对测试命令行程序有用的库：

• duct 用于协调多个进程
• commandspec 用于更容易地编写命令
• rexpect 用于控制交互式程序
• assert_cmd 可以重用以简化控制CLI

许可证

根据以下任一许可证授权：

• Apache License, Version 2.0
• MIT license

由你选择。