refactor OkWrap to not call .into_py(py)

This commit is contained in:
David Hewitt 2023-11-24 04:29:24 +00:00
parent 81df150823
commit c814078866
7 changed files with 69 additions and 40 deletions

View file

@ -449,11 +449,13 @@ impl<'a> FnSpec<'a> {
let func_name = &self.name; let func_name = &self.name;
let rust_call = |args: Vec<TokenStream>| { let rust_call = |args: Vec<TokenStream>| {
let mut call = quote! { function(#self_arg #(#args),*) }; let call = quote! { function(#self_arg #(#args),*) };
if self.asyncness.is_some() { let wrapped_call = if self.asyncness.is_some() {
call = quote! { _pyo3::impl_::coroutine::wrap_future(#call) }; quote! { _pyo3::PyResult::Ok(_pyo3::impl_::wrap::wrap_future(#call)) }
} } else {
quotes::map_result_into_ptr(quotes::ok_wrap(call)) quotes::ok_wrap(call)
};
quotes::map_result_into_ptr(wrapped_call)
}; };
let rust_name = if let Some(cls) = cls { let rust_name = if let Some(cls) = cls {

View file

@ -458,7 +458,7 @@ fn impl_py_class_attribute(cls: &syn::Type, spec: &FnSpec<'_>) -> syn::Result<Me
let associated_method = quote! { let associated_method = quote! {
fn #wrapper_ident(py: _pyo3::Python<'_>) -> _pyo3::PyResult<_pyo3::PyObject> { fn #wrapper_ident(py: _pyo3::Python<'_>) -> _pyo3::PyResult<_pyo3::PyObject> {
let function = #cls::#name; // Shadow the method name to avoid #3017 let function = #cls::#name; // Shadow the method name to avoid #3017
#body _pyo3::impl_::wrap::map_result_into_py(py, #body)
} }
}; };

View file

@ -9,13 +9,13 @@ pub(crate) fn some_wrap(obj: TokenStream) -> TokenStream {
pub(crate) fn ok_wrap(obj: TokenStream) -> TokenStream { pub(crate) fn ok_wrap(obj: TokenStream) -> TokenStream {
quote! { quote! {
_pyo3::impl_::wrap::OkWrap::wrap(#obj, py) _pyo3::impl_::wrap::OkWrap::wrap(#obj)
.map_err(::core::convert::Into::<_pyo3::PyErr>::into) .map_err(::core::convert::Into::<_pyo3::PyErr>::into)
} }
} }
pub(crate) fn map_result_into_ptr(result: TokenStream) -> TokenStream { pub(crate) fn map_result_into_ptr(result: TokenStream) -> TokenStream {
quote! { quote! {
#result.map(_pyo3::PyObject::into_ptr) _pyo3::impl_::wrap::map_result_into_ptr(py, #result)
} }
} }

View file

@ -6,8 +6,6 @@
//! APIs may may change at any time without documentation in the CHANGELOG and without //! APIs may may change at any time without documentation in the CHANGELOG and without
//! breaking semver guarantees. //! breaking semver guarantees.
#[cfg(feature = "macros")]
pub mod coroutine;
pub mod deprecations; pub mod deprecations;
pub mod extract_argument; pub mod extract_argument;
pub mod freelist; pub mod freelist;

View file

@ -1,19 +0,0 @@
use crate::coroutine::Coroutine;
use crate::impl_::wrap::OkWrap;
use crate::{IntoPy, PyErr, PyObject, Python};
use std::future::Future;
/// Used to wrap the result of async `#[pyfunction]` and `#[pymethods]`.
pub fn wrap_future<F, R, T>(future: F) -> Coroutine
where
F: Future<Output = R> + Send + 'static,
R: OkWrap<T>,
T: IntoPy<PyObject>,
PyErr: From<R::Error>,
{
let future = async move {
// SAFETY: GIL is acquired when future is polled (see `Coroutine::poll`)
future.await.wrap(unsafe { Python::assume_gil_acquired() })
};
Coroutine::from_future(future)
}

View file

@ -1,17 +1,19 @@
use crate::{IntoPy, Py, PyAny, PyErr, PyObject, PyResult, Python}; use std::convert::Infallible;
use crate::{ffi, IntoPy, PyObject, PyResult, Python};
/// Used to wrap values in `Option<T>` for default arguments. /// Used to wrap values in `Option<T>` for default arguments.
pub trait SomeWrap<T> { pub trait SomeWrap<T> {
fn wrap(self) -> T; fn wrap(self) -> Option<T>;
} }
impl<T> SomeWrap<Option<T>> for T { impl<T> SomeWrap<T> for T {
fn wrap(self) -> Option<T> { fn wrap(self) -> Option<T> {
Some(self) Some(self)
} }
} }
impl<T> SomeWrap<Option<T>> for Option<T> { impl<T> SomeWrap<T> for Option<T> {
fn wrap(self) -> Self { fn wrap(self) -> Self {
self self
} }
@ -20,7 +22,7 @@ impl<T> SomeWrap<Option<T>> for Option<T> {
/// Used to wrap the result of `#[pyfunction]` and `#[pymethods]`. /// Used to wrap the result of `#[pyfunction]` and `#[pymethods]`.
pub trait OkWrap<T> { pub trait OkWrap<T> {
type Error; type Error;
fn wrap(self, py: Python<'_>) -> Result<Py<PyAny>, Self::Error>; fn wrap(self) -> Result<T, Self::Error>;
} }
// The T: IntoPy<PyObject> bound here is necessary to prevent the // The T: IntoPy<PyObject> bound here is necessary to prevent the
@ -29,9 +31,10 @@ impl<T> OkWrap<T> for T
where where
T: IntoPy<PyObject>, T: IntoPy<PyObject>,
{ {
type Error = PyErr; type Error = Infallible;
fn wrap(self, py: Python<'_>) -> PyResult<Py<PyAny>> { #[inline]
Ok(self.into_py(py)) fn wrap(self) -> Result<T, Infallible> {
Ok(self)
} }
} }
@ -40,11 +43,44 @@ where
T: IntoPy<PyObject>, T: IntoPy<PyObject>,
{ {
type Error = E; type Error = E;
fn wrap(self, py: Python<'_>) -> Result<Py<PyAny>, Self::Error> { #[inline]
self.map(|o| o.into_py(py)) fn wrap(self) -> Result<T, Self::Error> {
self
} }
} }
/// This is a follow-up function to `OkWrap::wrap` that converts the result into
/// a `*mut ffi::PyObject` pointer.
pub fn map_result_into_ptr<T: IntoPy<PyObject>>(
py: Python<'_>,
result: PyResult<T>,
) -> PyResult<*mut ffi::PyObject> {
result.map(|obj| obj.into_py(py).into_ptr())
}
/// This is a follow-up function to `OkWrap::wrap` that converts the result into
/// a safe wrapper.
pub fn map_result_into_py<T: IntoPy<PyObject>>(
py: Python<'_>,
result: PyResult<T>,
) -> PyResult<PyObject> {
result.map(|err| err.into_py(py))
}
/// Used to wrap the result of async `#[pyfunction]` and `#[pymethods]`.
#[cfg(feature = "macros")]
pub fn wrap_future<F, R, T>(future: F) -> crate::coroutine::Coroutine
where
F: std::future::Future<Output = R> + Send + 'static,
R: OkWrap<T>,
T: IntoPy<PyObject>,
crate::PyErr: From<R::Error>,
{
crate::coroutine::Coroutine::from_future::<_, T, crate::PyErr>(async move {
OkWrap::wrap(future.await).map_err(Into::into)
})
}
#[cfg(test)] #[cfg(test)]
mod tests { mod tests {
use super::*; use super::*;
@ -57,4 +93,16 @@ mod tests {
let b: Option<u8> = SomeWrap::wrap(None); let b: Option<u8> = SomeWrap::wrap(None);
assert_eq!(b, None); assert_eq!(b, None);
} }
#[test]
fn wrap_result() {
let a: Result<u8, _> = OkWrap::wrap(42u8);
assert!(matches!(a, Ok(42)));
let b: PyResult<u8> = OkWrap::wrap(Ok(42u8));
assert!(matches!(b, Ok(42)));
let c: Result<u8, &str> = OkWrap::wrap(Err("error"));
assert_eq!(c, Err("error"));
}
} }

View file

@ -33,7 +33,7 @@ fn test_compile_errors() {
t.compile_fail("tests/ui/invalid_pymethod_receiver.rs"); t.compile_fail("tests/ui/invalid_pymethod_receiver.rs");
t.compile_fail("tests/ui/missing_intopy.rs"); t.compile_fail("tests/ui/missing_intopy.rs");
// adding extra error conversion impls changes the output // adding extra error conversion impls changes the output
#[cfg(all(target_os = "linux", not(any(feature = "eyre", feature = "anyhow"))))] #[cfg(not(any(windows, feature = "eyre", feature = "anyhow")))]
t.compile_fail("tests/ui/invalid_result_conversion.rs"); t.compile_fail("tests/ui/invalid_result_conversion.rs");
t.compile_fail("tests/ui/not_send.rs"); t.compile_fail("tests/ui/not_send.rs");
t.compile_fail("tests/ui/not_send2.rs"); t.compile_fail("tests/ui/not_send2.rs");