파이썬 isinstance는 실행 중 값이 특정 타입인지 확인하는 함수입니다. 입력 검증에는 유용하지만, 모든 코드를 타입 분기로 만들면 Python 코드의 유연성이 줄어들 수 있습니다.
핵심은 타입을 확인해야 하는 경계와, 객체의 행동을 믿어도 되는 내부 흐름을 나누는 것입니다. 이 글은 Python 공식 isinstance 문서와 type hierarchy 설명을 기준으로 사용 기준을 정리합니다.
isinstance를 먼저 한 줄로 정리하면
isinstance는 어떤 값이 특정 타입의 인스턴스인지 실행 중에 확인합니다. 서브클래스 인스턴스도 인정한다는 점이 단순 `type(x) == T` 비교와 다릅니다.
value = True
print(isinstance(value, bool)) # True
print(isinstance(value, int)) # True, bool은 int의 subclass이런 결과 때문에 isinstance는 편리하지만, Python 타입 계층을 모른 채 쓰면 예상과 다른 분기가 생길 수 있습니다.
외부 입력 경계에서는 타입 체크가 도움이 된다
사용자 입력, JSON, 환경 변수, 외부 API 응답처럼 신뢰하기 어려운 값은 런타임 검증이 필요할 수 있습니다. 이때 isinstance는 빠르게 방어선을 만들 수 있습니다.
def normalize_tags(tags):
if isinstance(tags, str):
return [tags]
if isinstance(tags, list):
return tags
raise TypeError("tags must be str or list")입력 경계에서 타입을 정리하면 내부 로직은 더 단순한 타입을 믿고 작성할 수 있습니다.
type 비교보다 isinstance가 자연스러운 경우
서브클래스까지 같은 계열로 인정해야 한다면 `type(x) == SomeClass`보다 `isinstance(x, SomeClass)`가 자연스럽습니다.
class Animal:
pass
class Dog(Animal):
pass
dog = Dog()
print(isinstance(dog, Animal)) # True정확히 그 타입만 허용해야 하는 특수한 상황이 아니라면, 상속 관계를 인정하는 isinstance가 일반적인 객체지향 코드와 잘 맞습니다.
duck typing을 막지 않도록 조심하자
Python에서는 객체가 어떤 타입인지보다 필요한 행동을 제공하는지가 더 중요한 경우가 많습니다. 파일처럼 `.read()`를 제공하면 충분한 코드에서 실제 타입까지 검사하면 오히려 재사용성이 떨어질 수 있습니다.
def read_first_line(file_like):
return file_like.readline()객체가 무엇인지 묻기 전에, 이 코드가 정말 특정 타입만 필요로 하는지 먼저 물어야 합니다. 필요한 행동이 작다면 protocol이나 예외 처리가 더 자연스러울 수 있습니다.
타입 힌트와 isinstance는 역할이 다르다
타입 힌트는 개발 도구와 정적 분석이 코드를 이해하도록 돕는 표시입니다. isinstance는 프로그램이 실행되는 순간 실제 값을 검사합니다. 둘은 경쟁 관계가 아니라 서로 다른 층의 도구입니다.
def total(values: list[int]) -> int:
return sum(values)이 함수의 타입 힌트는 의도를 알려 주지만, 실행 중에 모든 원소가 int인지 자동으로 검사하지는 않습니다. 외부 입력이라면 별도 검증이 필요할 수 있습니다.
실무 체크리스트
- 외부 입력 경계인지 내부 로직인지 먼저 구분한다
- 서브클래스를 허용할지 정확한 타입만 허용할지 정한다
- 타입보다 필요한 행동이 중요한 경우 duck typing을 우선 검토한다
- 여러 타입을 허용할 때는 tuple classinfo나 명시적 분기 기준을 사용한다
- 타입 체크가 늘어나면 설계가 과하게 분기되고 있지 않은지 되돌아본다
정리
파이썬 isinstance를 이해할 때는 문법 자체보다 코드가 표현하려는 경계를 먼저 보는 편이 좋습니다. 오늘 글의 기준은 ‘읽는 사람이 실수를 줄일 수 있는가’입니다.
함께 보면 좋은 내부 글은 파이썬 property는 왜 쓸까, 파이썬 dataclass는 왜 쓸까, 파이썬 예외 처리는 어디까지 잡아야 할까입니다. 외부 기준은 Python Docs – built-in isinstance, Python Docs – built-in type, Python Docs – typing를 확인했습니다.
