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

Suchen Sie die Dokumentationseinträge für concurrent.interpreters.create_queue() und Interpreter.prepare_main() und prüfen Sie anschließend die verlinkte Diskussion in issue 139383. Fügen Sie eine klare Erklärung und ein kurzes Beispiel hinzu, das zeigt, wie eine Queue zwischen Interpretern übergeben wird, sowie eine entsprechende Anleitung für Interpreter.prepare_main(); abgeschlossen ist die Aufgabe, wenn beide Einträge diesen Anwendungsfall ausdrücklich dokumentieren.