luxolus/pyo3
2
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity

add Bound::as_unbound (#3973)

Browse source 
* add Bound::as_unbound

* Update src/instance.rs
This commit is contained in:
David Hewitt 2024-03-20 12:52:09 +00:00 committed by GitHub
parent 2736cf670c
commit cedac43dbb
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 24 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

27
src/instance.rs
View file

@ -465,6 +465,13 @@ impl<'py, T> Bound<'py, T> {
unsafe { Py::from_non_null(non_null) }
}
/// Removes the connection for this `Bound<T>` from the GIL, allowing
/// it to cross thread boundaries, without transferring ownership.
#[inline]
pub fn as_unbound(&self) -> &Py<T> {
&self.1
}
/// Casts this `Bound<T>` as the corresponding "GIL Ref" type.
///
/// This is a helper to be used for migration from the deprecated "GIL Refs" API.
@ -521,11 +528,11 @@ impl<'py, T> Borrowed<'_, 'py, T> {
/// # fn main() -> PyResult<()> {
/// Python::with_gil(|py| -> PyResult<()> {
/// let tuple = PyTuple::new_bound(py, [1, 2, 3]);
///
///
/// // borrows from `tuple`, so can only be
/// // used while `tuple` stays alive
/// let borrowed = tuple.get_borrowed_item(0)?;
///
///
/// // creates a new owned reference, which
/// // can be used indendently of `tuple`
/// let bound = borrowed.to_owned();
@ -1960,8 +1967,8 @@ impl PyObject {
mod tests {
use super::{Bound, Py, PyObject};
use crate::types::any::PyAnyMethods;
use crate::types::PyCapsule;
use crate::types::{dict::IntoPyDict, PyDict, PyString};
use crate::types::{PyCapsule, PyStringMethods};
use crate::{ffi, Borrowed, PyAny, PyNativeType, PyResult, Python, ToPyObject};
#[test]
@ -2161,6 +2168,20 @@ a = A()
});
}
#[test]
fn test_bound_py_conversions() {
Python::with_gil(|py| {
let obj: Bound<'_, PyString> = PyString::new_bound(py, "hello world");
let obj_unbound: &Py<PyString> = obj.as_unbound();
let _: &Bound<'_, PyString> = obj_unbound.bind(py);
let obj_unbound: Py<PyString> = obj.unbind();
let obj: Bound<'_, PyString> = obj_unbound.into_bound(py);
assert_eq!(obj.to_cow().unwrap(), "hello world");
});
}
#[test]
fn bound_from_borrowed_ptr_constructors() {
// More detailed tests of the underlying semantics in pycell.rs