pytest.raises로 예외 계약을 검증한다

오늘의 질문

`pytest.raises`의 좁은 exception type·message boundary·exception attributes와 실패 전후 state를 검증한다. 이 판단을 생략하면 통과한 test와 많은 log가 있어도 결함을 놓치거나 잘못된 수정을 승인할 수 있습니다.

아직 답을 몰라도 괜찮아요. 아래 작은 예시를 보고 먼저 예상해 보세요.

01 · 가볍게 시작하기

정답을 보기 전에 먼저 골라볼까요?

눈으로만 보고 답 하나를 떠올려 보세요금액 validation과 domain exception API에서 pytest.raises로 예외 계약을 검증한다 계약을 적용한다.synthetic td20 fixture · secret 없는 고정 입력 · exact Python 3.14.6

1
먼저 골라보기
틀려도 괜찮아요. 지금 생각한 답 하나를 정해요.
2
그림으로 확인하기
움직이는 순서와 달라지는 곳만 천천히 찾아요.
3
내 말로 다시 말하기
한 문장으로 말해 보면 내가 이해한 곳을 확인할 수 있어요.

02 · 그림으로 보기

그림이 움직이는 순서를 직접 확인해요

01관찰pytest.raises · exception type · match · ExceptionInfo
02추론`pytest.raises`는 검증할 호출만 감싸고 가능한 가장 좁은 exception class를 기대한다. message 전체 문구보다 공개된 stable pattern과 domain attribute를 검사해 localization 변경에 덜 취약하게 한다. 예외 발생 여부와 별도로 partial state·external effect·exception chaining 계약을 확인한다.
03검증pytest.raises로 예외 계약을 검증한다의 예상 결과·관찰 결과·판정 oracle을 실행 전에 분리해 기록한다. `pytest.raises(Exception)`으로 typo를 잡는다.에서 최초 불일치 지점과 근본 원인을 재현 가능한 evidence로 국소화한다. 의도한 exception class·stable metadata·cause와 원자적 상태 보존을 정상·경계·실패 fixture에 적용하고 false green·false red가 없는지 검증한다.

pytest.raises로 예외 계약을 검증한다에서 숨은 입력·상태·제어 흐름·oracle·관측 증거를 한 화면에서 대조한다.pytest.raises로 예외 계약을 검증한다의 baseline, injected defect, first divergence, assertion/log/trace evidence와 sealed regression을 연결한 code-trace현재 화면: 정적 요약 지도 · 읽는 방법: fixture와 단계 탭을 선택하면 expected·actual·evidence가 동기화되고 최종 단계에서만 판정과 수정 근거를 공개한다. · 모션 축소 설계: 자동 이동 없이 선택 상태를 즉시 표시하고 번호·문자 label·선 종류·도형으로 색상 외 의미를 중복 제공한다.

처음 보는 말도 책 읽듯 풀어봐요

이 수업은 쉬운 뜻과 생활 예를 아직 함께 준비하지 못했어요. 설명 없는 정확한 이름은 먼저 보여 주지 않을게요.

그림에서 찾을 쉬운 규칙

01`pytest.raises`는 검증할 호출만 감싸고 가능한 가장 좁은 exception class를 기대한다.
02message 전체 문구보다 공개된 stable pattern과 domain attribute를 검사해 localization 변경에 덜 취약하게 한다.
03예외 발생 여부와 별도로 partial state·external effect·exception chaining 계약을 확인한다.

03 · 같이 풀어보기

한 단계씩 따라가면 어렵지 않아요

금액 validation과 domain exception API에서 pytest.raises로 예외 계약을 검증한다 계약을 적용한다.

함께 볼 작은 예시synthetic td20 fixture · secret 없는 고정 입력 · exact Python 3.14.6

04 · 이제 내가 해볼 차례

여기까지 오면 이런 일을 할 수 있어요

`pytest.raises`의 좁은 exception type·message boundary·exception attributes와 실패 전후 state를 검증한다.

pytest.raises로 예외 계약을 검증한다의 예상 결과·관찰 결과·판정 oracle을 실행 전에 분리해 기록한다.
`pytest.raises(Exception)`으로 typo를 잡는다.에서 최초 불일치 지점과 근본 원인을 재현 가능한 evidence로 국소화한다.
의도한 exception class·stable metadata·cause와 원자적 상태 보존을 정상·경계·실패 fixture에 적용하고 false green·false red가 없는지 검증한다.

05 · 자주 헷갈리는 지점

틀린 답도 이유를 알면 다음에는 맞힐 수 있어요

01넓은 `Exception`을 기대하면 모든 오류 경로를 안전하게 test한다.

한 번 더 생각해 볼 질문pytest.raises로 예외 계약을 검증한다의 최소 fixture에서 이 주장을 깨는 관찰값과 판정 근거를 각각 한 줄로 쓰세요.

이렇게 고쳐 생각해요`pytest.raises`는 검증할 호출만 감싸고 가능한 가장 좁은 exception class를 기대한다.

02with block 안에 setup과 여러 호출을 넣어도 어느 줄이 raise했는지 중요하지 않다.

한 번 더 생각해 볼 질문pytest.raises로 예외 계약을 검증한다의 최소 fixture에서 이 주장을 깨는 관찰값과 판정 근거를 각각 한 줄로 쓰세요.

이렇게 고쳐 생각해요message 전체 문구보다 공개된 stable pattern과 domain attribute를 검사해 localization 변경에 덜 취약하게 한다.

03예외 class가 맞으면 상태 보존과 원인 chaining도 자동으로 맞다.

한 번 더 생각해 볼 질문pytest.raises로 예외 계약을 검증한다의 최소 fixture에서 이 주장을 깨는 관찰값과 판정 근거를 각각 한 줄로 쓰세요.

이렇게 고쳐 생각해요예외 발생 여부와 별도로 partial state·external effect·exception chaining 계약을 확인한다.

06 · 더 궁금할 때만 보기

선생님과 검토자를 위한 믿을 만한 원문

원문과 어디까지 참고했는지 펼쳐 보기처음 배우는 동안에는 열지 않아도 괜찮아요.

Python Software Foundation · 공개 문서를 확인했어요traceback — Print or retrieve a stack traceback

traceback 추출·formatting과 exception chain 진단. 마지막 frame을 root cause로 자동 판정하지 않음

pytest development team · 공개 문서를 확인했어요pytest 9.0 documentation

discovery, assertion introspection, parametrization, markers, raises, warning·capture·debugging과 import 경계

Python Institute · 2026년 7월 28일에 확인했어요PCAT-31-0x Exam Syllabus

2.3 AAA, 4.1~4.8 unit-testing foundations, 5.1~5.7 advanced unit-testing techniques, 6.1~6.2 TDD의 선택적 objective

Exercism · 2026년 7월 28일에 확인했어요Testing on the Python track

pytest 실행, marker, failure output, -x·--ff·--pdb workflow의 공개 practice. 표시 예시 version은 product pin이 아님