summaryrefslogtreecommitdiff
path: root/doc/source/user
diff options
context:
space:
mode:
authorjoaopfg <jfontesgoncalves@gmail.com>2022-07-07 23:06:43 +0200
committerjoaopfg <jfontesgoncalves@gmail.com>2022-07-07 23:06:43 +0200
commitc94e84162a996d11415ce1a7add0d5e700ff9c6f (patch)
tree104afca60b0c1e26a251c5c108d5d716d513775a /doc/source/user
parent43b666c9296b24bc072f13e43dd2c605b6e659d2 (diff)
downloadnumpy-c94e84162a996d11415ce1a7add0d5e700ff9c6f.tar.gz
Adding docs about the C-API incompatibility error and pointing to the docs in the error
Diffstat (limited to 'doc/source/user')
-rw-r--r--doc/source/user/troubleshooting-importerror.rst18
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/source/user/troubleshooting-importerror.rst b/doc/source/user/troubleshooting-importerror.rst
index 1f99491a1..7809ae386 100644
--- a/doc/source/user/troubleshooting-importerror.rst
+++ b/doc/source/user/troubleshooting-importerror.rst
@@ -146,3 +146,21 @@ following in python::
This may mainly help you if you are not running the python and/or NumPy
version you are expecting to run.
+
+
+C-API incompatibility
+---------------------------
+
+If you see this error you may have:
+
+* A bad extension "wheel" (binary install) that should use `oldest-support-numpy <https://pypi.org/project/oldest-supported-numpy/>`_ (with manual constraints if necessary) to build their binary packages.
+* An environment issue messing with package versions, or incompatible package versions somehow enforced manually.
+* An extension module compiled locally against a very recent version followed by a NumPy downgrade or a compiled extension copied to a different computer with an older NumPy version.
+
+The best thing to do if you see this error is to contact the maintainers of the package that is causing problem so that they can solve the problem properly.
+
+However, while you wait for a solution, a work around that usually works is to upgrade the NumPy version:
+
+
+ pip install numpy --upgrade
+