STY: Include Python.h explicitly and add comments explaining why it's there.

DWesl · DWesl · commit 79ab7673af83 · 2025-06-27T19:29:33.000-04:00
diff --git a/numpy/_core/src/common/blas_utils.c b/numpy/_core/src/common/blas_utils.c
@@ -1,3 +1,8 @@
+/* Any file that includes Python.h must include it before any other files */
+/* https://docs.python.org/3/extending/extending.html#a-simple-example */
+/* npy_common.h includes Python.h so it also counts in this list */
+#include <Python.h>
+
 #include "numpy/numpyconfig.h"  // NPY_VISIBILITY_HIDDEN
 #include "numpy/npy_math.h"     // npy_get_floatstatus_barrier
 #include "blas_utils.h"
diff --git a/numpy/_core/src/common/blas_utils.h b/numpy/_core/src/common/blas_utils.h
@@ -1,3 +1,8 @@
+/* Any file that includes Python.h must include it before any other files */
+/* https://docs.python.org/3/extending/extending.html#a-simple-example */
+/* npy_common.h includes Python.h so it also counts in this list */
+#include <Python.h>
+
 #include "numpy/numpyconfig.h" // for NPY_VISIBILITY_HIDDEN
 
 #include <stdbool.h>
