Learn Rust Coding · Lezione

Fondamenti di clap

Parsing degli argomenti

Fondamenti di clap è una lezione Learn Rust Coding gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Learn Rust Coding, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Learn Rust Coding include 4 lezioni in totale.

Perché clap?

clap (Command Line Argument Parser) è il crate di riferimento per la creazione di CLI in Rust.

Analizza argomenti, flag e opzioni
Genera automaticamente --help e --version
Convalida l'input e segnala gli errori in modo comprensibile

Senza di esso dovrebbe scorrere manualmente std::env::args() e gestire personalmente ogni caso limite.

Leggere gli argomenti manualmente

Prima di ricorrere a clap, è utile vedere l'approccio di base. std::env::args() restituisce un iteratore il cui primo elemento è il nome del programma.

fn main() {
    let args: Vec<String> = std::env::args().collect();
    println!("Program: {}", args[0]);
    println!("Got {} extra arg(s)", args.len() - 1);
}

Aggiungere clap a Cargo.toml

Per usare clap, lo dichiari come dipendenza. La funzionalità derive abilita l'API basata sulle macro.

cargo add clap --features derive

Questo passaggio viene eseguito nel terminale e modifica i file del progetto, quindi non lo eseguiamo qui.

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

L'API builder

clap offre due stili. La builder API costruisce un Command a runtime concatenando chiamate ai metodi.

use clap::{Command, Arg};

fn main() {
    let cmd = Command::new("greet")
        .arg(Arg::new("name"));
    let matches = cmd.get_matches();
    // access values from matches
}

Argomenti posizionali

Un argomento posizionale viene fornito in base all'ordine, non tramite un flag. Qui name viene letto direttamente dalla riga di comando.

greet Alice imposta name su Alice

use clap::{Command, Arg};

fn main() {
    let m = Command::new("greet")
        .arg(Arg::new("name").required(true))
        .get_matches();
    let name = m.get_one::<String>("name").unwrap();
    println!("Hello, {}!", name);
}

Flag opzionali

Un flag è un interruttore booleano. Usi ArgAction::SetTrue affinché la sua presenza imposti un valore booleano.

--loud attiva il flag

use clap::{Command, Arg, ArgAction};

fn main() {
    let m = Command::new("greet")
        .arg(Arg::new("loud").long("loud").action(ArgAction::SetTrue))
        .get_matches();
    let loud = m.get_flag("loud");
    println!("loud = {}", loud);
}

Opzioni con valori

Un'opzione accetta un valore, come --count 3. Le assegni un nome short e uno long per facilitarne l'uso.

use clap::{Command, Arg};

fn main() {
    let m = Command::new("greet")
        .arg(Arg::new("count").short('c').long("count"))
        .get_matches();
    if let Some(c) = m.get_one::<String>("count") {
        println!("count = {}", c);
    }
}

Valori predefiniti

Assegni a un argomento un valore alternativo con default_value, così gli utenti possono ometterlo.

Se manca --count, diventa 1

use clap::{Command, Arg};

fn main() {
    let m = Command::new("greet")
        .arg(Arg::new("count").long("count").default_value("1"))
        .get_matches();
    let count = m.get_one::<String>("count").unwrap();
    println!("count = {}", count);
}

Simulare il risultato

Anche senza avere clap installato possiamo simulare l'aspetto dei valori analizzati. Ecco un modello in Rust puro che mostra la logica eseguita da clap al nostro posto.

fn main() {
    let name = "Alice";
    let count: u32 = 3;
    for _ in 0..count {
        println!("Hello, {}!", name);
    }
}

Guida generata automaticamente

clap crea gratuitamente --help a partire dai metadati degli argomenti. Aggiunga stringhe about e help per renderla utile.

use clap::{Command, Arg};

fn main() {
    Command::new("greet")
        .about("Greets a person")
        .arg(Arg::new("name").help("Who to greet"))
        .get_matches();
}

Flag della versione

Imposti una volta la versione e clap configurerà --version. La macro crate_version! la recupera da Cargo.toml.

use clap::Command;

fn main() {
    Command::new("greet")
        .version("1.0.0")
        .get_matches();
}

Verifica rapida

Verifichi la sua comprensione delle basi di clap.

Riepilogo

Ha imparato le basi di clap:

Lo aggiunga con la funzionalità derive
La builder API usa Command e Arg
Gli argomenti posizionali dipendono dall'ordine; i flag usano SetTrue; le opzioni accettano valori
default_value fornisce valori alternativi
--help e --version vengono generati automaticamente

Nel prossimo passaggio strutturerà CLI più grandi con i sottocomandi.

Domande Frequenti

La lezione «Fondamenti di clap» è gratuita?

Sì — il testo completo di «Fondamenti di clap» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Learn Rust Coding, passa a CoddyKit PRO. Il corso Learn Rust Coding include 4 lezioni in totale.

Cosa imparerò in «Fondamenti di clap»?

Parsing degli argomenti Eserciti Learn Rust Coding con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Learn Rust Coding?

Non è richiesta alcuna esperienza precedente. Learn Rust Coding su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.

Quanto tempo richiede la lezione «Fondamenti di clap»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Learn Rust Coding?

Sì. Ogni lezione Learn Rust Coding include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Learn Rust Coding