Skip to content

Commit f89babb

Browse files
committed
Added a note about there being no guarantee of stability of the Python C ABI between Python versions and how this can cause trouble with CFFI.
1 parent 3970e71 commit f89babb

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

cffi/Readme.md

+10
Original file line numberDiff line numberDiff line change
@@ -18,3 +18,13 @@ Compare the results of a pure Python implementation to that of the CFFI wrapper
1818
* fibonacci.h/.c
1919
* CFFI "wrapper" (there is no wrapper code, its all inline Python)
2020
* test_cffi.py
21+
22+
23+
## Troubleshooting
24+
The ABI of the C API is generally not stable and may change between versions of Python. This can
25+
cause code which used to work to break when you upgrade either your version of Python or CFFI.
26+
27+
If you get a Python traceback from an exception that contains something like "ImportError: dlopen",
28+
then you may have a mismatch between your version of Python and your version of CFFI. Try upgrading
29+
one or both. The **conda** package manager which ships with the Anaconda Python distro is convenient
30+
for this.

0 commit comments

Comments
 (0)