anyhow
유연한 애플리케이션 오류 처리
anyhow은(는) CoddyKit의 무료 Learn Rust Coding 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Learn Rust Coding 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
유연한 애플리케이션 오류
애플리케이션 코드에서는 각 오류마다 타입이 지정된 열거형을 정의하기보다, 오류를 맥락과 함께 상위로 전달하고 싶은 경우가 많습니다. anyhow 크레이트는 바로 이러한 용도로 하나의 간단한 오류 형식을 제공합니다.
anyhow 추가하기
의존성으로 추가합니다. thiserror와 잘 어울립니다. 라이브러리에는 thiserror를, 바이너리에는 anyhow를 사용합니다.
[dependencies]
anyhow = "1.0"anyhow::Result 별칭
anyhow::Result<T>는 Result<T, anyhow::Error>의 줄임 표현입니다. Error 형식은 std::error::Error를 구현하는 모든 오류를 담을 수 있습니다.
use anyhow::Result;
fn load() -> Result<String> {
let text = std::fs::read_to_string("config.txt")?;
Ok(text)
}자동 변환
? 연산자는 모든 표준 오류를 anyhow::Error로 자동 변환하므로, 오류 형식을 자유롭게 섞어 사용할 수 있습니다.
use anyhow::Result;
fn parse_file(path: &str) -> Result<i32> {
let text = std::fs::read_to_string(path)?; // io error
let n: i32 = text.trim().parse()?; // parse error
Ok(n)
}맥락 추가하기
.context() 메서드는 사람이 이해하기 쉬운 메시지를 오류에 추가하여, 실패가 발생했을 때 읽기 쉬운 연결 고리를 만듭니다.
use anyhow::{Context, Result};
fn read_config(path: &str) -> Result<String> {
let text = std::fs::read_to_string(path)
.context("failed to read config file")?;
Ok(text)
}지연된 맥락
메시지를 만드는 데 비용이 많이 들거나 실행 중 데이터가 필요할 때는 with_context를 사용합니다. 이 클로저는 오류가 발생한 경우에만 실행됩니다.
use anyhow::{Context, Result};
fn open(path: &str) -> Result<String> {
std::fs::read_to_string(path)
.with_context(|| format!("could not open {path}"))
}임시 오류 만들기
anyhow! 매크로는 메시지에서 오류를 만들고, bail!은 오류와 함께 조기에 반환합니다.
use anyhow::{anyhow, bail, Result};
fn check(age: i32) -> Result<()> {
if age < 0 {
bail!("age cannot be negative");
}
if age > 150 {
return Err(anyhow!("age {age} is implausible"));
}
Ok(())
}ensure! 사용하기
ensure!는 assert!와 비슷하지만 패닉을 일으키는 대신 오류를 반환합니다.
use anyhow::{ensure, Result};
fn divide(a: i32, b: i32) -> Result<i32> {
ensure!(b != 0, "division by zero");
Ok(a / b)
}main에서 anyhow 사용하기
main에서 anyhow::Result<()>를 반환하면 실패 시 형식이 잘 지정된 오류 연결 고리가 출력됩니다.
use anyhow::Result;
fn main() -> Result<()> {
let text = std::fs::read_to_string("data.txt")?;
println!("{text}");
Ok(())
}원인 검사하기
anyhow::Error가 불투명한 형식이더라도 검사할 수 있습니다. 특정 오류 형식에 따라 분기해야 할 때 downcast_ref로 구체적인 오류 형식을 복원할 수 있습니다.
use anyhow::Result;
fn report(err: anyhow::Error) {
if let Some(io) = err.downcast_ref::<std::io::Error>() {
println!("io error: {io}");
} else {
println!("other error: {err}");
}
}thiserror와 anyhow
일반적인 기준은 다음과 같습니다:
- thiserror — 라이브러리와 호출자가 구분할 수 있는 타입 지정 오류
- anyhow — 애플리케이션에서 맥락과 함께 오류를 전달하는 경우
?를 사용하면 thiserror 오류를 anyhow로 매끄럽게 변환할 수 있습니다.
빠른 확인
오류가 전달되는 동안 설명 메시지를 추가하는 anyhow 메서드는 무엇인가요?
정리
anyhow 크레이트에서 다음을 배웠습니다:
anyhow::Result<T>는 유연한 하나의 오류 형식을 사용합니다?는 모든 표준 오류를 자동으로 변환합니다.context()/with_context()는 읽기 쉬운 메시지를 추가합니다anyhow!,bail!,ensure!는 오류를 만듭니다- 애플리케이션(바이너리) 코드에 가장 적합합니다
자주 묻는 질문
“anyhow” 강의는 무료인가요?
네 — “anyhow” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Learn Rust Coding 강의 전체를 잠금 해제할 수 있습니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
“anyhow”에서 뭘 배우나요?
유연한 애플리케이션 오류 처리 브라우저에서 직접 실행하는 실습 코드로 Learn Rust Coding을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Learn Rust Coding을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Learn Rust Coding은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“anyhow” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Learn Rust Coding 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Learn Rust Coding 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.