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

Repérez les entrées de documentation pour concurrent.interpreters.create_queue() et Interpreter.prepare_main(), puis examinez la discussion liée dans issue 139383. Ajoutez une explication claire et un court exemple montrant comment une file d’attente est transmise entre des interpréteurs, ainsi que des indications similaires pour Interpreter.prepare_main() ; le travail est terminé lorsque les deux entrées documentent explicitement ce cas d’utilisation.