Learn Rust Coding · 강의

하위 명령

구조화된 CLI

하위 명령은(는) CoddyKit의 무료 Learn Rust Coding 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Learn Rust Coding 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.

subcommand란 무엇인가요?

subcommand를 사용하면 하나의 바이너리에서 git commit과 git push처럼 여러 작업을 제공할 수 있습니다.

각 subcommand에는 고유한 인수가 있습니다
CLI가 커져도 구조를 확장할 수 있습니다

clap은 중첩된 Command 값으로 이를 모델링합니다.

subcommand 추가하기

.subcommand()로 자식 명령을 연결합니다. 그러면 부모 명령이 디스패처 역할을 합니다.

use clap::Command;

fn main() {
    Command::new("todo")
        .subcommand(Command::new("add"))
        .subcommand(Command::new("list"))
        .get_matches();
}

선택한 subcommand 구분하기

분석이 끝난 후 subcommand()가 어떤 자식 명령이 실행되었는지 알려 줍니다. 이름을 기준으로 구분하여 디스패치합니다.

use clap::Command;

fn main() {
    let m = Command::new("todo")
        .subcommand(Command::new("add"))
        .subcommand(Command::new("list"))
        .get_matches();
    match m.subcommand() {
        Some(("add", _)) => println!("adding"),
        Some(("list", _)) => println!("listing"),
        _ => println!("no subcommand"),
    }
}

subcommand 내부의 Args

subcommand에는 고유한 인수가 있습니다. 아래의 add 명령은 작업 설명을 받습니다.

use clap::{Command, Arg};

fn main() {
    Command::new("todo")
        .subcommand(
            Command::new("add")
                .arg(Arg::new("task").required(true))
        )
        .get_matches();
}

subcommand 인수 읽기

튜플의 두 번째 요소가 하위 ArgMatches입니다. 최상위 수준과 같은 방식으로 여기에서 값을 가져옵니다.

use clap::{Command, Arg};

fn main() {
    let m = Command::new("todo")
        .subcommand(Command::new("add").arg(Arg::new("task")))
        .get_matches();
    if let Some(("add", sub)) = m.subcommand() {
        let task = sub.get_one::<String>("task").unwrap();
        println!("add: {}", task);
    }
}

subcommand 필수로 지정하기

subcommand_required(true)를 사용하면 인수 없이 바이너리를 실행했을 때 아무 작업도 하지 않는 대신 도움말을 출력합니다.

use clap::Command;

fn main() {
    Command::new("todo")
        .subcommand_required(true)
        .arg_required_else_help(true)
        .subcommand(Command::new("list"))
        .get_matches();
}

일반 Rust로 디스패치 모델링하기

subcommand CLI의 핵심은 문자열에 대한 match입니다. 이 실행 가능한 예시는 그러한 디스패치 로직을 그대로 보여 줍니다.

fn main() {
    let cmd = "add";
    let task = "Buy milk";
    match cmd {
        "add" => println!("Added: {}", task),
        "list" => println!("Listing tasks"),
        other => println!("Unknown command: {}", other),
    }
}

중첩된 subcommand

하위 명령 자체에도 하위 명령을 둘 수 있습니다. 예를 들어 cargo build --release처럼 더 깊은 트리를 구성할 수 있습니다. .subcommand() 호출을 더 중첩하면 됩니다.

use clap::Command;

fn main() {
    Command::new("app")
        .subcommand(
            Command::new("config")
                .subcommand(Command::new("get"))
                .subcommand(Command::new("set"))
        )
        .get_matches();
}

하위 명령별 도움말

각 하위 명령에는 자체 --help 페이지가 제공됩니다. 하위 명령을 설명하려면 about 문자열을 추가하세요.

use clap::Command;

fn main() {
    Command::new("todo")
        .subcommand(
            Command::new("add").about("Add a new task")
        )
        .get_matches();
}

별칭

visible_alias로 사용자에게 단축 명령을 제공하세요. 이제 ls도 list와 동일하게 작동합니다.

use clap::Command;

fn main() {
    Command::new("todo")
        .subcommand(
            Command::new("list").visible_alias("ls")
        )
        .get_matches();
}

종료 코드 반환

완성도 높은 CLI는 성공 또는 실패를 나타냅니다. std::process::exit를 사용하거나 main에서 Result를 반환하여 하위 명령에서 0이 아닌 코드를 반환하세요.

fn main() {
    let success = true;
    if !success {
        std::process::exit(1);
    }
    println!("ok");
}

빠른 확인

하위 명령에 대한 이해도를 확인해 보세요.

복습

이제 하위 명령을 사용해 구조화된 CLI를 만들 수 있습니다.

.subcommand()로 하위 명령을 추가합니다
m.subcommand()와 일치하는 항목을 찾아 실행합니다
각 하위 명령에는 고유한 인수와 도움말 페이지가 있습니다
subcommand_required와 별칭을 사용해 완성도를 높입니다

다음으로 derive API를 사용해 구조체를 인수 분석기로 변환하는 방법을 알아봅니다.

자주 묻는 질문

“하위 명령” 강의는 무료인가요?

네 — “하위 명령” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Learn Rust Coding 강의 전체를 잠금 해제할 수 있습니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.

“하위 명령”에서 뭘 배우나요?

구조화된 CLI 브라우저에서 직접 실행하는 실습 코드로 Learn Rust Coding을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Learn Rust Coding을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Learn Rust Coding은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“하위 명령” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Learn Rust Coding 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Learn Rust Coding 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Learn Rust Coding(으)로 돌아가기