타입 힌트 기본

기본 패턴

def greet(name: str) -> str:
    return f"Hello, {name}"

scores: list[int] = [90, 80, 100]

설명

• 타입 힌트는 코드가 기대하는 값의 종류를 사람이 읽고 도구가 검사하기 쉽게 적는 방식입니다.
• Python 실행 자체가 타입 힌트만으로 엄격해지는 것은 아니지만, 가독성과 정적 분석 품질이 좋아집니다.
• 함수 매개변수, 반환값, 변수에 모두 타입 의도를 적을 수 있습니다.
• 현대 Python 코드베이스에서는 문서 역할과 유지보수 편의성 때문에 타입 힌트 사용이 점점 더 일반적입니다.

짧은 예제

def average(values: list[float]) -> float:
    return sum(values) / len(values)

빠른 정리

공식 참고: typing — Support for type hints

주의할 점