concurrent.interpreters queue documentation doesn't match reality

Đang mở

#136,563 mở ngày 12/7/2025 3 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

3.14 3.15 docs stdlib topic-subinterpreters

Ngôn ngữ chính: Python
Star: 77.2k
Fork: 36k
Chỉ số merge pull request: Chỉ số pull request đang chờ

Mô tả

I don't know if this is a problem with the documentation or with reality but:

QueueEmptyError and QueueFullError don't exist (https://docs.python.org/3.14/library/concurrent.interpreters.html#concurrent.interpreters.QueueEmptyError). They appear to be called QueueEmpty and QueueFull.
queue.get doesn't take a block keyword argument. The documentation says

which implements the queue.Queue interface.

and queue.Queue.get is documented as having a block method.

Linked PRs

gh-139358

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
Fork repository và làm thay đổi trên một nhánh.
Mở pull request có tham chiếu số hiệu của issue.

Hướng nghiên cứu

Bắt đầu với tài liệu về concurrent.interpreters, đặc biệt là các tham chiếu đến QueueEmptyError, QueueFullError và queue.get, rồi so sánh chúng với các tên và chữ ký được báo cáo. Kiểm tra PR gh-139358 được liên kết trước khi thực hiện thay đổi; hoàn tất có nghĩa là tài liệu khớp với hành vi thực tế của API.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ: python
Lĩnh vực: documentation
Loại issue: Tài liệu
Độ khó: 3/5
Thời gian dự kiến: 1-2 ngày
Mức độ hoạt động: Đình trệ
Độ rõ ràng: Khá rõ ràng
Mức phù hợp với người mới: 20/100

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.