Skip to content

Commit 0fb754e

Browse files
ApproximateIdentityncoghlan
authored andcommitted
Add external links to extension module guide (pypa#446)
This commit adds links to a series of articles hosted at thomasnyberg.com describing how cpython loads extension modules in more detail. It includes these as part of a new "Additional Resources" section, so we can readily accommodate other useful links as well.
1 parent bc9b536 commit 0fb754e

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

source/guides/packaging-binary-extensions.rst

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -295,3 +295,23 @@ For interim guidance on this topic, see the discussion in
295295
mention the fact that Linux distros have a requirement to build from
296296
source in their own build systems, so binary-only releases are strongly
297297
discouraged
298+
299+
300+
Additional Resources
301+
====================
302+
303+
Cross-platform development and distribution of extension modules is a complex topic,
304+
so this guide focuses primarily on providing pointers to various tools that automate
305+
dealing with the underlying technical challenges. The additional resources in this
306+
section are instead intended for developers looking to understand more about the
307+
underlying binary interfaces that those systems rely on at runtime.
308+
309+
Introduction to C/C++ extension modules
310+
---------------------------------------
311+
312+
For a more in depth explanation of how extension modules are used by CPython on
313+
a Debian system, see the following articles:
314+
315+
* `What are (c)python extension modules? <https://thomasnyberg.com/what_are_extension_modules.html>`_
316+
* `Releasing the gil <https://thomasnyberg.com/releasing_the_gil.html>`_
317+
* `Writing cpython extension modules using C++ <https://thomasnyberg.com/cpp_extension_modules.html>`_

0 commit comments

Comments
 (0)