Merge pull request #2295 from davidhewitt/base-datetimes

ffi: add BaseDateTime and BaseTime definitions

CHANGELOG.md

@@ -11,6 +11,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - Add an experimental `generate-abi3-import-lib` feature to auto-generate `python3.dll` import libraries for Windows. [#2282](https://github.com/PyO3/pyo3/pull/2282)
+- Add FFI definitions for `PyDateTime_BaseTime` and `PyDateTime_BaseDateTime`. [#2294](https://github.com/PyO3/pyo3/pull/2294)
 
 ### Changed
 

pyo3-ffi/src/datetime.rs

@@ -38,11 +38,29 @@ pub struct PyDateTime_Delta {
 
 // skipped non-limited PyDateTime_TZInfo
 // skipped non-limited _PyDateTime_BaseTZInfo
-// skipped non-limited _PyDateTime_BaseTime
+
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+/// Structure representing a `datetime.time` without a `tzinfo` member.
+pub struct PyDateTime_BaseTime {
+    pub ob_base: PyObject,
+    #[cfg(not(PyPy))]
+    pub hashcode: Py_hash_t,
+    pub hastzinfo: c_char,
+    #[cfg(not(PyPy))]
+    pub data: [c_uchar; _PyDateTime_TIME_DATASIZE],
+    #[cfg(not(PyPy))]
+    pub fold: c_uchar,
+}
 
 #[repr(C)]
 #[derive(Debug, Copy, Clone)]
 /// Structure representing a `datetime.time`.
+///
+/// # Safety
+///
+/// Care should be taken when reading the `tzinfo` field of this type. If the time does not have a
+/// tzinfo then the Python interpreter is free to allocate it as a [PyDateTime_BaseTime].
 pub struct PyDateTime_Time {
     pub ob_base: PyObject,
     #[cfg(not(PyPy))]
@@ -66,11 +84,28 @@ pub struct PyDateTime_Date {
     pub data: [c_uchar; _PyDateTime_DATE_DATASIZE],
 }
 
-// skipped non-limited _PyDateTime_BaseDateTime
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+/// Structure representing a `datetime.datetime` without a `tzinfo` member.
+pub struct PyDateTime_BaseDateTime {
+    pub ob_base: PyObject,
+    #[cfg(not(PyPy))]
+    pub hashcode: Py_hash_t,
+    pub hastzinfo: c_char,
+    #[cfg(not(PyPy))]
+    pub data: [c_uchar; _PyDateTime_DATETIME_DATASIZE],
+    #[cfg(not(PyPy))]
+    pub fold: c_uchar,
+}
 
 #[repr(C)]
 #[derive(Debug, Copy, Clone)]
-/// Structure representing a `datetime.datetime`
+/// Structure representing a `datetime.datetime`.
+///
+/// # Safety
+///
+/// Care should be taken when reading the `tzinfo` field of this type. If the datetime does not have a
+/// tzinfo then the Python interpreter is free to allocate it as a [PyDateTime_BaseDateTime].
 pub struct PyDateTime_DateTime {
     pub ob_base: PyObject,
     #[cfg(not(PyPy))]