feat(toolchains): ABI3 Python headers target (#3274) Until now, we silently link extensions with both stable and unstable ABI libs, with the latter taking precedence in symbol resolution, because it appears first in the linker command AND, crucially, contains all CPython symbols present in the stable ABI library, thus overriding them. This has the effect that stable ABI extensions on Windows are usable only with the Python distribution that they were built on. To fix, a separate ABI3 header target is introduced, and should be used for C++ extensions on Windows if stable ABI builds are requested. Idea as formulated by `@dgrunwald-qt` in https://github.com/nicholasjng/nanobind-bazel/issues/72#issuecomment-3249959583. This is motivated by https://github.com/nicholasjng/nanobind-bazel/issues/72. This change shifts stable ABI selection on Windows to the extension developer, where it has arguably always been (they had to set the `Py_LIMITED_API` macro). An upside of this approach is that with a separate target, the question "stable ABI or not" can be decided on an extension-by-extension basis, giving maximum flexibility to developers. This should not influence the wheel platform target, because a wheel is marked ABI3 if and only if all of its extensions are marked as ABI3. --------- Co-authored-by: Richard Levasseur <rlevasseur@google.com> Co-authored-by: Richard Levasseur <richardlev@gmail.com>
This repository is the home of the core Python rules -- py_library, py_binary, py_test, py_proto_library, and related symbols that provide the basis for Python support in Bazel. It also contains package installation rules for integrating with PyPI and other indices.
Documentation for rules_python is at https://rules-python.readthedocs.io and in the Bazel Build Encyclopedia.
Examples live in the examples directory.
The core rules are stable. Their implementation is subject to Bazel's backward compatibility policy. This repository aims to follow semantic versioning.
The Bazel community maintains this repository. Neither Google nor the Bazel team provides support for the code. However, this repository is part of the test suite used to vet new Bazel releases. See How to contribute page for information on our development workflow.
For detailed documentation, see https://rules-python.readthedocs.io
See Bzlmod support for more details.