API สำหรับ derive

derive API

โครงสร้าง Parser ขั้นต่ำ

use clap::Parser;

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

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

ฟิลด์กลายเป็นอาร์กิวเมนต์ตามตำแหน่ง

use clap::Parser;

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

ฟิลด์ที่ไม่บังคับ

use clap::Parser;

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

แฟล็กและชื่อแบบสั้น/แบบยาว

use clap::Parser;

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

ค่าที่มีชนิดข้อมูล

use clap::Parser;

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

การสร้างแบบจำลอง Cli ที่แยกวิเคราะห์แล้ว

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);
    }
}

คำสั่งย่อยในรูปแบบ enum

use clap::{Parser, Subcommand};

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

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

การจับคู่คำสั่งย่อยของ enum

use clap::Parser;

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

ข้อมูลกำกับผ่านคำกำกับ command

use clap::Parser;

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

สาธิตการส่งต่อด้วย enum

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"),
    }
}

ตรวจสอบความเข้าใจอย่างรวดเร็ว

ทบทวน