Rust二进制工具管理库binstalk-bins的使用，高效安装与管理Rust命令行工具链

安装

在项目目录中运行以下Cargo命令：

cargo add binstalk-bins

或者将以下行添加到您的Cargo.toml中：

binstalk-bins = "0.6.14"

基本使用示例

以下是使用binstalk-bins管理Rust二进制工具链的基本示例：

use binstalk_bins::Binaries;

fn main() {
    // 初始化二进制工具管理器
    let binaries = Binaries::new().expect("Failed to initialize binaries manager");
    
    // 安装一个工具 (例如: ripgrep)
    binaries.install("ripgrep").expect("Failed to install ripgrep");
    
    // 检查工具是否已安装
    if binaries.is_installed("ripgrep") {
        println!("ripgrep is installed");
    }
    
    // 列出所有已安装的工具
    let installed = binaries.list_installed().expect("Failed to list installed tools");
    println!("Installed tools: {:?}", installed);
    
    // 更新所有已安装的工具
    binaries.update_all().expect("Failed to update tools");
    
    // 卸载工具
    binaries.uninstall("ripgrep").expect("Failed to uninstall ripgrep");
}

高级功能示例

use binstalk_bins::{Binaries, InstallOptions};

fn main() {
    let binaries = Binaries::new().expect("Failed to initialize binaries manager");
    
    // 自定义安装选项
    let options = InstallOptions {
        version: Some("13.0.0".to_string()),  // 指定版本
        force: true,                          // 强制重新安装
        features: vec!["pcre2".to_string()],  // 启用特定功能
        ..Default::default()
    };
    
    // 使用自定义选项安装工具
    binaries.install_with_options("ripgrep", &options)
        .expect("Failed to install ripgrep with custom options");
    
    // 获取工具的元数据
    let metadata = binaries.get_metadata("ripgrep")
        .expect("Failed to get ripgrep metadata");
    println!("ripgrep metadata: {:?}", metadata);
    
    // 检查工具更新
    if binaries.check_update("ripgrep").expect("Failed to check update") {
        println!("ripgrep has available updates");
    }
}

完整示例代码

//! 完整的binstalk-bins使用示例
//! 包含安装、管理、更新和卸载Rust二进制工具的全过程

use binstalk_bins::{Binaries, InstallOptions};

fn main() {
    // 1. 初始化工具管理器
    let binaries = match Binaries::new() {
        Ok(b) => b,
        Err(e) => {
            eprintln!("初始化失败: {}", e);
            return;
        }
    };

    // 2. 基本安装演示
    println!("=== 基本安装演示 ===");
    let tool_name = "ripgrep";
    
    // 检查是否已安装
    if !binaries.is_installed(tool_name) {
        // 安装工具
        if let Err(e) = binaries.install(tool_name) {
            eprintln!("安装{}失败: {}", tool_name, e);
            return;
        }
        println!("成功安装: {}", tool_name);
    } else {
        println!("{}已安装", tool_name);
    }

    // 3. 高级安装选项演示
    println!("\n=== 高级安装选项演示 ===");
    let advanced_tool = "fd-find";
    
    let options = InstallOptions {
        version: Some("8.7.0".to_string()),  // 指定版本
        force: false,                        // 不强制重新安装
        features: vec!["jwalk".to_string()], // 启用jwalk特性
        ..Default::default()
    };

    match binaries.install_with_options(advanced_tool, &options) {
        Ok(_) => println!("成功安装: {} (带自定义选项)", advanced_tool),
        Err(e) => eprintln!("安装失败: {}", e),
    }

    // 4. 工具管理操作
    println!("\n=== 工具管理操作 ===");
    
    // 列出所有已安装工具
    match binaries.list_installed() {
        Ok(tools) => println!("已安装工具: {:?}", tools),
        Err(e) => eprintln!("获取已安装工具列表失败: {}", e),
    }

    // 检查更新
    match binaries.check_update(tool_name) {
        Ok(has_update) => {
            if has_update {
                println!("{}有可用更新", tool_name);
            } else {
                println!("{}已是最新版本", tool_name);
            }
        }
        Err(e) => eprintln!("检查更新失败: {}", e),
    }

    // 更新所有工具
    println!("\n正在更新所有工具...");
    match binaries.update_all() {
        Ok(_) => println!("所有工具更新完成"),
        Err(e) => eprintln!("更新失败: {}", e),
    }

    // 5. 卸载工具
    println!("\n=== 卸载工具演示 ===");
    match binaries.uninstall(advanced_tool) {
        Ok(_) => println!("已卸载: {}", advanced_tool),
        Err(e) => eprintln!("卸载失败: {}", e),
    }
}

许可证

binstalk-bins采用GPL-3.0-only许可证。