Skip to content

Commit 7599841

Browse files
committed
Add tips+tricks entry for ABI3 building
1 parent 46702f5 commit 7599841

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

docs/faq.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -103,6 +103,12 @@ Linux), and the other architectures are emulated automatically.
103103
{% include "../examples/github-with-qemu.yml" %}
104104
```
105105

106+
### Building CPython ABI3 wheels (Limited API) {: #abi3}
107+
108+
The CPython Limited API is a subset of the Python C Extension API that's declared to be forward-compatible, meaning you can compile wheels for one version of Python, and they'll be compatible with future versions. Wheels that use the Limited API are known as ABI3 wheels.
109+
110+
To create a package that builds ABI3 wheels, you'll need to configure your build backend to compile libraries correctly create wheels with the right tags. [Check this repo](https://github.com/joerick/python-abi3-package-sample) for an example of how to do this with setuptools.
111+
106112
### Building packages with optional C extensions
107113

108114
`cibuildwheel` defines the environment variable `CIBUILDWHEEL` to the value `1` allowing projects for which the C extension is optional to make it mandatory when building wheels.

0 commit comments

Comments
 (0)