Pydantic V2는 일부 주요 변경 사항을 포함하여 API에 여러 가지 변경 사항을 도입했습니다.

이 페이지는 Pydantic V1에서 Pydantic V2로 코드를 마이그레이션하는 데 도움이 되는 가장 중요한 변경 사항을 강조하는 가이드를 제공합니다.

Pydantic V2 설치

Pydantic V2는 이제 Pydantic의 현재 생산 릴리스입니다. PyPI에서 Pydantic V2를 설치할 수 있습니다:

pip install -U pydantic

문제가 발생하면 버그 V2 라벨을 사용하여 GitHub에서 문제를 생성하세요. 이는 오류를 적극적으로 모니터링 및 추적하고 라이브러리 성능을 지속적으로 개선하는 데 도움이 될 것입니다.

어떤 이유로든 최신 Pydantic V1을 사용해야 하는 경우, pydantic.v1에서 설치 및 가져오기에 대한 자세한 내용은 아래 Pydantic V1 기능 계속 사용 섹션을 참조하세요.

코드 변환 도구

우리는 귀하의 코드를 마이그레이션하는 데 도움이 되는 도구를 만들었습니다. 이 도구는 아직 베타 버전이지만 코드를 더 빠르게 마이그레이션하는 데 도움이 되기를 바랍니다.

PyPI에서 도구를 설치할 수 있습니다.

pip installump-pydantic

사용법은 간단합니다. 프로젝트 구조가 다음과 같은 경우:

* repo_folder
    * my_package
        * <python source files> ...

그런 다음 다음을 수행하고 싶을 것입니다.

cd /path/to/repo_folder
bump-pydantic my_package

이에 대한 자세한 내용은 Bump Pydantic 저장소에서 확인하세요.

Pydantic V1 기능을 계속 사용하세요

Pydantic V1은 필요할 때 계속 사용할 수 있지만 개선 사항과 새로운 기능을 위해 Pydantic V2로 마이그레이션하는 것이 좋습니다.

최신 Pydantic V1을 사용해야 하는 경우 다음을 사용하여 설치할 수 있습니다.

pip 설치 "pydantic==1.*"

Pydantic V2 패키지는 또한 pydantic.v1을 통해 가져옴으로써 Pydantic V1 API에 대한 액세스를 계속 제공합니다.

예를 들어, Pydantic V2 pydantic.BaseModel 클래스 대신 Pydantic V1의 BaseModel 클래스를 사용할 수 있습니다.

from pydantic.v1 import BaseModel

lenient_isinstance와 같이 Pydantic V2에서 제거된 함수를 가져올 수도 있습니다:

from pydantic.v1.utils import lenient_isinstance

Pydantic V1 문서는 https://docs.pydantic.dev/1.10/에서 확인할 수 있습니다.

v1/v2 환경에서 Pydantic v1 기능 사용

pydantic>=1.10.17부터 pydantic.v1 네임스페이스를 V1 내에서 사용할 수 있습니다. 이렇게 하면 pydantic.v1도 지원하는 V2로 마이그레이션하기가 더 쉬워집니다. 네임스페이스. pydantic<2 종속성을 고정 해제하고 V1 기능을 계속 사용하려면 다음 단계를 수행하십시오.

1. pydantic<2를 pydantic>=1.10.17로 바꾸세요.

2. 다음 항목을 모두 찾아 바꿉니다.

   from pydantic. import