버전 정책
버전 정책
Pydantic AI V1은 2025년 9월에 릴리스됐고, 안정적인 V2.0은 2026년 6월 23일에 릴리스됐어요. V2에 무엇이 있는지, 어떻게 설치하는지, 어떻게 업그레이드하는지는 업그레이드 가이드를 참고하세요.
우리는 마이너 릴리스에서 의도적으로 파괴적인 변경을 하지 않아요. 릴리스에서 deprecated로 표시된 기능은 V2.0 후 최소 3개월 이후에나 릴리스할 다음 메이저 버전까지는 제거되지 않아요.
V2 안정 릴리스 후 최소 6개월 동안 V1에 대한 보안 수정을 계속 제공할 거예요. 그래서 애플리케이션을 업그레이드할 시간이 충분해요. 점프할 준비가 되면, 업그레이드 가이드가 각 버전의 파괴적 변경과 V2로 가는 권장 경로를 나열해요.
물론, 명백히 안전해 보이는 변경과 버그 수정도 필연적으로 일부 사용자의 코드를 깨뜨릴 거예요. 필수 링크 xkcd.
다음 변경은 파괴적 변경으로 간주되지 않고, 마이너 릴리스에서 발생할 수 있어요:
- 기존 코드를 깨뜨릴 수 있는 버그 수정. 단, 그 코드가 문서화되지 않은 기능/구조/가정에 의존하고 있었던 경우에 한해요.
- 기존 메시지(파트)와 이벤트 타입에 새 메시지 파트, 스트림 이벤트, 또는 선택적 필드(기본값 있는 필드 포함) 추가. 메시지 파트나 이벤트 스트림을 소비할 때는 항상 방어적으로 코딩하고,
ModelMessagesTypeAdapter로 메시지 이력을 (역)직렬화하세요. - OpenTelemetry 스팬 속성 변경. 서로 다른 옵저버빌리티 플랫폼이 생성형 AI 시스템을 위한 OpenTelemetry 시맨틱 컨벤션의 서로 다른 버전을 지원하기 때문에, Pydantic AI는 인스트루멘테이션 버전을 구성할 수 있게 하지만, 기본 버전은 마이너 릴리스에서 바뀔 수 있어요. Pydantic Evals의 스팬 속성도 Pydantic Logfire에서 Evals 지원을 반복하면서 바뀔 수 있어요.
- 공개 클래스의
__repr__동작 변경.
모든 경우에 우리는 변화를 최소화하는 것을 목표로 하고, Pydantic AI의 품질 향상으로 정당화될 때만 그렇게 해요.
이 허용된 변경 중 하나가 기존 코드의 변경을 요구할 때, 그 풀 리퀘스트와 릴리스 노트에는 눈에 띄는 호환성 영향 경고와 마이그레이션 지침이 포함돼요.
출처: 문서
본문
베타 기능
Pydantic에서는 빠르게 움직이고 혁신하는 것을 좋아해요! 이를 위해 마이너 릴리스는 진행 중인 작업인 베타 기능(beta 모듈로 표시)을 도입할 수 있어요. 베타 단계 동안 기능의 API와 동작은 안정적이지 않을 수 있고, 기능에 대한 변경이 하위 호환되지 않을 가능성이 매우 커요. 우리는 사용자가 피드백을 제공하고 프로덕션에서 기능을 테스트할 기회를 가진 후, 초기 릴리스 후 수 개월 내에 베타 기능을 베타에서 벗어나게 하는 것을 목표로 해요.
Python 버전 지원
Pydantic은 다음 조건이 충족되면 Python 버전 지원을 중단해요:
- 그 Python 버전이 예정된 수명 종료에 도달했고,
- 가장 최근 마이너 릴리스의 다운로드 중 5% 미만이 그 버전을 사용하고 있을 때.