Skip to content

docs(cc): clarify abi_tag is equivalent to SOABI and cite PEP 3149 - #3985

Merged
rickeylev merged 2 commits into
bazel-contrib:mainfrom
rickeylev:debug_python_extension_naming
Aug 2, 2026
Merged

docs(cc): clarify abi_tag is equivalent to SOABI and cite PEP 3149#3985
rickeylev merged 2 commits into
bazel-contrib:mainfrom
rickeylev:debug_python_extension_naming

Conversation

@rickeylev

@rickeylev rickeylev commented Aug 1, 2026

Copy link
Copy Markdown
Collaborator

Clarify the documentation for abi_tag in C++ Python toolchains so
that rule maintainers and users can easily map Bazel's toolchain
attributes to standard Python distribution environment variables.

Update docstrings in python/private/py_cc_toolchain_info.bzl and
python/private/py_cc_toolchain_rule.bzl to explicitly note that
abi_tag is the equivalent of the Python sysconfig variable SOABI,
accompanied by a reference citation to PEP 3149.

Also add :::{versionadded} VERSION_NEXT_FEATURE directives to all newly
introduced toolchain fields and rule attributes.

Clarify the documentation for `abi_tag` in C++ Python toolchains so that rule maintainers and users can easily map Bazel's toolchain attributes to standard Python distribution environment variables.

Update docstrings in `python/private/py_cc_toolchain_info.bzl` and `python/private/py_cc_toolchain_rule.bzl` to explicitly note that `abi_tag` is the equivalent of the Python `sysconfig` variable `SOABI`, accompanied by a reference citation to PEP 3149.
@rickeylev
rickeylev requested a review from aignas as a code owner August 1, 2026 18:45
@rickeylev
rickeylev enabled auto-merge August 1, 2026 18:45
@rickeylev
rickeylev requested a review from dougthor42 August 1, 2026 22:37
@rickeylev
rickeylev added this pull request to the merge queue Aug 2, 2026
Merged via the queue into bazel-contrib:main with commit 61955f2 Aug 2, 2026
6 checks passed
@rickeylev
rickeylev deleted the debug_python_extension_naming branch August 2, 2026 03:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants