Add types for built-in singletons

None, Ellipsis, and NotImplemented

src/conversion.rs

@@ -263,19 +263,6 @@ where
  }
 }
 
-/// `()` is converted to Python `None`.
-impl ToPyObject for () {
- fn to_object(&self, py: Python<'_>) -> PyObject {
- py.None()
- }
-}
-
-impl IntoPy<PyObject> for () {
- fn into_py(self, py: Python<'_>) -> PyObject {
- py.None()
- }
-}
-
 impl<T> IntoPy<PyObject> for &'_ T
 where
  T: AsPyPointer,

src/marker.rs

@@ -118,7 +118,9 @@
 use crate::err::{self, PyDowncastError, PyErr, PyResult};
 use crate::gil::{GILGuard, GILPool, SuspendGIL};
 use crate::impl_::not_send::NotSend;
-use crate::types::{PyAny, PyDict, PyModule, PyString, PyType};
+use crate::types::{
+ PyAny, PyDict, PyEllipsis, PyModule, PyNone, PyNotImplemented, PyString, PyType,
+};
 use crate::version::PythonVersionInfo;
 use crate::{ffi, FromPyPointer, IntoPy, Py, PyNativeType, PyObject, PyTryFrom, PyTypeInfo};
 use std::ffi::{CStr, CString};
@@ -690,21 +692,21 @@ impl<'py> Python<'py> {
  #[allow(non_snake_case)] // the Python keyword starts with uppercase
  #[inline]
  pub fn None(self) -> PyObject {
- unsafe { PyObject::from_borrowed_ptr(self, ffi::Py_None()) }
+ PyNone::get(self).into()
  }
 
  /// Gets the Python builtin value `Ellipsis`, or `...`.
  #[allow(non_snake_case)] // the Python keyword starts with uppercase
  #[inline]
  pub fn Ellipsis(self) -> PyObject {
- unsafe { PyObject::from_borrowed_ptr(self, ffi::Py_Ellipsis()) }
+ PyEllipsis::get(self).into()
  }
 
  /// Gets the Python builtin value `NotImplemented`.
  #[allow(non_snake_case)] // the Python keyword starts with uppercase
  #[inline]
  pub fn NotImplemented(self) -> PyObject {
- unsafe { PyObject::from_borrowed_ptr(self, ffi::Py_NotImplemented()) }
+ PyNotImplemented::get(self).into()
  }
 
  /// Gets the running Python interpreter version as a string.

src/types/ellipsis.rs

@@ -0,0 +1,19 @@
+use crate::{ffi, PyAny, Python};
+
+/// Represents the Python `Ellipsis` object.
+#[repr(transparent)]
+pub struct PyEllipsis(PyAny);
+
+pyobject_native_type!(
+ PyEllipsis,
+ ffi::PyObject,
+ pyobject_native_static_type_object!(ffi::PyEllipsis_Type)
+);
+
+impl PyEllipsis {
+ /// Returns the `Ellipsis` object.
+ #[inline]
+ pub fn get(py: Python<'_>) -> &PyEllipsis {
+ unsafe { py.from_borrowed_ptr(ffi::Py_Ellipsis()) }
+ }
+}

src/types/mod.rs

@@ -16,6 +16,7 @@ pub use self::datetime::{
 pub use self::dict::{IntoPyDict, PyDict};
 #[cfg(not(PyPy))]
 pub use self::dict::{PyDictItems, PyDictKeys, PyDictValues};
+pub use self::ellipsis::PyEllipsis;
 pub use self::floatob::PyFloat;
 #[cfg(all(not(Py_LIMITED_API), not(PyPy)))]
 pub use self::frame::PyFrame;
@@ -27,6 +28,8 @@ pub use self::iterator::PyIterator;
 pub use self::list::PyList;
 pub use self::mapping::PyMapping;
 pub use self::module::PyModule;
+pub use self::none::PyNone;
+pub use self::notimplemented::PyNotImplemented;
 pub use self::num::PyLong;
 pub use self::num::PyLong as PyInt;
 #[cfg(not(PyPy))]
@@ -278,6 +281,7 @@ mod complex;
 #[cfg(not(Py_LIMITED_API))]
 mod datetime;
 mod dict;
+mod ellipsis;
 mod floatob;
 #[cfg(all(not(Py_LIMITED_API), not(PyPy)))]
 mod frame;
@@ -287,6 +291,8 @@ mod iterator;
 pub(crate) mod list;
 mod mapping;
 mod module;
+mod none;
+mod notimplemented;
 mod num;
 #[cfg(not(PyPy))]
 mod pysuper;

src/types/none.rs

@@ -0,0 +1,33 @@
+use crate::{ffi, IntoPy, PyAny, PyObject, Python, ToPyObject};
+
+/// Represents the Python `None` object.
+#[repr(transparent)]
+pub struct PyNone(PyAny);
+
+pyobject_native_type!(
+ PyNone,
+ ffi::PyObject,
+ pyobject_native_static_type_object!(ffi::_PyNone_Type)
+);
+
+impl PyNone {
+ /// Returns the `None` object.
+ #[inline]
+ pub fn get(py: Python<'_>) -> &PyNone {
+ unsafe { py.from_borrowed_ptr(ffi::Py_None()) }
+ }
+}
+
+/// `()` is converted to Python `None`.
+impl ToPyObject for () {
+ fn to_object(&self, py: Python<'_>) -> PyObject {
+ PyNone::get(py).into()
+ }
+}
+
+impl IntoPy<PyObject> for () {
+ #[inline]
+ fn into_py(self, py: Python<'_>) -> PyObject {
+ PyNone::get(py).into()
+ }
+}

src/types/notimplemented.rs

@@ -0,0 +1,19 @@
+use crate::{ffi, PyAny, Python};
+
+/// Represents the Python `NotImplemented` object.
+#[repr(transparent)]
+pub struct PyNotImplemented(PyAny);
+
+pyobject_native_type!(
+ PyNotImplemented,
+ ffi::PyObject,
+ pyobject_native_static_type_object!(ffi::_PyNotImplemented_Type)
+);
+
+impl PyNotImplemented {
+ /// Returns the `NotImplemented` object.
+ #[inline]
+ pub fn get(py: Python<'_>) -> &PyNotImplemented {
+ unsafe { py.from_borrowed_ptr(ffi::Py_NotImplemented()) }
+ }
+}