Skip to content

Commit

Permalink
Merge pull request numpy#27981 from larsoner/abi3
Browse files Browse the repository at this point in the history
DOC: Document abi3 compat
  • Loading branch information
ngoldbaum authored Dec 11, 2024
2 parents f7823da + 340543b commit c81c44a
Showing 1 changed file with 8 additions and 1 deletion.
9 changes: 8 additions & 1 deletion doc/source/dev/depending_on_numpy.rst
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,13 @@ forward but not backward compatible. This means: binaries compiled against a
given target version of NumPy's C API will still run correctly with newer NumPy
versions, but not with older versions.

Modules can also be safely built against NumPy 2.0 or later in
:ref:`CPython's abi3 mode <python:stable-abi>`, which allows
building against a single (minimum-supported) version of Python but be
forward compatible higher versions in the same series (e.g., ``3.x``).
This can greatly reduce the number of wheels that need to be built and
distributed. For more information and examples, see the
`cibuildwheel docs <https://cibuildwheel.pypa.io/en/stable/faq/#abi3>`__.

.. _testing-prereleases:

Expand Down Expand Up @@ -82,7 +89,7 @@ Build-time dependency

If a package either uses the NumPy C API directly or it uses some other tool
that depends on it like Cython or Pythran, NumPy is a *build-time* dependency
of the package.
of the package.

By default, NumPy will expose an API that is backwards compatible with the
oldest NumPy version that supports the currently oldest compatible Python
Expand Down

0 comments on commit c81c44a

Please sign in to comment.