문서 문자열과 타입 힌트

개념 이해하기

docstring은 함수 바로 아래 문자열로 목적과 중요한 규칙을 설명합니다. 타입 힌트는 매개변수와 반환값의 예상 타입을 표시해 편집기와 정적 검사기가 오류를 일찍 찾도록 돕지만 런타임에서 자동 검증하지는 않습니다.

예제에서 def add(a: int, b: int) -> int: 부분부터 찾으세요. 값을 만드는 표현식과 그 값을 다음 문장으로 넘기는 흐름을 한 줄씩 따라가면 실행 결과를 스스로 설명할 수 있습니다.

list[str], dict[str, int], str | None처럼 복합 타입도 표현할 수 있습니다. 타입은 구현 세부보다 호출자가 알아야 하는 계약을 나타냅니다.

공개 함수에는 이름, 타입, 문서, 예외를 함께 관리하고 pyright나 mypy 같은 정적 검사 도구를 CI에 연결할 수 있습니다.

이 코드는 브라우저의 실제 Python에서 실행됩니다. 먼저 현재 결과를 확인한 뒤 반환 타입을 tuple[int, float]로 갖는 통계 함수를 작성하세요.