[Superseded] PEP 291 - Backward Compatibility for the Python 2 Standard Library

September 26, 2025

원문 링크: PEP 291 - Backward Compatibility for the Python 2 Standard Library

상태: Superseded 유형: Informational 작성일: 06-Jun-2002

PEP 291 – Python 2 표준 라이브러리의 하위 호환성 (Backward Compatibility for the Python 2 Standard Library)

작성자: Neal Norwitz
상태: Superseded (대체됨)
유형: Informational (정보성)
생성일: 2002년 6월 6일
Python 버전: 2.3
Superseded-By (대체한 PEP): PEP 387

개요 (Abstract)

이 PEP는 이전 버전의 Python과 하위 호환성을 유지해야 하는 Python 2 표준 라이브러리의 패키지 및 모듈을 설명합니다. 여기에 나열되지 않은 패키지는 배포되는 Python 버전과만 호환성을 유지하면 됩니다. 이 PEP는 Python 3 표준 라이브러리에는 영향을 미치지 않습니다.

배경 (Rationale)

작성자들은 패키지와 모듈이 이전 Python 버전에서도 계속 작동해야 하는 다양한 이유를 가지고 있습니다. 나머지 표준 라이브러리를 발전시키면서 이러한 모듈의 하위 호환성을 유지하기 위해서는 어떤 모듈을 수정할 수 있고 어떤 모듈이 이전 버전의 (그리고 아마도 더 이상 사용되지 않는) 기능을 사용해야 하는지 아는 것이 필요합니다.

일반적으로 작성자는 버그 수정을 이전 버전으로 쉽게 백포트(backport)할 수 있도록 이전 출시된 Python 버전과의 변경 사항을 하위 호환 가능하게 유지해야 합니다.

이 PEP에 패키지나 모듈이 나열되는 것 외에도, 작성자는 호환성 요구 사항을 문서화하기 위해 각 파일 상단에 주석을 추가해야 합니다.

Python의 주요 버전이 출시될 때, 지속적인 유지 보수 및 버그 수정 릴리스를 위해 Subversion 브랜치가 생성됩니다. 브랜치에 있는 패키지 버전은 트렁크(즉, 현재 개발 중인 최신 버전)에 있는 동일한 패키지와 다른 호환성 요구 사항을 가질 수 있습니다. 적절한 경우, 이러한 브랜치 호환성은 아래에 나열됩니다.

피해야 할 기능 (Features to Avoid)

다음 목록은 각 Python 버전과의 하위 호환성을 유지하기 위해 피해야 할 일반적인 기능들을 포함합니다. 이 목록은 완전하지 않으며, 일반적인 지침으로만 사용됩니다.

아래 기능들은 나열된 버전 다음 버전에서 구현되었습니다. 예를 들어, 1.5.2 옆에 나열된 기능들은 2.0에서 구현되었습니다.

버전	피해야 할 기능
——-	——————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————-	Python 2 표준 라이브러리의 하위 호환성
작성자	Neal Norwitz
Python 버전	패키지/모듈	작성자	비고
Python 버전	패키지/모듈	작성자	비고
2.5	`with` 문 (from `__future__ import` 없이), `io` 모듈, `str.format()`, `except as`, `bytes`, `b''` 리터럴, `property.setter`/`deleter`
2.4	`with` 문, 조건 표현식 (conditional expressions), `try`/`except`/`finally` 결합, 상대적 `import` (relative imports), `yield` 표현식 또는 `generator.throw`/`send`/`close()`		이 모든 기능은 이전 기능들을 포함합니다.
Python 버전	패키지/모듈	작성자	비고
Python 버전	패키지/모듈	작성자	비고
2.3	distutils	Tarek Ziade

하위 호환 가능한 패키지, 모듈 및 도구 (Backward Compatible Packages, Modules, and Tools)

아래 표는 이전 Python 버전과의 하위 호환성을 유지해야 하는 Python 표준 라이브러리의 패키지, 모듈 및 도구를 나열합니다.

패키지/모듈	작성자	Python 버전	비고
Python 버전	패키지/모듈	작성자	비고
2to3	Benjamin Peterson	2.5
bsddb	Greg Smith, Barry Warsaw	2.1
compiler	Jeremy Hylton	2.1
decimal	Raymond Hettinger	2.3
email	Barry Warsaw	2.1 / 2.3
pkgutil	Phillip Eby	2.3
platform	Marc-Andre Lemburg	1.5.2
pybench	Marc-Andre Lemburg	1.5.2
sre	Fredrik Lundh	2.1
subprocess	Peter Astrand	2.2
wsgiref	Phillip J. Eby	2.1
xml (PyXML)	Martin v. Loewis	2.0
xmlrpclib	Fredrik Lundh	2.1

비고 (Notes)

email 패키지 버전 2는 Python 2.3까지의 Python과 함께 배포되었으며, Python 2.1과 호환성을 유지해야 합니다. email 패키지 버전 3은 Python 2.4와 함께 배포될 예정이며, Python 2.3과만 호환성을 유지하면 됩니다. 스펙 업데이트는 버그 수정으로 취급되어 백포트될 것입니다. Python 2.3 호환성은 적어도 Python 2.4에서 유지될 것입니다. Python 2.5에서는 이 결정이 재검토될 것이며, 명백한 이점이 발생하지 않는 한 변경되지 않을 것입니다.
pybench는 Tools/ 디렉터리에 있습니다. Python 버전 간의 성능 비교를 가능하게 하기 위해 이전 Python 버전과의 호환성이 필요합니다. 새로운 기능은 새로운 테스트에 계속 사용될 수 있으며, 이 경우 이전 Python 버전의 도구에서 import 시 정상적으로 실패하도록 설정될 수 있습니다.

이 문서는 퍼블릭 도메인에 공개되었습니다.

⚠️ 알림: 이 문서는 AI를 활용하여 번역되었으며, 기술적 정확성을 보장하지 않습니다. 정확한 내용은 반드시 원문을 확인하시기 바랍니다.