0Pricing
Learn Rust Coding · 강의

검증과 도움말

완성도 높은 CLI

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

CLI 다듬기

훌륭한 CLI는 입력을 일찍 검증하고 명확한 도움말을 제공합니다. clap은 주석과 값 분석기를 사용해 이 두 기능을 지원합니다.

  • 이해하기 쉬운 메시지로 잘못된 값을 거부합니다
  • 모든 인수를 문서화합니다

값의 범위

value_parser로 숫자 인수를 특정 범위로 제한하세요. 범위를 벗어난 입력은 자동으로 거부됩니다.

use clap::Parser;

#[derive(Parser)]
struct Cli {
    #[arg(long, value_parser = clap::value_parser!(u16).range(1..=65535))]
    port: u16,
}

열거형 선택지

#[derive(ValueEnum)]을 사용해 인수를 정해진 문자열 집합으로 제한하세요.

use clap::{Parser, ValueEnum};

#[derive(Clone, ValueEnum)]
enum Mode { Fast, Safe }

#[derive(Parser)]
struct Cli {
    #[arg(long, value_enum)]
    mode: Mode,
}

사용자 지정 검증 함수

Result를 반환하는 함수를 value_parser에 전달하세요. clap은 Err를 사용법 오류로 변환합니다.

fn parse_even(s: &str) -> Result<u32, String> {
    let n: u32 = s.parse().map_err(|_| "not a number".to_string())?;
    if n % 2 == 0 { Ok(n) } else { Err("must be even".to_string()) }
}

검증 로직 실행하기

검증 함수는 일반적인 Rust 코드입니다. 실행하여 짝수 및 홀수 검사가 Ok 또는 Err를 반환하는 방식을 확인해 보세요.

fn parse_even(s: &str) -> Result<u32, String> {
    let n: u32 = s.parse().map_err(|_| "not a number".to_string())?;
    if n % 2 == 0 { Ok(n) } else { Err("must be even".to_string()) }
}

fn main() {
    println!("{:?}", parse_even("4"));
    println!("{:?}", parse_even("7"));
}

필수 그룹과 충돌

인수 사이의 관계를 표현하세요. conflicts_with는 호환되지 않는 두 플래그를 함께 사용하지 못하게 합니다.

use clap::Parser;

#[derive(Parser)]
struct Cli {
    #[arg(long)]
    quiet: bool,
    #[arg(long, conflicts_with = "quiet")]
    verbose: bool,
}

필드별 도움말 텍스트

필드 위에 작성한 문서 주석은 해당 필드의 도움말 텍스트가 됩니다. 이것이 인수를 문서화하는 관용적인 방법입니다.

use clap::Parser;

#[derive(Parser)]
struct Cli {
    /// The file to process
    input: String,
}

긴 도움말과 짧은 도움말

clap은 -h에 짧은 요약을 표시하고 --help에 전체 텍스트를 표시합니다. 필요하면 #[arg(short_help, long_help)]로 둘을 나누세요.

use clap::Parser;

#[derive(Parser)]
struct Cli {
    #[arg(long, long_help = "A detailed explanation shown only with --help")]
    flag: bool,
}

main에서 Result 반환하기

분석 후 발생하는 실행 시간 오류에는 main에서 Result를 반환하세요. ? 연산자는 오류를 전파하며, clap을 사용하지 않는 프로그램은 오류를 출력하고 0이 아닌 종료 코드로 끝납니다.

fn main() -> Result<(), String> {
    let value = "42";
    let n: i32 = value.parse().map_err(|_| "bad number".to_string())?;
    println!("parsed {}", n);
    Ok(())
}

사용자 지정 오류 스타일

clap은 사용법 오류의 형식을 자동으로 지정하지만, clap::Error와 cmd.error()를 사용해 상황에 맞는 메시지를 직접 만들 수도 있습니다.

use clap::{CommandFactory, Parser};

#[derive(Parser)]
struct Cli { value: i32 }

fn fail() {
    let mut cmd = Cli::command();
    cmd.error(clap::error::ErrorKind::ValueValidation, "value too large").exit();
}

일반 Rust로 검증 요약하기

CLI 검증의 핵심은 값을 확인하고 명확한 오류를 보고하는 것입니다. 다음은 그 전 과정을 보여 주는 예입니다.

fn validate_port(p: u32) -> Result<u32, String> {
    if (1..=65535).contains(&p) { Ok(p) }
    else { Err(format!("port {} out of range", p)) }
}

fn main() {
    match validate_port(8080) {
        Ok(p) => println!("using port {}", p),
        Err(e) => eprintln!("error: {}", e),
    }
}

빠른 확인

검증과 도움말에 대한 이해도를 확인해 보세요.

복습

이제 완성도 높은 CLI를 만들 수 있습니다.

  • value_parser로 범위와 사용자 지정 규칙을 적용합니다
  • ValueEnum으로 선택지를 제한합니다
  • conflicts_with로 호환되지 않는 플래그를 표현합니다
  • 문서 주석이 도움말 텍스트가 됩니다
  • 실행 시간 오류에는 main에서 Result를 반환합니다

이것으로 clap 과정을 마칩니다.

자주 묻는 질문

“검증과 도움말” 강의는 무료인가요?

네 — “검증과 도움말” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 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개 중 4번째 강의입니다.

“검증과 도움말” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

  1. clap 기초
  2. 하위 명령
  3. Derive API
  4. 검증과 도움말
← Learn Rust Coding(으)로 돌아가기