cporting.rst 1009 Bytes
Newer Older
Benjamin Peterson's avatar
Benjamin Peterson committed
1 2
.. highlightlang:: c

3 4
.. _cporting-howto:

5 6 7
*************************************
Porting Extension Modules to Python 3
*************************************
Benjamin Peterson's avatar
Benjamin Peterson committed
8

9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26
We recommend the following resources for porting extension modules to Python 3:

* The `Migrating C extensions`_ chapter from
  *Supporting Python 3: An in-depth guide*, a book on moving from Python 2
  to Python 3 in general, guides the reader through porting an extension
  module.
* The `Porting guide`_ from the *py3c* project provides opinionated
  suggestions with supporting code.
* The `Cython`_ and `CFFI`_ libraries offer abstractions over
  Python's C API.
  Extensions generally need to be re-written to use one of them,
  but the library then handles differences between various Python
  versions and implementations.

.. _Migrating C extensions: http://python3porting.com/cextensions.html
.. _Porting guide: https://py3c.readthedocs.io/en/latest/guide.html
.. _Cython: http://cython.org/
.. _CFFI: https://cffi.readthedocs.io/en/latest/