Struct BoundContextWatcherGuard 

pub struct BoundContextWatcherGuard<'py> { /* private fields */ }

A Python-bound guard which keeps a context watcher registered.

The watcher is registered for the current Python interpreter and is removed when this guard is dropped. Use clear to remove it explicitly and observe any error returned by CPython.

This guard is bound to the Python attachment used to create it. It therefore cannot be sent to another thread, moved outside that attachment, or moved into Python::detach.

Use unbind to convert this guard into a ContextWatcherGuard which can be stored outside the current attachment.

Implementations

impl BoundContextWatcherGuard<'_>

pub fn clear(self) -> PyResult<()>

Removes this watcher from the current Python interpreter.

Dropping the guard also removes the watcher, but cannot report a failure to the caller.

pub fn unbind(self) -> ContextWatcherGuard

Removes the connection to the current Python attachment, allowing the guard to be stored outside it or sent to another thread.

Dropping the returned guard automatically attaches to Python to remove the watcher. To avoid that attachment, convert it back with ContextWatcherGuard::into_bound before dropping it, or call ContextWatcherGuard::clear while attached.

Trait Implementations

impl Drop for BoundContextWatcherGuard<'_>

Available on Py_3_14 and non-Py_GIL_DISABLED only.

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.