PyO3 将 rust 结构转换为 &PyAny

Question

我有一个结构

#[pyclass]
pub struct DynMat {
   ...
}

我有这个功能

#[pyfunction]
#[text_signature = "(tensor/)"]
pub fn exp<'py>(py: Python<'py>, tensor_or_scalar: &'py PyAny) -> PyResult<&'py PyAny> {
    // I need to return &PyAny because I might either return PyFloat or DynMat
    if let Ok(scalar) = tensor_or_scalar.cast_as::<PyFloat>() {
        let scalar: &PyAny = PyFloat::new(py, scalar.extract::<f64>()?.exp());
        Ok(scalar)
    } else if let Ok(tensor) = tensor_or_scalar.cast_as::<PyCell<DynMat>>() {
        let mut tensor:PyRef<DynMat> = tensor.try_borrow()?;
        let tensor:DynMat = tensor.exp()?;
        // what now? How to return tensor
    }
}

问题是，我怎样才能从一个期望 PyResult<&'py PyAny> 的函数返回一个标有 pyclass 的 Rust 结构

Answer 1

我假设您要返回的是 tensor。

如果您的返回类型是 PyResult<DynMat>，您可以直接返回它并让自动转换开始。但我假设根据您是标量还是张量，您将返回不同的类型。

所以，现在您将tensor 作为DynMat 在一个拥有的值，我们需要将它移动到python 堆。看起来是这样的：

let tensor_as_py = Py::new(py, tensor)?.into_ref(py);
return Ok(tensor_as_py);

PS：你也可以更简洁地写下你的转换尝试：

pub fn blablabla() {
  let tensor: PyRefMut<DynMat> = tensor_or_scalar.extract();
  if let Ok(tensor) = tensor {
    let tensor = tensor.exp();

但是看看你的代码，还有一件事让我很困惑：

要对张量求幂，您是在可变地借用它。这向我表明，求幂将就位。那你为什么还要退货呢？

或者这是否意味着对原始张量的引用？在这种情况下，我会去掉变量阴影，这样您就可以返回 PyRefMut<DynMat>，您可以通过 from 或 into 将其转换为 &PyAny。

但实际上，tensor.exp()? 似乎返回了 DynMat 类型的拥有值，所以它似乎毕竟创建了一个 new 张量。在这种情况下，是的，您需要使用上面显示的Py::new 方法将其从 Rust 移动到 python 堆。

编辑： 以前的版本使用 as_ref(py) 而不是 into_ref(py)。前者借用 Py<_> 对象给你一个参考，但后者实际上消耗 Py<_> 对象。

文档实际上在这里准确地解释了您的用例https://docs.rs/pyo3/0.13.2/pyo3/prelude/struct.Py.html#method.into_ref