Merge branch 'main' into update-pypi-deps-docs-20260501

Author: rickeylev

.bazelignore

@@ -33,3 +33,4 @@ sphinxdocs
 tests/integration/compile_pip_requirements/bazel-compile_pip_requirements
 tests/integration/local_toolchains/bazel-local_toolchains
 tests/integration/py_cc_toolchain_registered/bazel-py_cc_toolchain_registered
+tests/integration/toolchain_target_settings/bazel-module_under_test

.bazelrc

@@ -25,6 +25,9 @@ common --incompatible_disallow_struct_provider_syntax
 # Makes Bazel 7 act more like Bazel 8
 common --incompatible_use_plus_in_repo_names
 
+# Implicitly adds --config=linux|macos|windows, depending on the host platform
+common --enable_platform_specific_config
+
 # Needed to make Windows with a py_binary in data deps work. The Bazel launcher
 # is used, which falls back to finding python.exe on PATH to bootstrap.
 # See https://github.com/bazel-contrib/rules_python/issues/3655
@@ -55,6 +58,20 @@ common --incompatible_no_implicit_file_export
 
 build --lockfile_mode=update
 
+# Silence spammy C++ compile warnings
+build:linux --copt=-Wno-deprecated-declarations
+build:linux --copt=-Wno-stringop-overread
+build:linux --copt=-Wno-sign-compare
+build:linux --host_copt=-Wno-deprecated-declarations
+build:linux --host_copt=-Wno-stringop-overread
+build:linux --host_copt=-Wno-sign-compare
+build:macos --copt=-Wno-deprecated-declarations
+build:macos --copt=-Wno-stringop-overread
+build:macos --copt=-Wno-sign-compare
+build:macos --host_copt=-Wno-deprecated-declarations
+build:macos --host_copt=-Wno-stringop-overread
+build:macos --host_copt=-Wno-sign-compare
+
 import %workspace%/specialized_configs.bazelrc
 
 try-import user.bazelrc

.bazelrc.deleted_packages

@@ -35,7 +35,9 @@ common --deleted_packages=tests/integration/custom_commands
 common --deleted_packages=tests/integration/local_toolchains
 common --deleted_packages=tests/integration/pip_parse
 common --deleted_packages=tests/integration/pip_parse/empty
+common --deleted_packages=tests/integration/pip_parse_isolated
 common --deleted_packages=tests/integration/py_cc_toolchain_registered
+common --deleted_packages=tests/integration/toolchain_target_settings
 common --deleted_packages=tests/modules/another_module
 common --deleted_packages=tests/modules/other
 common --deleted_packages=tests/modules/other/nspkg_delta

.github/CODEOWNERS

@@ -7,5 +7,5 @@
 /examples/build_file_generation/ @dougthor42 @aignas
 
 # PyPI integration related code
-/python/private/pypi/ @rickeylev @aignas @groodt
-/tests/pypi/ @rickeylev @aignas @groodt
+/python/private/pypi/ @rickeylev @aignas
+/tests/pypi/ @rickeylev @aignas

.github/workflows/release.yml

@@ -46,7 +46,7 @@ jobs:
       - name: Create release archive and notes
         run: .github/workflows/create_archive_and_notes.sh ${{ inputs.tag_name || github.ref_name }}
       - name: Release
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@v3
         with:
           # Use GH feature to populate the changelog automatically
           generate_release_notes: true

AGENTS.md

@@ -5,7 +5,7 @@ project.
 
 Act as an expert in Bazel, rules_python, Starlark, and Python.
 
-DO NOT `git commit` or `git push`.
+DO NOT `git commit` or `git push` unless given explicit permission.
 
 ## RULES TO ALWAYS FOLLOW AND NEVER IGNORE
 
@@ -30,6 +30,11 @@ into the sentence, not verbatim.
 When adding `{versionadded}` or `{versionchanged}` sections, add them add the
 end of the documentation text.
 
+### PR descriptions
+
+Follow the advice in `CONTRIBUTING.md` for PR descriptions. PR descriptions
+become the commit message upon merge.
+
 ### Starlark style
 
 For doc strings, using triple quoted strings when the doc string is more than

CHANGELOG.md

@@ -60,21 +60,38 @@ END_UNRELEASED_TEMPLATE
 ### Changed
 * (gazelle) WORKSPACE's bazel-gazelle dependency bumped from 0.36.0 to 0.47.0.
   The go version was also bumped from 1.21.13 to 1.22.9.
+* (pypi) The data files of a wheel (bin, includes, etc) are now always included
+  as a library's data dependencies.
 
 {#v0-0-0-fixed}
 ### Fixed
 * (gazelle) Fixed handling of auto-included `__init__.py` files when generating `py_binary`
   targets ([#3729](https://github.com/bazel-contrib/rules_python/issues/3729)).
+* (entry_point) From now on `mypy` type checking will be skipped on the generated
+  files ([#3126](https://github.com/bazel-contrib/rules_python/issues/3126)).
+* (pypi) Support `--experimental_isolated_extension_usages`
+  ([#3668](https://github.com/bazel-contrib/rules_python/issues/3668)).
+* (uv) use the astral.sh mirror as the preferred url for binary downloads,
+  with github.com as a fallback; for uv >= 0.11.0, read the checksums directly
+  from the dist-manifest contents.
 
 {#v0-0-0-added}
 ### Added
+* (toolchain) Added {obj}`python.override.toolchain_target_settings` to allow
+  adding `config_setting` labels to all registered toolchains.
 * (windows) Full venv support for Windows is available. Set
   {obj}`--venvs_site_packages=yes` to enable.
+* (test/binaries) When {obj}`--venv_site_packages=yes` is enabled,
+  wheel `data`, `bin`, and `include` files are populated into the venv.
 * (runfiles) Added a pathlib-compatible API: {obj}`Runfiles.root()`
   Fixes [#3296](https://github.com/bazel-contrib/rules_python/issues/3296).
+* (gazelle) Support alias_kind directive.
+  Fixes [#3183](https://github.com/bazel-contrib/rules_python/issues/3183).
 * (toolchains) `3.13.12`, `3.14.3` Python toolchain from [20260325] release.
 * (toolchains) `3.10.20`, `3.11.15`, `3.12.13`, `3.13.13` `3.14.4`, `3.15.0a8`
 * Python toolchain from [20260414] release.
+* (pypi) `package_metadata` support, fixes 
+  [#2054](https://github.com/bazel-contrib/rules_python/issues/2054).
 
 [20260325]: https://github.com/astral-sh/python-build-standalone/releases/tag/20260325
 [20260414]: https://github.com/astral-sh/python-build-standalone/releases/tag/20260414

CONTRIBUTING.md

@@ -103,7 +103,7 @@ information on using pull requests.
 
 [GitHub Help]: https://help.github.com/articles/about-pull-requests/
 
-### Commit messages
+### Commit messages and PR descriptions
 
 Commit messages (upon merging) and PR messages should follow the [Conventional
 Commits](https://www.conventionalcommits.org/) style:
@@ -139,9 +139,36 @@ Common `type`s:
 * `revert:` means a prior change is being reverted in some way.
 * `test:` means only tests are being added.
 
+For the body, follow this guidance:
+
+* Briefly tells *why* the change is being made. This usually means
+  briefly describing how a bug manifests or what can't be accomplished
+  without the feature.
+* Briefly gives an overview of *how* the code is changed. This is to
+  orient readers for the diff they're about to read and understand; it's
+  not a verbatim description of what changed.
+* List unrelated or notable dev-only changes at the end. e.g. formatting an
+  old file, cleaning up testing, adding test support code, etc.
+
 For the full details of types, see
 [Conventional Commits](https://www.conventionalcommits.org/).
 
+#### PR description example
+
+```
+fix(pypi): handle files with .exe extensions
+
+Currently, if a file with `.exe` is seen, an error
+occurs because validation assumes unix-only filenames.
+This prevents using whls with pre-built .exe files in
+their data payload.
+
+To fix, detect the target OS and use an OS-appropriate
+validation function.
+
+* Also adds test helpers for detecting the current OS
+```
+
 ### Documenting changes
 
 Changes are documented in two places: CHANGELOG.md and API docs.

MODULE.bazel

@@ -6,8 +6,9 @@ module(
 
 bazel_dep(name = "bazel_features", version = "1.21.0")
 bazel_dep(name = "bazel_skylib", version = "1.8.2")
-bazel_dep(name = "rules_cc", version = "0.1.5")
+bazel_dep(name = "package_metadata", version = "0.0.7")
 bazel_dep(name = "platforms", version = "0.0.11")
+bazel_dep(name = "rules_cc", version = "0.1.5")
 
 # Those are loaded only when using py_proto_library
 # Use py_proto_library directly from protobuf repository
@@ -64,141 +65,6 @@ register_toolchains("@pythons_hub//:all")
 # Install twine for our own runfiles wheel publishing and allow bzlmod users to use it.
 
 pip = use_extension("//python/extensions:pip.bzl", "pip")
-
-# NOTE @aignas 2025-07-06: we define these platforms to keep backwards compatibility. Whilst we
-# stabilize the API this list may be updated with a mention in the CHANGELOG.
-[
-    pip.default(
-        arch_name = cpu,
-        config_settings = [
-            "@platforms//cpu:{}".format(cpu),
-            "@platforms//os:linux",
-            "//python/config_settings:_is_py_freethreaded_{}".format(
-                "yes" if freethreaded else "no",
-            ),
-        ],
-        env = {"platform_version": "0"},
-        marker = "python_version >= '3.13'" if freethreaded else "",
-        os_name = "linux",
-        platform = "linux_{}{}".format(cpu, freethreaded),
-        whl_abi_tags = ["cp{major}{minor}t"] if freethreaded else [
-            "abi3",
-            "cp{major}{minor}",
-        ],
-        whl_platform_tags = [
-            "linux_{}".format(cpu),
-            "manylinux_*_{}".format(cpu),
-        ],
-    )
-    for cpu in [
-        "x86_64",
-        "aarch64",
-    ]
-    for freethreaded in [
-        "",
-        "_freethreaded",
-    ]
-]
-
-[
-    pip.default(
-        arch_name = cpu,
-        config_settings = [
-            "@platforms//cpu:{}".format(cpu),
-            "@platforms//os:osx",
-            "//python/config_settings:_is_py_freethreaded_{}".format(
-                "yes" if freethreaded else "no",
-            ),
-        ],
-        # We choose the oldest non-EOL version at the time when we release `rules_python`.
-        # See https://endoflife.date/macos
-        env = {"platform_version": "14.0"},
-        marker = "python_version >= '3.13'" if freethreaded else "",
-        os_name = "osx",
-        platform = "osx_{}{}".format(cpu, freethreaded),
-        whl_abi_tags = ["cp{major}{minor}t"] if freethreaded else [
-            "abi3",
-            "cp{major}{minor}",
-        ],
-        whl_platform_tags = [
-            "macosx_*_{}".format(suffix)
-            for suffix in platform_tag_cpus
-        ],
-    )
-    for cpu, platform_tag_cpus in {
-        "aarch64": [
-            "universal2",
-            "arm64",
-        ],
-        "x86_64": [
-            "universal2",
-            "x86_64",
-        ],
-    }.items()
-    for freethreaded in [
-        "",
-        "_freethreaded",
-    ]
-]
-
-[
-    pip.default(
-        arch_name = cpu,
-        config_settings = [
-            "@platforms//cpu:{}".format(cpu),
-            "@platforms//os:windows",
-            "//python/config_settings:_is_py_freethreaded_{}".format(
-                "yes" if freethreaded else "no",
-            ),
-        ],
-        env = {"platform_version": "0"},
-        marker = "python_version >= '3.13'" if freethreaded else "",
-        os_name = "windows",
-        platform = "windows_{}{}".format(cpu, freethreaded),
-        whl_abi_tags = ["cp{major}{minor}t"] if freethreaded else [
-            "abi3",
-            "cp{major}{minor}",
-        ],
-        whl_platform_tags = whl_platform_tags,
-    )
-    for cpu, whl_platform_tags in {
-        "x86_64": ["win_amd64"],
-    }.items()
-    for freethreaded in [
-        "",
-        "_freethreaded",
-    ]
-]
-
-[
-    pip.default(
-        arch_name = cpu,
-        config_settings = [
-            "@platforms//cpu:{}".format(cpu),
-            "@platforms//os:windows",
-            "//python/config_settings:_is_py_freethreaded_{}".format(
-                "yes" if freethreaded else "no",
-            ),
-        ],
-        env = {"platform_version": "0"},
-        marker = "python_version >= '3.13'" if freethreaded else "python_version >= '3.11'",
-        os_name = "windows",
-        platform = "windows_{}{}".format(cpu, freethreaded),
-        whl_abi_tags = ["cp{major}{minor}t"] if freethreaded else [
-            "abi3",
-            "cp{major}{minor}",
-        ],
-        whl_platform_tags = whl_platform_tags,
-    )
-    for cpu, whl_platform_tags in {
-        "aarch64": ["win_arm64"],
-    }.items()
-    for freethreaded in [
-        "",
-        "_freethreaded",
-    ]
-]
-
 pip.parse(
     hub_name = "rules_python_publish_deps",
     python_version = "3.11",
@@ -246,6 +112,8 @@ use_repo(
     "somepkg_with_build_files",
     "whl_library_extras_direct_dep",
     "whl_with_build_files",
+    "whl_with_data1",
+    "whl_with_data2",
 )
 
 dev_rules_python_config = use_extension(

docs/environment-variables.md

@@ -52,32 +52,6 @@ When `1`, `rules_python` will warn users about deprecated functionality that wil
 be removed in a subsequent major `rules_python` version. Defaults to `0` if unset.
 :::
 
-::::{envvar} RULES_PYTHON_ENABLE_PYSTAR
-
-When `1`, the `rules_python` Starlark implementation of the core rules is used
-instead of the Bazel-builtin rules. Note that this requires Bazel 7+. Defaults
-to `1`.
-
-:::{versionadded} 0.26.0
-Defaults to `0` if unspecified.
-:::
-:::{versionchanged} 0.40.0
-The default became `1` if unspecified
-:::
-::::
-
-::::{envvar} RULES_PYTHON_ENABLE_PIPSTAR
-
-When `1`, the `rules_python` Starlark implementation of the PyPI/pip integration is used
-instead of the legacy Python scripts.
-
-:::{versionadded} 1.5.0
-:::
-:::{versionchanged} 1.7.0
-Flipped to be enabled by default.
-:::
-::::
-
 ::::{envvar} RULES_PYTHON_EXTRACT_ROOT
 
 Directory to use as the root for creating files necessary for bootstrapping so
@@ -174,3 +148,14 @@ os, arch values are the same as the ones mentioned in the
 
 When `1`, debug information about coverage behavior is printed to stderr.
 :::
+
+## Removed Environment Variables
+
+:::{versionremoved} VERSION_NEXT_FEATURE
+The following environment variables were removed:
+
+* `RULES_PYTHON_ENABLE_PYSTAR`: Used to enable the Starlark implementation of
+  core rules.
+* `RULES_PYTHON_ENABLE_PIPSTAR`: Used to enable the Starlark implementation of
+  PyPI integration.
+:::