Update Rust crate pyo3 to 0.22.0

[renovate]

This PR contains the following updates:

Package	Type	Update	Change
pyo3	dependencies	minor	0.17.1 -> 0.22.0

---

Release Notes

pyo3/pyo3 (pyo3)

v0.22.2

Compare Source

Packaging

• Require opt-in to freethreaded Python using the UNSAFE_PYO3_BUILD_FREE_THREADED=1 environment variable (it is not yet supported by PyO3). #​4327

Changed

• Use FFI function calls for reference counting on all abi3 versions. #​4324
• #[pymodule(...)] now directly accepts all relevant #[pyo3(...)] options. #​4330

Fixed

• Fix compile failure in declarative #[pymodule] under presence of #![no_implicit_prelude]. #​4328
• Fix compile failure due to c-string literals on Rust < 1.79. #​4353

v0.22.1

Compare Source

Added

• Add #[pyo3(submodule)] option for declarative #[pymodule]s. #​4301
• Implement PartialEq<bool> for Bound<'py, PyBool>. #​4305

Fixed

• Return NotImplemented instead of raising TypeError from generated equality method when comparing different types. #​4287
• Handle full-path #[pyo3::prelude::pymodule] and similar for #[pyclass] and #[pyfunction] in declarative modules.#​4288
• Fix 128-bit int regression on big-endian platforms with Python <3.13. #​4291
• Stop generating code that will never be covered with declarative modules. #​4297
• Fix invalid deprecation warning for trailing optional on #[setter] function. #​4304

v0.22.0

Compare Source

Packaging

• Update heck dependency to 0.5. #​3966
• Extend range of supported versions of chrono-tz optional dependency to include version 0.10. #​4061
• Update MSRV to 1.63. #​4129
• Add optional num-rational feature to add conversions with Python's fractions.Fraction. #​4148
• Support Python 3.13. #​4184

Added

• Add PyWeakref, PyWeakrefReference and PyWeakrefProxy. #​3835
• Support #[pyclass] on enums that have tuple variants. #​4072
• Add support for scientific notation in Decimal conversion. #​4079
• Add pyo3_disable_reference_pool conditional compilation flag to avoid the overhead of the global reference pool at the cost of known limitations as explained in the performance section of the guide. #​4095
• Add #[pyo3(constructor = (...))] to customize the generated constructors for complex enum variants. #​4158
• Add PyType::module, which always matches Python __module__. #​4196
• Add PyType::fully_qualified_name which matches the "fully qualified name" defined in PEP 737. #​4196
• Add PyTypeMethods::mro and PyTypeMethods::bases. #​4197
• Add #[pyclass(ord)] to implement ordering based on PartialOrd. #​4202
• Implement ToPyObject and IntoPy<PyObject> for PyBackedStr and PyBackedBytes. #​4205
• Add #[pyclass(hash)] option to implement __hash__ in terms of the Hash implementation #​4206
• Add #[pyclass(eq)] option to generate __eq__ based on PartialEq, and #[pyclass(eq_int)] for simple enums to implement equality based on their discriminants. #​4210
• Implement From<Bound<'py, T>> for PyClassInitializer<T>. #​4214
• Add as_super methods to PyRef and PyRefMut for accesing the base class by reference. #​4219
• Implement PartialEq<str> for Bound<'py, PyString>. #​4245
• Implement PyModuleMethods::filename on PyPy. #​4249
• Implement PartialEq<[u8]> for Bound<'py, PyBytes>. #​4250
• Add pyo3_ffi::c_str macro to create &'static CStr on Rust versions which don't have 1.77's c"" literals. #​4255
• Support bool conversion with numpy 2.0's numpy.bool type #​4258
• Add PyAnyMethods::{bitnot, matmul, floor_div, rem, divmod}. #​4264

Changed

• Change the type of PySliceIndices::slicelength and the length parameter of PySlice::indices(). #​3761
• Deprecate implicit default for trailing optional arguments #​4078
• Cloneing pointers into the Python heap has been moved behind the py-clone feature, as it must panic without the GIL being held as a soundness fix. #​4095
• Add #[track_caller] to all Py<T>, Bound<'py, T> and Borrowed<'a, 'py, T> methods which can panic. #​4098
• Change PyAnyMethods::dir to be fallible and return PyResult<Bound<'py, PyList>> (and similar for PyAny::dir). #​4100
• The global reference pool (to track pending reference count decrements) is now initialized lazily to avoid the overhead of taking a mutex upon function entry when the functionality is not actually used. #​4178
• Emit error messages when using weakref or dict when compiling for abi3 for Python older than 3.9. #​4194
• Change PyType::name to always match Python __name__. #​4196
• Remove CPython internal ffi call for complex number including: add, sub, mul, div, neg, abs, pow. Added PyAnyMethods::{abs, pos, neg} #​4201
• Deprecate implicit integer comparision for simple enums in favor of #[pyclass(eq_int)]. #​4210
• Set the module= attribute of declarative modules' child #[pymodule]s and #[pyclass]es. #​4213
• Set the module option for complex enum variants from the value set on the complex enum module. #​4228
• Respect the Python "limited API" when building for the abi3 feature on PyPy or GraalPy. #​4237
• Optimize code generated by #[pyo3(get)] on #[pyclass] fields. #​4254
• PyCFunction::new, PyCFunction::new_with_keywords and PyCFunction::new_closure now take &'static CStr name and doc arguments (previously was &'static str). #​4255
• The experimental-declarative-modules feature is now stabilized and available by default. #​4257

Fixed

• Fix panic when PYO3_CROSS_LIB_DIR is set to a missing path. #​4043
• Fix a compile error when exporting an exception created with create_exception! living in a different Rust module using the declarative-module feature. #​4086
• Fix FFI definitions of PY_VECTORCALL_ARGUMENTS_OFFSET and PyVectorcall_NARGS to fix a false-positive assertion. #​4104
• Disable PyUnicode_DATA on PyPy: not exposed by PyPy. #​4116
• Correctly handle #[pyo3(from_py_with = ...)] attribute on dunder (__magic__) method arguments instead of silently ignoring it. #​4117
• Fix a compile error when declaring a standalone function or class method with a Python name that is a Rust keyword. #​4226
• Fix declarative modules discarding doc comments on the mod node. #​4236
• Fix __dict__ attribute missing for #[pyclass(dict)] instances when building for abi3 on Python 3.9. #​4251

v0.21.2

Compare Source

Changed

• Deprecate the PySet::empty() gil-ref constructor. #​4082

Fixed

• Fix compile error for async fn in #[pymethods] with a &self receiver and more than one additional argument. #​4035
• Improve error message for wrong receiver type in __traverse__. #​4045
• Fix compile error when exporting a #[pyclass] living in a different Rust module using the experimental-declarative-modules feature. #​4054
• Fix missing_docs lint triggering on documented #[pymodule] functions. #​4067
• Fix undefined symbol errors for extension modules on AIX (by linking libpython). #​4073

v0.21.1

Compare Source

Added

• Implement Send and Sync for PyBackedStr and PyBackedBytes. #​4007
• Implement Clone, Debug, PartialEq, Eq, PartialOrd, Ord and Hash implementation for PyBackedBytes and PyBackedStr, and Display for PyBackedStr. #​4020
• Add import_exception_bound! macro to import exception types without generating GIL Ref functionality for them. #​4027

Changed

• Emit deprecation warning for uses of GIL Refs as #[setter] function arguments. #​3998
• Add #[inline] hints on many Bound and Borrowed methods. #​4024

Fixed

• Handle #[pyo3(from_py_with = "")] in #[setter] methods #​3995
• Allow extraction of &Bound in #[setter] methods. #​3998
• Fix some uncovered code blocks emitted by #[pymodule], #[pyfunction] and #[pyclass] macros. #​4009
• Fix typo in the panic message when a class referenced in pyo3::import_exception! does not exist. #​4012
• Fix compile error when using an async #[pymethod] with a receiver and additional arguments. #​4015

v0.21.0

Compare Source

Added

• Add support for GraalPy (24.0 and up). #​3247
• Add PyMemoryView type. #​3514
• Allow async fn in for #[pyfunction] and #[pymethods], with the experimental-async feature. #​3540 #​3588 #​3599 #​3931
• Implement PyTypeInfo for PyEllipsis, PyNone and PyNotImplemented. #​3577
• Support #[pyclass] on enums that have non-unit variants. #​3582
• Support chrono feature with abi3 feature. #​3664
• FromPyObject, IntoPy<PyObject> and ToPyObject are implemented on std::duration::Duration #​3670
• Add PyString::to_cow. Add Py<PyString>::to_str, Py<PyString>::to_cow, and Py<PyString>::to_string_lossy, as ways to access Python string data safely beyond the GIL lifetime. #​3677
• Add Bound<T> and Borrowed<T> smart pointers as a new API for accessing Python objects. #​3686
• Add PyNativeType::as_borrowed to convert "GIL refs" to the new Bound smart pointer. #​3692
• Add FromPyObject::extract_bound method, to migrate FromPyObject implementations to the Bound API. #​3706
• Add gil-refs feature to allow continued use of the deprecated GIL Refs APIs. #​3707
• Add methods to PyAnyMethods for binary operators (add, sub, etc.) #​3712
• Add chrono-tz feature allowing conversion between chrono_tz::Tz and zoneinfo.ZoneInfo #​3730
• Add FFI definition PyType_GetModuleByDef. #​3734
• Conversion between std::time::SystemTime and datetime.datetime #​3736
• Add Py::as_any and Py::into_any. #​3785
• Add PyStringMethods::encode_utf8. #​3801
• Add PyBackedStr and PyBackedBytes, as alternatives to &str and &bytes where a Python object owns the data. #​3802 #​3991
• Allow #[pymodule] macro on Rust mod blocks, with the experimental-declarative-modules feature. #​3815
• Implement ExactSizeIterator for set and frozenset iterators on abi3 feature. #​3849
• Add Py::drop_ref to explicitly drop a `Py`` and immediately decrease the Python reference count if the GIL is already held. #​3871
• Allow #[pymodule] macro on single argument functions that take &Bound<'_, PyModule>. #​3905
• Implement FromPyObject for Cow<str>. #​3928
• Implement Default for GILOnceCell. #​3971
• Add PyDictMethods::into_mapping, PyListMethods::into_sequence and PyTupleMethods::into_sequence. #​3982

Changed

• PyDict::from_sequence now takes a single argument of type &PyAny (previously took two arguments Python and PyObject). #​3532
• Deprecate Py::is_ellipsis and PyAny::is_ellipsis in favour of any.is(py.Ellipsis()). #​3577
• Split some PyTypeInfo functionality into new traits HasPyGilRef and PyTypeCheck. #​3600
• Deprecate PyTryFrom and PyTryInto traits in favor of any.downcast() via the PyTypeCheck and PyTypeInfo traits. #​3601
• Allow async methods to accept &self/&mut self #​3609
• FromPyObject for set types now also accept frozenset objects as input. #​3632
• FromPyObject for bool now also accepts NumPy's bool_ as input. #​3638
• Add AsRefSource associated type to PyNativeType. #​3653
• Rename .is_true to .is_truthy on PyAny and Py<PyAny> to clarify that the test is not based on identity with or equality to the True singleton. #​3657
• PyType::name is now PyType::qualname whereas PyType::name efficiently accesses the full name which includes the module name. #​3660
• The Iter(A)NextOutput types are now deprecated and __(a)next__ can directly return anything which can be converted into Python objects, i.e. awaitables do not need to be wrapped into IterANextOutput or Option any more. Option can still be used as well and returning None will trigger the fast path for __next__, stopping iteration without having to raise a StopIteration exception. #​3661
• Implement FromPyObject on chrono::DateTime<Tz> for all Tz, not just FixedOffset and Utc. #​3663
• Add lifetime parameter to PyTzInfoAccess trait. For the deprecated gil-ref API, the trait is now implemented for &'py PyTime and &'py PyDateTime instead of PyTime and PyDate. #​3679
• Calls to __traverse__ become no-ops for unsendable pyclasses if on the wrong thread, thereby avoiding hard aborts at the cost of potential leakage. #​3689
• Include PyNativeType in pyo3::prelude. #​3692
• Improve performance of extract::<i64> (and other integer types) by avoiding call to __index__() converting the value to an integer for 3.10+. Gives performance improvement of around 30% for successful extraction. #​3742
• Relax bound of FromPyObject for Py<T> to just T: PyTypeCheck. #​3776
• PySet and PyFrozenSet iterators now always iterate the equivalent of iter(set). (A "fast path" with no noticeable performance benefit was removed.) #​3849
• Move implementations of FromPyObject for &str, Cow<str>, &[u8] and Cow<[u8]> onto a temporary trait FromPyObjectBound when gil-refs feature is deactivated. #​3928
• Deprecate GILPool, Python::with_pool, and Python::new_pool. #​3947

Removed

• Remove all functionality deprecated in PyO3 0.19. #​3603

Fixed

• Match PyPy 7.3.14 in removing PyPy-only symbol Py_MAX_NDIMS in favour of PyBUF_MAX_NDIM. #​3757
• Fix segmentation fault using datetime types when an invalid datetime module is on sys.path. #​3818
• Fix non_local_definitions lint warning triggered by many PyO3 macros. #​3901
• Disable PyCode and PyCode_Type on PyPy: PyCode_Type is not exposed by PyPy. #​3934

v0.20.3

Compare Source

Packaging

• Add portable-atomic dependency. #​3619
• Check maximum version of Python at build time and for versions not yet supported require opt-in to the abi3 stable ABI by the environment variable PYO3_USE_ABI3_FORWARD_COMPATIBILITY=1. #​3821

Fixed

• Use portable-atomic to support platforms without 64-bit atomics. #​3619
• Fix compilation failure with either feature enabled without experimental-inspect enabled. #​3834

v0.20.2

Compare Source

Packaging

• Pin pyo3 and pyo3-ffi dependencies on pyo3-build-config to require the same patch version, i.e. pyo3 0.20.2 requires exactly pyo3-build-config 0.20.2. #​3721

Fixed

• Fix compile failure when building pyo3 0.20.0 with latest pyo3-build-config 0.20.X. #​3724
• Fix docs.rs build. #​3722

v0.20.1

Compare Source

Added

• Add optional either feature to add conversions for either::Either<L, R> sum type. #​3456
• Add optional smallvec feature to add conversions for smallvec::SmallVec. #​3507
• Add take and into_inner methods to GILOnceCell #​3556
• #[classmethod] methods can now also receive Py<PyType> as their first argument. #​3587
• #[pyfunction(pass_module)] can now also receive Py<PyModule> as their first argument. #​3587
• Add traverse method to GILProtected. #​3616
• Added abi3-py312 feature #​3687

Fixed

• Fix minimum version specification for optional chrono dependency. #​3512
• Silenced new clippy::unnecessary_fallible_conversions warning when using a Py<Self> self receiver. #​3564

v0.20.0

Compare Source

Packaging

• Dual-license PyO3 under either the Apache 2.0 OR the MIT license. This makes the project GPLv2 compatible. #​3108
• Update MSRV to Rust 1.56. #​3208
• Bump indoc dependency to 2.0 and unindent dependency to 0.2. #​3237
• Bump syn dependency to 2.0. #​3239
• Drop support for debug builds of Python 3.7. #​3387
• Bump chrono optional dependency to require 0.4.25 or newer. #​3427
• Support Python 3.12. #​3488

Added

• Support __lt__, __le__, __eq__, __ne__, __gt__ and __ge__ in #[pymethods]. #​3203
• Add FFI definition Py_GETENV. #​3336
• Add as_ptr and into_ptr inherent methods for Py, PyAny, PyRef, and PyRefMut. #​3359
• Implement DoubleEndedIterator for PyTupleIterator and PyListIterator. #​3366
• Add #[pyclass(rename_all = "...")] option: this allows renaming all getters and setters of a struct, or all variants of an enum. Available renaming rules are: "camelCase", "kebab-case", "lowercase", "PascalCase", "SCREAMING-KEBAB-CASE", "SCREAMING_SNAKE_CASE", "snake_case", "UPPERCASE". #​3384
• Add FFI definitions PyObject_GC_IsTracked and PyObject_GC_IsFinalized on Python 3.9 and up (PyPy 3.10 and up). #​3403
• Add types for None, Ellipsis, and NotImplemented. #​3408
• Add FFI definitions for the Py_mod_multiple_interpreters constant and its possible values. #​3494
• Add FFI definitions for PyInterpreterConfig struct, its constants and Py_NewInterpreterFromConfig. #​3502

Changed

• Change PySet::discard to return PyResult<bool> (previously returned nothing). #​3281
• Optimize implmentation of IntoPy for Rust tuples to Python tuples. #​3321
• Change PyDict::get_item to no longer suppress arbitrary exceptions (the return type is now PyResult<Option<&PyAny>> instead of Option<&PyAny>), and deprecate PyDict::get_item_with_error. #​3330
• Deprecate FFI definitions which are deprecated in Python 3.12. #​3336
• AsPyPointer is now an unsafe trait. #​3358
• Accept all os.PathLike values in implementation of FromPyObject for PathBuf. #​3374
• Add __builtins__ to globals in py.run() and py.eval() if they're missing. #​3378
• Optimize implementation of FromPyObject for BigInt and BigUint. #​3379
• PyIterator::from_object and PyByteArray::from now take a single argument of type &PyAny (previously took two arguments Python and AsPyPointer). #​3389
• Replace AsPyPointer with AsRef<PyAny> as a bound in the blanket implementation of From<&T> for PyObject. #​3391
• Replace blanket impl IntoPy<PyObject> for &T where T: AsPyPointer with implementations of impl IntoPy<PyObject> for &PyAny, &T where T: AsRef<PyAny>, and &Py<T>. #​3393
• Preserve std::io::Error kind in implementation of From<std::io::IntoInnerError> for PyErr #​3396
• Try to select a relevant ErrorKind in implementation of From<PyErr> for OSError subclass. #​3397
• Retrieve the original PyErr in implementation of From<std::io::Error> for PyErr if the std::io::Error has been built using a Python exception (previously would create a new exception wrapping the std::io::Error). #​3402
• #[pymodule] will now return the same module object on repeated import by the same Python interpreter, on Python 3.9 and up. #​3446
• Truncate leap-seconds and warn when converting chrono types to Python datetime types (datetime cannot represent leap-seconds). #​3458
• Err returned from #[pyfunction] will now have a non-None __context__ if called from inside a catch block. #​3455
• Deprecate undocumented #[__new__] form of #[new] attribute. #​3505

Removed

• Remove all functionality deprecated in PyO3 0.18, including #[args] attribute for #[pymethods]. #​3232
• Remove IntoPyPointer trait in favour of into_ptr inherent methods. #​3385

Fixed

• Handle exceptions properly in PySet::discard. #​3281
• The PyTupleIterator type returned by PyTuple::iter is now public and hence can be named by downstream crates. #​3366
• Linking of PyOS_FSPath on PyPy. #​3374
• Fix memory leak in PyTypeBuilder::build. #​3401
• Disable removed FFI definitions _Py_GetAllocatedBlocks, _PyObject_GC_Malloc, and _PyObject_GC_Calloc on Python 3.11 and up. #​3403
• Fix ResourceWarning and crashes related to GC when running with debug builds of CPython. #​3404
• Some-wrapping of Option<T> default arguments will no longer re-wrap Some(T) or expressions evaluating to None. #​3461
• Fix IterNextOutput::Return not returning a value on PyPy. #​3471
• Emit compile errors instead of ignoring macro invocations inside #[pymethods] blocks. #​3491
• Emit error on invalid arguments to #[new], #[classmethod], #[staticmethod], and #[classattr]. #​3484
• Disable PyMarshal_WriteObjectToString from PyMarshal_ReadObjectFromString with the abi3 feature. #​3490
• Fix FFI definitions for _PyFrameEvalFunction on Python 3.11 and up (it now receives a _PyInterpreterFrame opaque struct). #​3500

v0.19.2

Compare Source

Added

• Add FFI definitions PyState_AddModule, PyState_RemoveModule and PyState_FindModule for PyPy 3.9 and up. #​3295
• Add FFI definitions _PyObject_CallFunction_SizeT and _PyObject_CallMethod_SizeT. #​3297
• Add a "performance" section to the guide collecting performance-related tricks and problems. #​3304
• Add PyErr::Display for all Python versions, and FFI symbol PyErr_DisplayException for Python 3.12. #​3334
• Add FFI definition PyType_GetDict() for Python 3.12. #​3339
• Add PyAny::downcast_exact. #​3346
• Add PySlice::full() to construct a full slice (::). #​3353

Changed

• Update PyErr for 3.12 betas to avoid deprecated ffi methods. #​3306
• Update FFI definitions of object.h for Python 3.12.0b4. #​3335
• Update pyo3::ffi struct definitions to be compatible with 3.12.0b4. #​3342
• Optimize conversion of float to f64 (and PyFloat::value) on non-abi3 builds. #​3345

Fixed

• Fix timezone conversion bug for FixedOffset datetimes that were being incorrectly converted to and from UTC. #​3269
• Fix SystemError raised in PyUnicodeDecodeError_Create on PyPy 3.10. #​3297
• Correct FFI definition Py_EnterRecursiveCall to return c_int (was incorrectly returning ()). #​3300
• Fix case where PyErr::matches and PyErr::is_instance returned results inconsistent with PyErr::get_type. #​3313
• Fix loss of panic message in PanicException when unwinding after the exception was "normalized". #​3326
• Fix PyErr::from_value and PyErr::into_value losing traceback on conversion. #​3328
• Fix reference counting of immortal objects on Python 3.12.0b4. #​3335

v0.19.1

Compare Source

Packaging

• Extend range of supported versions of hashbrown optional dependency to include version 0.14 #​3258
• Extend range of supported versions of indexmap optional dependency to include version 2. #​3277
• Support PyPy 3.10. #​3289

Added

• Add pyo3::types::PyFrozenSetBuilder to allow building a PyFrozenSet item by item. #​3156
• Add support for converting to and from Python's ipaddress.IPv4Address/ipaddress.IPv6Address and std::net::IpAddr. #​3197
• Add support for num-bigint feature in combination with abi3. #​3198
• Add PyErr_GetRaisedException(), PyErr_SetRaisedException() to FFI definitions for Python 3.12 and later. #​3248
• Add Python::with_pool which is a safer but more limited alternative to Python::new_pool. #​3263
• Add PyDict::get_item_with_error on PyPy. #​3270
• Allow #[new] methods may to return Py<Self> in order to return existing instances. #​3287

Fixed

• Fix conversion of classes implementing __complex__ to Complex when using abi3 or PyPy. #​3185
• Stop suppressing unrelated exceptions in PyAny::hasattr. #​3271
• Fix memory leak when creating PySet or PyFrozenSet or returning types converted into these internally, e.g. HashSet or BTreeSet. #​3286

v0.19.0

Compare Source

Packaging

• Correct dependency on syn to version 1.0.85 instead of the incorrect version 1.0.56. #​3152

Added

• Accept text_signature option (and automatically generate signature) for #[new] in #[pymethods]. #​2980
• Add support for converting to and from Python's decimal.Decimal and rust_decimal::Decimal. #​3016
• Add #[pyo3(from_item_all)] when deriving FromPyObject to specify get_item as getter for all fields. #​3120
• Add pyo3::exceptions::PyBaseExceptionGroup for Python 3.11, and corresponding FFI definition PyExc_BaseExceptionGroup. #​3141
• Accept #[new] with #[classmethod] to create a constructor which receives a (subtype's) class/PyType as its first argument. #​3157
• Add PyClass::get and Py::get for GIL-indepedent access to classes with #[pyclass(frozen)]. #​3158
• Add PyAny::is_exact_instance and PyAny::is_exact_instance_of. #​3161

Changed

• PyAny::is_instance_of::<T>(obj) is now equivalent to T::is_type_of(obj), and now returns bool instead of PyResult<bool>. #​2881
• Deprecate text_signature option on #[pyclass] structs. #​2980
• No longer wrap anyhow::Error/eyre::Report containing a basic PyErr without a chain in a PyRuntimeError. #​3004
• • Change #[getter] and #[setter] to use a common call "trampoline" to slightly reduce generated code size and compile times. #​3029
• Improve default values for str, numbers and bool in automatically-generated text_signature. #​3050
• Improve default value for None in automatically-generated text_signature. #​3066
• Rename PySequence::list and PySequence::tuple to PySequence::to_list and PySequence::to_tuple. (The old names continue to exist as deprecated forms.) #​3111
• Extend the lifetime of the GIL token returned by PyRef::py and PyRefMut::py to match the underlying borrow. #​3131
• Safe access to the GIL, for example via Python::with_gil, is now locked inside of implementations of the __traverse__ slot. #​3168

Removed

• Remove all functionality deprecated in PyO3 0.17, most prominently Python::acquire_gil is replaced by Python::with_gil. #​2981

Fixed

• Correct FFI definitions PyGetSetDef, PyMemberDef, PyStructSequence_Field and PyStructSequence_Desc to have *const c_char members for name and doc (not *mut c_char). #​3036
• Fix panic on fmt::Display, instead return "<unprintable object>" string and report error via sys.unraisablehook() #​3062
• Fix a compile error of "temporary value dropped while borrowed" when #[pyfunction]s take references into #[pyclass]es #​3142
• Fix crashes caused by PyO3 applying deferred reference count updates when entering a __traverse__ implementation. #​3168
• Forbid running the Drop implementations of unsendable classes on other threads. #​3176
• Fix a compile error when #[pymethods] items come from somewhere else (for example, as a macro argument) and a custom receiver like Py<Self> is used. #​3178

v0.18.3

Compare Source

Added

• Add GILProtected<T> to mediate concurrent access to a value using Python's global interpreter lock (GIL). #​2975
• Support PyASCIIObject / PyUnicode and associated methods on big-endian architectures. #​3015
• Add FFI definition _PyDict_Contains_KnownHash() for CPython 3.10 and up. #​3088

Fixed

• Fix compile error for #[pymethods] and #[pyfunction] called "output". #​3022
• Fix compile error in generated code for magic methods implemented as a #[staticmethod]. #​3055
• Fix is_instance for PyDateTime (would incorrectly check for a PyDate). #​3071
• Fix upstream deprecation of PyUnicode_InternImmortal since Python 3.10. #​3071

v0.18.2

Compare Source

Packaging

• Disable default features of chrono to avoid depending on time v0.1.x. #​2939

Added

• Implement IntoPy<PyObject>, ToPyObject and FromPyObject for Cow<[u8]> to efficiently handle both bytes and bytearray objects. #​2899
• Implement IntoPy<PyObject>, ToPyObject and FromPyObject for Cell<T>. #​3014
• Add PyList::to_tuple(), as a convenient and efficient conversion from lists to tuples. #​3042
• Add PyTuple::to_list(), as a convenient and efficient conversion from tuples to lists. #​3044

Changed

• Optimize PySequence conversion for list and tuple inputs. #​2944
• Improve exception raised when creating #[pyclass] type object fails during module import. #​2947
• Optimize PyMapping conversion for dict inputs. #​2954
• Allow create_exception! to take a dotted.module to place the exception in a submodule. #​2979

Fixed

• Fix a reference counting race condition affecting PyObjects cloned in allow_threads blocks. #​2952
• Fix clippy::redundant_closure lint on default arguments in #[pyo3(signature = (...))] annotations. #​2990
• Fix non_snake_case lint on generated code in #[pyfunction] macro. #​2993
• Fix some FFI definitions for the upcoming PyPy 3.10 release. #​3031

v0.18.1

Compare Source

Added

• Add PyErr::write_unraisable(). #​2889
• Add Python::Ellipsis() and PyAny::is_ellipsis() methods. #​2911
• Add PyDict::update() and PyDict::update_if_missing() methods. #​2912

Changed

• FFI definition PyIter_Check on CPython 3.7 is now implemented as hasattr(type(obj), "__next__"), which works correctly on all platforms and adds support for abi3. #​2914
• Warn about unknown config keys in PYO3_CONFIG_FILE instead of denying. #​2926

Fixed

• Send errors returned by __releasebuffer__ to sys.unraisablehook rather than causing SystemError. #​2886
• Fix downcast to PyIterator succeeding for Python classes which did not implement __next__. #​2914
• Fix segfault in __traverse__ when visiting None fields of Option<T: AsPyPointer>. #​2921
• Fix #[pymethods(crate = "...")] option being ignored. #​2923
• Link against pythonXY_d.dll for debug Python builds on Windows. #​2937

v0.18.0

Compare Source

Packaging

• Relax indexmap optional depecency to allow >= 1.6, < 2. #​2849
• Relax hashbrown optional dependency to allow >= 0.9, < 0.14. #​2875
• Update memoffset dependency to 0.8. #​2875

Added

• Add GILOnceCell::get_or_try_init for fallible GILOnceCell initialization. #​2398
• Add experimental feature experimental-inspect with type_input() and type_output() helpers to get the Python type of any Python-compatible object. #​2490 #​2882
• The #[pyclass] macro can now take get_all and set_all to create getters and setters for every field. #​2692
• Add #[pyo3(signature = (...))] option for #[pyfunction] and #[pymethods]. #​2702
• pyo3-build-config: rebuild when PYO3_ENVIRONMENT_SIGNATURE environment variable value changes. #​2727
• Add conversions between non-zero int types in std::num and Python int. #​2730
• Add Py::downcast() as a companion to PyAny::downcast(), as well as downcast_unchecked() for both types. #​2734
• Add types for all built-in Warning classes as well as PyErr::warn_explicit. #​2742
• Add abi3-py311 feature. #​2776
• Add FFI definition _PyErr_ChainExceptions() for CPython. #​2788
• Add FFI definitions PyVectorcall_NARGS and PY_VECTORCALL_ARGUMENTS_OFFSET for PyPy 3.8 and up. #​2811
• Add PyList::get_item_unchecked for PyPy. #​2827

Changed

• PyO3's macros now emit a much nicer error message if function return values don't implement the required trait(s). #​2664
• Use a TypeError, rather than a ValueError, when refusing to treat a str as a Vec. #​2685
• Change PyCFunction::new_closure to take name and doc arguments. #​2686
• PyType::is_subclass, PyErr::is_instance and PyAny::is_instance now take &PyAny instead of &PyType arguments, so that they work with objects that pretend to be types using __subclasscheck__ and __instancecheck__. #​2695
• Deprecate #[args] attribute and passing "args" specification directly to #[pyfunction] in favor of the new #[pyo3(signature = (...))] option. #​2702
• Deprecate required arguments after Option<T> arguments to #[pyfunction] and #[pymethods] without also using #[pyo3(signature)] to specify whether the arguments should be required or have defaults. #​2703
• Change #[pyfunction] and #[pymethods] to use a common call "trampoline" to slightly reduce generated code size and compile times. #​2705
• PyAny::cast_as() and Py::cast_as() are now deprecated in favor of PyAny::downcast() and the new Py::downcast(). #​2734
• Relax lifetime bounds on PyAny::downcast(). #​2734
• Automatically generate __text_signature__ for all Python functions created using #[pyfunction] and #[pymethods]. #​2784
• Accept any iterator in PySet::new and PyFrozenSet::new. #​2795
• Mixing #[cfg(...)] and #[pyo3(...)] attributes on #[pyclass] struct fields will now work. #​2796
• Re-enable PyFunction on when building for abi3 or PyPy. #​2838
• Improve derive(FromPyObject) to use intern! when applicable for #[pyo3(item)]. #​2879

Removed

• Remove the deprecated pyproto feature, #[pyproto] macro, and all accompanying APIs. #​2587
• Remove all functionality deprecated in PyO3 0.16. #​2843

Fixed

• Disable PyModule::filename on PyPy. #​2715
• PyCodeObject is now once again defined with fields on Python 3.7. #​2726
• Raise a TypeError if #[new] pymethods with no arguments receive arguments when called from Python. #​2749
• Use the NOARGS argument calling convention for methods that have a single py: Python argument (as a performance optimization). #​2760
• Fix truncation of isize values to c_long in PySlice::new. #​2769
• Fix soundness issue with FFI definition PyUnicodeDecodeError_Create on PyPy leading to indeterminate behavior (typically a TypeError). #​2772
• Allow functions taking **kwargs to accept keyword arguments which share a name with a positional-only argument (as permitted by PEP 570). #​2800
• Fix unresolved symbol for PyObject_Vectorcall on PyPy 3.9 and up. #​2811
• Fix memory leak in PyCFunction::new_closure. #​2842

v0.17.3

Compare Source

Packaging

• Support Python 3.11. (Previous versions of PyO3 0.17 have been tested against Python 3.11 release candidates and are expected to be compatible, this is the first version tested against Python 3.11.0.) #​2708

Added

• Implemented ExactSizeIterator for PyListIterator, PyDictIterator, PySetIterator and PyFrozenSetIterator. #​2676

Fixed

• Fix regression of impl FromPyObject for [T; N] no longer accepting types passing PySequence_Check, e.g. NumPy arrays, since version 0.17.0. This the same fix that was applied impl FromPyObject for Vec<T> in version 0.17.1 extended to fixed-size arrays. #​2675
• Fix UB in FunctionDescription::extract_arguments_fastcall due to creating slices from a null pointer. #​2687

v0.17.2

Compare Source

Packaging

• Added optional chrono feature to convert chrono types into types in the datetime module. #​2612

Added

• Add support for num-bigint feature on PyPy. #​2626

Fixed

• Correctly implement __richcmp__ for enums, fixing __ne__ returning always returning True. #​2622
• Fix compile error since 0.17.0 with Option<&SomePyClass> argument with a default. #​2630
• Fix regression of impl FromPyObject for Vec<T> no longer accepting types passing PySequence_Check, e.g. NumPy arrays, since 0.17.0. #​2631

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.

[renovate]

⚠ Artifact update problem

Renovate failed to update an artifact related to this branch. You probably do not want to merge this PR as-is.

♻ Renovate will retry this branch, including artifacts, only when one of the following happens:

• any of the package files in this branch needs updating, or
• the branch becomes conflicted, or
• you click the rebase/retry checkbox if found above, or
• you rename this PR's title to start with "rebase!" to trigger it manually

The artifact failure details are included below:

File name: Cargo.lock

Command failed: cargo update --config net.git-fetch-with-cli=true --manifest-path Cargo.toml --workspace
    Updating crates.io index
error: failed to select a version for `pyo3-ffi`.
    ... required by package `pyo3 v0.21.0`
    ... which satisfies dependency `pyo3 = "^0.21.0"` of package `spatialtis_core v0.2.3 (/tmp/renovate/repos/github/Mr-Milk/SpatialTis-core)`
versions that meet the requirements `=0.21.0` are: 0.21.0

the package `pyo3-ffi` links to the native library `python`, but it conflicts with a previous package which links to `python` as well:
package `pyo3-ffi v0.17.0`
    ... which satisfies dependency `pyo3-ffi = "=0.17.0"` of package `pyo3 v0.17.0`
    ... which satisfies dependency `pyo3 = "^0.17"` of package `numpy v0.17.1`
    ... which satisfies dependency `numpy = "^0.17.1"` of package `spatialtis_core v0.2.3 (/tmp/renovate/repos/github/Mr-Milk/SpatialTis-core)`
Only one package in the dependency graph may specify the same links value. This helps ensure that only one copy of a native library is linked in the final binary. Try to adjust your dependencies so that only one package uses the `links = "python"` value. For more information, see https://doc.rust-lang.org/cargo/reference/resolver.html#links.

failed to select a version for `pyo3-ffi` which could resolve this conflict

[renovate]

⚠️ Artifact update problem

Renovate failed to update an artifact related to this branch. You probably do not want to merge this PR as-is.

♻ Renovate will retry this branch, including artifacts, only when one of the following happens:

• any of the package files in this branch needs updating, or
• the branch becomes conflicted, or
• you click the rebase/retry checkbox if found above, or
• you rename this PR's title to start with "rebase!" to trigger it manually

The artifact failure details are included below:

File name: Cargo.lock

Command failed: cargo update --config net.git-fetch-with-cli=true --manifest-path Cargo.toml --workspace
    Updating crates.io index
error: failed to select a version for `pyo3-ffi`.
    ... required by package `pyo3 v0.17.0`
    ... which satisfies dependency `pyo3 = "^0.17"` of package `numpy v0.17.1`
    ... which satisfies dependency `numpy = "^0.17.1"` of package `spatialtis_core v0.2.3 (/tmp/renovate/repos/github/Mr-Milk/SpatialTis-core)`
versions that meet the requirements `=0.17.0` are: 0.17.0

the package `pyo3-ffi` links to the native library `python`, but it conflicts with a previous package which links to `python` as well:
package `pyo3-ffi v0.22.0`
    ... which satisfies dependency `pyo3-ffi = "=0.22.0"` of package `pyo3 v0.22.0`
    ... which satisfies dependency `pyo3 = "^0.22.0"` of package `spatialtis_core v0.2.3 (/tmp/renovate/repos/github/Mr-Milk/SpatialTis-core)`
Only one package in the dependency graph may specify the same links value. This helps ensure that only one copy of a native library is linked in the final binary. Try to adjust your dependencies so that only one package uses the `links = "python"` value. For more information, see https://doc.rust-lang.org/cargo/reference/resolver.html#links.

failed to select a version for `pyo3-ffi` which could resolve this conflict