용어 사전 coding 용어 페이지

Pydantic

타입 힌트 기반으로 입력 데이터를 검증하고 구조화하는 Python 라이브러리

pydantic #fastapi#python#validation

English version

다른 이름

pydantic

관련 개념

BaseModel 요청 본문 response_model

핵심 아이디어

Pydantic은 Python 타입 힌트를 읽어 입력 데이터를 구조화하고 검증하는 라이브러리입니다. 문자열, 숫자, 리스트, 중첩 객체 같은 데이터를 "어떤 모양이어야 하는가"라는 스키마로 선언하면, 실제 입력이 그 모양을 따르는지 자동으로 검사해 줍니다.

중요한 점은 단순 타입 검사 도구가 아니라는 것입니다. 기본값, 길이 제한, 중첩 모델, 문서화까지 한 흐름으로 연결되기 때문에 API 설계에서 특히 강합니다.

이 블로그에서의 역할

Mathbong의 FastAPI 시리즈에서는 요청 JSON을 받는 순간부터 응답 스키마를 고정하는 순간까지 Pydantic이 계속 등장합니다. BaseModel, 요청 본문, response_model을 하나로 묶어 주는 중심 허브입니다.

이 개념을 다루는 글

[FastAPI 시리즈 4편] 요청 본문과 Pydantic 모델 다루기 JSON 본문으로 데이터를 받고 Pydantic 모델로 검증하는 기본 흐름을 실습하며 정리합니다.[FastAPI Series 4] Handle Request Bodies with Pydantic Introduces JSON request bodies, shows how FastAPI pairs them with Pydantic models, and walks through validation and error handling.