concurrent.interpreters --- Multiple interpreters in the same process¶
Added in version 3.14.
Source code: Lib/concurrent/interpreters.py
はじめに¶
The concurrent.interpreters module constructs higher-level
interfaces on top of the lower level _interpreters module.
参考
- 拡張モジュールを分離する
how to update an extension module to support multiple interpreters
Availability: not WASI.
このモジュールは WebAssembly では動作しないか、利用不可です。詳しくは、WebAssembly プラットフォーム を見てください。
Key details¶
Before we dive into examples, there are a small number of details to keep in mind about using multiple interpreters:
isolated, by default
no implicit threads
not all PyPI packages support use in multiple interpreters yet
In the context of multiple interpreters, "isolated" means that different interpreters do not share any state. In practice, there is some process-global data they all share, but that is managed by the runtime.
リファレンス¶
このモジュールは以下の関数を定義しています:
- concurrent.interpreters.list_all()¶
Return a
listofInterpreterobjects, one for each existing interpreter.
- concurrent.interpreters.get_current()¶
Return an
Interpreterobject for the currently running interpreter.
- concurrent.interpreters.get_main()¶
Return an
Interpreterobject for the main interpreter.
- concurrent.interpreters.create()¶
Initialize a new (idle) Python interpreter and return a
Interpreterobject for it.
Interpreter objects¶
- class concurrent.interpreters.Interpreter(id)¶
A single interpreter in the current process.
Generally,
Interpretershouldn't be called directly. Instead, usecreate()or one of the other module functions.- id¶
(read-only)
The interpreter's ID.
- whence¶
(read-only)
A string describing where the interpreter came from.
- is_running()¶
Return
Trueif the interpreter is currently executing code in its__main__module andFalseotherwise.
- close()¶
Finalize and destroy the interpreter.
- prepare_main(ns=None, **kwargs)¶
Bind "shareable" objects in the interpreter's
__main__module.
- exec(code, /, dedent=True)¶
Run the given source code in the interpreter (in the current thread).
- call(callable, /, *args, **kwargs)¶
Return the result of calling running the given function in the interpreter (in the current thread).
- call_in_thread(callable, /, *args, **kwargs)¶
Run the given function in the interpreter (in a new thread).
例外¶
- exception concurrent.interpreters.InterpreterError¶
This exception, a subclass of
Exception, is raised when an interpreter-related error happens.
- exception concurrent.interpreters.InterpreterNotFoundError¶
This exception, a subclass of
InterpreterError, is raised when the targeted interpreter no longer exists.
- exception concurrent.interpreters.ExecutionFailed¶
This exception, a subclass of
InterpreterError, is raised when the running code raised an uncaught exception.- excinfo¶
A basic snapshot of the exception raised in the other interpreter.
This exception, a subclass of
TypeError, is raised when an object cannot be sent to another interpreter.
基本的な使い方¶
Creating an interpreter and running code in it:
from concurrent import interpreters
interp = interpreters.create()
# Run in the current OS thread.
interp.exec('print("spam!")')
interp.exec("""if True:
print('spam!')
""")
from textwrap import dedent
interp.exec(dedent("""
print('spam!')
"""))
def run():
print('spam!')
interp.call(run)
# Run in new OS thread.
t = interp.call_in_thread(run)
t.join()