SuperAPI AI 工具集

rust-cli

编程与开发

查看项目

更新于 10-16 03:17

技能介绍

该技能面向使用 Rust 构建命令行工具(CLI)与终端界面(TUI)应用的场景,主要基于 clap、ratatui、crossterm 等库,涵盖参数、标志、子命令、环境变量与配置文件(TOML)等内容。

主要能力与约束:强调用户易用性(清晰的帮助与错误信息)、配置优先级(CLI > 环境变量 > 配置文件 > 默认值)、退出码(出错时返回非零)、输出流区分(数据走 stdout、错误走 stderr)以及可中断性(处理 Ctrl+C)。关键规则包括:错误输出到 stderr、数据输出到 stdout 以便管道与脚本使用;遵循标准覆盖链;任何错误都返回非零退出码以支持脚本集成。

涉及的关键 crate:参数解析 clap、交互提示 dialoguer、进度条 indicatif、彩色输出 colored、终端 UI ratatui、终端控制 crossterm、控制台工具 console。

使用方式:提供 CLI 结构模式示例,使用 clap 的 Parser 与 Subcommand 派生宏定义顶层命令与子命令,例如 define 带 verbose 标志的 Cli 结构、定义 Init 与 Run 等子命令,并在 main 中通过 Cli::parse() 解析后按子命令分发,返回 anyhow::Result。必要命令与代码保持原样:use clap::{Parser, Subcommand};、#[derive(Parser)]、#[command(name = "myapp", about = "My CLI tool")]、#[arg(short, long)]、#[command(subcommand)]、#[derive(Subcommand)]、fn main() -> anyhow::Result<()>、Cli::parse()。

常见错误与修正:错误输出到 stdout 会破坏管道,应改用 eprintln!;缺少帮助文本影响体验,应加 #[arg(help = "...")];出错时 panic 会导致退出码不当,应使用 Result 并妥善处理;长耗时操作缺少进度提示会让用户困惑,可使用 indicatif。

适用场景:构建 Rust 命令行工具或 TUI 应用。限制方面:资料未提供具体安装命令、版本要求、平台差异与完整 API 说明,暂未提供。