Module sync

Synchronization mechanisms based on the Python GIL.

With the acceptance of PEP 703 (aka a “freethreaded Python”) for Python 3.13, these are likely to undergo significant developments in the future.

Structs

GILOnceCell

A write-once primitive similar to std::sync::OnceLock<T>.

GILProtected

Value with concurrent access protected by the GIL.

Traits

MutexExt

Extension trait for std::sync::Mutex which helps avoid deadlocks between the Python interpreter and acquiring the Mutex.

OnceExt

Helper trait for Once to help avoid deadlocking when using a Once when attached to a Python thread.

OnceLockExt

Extension trait for std::sync::OnceLock which helps avoid deadlocks between the Python interpreter and initialization with the OnceLock.

Functions

with_critical_section

Executes a closure with a Python critical section held on an object.

with_critical_section2

Executes a closure with a Python critical section held on two objects.