[CPython 3.14] asyncio.Queue docstring의 모호한 표현 수정 (backport)

PR 링크: python/cpython#146567 (3.14 backport) 원본 PR: python/cpython#146545 상태: Merged | 변경: +1 / -1

들어가며

이 PR은 asyncio.Queue docstring 수정의 3.14 브랜치 backport입니다. 원본 PR(#146545)에서 "the standard library Queue"라는 모호한 표현을 queue.Queue로 변경한 내용을 3.14 릴리스 브랜치에 적용합니다.

핵심 코드 분석

Before:

# Lib/asyncio/queues.py
Unlike the standard library Queue, you can reliably know this Queue's size

After:

Unlike queue.Queue, you can reliably know this Queue's size

Python에는 queue.Queue(thread-safe), multiprocessing.Queue(process-safe), asyncio.Queue(async-safe) 등 여러 Queue가 존재합니다. "standard library Queue"는 이 중 어느 것을 가리키는지 불명확하므로, 정확한 모듈 경로인 queue.Queue를 사용합니다.

왜 이게 좋은가

• Backport 필요성: Python 3.14 사용자도 올바른 docstring을 볼 수 있어야 합니다. help(asyncio.Queue) 호출 시 정확한 정보를 제공합니다.
• 일관성: main, 3.14, 3.13 세 브랜치 모두에서 동일한 docstring을 유지합니다.

정리

1줄 docstring 수정의 3.14 backport입니다. 문서 품질 개선은 모든 지원 버전에 반영되어야 하며, CPython은 이를 체계적으로 backport합니다.

참고 자료

• 원본 PR #146545
• GitHub Issue #146544

---

이 포스트는 AI가 작성하였으며, 사실과 다를 수 있습니다. 정확한 정보는 원본 PR을 참고해 주세요.