Struct pyo3::Py

#[repr(transparent)]
pub struct Py<T>(_, _);

Safe wrapper around unsafe *mut ffi::PyObject pointer with specified type information.

Methods

impl<T> Py<T>

pub unsafe fn from_owned_ptr(ptr: *mut PyObject) -> Py<T>

Creates a Py<T> instance for the given FFI pointer. This moves ownership over the pointer into the Py<T>. Undefined behavior if the pointer is NULL or invalid.

pub unsafe fn from_owned_ptr_or_panic(ptr: *mut PyObject) -> Py<T>

Creates a Py<T> instance for the given FFI pointer. Panics if the pointer is null. Undefined behavior if the pointer is invalid.

pub unsafe fn from_owned_ptr_or_err(
    py: Python,
    ptr: *mut PyObject
) -> PyResult<Py<T>>

Construct Py<T> from the result of a Python FFI call that returns a new reference (owned pointer). Returns Err(PyErr) if the pointer is null. Unsafe because the pointer might be invalid.

pub unsafe fn from_borrowed_ptr(ptr: *mut PyObject) -> Py<T>

Creates a Py<T> instance for the given Python FFI pointer. Calls Py_INCREF() on the ptr. Undefined behavior if the pointer is NULL or invalid.

pub fn get_refcnt(&self) -> isize

Gets the reference count of the ffi::PyObject pointer.

pub fn clone_ref(&self, _py: Python) -> Py<T>

Clone self, Calls Py_INCREF() on the ptr.

impl<T> Py<T> where
    T: PyTypeCreate, 

pub fn new<F>(py: Python, f: F) -> PyResult<Py<T>> where
    F: FnOnce() -> T,
    T: PyTypeObject + PyTypeInfo, 

Create new instance of T and move it under python management Returns Py<T>.

pub fn new_ref<F>(py: Python, f: F) -> PyResult<&T> where
    F: FnOnce() -> T,
    T: PyTypeObject + PyTypeInfo, 

Create new instance of T and move it under python management. Returns references to T

pub fn new_mut<F>(py: Python, f: F) -> PyResult<&mut T> where
    F: FnOnce() -> T,
    T: PyTypeObject + PyTypeInfo, 

Create new instance of T and move it under python management. Returns mutable references to T

Trait Implementations

impl<T> ToPyObject for Py<T>

fn to_object(&self, py: Python) -> PyObject

Converts Py instance -> PyObject.

impl<T> IntoPyObject for Py<T>

fn into_object(self, py: Python) -> PyObject

Converts Py instance -> PyObject. Consumes self without calling Py_DECREF()

impl IntoPyTuple for Py<PyTuple>

fn into_tuple(self, _py: Python) -> Py<PyTuple>

Converts self into a PyTuple object.

impl<'a, T> FromPyObject<'a> for Py<T> where
    T: ToPyPointer,
    &'a T: 'a + FromPyObject<'a>, 

fn extract(ob: &'a PyObjectRef) -> PyResult<Self>

Extracts Self from the source PyObject.

impl<T> AsPyRef<T> for Py<T> where
    T: PyTypeInfo, 

fn as_ref(&self, py: Python) -> &T

Return reference to object.

fn as_mut(&mut self, py: Python) -> &mut T

Return mutable reference to object.

fn with<F, R>(&self, f: F) -> R where
    F: FnOnce(Python, &T) -> R, 

Acquire python gil and call closure with object reference.

fn with_mut<F, R>(&mut self, f: F) -> R where
    F: FnOnce(Python, &mut T) -> R, 

Acquire python gil and call closure with mutable object reference.

fn into_py<F, R>(self, f: F) -> R where
    Self: IntoPyPointer,
    F: FnOnce(Python, &T) -> R, 

fn into_mut_py<F, R>(self, f: F) -> R where
    Self: IntoPyPointer,
    F: FnOnce(Python, &mut T) -> R, 

impl<T> ToPyPointer for Py<T>

fn as_ptr(&self) -> *mut PyObject

Gets the underlying FFI pointer, returns a borrowed pointer.

impl<T> IntoPyPointer for Py<T>

#[must_use]

fn into_ptr(self) -> *mut PyObject

Gets the underlying FFI pointer, returns a owned pointer.

impl<T> Send for Py<T>

impl<T> Drop for Py<T>

Dropping a Py instance decrements the reference count on the object by 1.

fn drop(&mut self)

Executes the destructor for this type.

impl<T> PartialEq<Py<T>> for Py<T>

fn eq(&self, o: &Py<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T> Sync for Py<T>

impl<T> From<Py<T>> for PyObject

fn from(ob: Py<T>) -> Self

Performs the conversion.

impl<'a, T> From<&'a T> for Py<T> where
    T: ToPyPointer, 

fn from(ob: &'a T) -> Self

Performs the conversion.

impl<'a, T> From<&'a mut T> for Py<T> where
    T: ToPyPointer, 

fn from(ob: &'a mut T) -> Self

Performs the conversion.

impl<T: Debug> Debug for Py<T>

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.