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

concurrent.interpreters.create_queue() と Interpreter.prepare_main() のドキュメント項目を見つけ、issue 139383 にリンクされている議論を確認してください。キューをインタープリター間で渡す方法を示す明確な説明と短い例を追加し、Interpreter.prepare_main() についても同様のガイダンスを追加してください。両方の項目でこのユースケースが明示的にドキュメント化されていれば完了です。