Learn Rust Coding · Lezione

API derive

Argomenti dalle struct

API derive è una lezione Learn Rust Coding gratuita su CoddyKit. Questa è la lezione 3 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.

L'API derive

La derive API consente di descrivere la CLI come una struct e di lasciare che clap generi il parser tramite #[derive(Parser)].

Meno codice ripetitivo rispetto alla builder API
Type-safe: i campi diventano valori tipizzati

La abiliti con la funzionalità derive.

Una struct Parser minimale

Annoti una struct con #[derive(Parser)] e chiami Cli::parse() in main. Ogni campo corrisponde a un argomento.

use clap::Parser;

#[derive(Parser)]
struct Cli {
    name: String,
}

fn main() {
    let cli = Cli::parse();
    println!("Hello, {}!", cli.name);
}

Il campo diventa posizionale

Un campo semplice come name: String è un argomento posizionale obbligatorio. Il nome del campo diventa il nome del valore.

use clap::Parser;

#[derive(Parser)]
struct Cli {
    input: String,
    output: String,
}

Campi opzionali

Racchiuda un campo in Option per renderlo opzionale. Se l'utente lo omette, otterrà None.

use clap::Parser;

#[derive(Parser)]
struct Cli {
    #[arg(short, long)]
    config: Option<String>,
}

Flag e nomi brevi/lunghi

L'attributo #[arg(short, long)] ricava -v e --verbose dal nome del campo. Un campo bool diventa un interruttore.

use clap::Parser;

#[derive(Parser)]
struct Cli {
    #[arg(short, long)]
    verbose: bool,
}

Valori tipizzati

clap analizza il valore nel tipo del campo. Un campo u32 rifiuta automaticamente gli input non numerici.

use clap::Parser;

#[derive(Parser)]
struct Cli {
    #[arg(short, long, default_value_t = 1)]
    count: u32,
}

Modellare una Cli analizzata

Dopo l'analisi, una struct Cli contiene semplici dati. Questa versione eseguibile mostra come usare i campi dopo l'analisi.

struct Cli {
    name: String,
    count: u32,
    verbose: bool,
}

fn main() {
    let cli = Cli { name: "Alice".to_string(), count: 2, verbose: true };
    for _ in 0..cli.count {
        println!("Hello, {}! (verbose={})", cli.name, cli.verbose);
    }
}

Sottocomandi come enum

Con l'API derive, un enum #[derive(Subcommand)] modella i sottocomandi. Ogni variante è un comando.

use clap::{Parser, Subcommand};

#[derive(Parser)]
struct Cli {
    #[command(subcommand)]
    cmd: Commands,
}

#[derive(Subcommand)]
enum Commands {
    Add { task: String },
    List,
}

Gestire i sottocomandi enum

Dopo Cli::parse(), usi match sull'enum per instradare l'esecuzione. I dati delle varianti si destrutturano in modo chiaro.

use clap::Parser;

fn run(cli: Cli) {
    match cli.cmd {
        Commands::Add { task } => println!("add {}", task),
        Commands::List => println!("list"),
    }
}

Metadati tramite l'attributo command

Applichi #[command(name, version, about)] alla struct per impostare i metadati della CLI. version può essere letto automaticamente da Cargo.

use clap::Parser;

#[derive(Parser)]
#[command(name = "greet", version, about = "Greets people")]
struct Cli {
    name: String,
}

Dimostrare l'instradamento tramite enum

Il modello che usa match sull'enum è il cuore dei sottocomandi derive. Ecco la stessa idea in Rust autonomo.

enum Command {
    Add(String),
    List,
}

fn main() {
    let cmd = Command::Add("Write code".to_string());
    match cmd {
        Command::Add(task) => println!("Added: {}", task),
        Command::List => println!("Listing"),
    }
}

Verifica rapida

Verifichi la Sua comprensione dell'API derive.

Riepilogo

La derive API trasforma le struct in parser:

#[derive(Parser)] insieme a Cli::parse()
I campi semplici sono argomenti posizionali; Option li rende facoltativi
#[arg(short, long)] genera flag e opzioni
Gli enum #[derive(Subcommand)] modellano i sottocomandi

Prossimo argomento: validazione e output di help più curato.

Domande Frequenti

La lezione «API derive» è gratuita?

Sì — il testo completo di «API derive» è 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 «API derive»?

Argomenti dalle struct 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 3 di 4.

Quanto tempo richiede la lezione «API derive»?

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