Function pyo3::prepare_freethreaded_python

pub fn prepare_freethreaded_python()

This is supported on non-PyPy only.

Prepares the use of Python in a free-threaded context.

If the Python interpreter is not already initialized, this function will initialize it with signal handling disabled (Python will not raise the KeyboardInterrupt exception). Python signal handling depends on the notion of a ‘main thread’, which must be the thread that initializes the Python interpreter.

If both the Python interpreter and Python threading are already initialized, this function has no effect.

This function is unavailable under PyPy because PyPy cannot be embedded in Rust (or any other software). Support for this is tracked on the PyPy issue tracker.

Panics

• If the Python interpreter is initialized but Python threading is not, a panic occurs. It is not possible to safely access the Python runtime unless the main thread (the thread which originally initialized Python) also initializes threading.

Examples

use pyo3::prelude::*;

fn main() {
    pyo3::prepare_freethreaded_python();
    Python::with_gil(|py| {
        py.run("print('Hello World')", None, None)
    });
}