Docs Are Not Clear on How to Share a Queue Between Interpreters

Documentation

Users create cross-interpreter queues by calling concurrent.interpreters.create_queue(). @terryjreedy pointed out that the docs aren't clear about how to get a queue in one interpreter over to another interpreter. See https://github.com/python/cpython/issues/139383#issuecomment-3354723401.

The docs entry for concurrent.interpreters.create_queue() should call this case out specifically and include a short example code snippet. It would probably be smart to add something similar to the docs entry for Interpreter.prepare_main(); the original motivation for that method was to pass a queue to another interpreter.

Linked PRs

• gh-149367

Tìm các mục tài liệu về concurrent.interpreters.create_queue() và Interpreter.prepare_main(), sau đó xem lại phần thảo luận được liên kết trong issue 139383. Thêm phần giải thích rõ ràng và ví dụ ngắn cho thấy cách truyền một hàng đợi giữa các interpreter, cùng với hướng dẫn tương tự cho Interpreter.prepare_main(); công việc được coi là hoàn tất khi cả hai mục đều ghi rõ trường hợp sử dụng này trong tài liệu.