Framework CLI para Rust: clap

O que é clap?

clap (Command Line Argument Parser) é um framework poderoso e rápido para criar interfaces de linha de comando (CLI) em Rust. Ele permite que desenvolvedores definam facilmente argumentos, opções, subcomandos e gerem ajuda automaticamente. clap é conhecido por sua performance, segurança e facilidade de uso. É uma das crates mais populares no ecossistema Rust para trabalhar com CLI.

Para que serve o clap?

Criar aplicações CLI manualmente é um processo trabalhoso que exige manipulação de strings, validação e formatação de erros. clap resolve esses problemas: ele analisa argumentos automaticamente, verifica tipos, gera ajuda (--help) e trata erros. Se você está escrevendo uma utilidade em Rust, uma ferramenta para DevOps ou qualquer ferramenta de console, clap economizará horas de desenvolvimento e deixará o código mais limpo.

Como instalar?

Adicione a dependência no Cargo.toml:

[dependencies]clap = { version = "4.5", features = ["derive"] }

Ou instale via cargo:

cargo add clap --features derive

Funcionalidades principais

• Análise declarativa — uso de atributos (derive) para definir argumentos.
• Suporte a subcomandos — interfaces no estilo git (ex.: git commit -m).
• Autocompletar — geração de scripts para Bash, Zsh, Fish.
• Validação — verificação de quantidade, tipos e intervalos de valores.
• Saída colorida — destaque de erros e ajuda.

Exemplo de código em Rust

use clap::Parser;

#[derive(Parser)]#[command(name = "greeter")]#[command(about = "Saudação simples")]struct Cli {    /// Nome do usuário    name: String,

    /// Número de repetições    #[arg(short, long, default_value_t = 1)]    count: u8,}

fn main() {    let cli = Cli::parse();    for _ in 0..cli.count {        println!("Olá, {}!", cli.name);    }}

Execução: cargo run -- --help mostrará a ajuda gerada.

Quando usar?

clap é ideal para qualquer ferramenta CLI em Rust: utilitários de sistema, builders, analisadores de código, scripts de automação. Se sua aplicação aceita argumentos de linha de comando — clap será a melhor escolha. Ele também é adequado para criar interfaces complexas com múltiplos subcomandos (como em Docker ou Git).

Graças à tipagem estrita do Rust e às macros do clap, erros em CLI são detectados em tempo de compilação, tornando as aplicações mais confiáveis. É o padrão de facto para CLI no mundo Rust.