run_script

在 rust 中运行 shell 脚本。

• 概述
• 用法
• 安装
• API 文档
• 贡献
• 版本历史
• 许可证

概述

此库允许根据其内容调用 shell 脚本。
虽然 std::process::Command 在执行独立命令时表现良好，但您需要更多的手动代码来获取脚本文本并执行它。
为此，创建了此库。

用法

只需包含库，并使用脚本文本和运行选项调用 run/spawn 函数

use run_script::ScriptOptions;

fn main() {
    let options = ScriptOptions::new();

    let args = vec![];

    // run the script and get the script execution output
    let (code, output, error) = run_script::run(
        r#"
         echo "Directory Info:"
         dir
         "#,
        &args,
        &options,
    )
    .unwrap();

    println!("Exit Code: {}", code);
    println!("Output: {}", output);
    println!("Error: {}", error);

    // run the script and get a handle to the running child process
    let child = run_script::spawn(
        r#"
         echo "Directory Info:"
         dir
         "#,
        &args,
        &options,
    )
    .unwrap();

    let spawn_output = child.wait_with_output().unwrap();

    println!("Success: {}", &spawn_output.status.success());
}

此库还提供了 run_script!、spawn_script! 和 run_script_or_exit! 宏，以实现更简单的使用。

use run_script::ScriptOptions;

fn main() {
    // simple call to run script with only the script text
    let (code, output, error) = run_script::run_script!(
        r#"
         echo "Test"
         exit 0
         "#
    )
    .unwrap();

    println!("Exit Code: {}", code);
    println!("Output: {}", output);
    println!("Error: {}", error);

    // run script invoked with the script text and options
    let options = ScriptOptions::new();
    let (code, output, error) = run_script::run_script!(
        r#"
         echo "Test"
         exit 0
         "#,
        &options
    )
    .unwrap();

    println!("Exit Code: {}", code);
    println!("Output: {}", output);
    println!("Error: {}", error);

    // run script invoked with all arguments
    let options = ScriptOptions::new();
    let (code, output, error) = run_script::run_script!(
        r#"
         echo "Test"
         exit 0
         "#,
        &vec!["ARG1".to_string(), "ARG2".to_string()],
        &options
    )
    .unwrap();

    println!("Exit Code: {}", code);
    println!("Output: {}", output);
    println!("Error: {}", error);

    // spawn_script! works the same as run_script! but returns the child process handle
    let child = run_script::spawn_script!(
        r#"
         echo "Test"
         exit 0
         "#
    )
    .unwrap();

    println!("PID: {}", child.id());
}

安装

为了使用此库，只需将其添加为依赖项

[dependencies]
run_script = "^0.10.1"

API 文档

请参阅完整文档： API 文档

贡献

请参阅 贡献指南

版本历史

请参阅 变更日志

许可证

由 Sagie Gur-Ari 开发并许可在 Apache 2 开源许可证下。