Rust插件库argyle的使用：高效灵活的插件系统扩展库

Argyle是一个简单的流式CLI参数解析器/迭代器，提供了介于标准库的std::env::args_os和完整服务库如clap之间的中间解决方案。

功能特点

• 执行基本规范化处理
• 以非panic方式处理字符串转换
• 识别简写值赋值如-kval、-k=val、--key=val
• 处理命令结束(--)参数
• 帮助识别应用程序预期的特殊键/值

安装

在Cargo.toml的dependencies中添加：

[dependencies]
argyle = "0.13.*"

示例代码

以下是内容中提供的示例：

use argyle::{Argument, KeyWord};
use std::path::PathBuf;

#[derive(Debug, Clone, Default)]
/// # Configuration.
struct Settings {
    threads: usize,
    verbose: bool,
    paths: Vec<PathBuf>,
}

let args = argyle::args()
    .with_keywords([
        KeyWord::key("-h").unwrap(),            // Boolean flag (short).
        KeyWord::key("--help").unwrap(),        // Boolean flag (long).
        KeyWord::key_with_value("-j").unwrap(), // Expects a value.
        KeyWord::key_with_value("--threads").unwrap(),
    ]);

// Loop and handle!
let mut settings = Settings::default();
for arg in args {
    match arg {
        // Help flag match.
        Argument::Key("-h" | "--help") => {
            println!("Help Screen Goes Here.");
            return;
        },

        // Thread option match.
        Argument::KeyWithValue("-j" | "--threads", value) => {
            settings.threads = value.parse()
                .expect("Maximum threads must be a number!");
        },

        // Something else.
        Argument::Other(v) => {
            settings.paths.push(PathBuf::from(v));
        },

        // Also something else, but not String-able. PathBuf doesn't care
        // about UTF-8, though, so it might be fine!
        Argument::InvalidUtf8(v) => {
            settings.paths.push(PathBuf::from(v));
        },

        // Nothing else is relevant here.
        _ => {},
    }
}

// Now that you're set up, do stuff…

完整示例demo

基于上述示例，这里是一个更完整的命令行参数处理demo：

use argyle::{Argument, KeyWord};
use std::path::PathBuf;

#[derive(Debug, Clone, Default)]
struct AppConfig {
    threads: usize,
    verbose: bool,
    input_files: Vec<PathBuf>,
    output_dir: Option<PathBuf>,
}

fn main() {
    // 定义支持的参数
    let args = argyle::args()
        .with_keywords([
            KeyWord::key("-h").unwrap(),            // 帮助标志(短)
            KeyWord::key("--help").unwrap(),        // 帮助标志(长)
            KeyWord::key("-v").unwrap(),           // 详细模式标志
            KeyWord::key("--verbose").unwrap(),     // 详细模式标志
            KeyWord::key_with_value("-j").unwrap(), // 线程数
            KeyWord::key_with_value("--threads").unwrap(),
            KeyWord::key_with_value("-o").unwrap(), // 输出目录
            KeyWord::key_with_value("--output").unwrap(),
        ]);

    let mut config = AppConfig {
        threads: 4,  // 默认4个线程
        ..Default::default()
    };

    // 处理参数
    for arg in args {
        match arg {
            // 帮助标志
            Argument::Key("-h" | "--help") => {
                print_help();
                return;
            },

            // 详细模式标志
            Argument::Key("-v" | "--verbose") => {
                config.verbose = true;
            },

            // 线程数设置
            Argument::KeyWithValue("-j" | "--threads", value) => {
                config.threads = value.parse()
                    .expect("线程数必须是正整数!");
            },

            // 输出目录设置
            Argument::KeyWithValue("-o" | "--output", value) => {
                config.output_dir = Some(PathBuf::from(value));
            },

            // 输入文件
            Argument::Other(v) => {
                config.input_files.push(PathBuf::from(v));
            },

            // 非UTF-8路径
            Argument::InvalidUtf8(v) => {
                config.input_files.push(PathBuf::from(v));
            },

            // 忽略其他参数
            _ => {},
        }
    }

    // 检查是否有输入文件
    if config.input_files.is_empty() {
        eprintln!("错误: 未指定输入文件");
        print_help();
        std::process::exit(1);
    }

    // 使用配置运行程序
    run_app(config);
}

fn print_help() {
    println!("用法: myapp [选项] 输入文件...");
    println!();
    println!("选项:");
    println!("  -h, --help        显示帮助信息");
    println!("  -v, --verbose     启用详细输出");
    println!("  -j, --threads N   设置线程数 (默认: 4)");
    println!("  -o, --output DIR  设置输出目录");
}

fn run_app(config: AppConfig) {
    println!("运行配置: {:?}", config);
    // 这里实现实际的应用程序逻辑
    // ...
}

特性

可以通过启用非默认的try_paths特性来暴露额外的Argument::Path变体，用于未关联且未识别的值，其中std::fs::exists() == Ok(true)。

许可证

本项目采用WTFPL许可证。