bazel-contrib / bazel-contrib/rules_python

Cannot run native python binary script without C++ toolchain

Ouverte
#4,040 2 commentaires 0 réactions 0 personnes assignées Voir sur GitHub
Langage dominant
Starlark
Étoiles
688
Forks
721
Merge moyen
15 h 7 min
PR mergées (30 j)
76

Description

# 🐞 bug report

### Affected Rule

`py_binary`

### Is this a regression?

Not tested, unlikely.

### Description

A trivial pure-Python `py_binary` appears to require C++ toolchain resolution even though it does not produce any C++ compile or link actions.

In a minimal example, `bazel cquery //:hello_world --toolchain_resolution_debug='.*'` shows that Bazel resolves both:
- `@@bazel_tools//tools/python:toolchain_type`
- `@@bazel_tools//tools/cpp:toolchain_type`

However, `bazel aquery //:hello_world` only shows Python-related actions such as Python bytecode precompilation and bootstrap/template generation. There are no C++ compile or link actions for the target.

This is surprising for Python-only projects. In environments where no C++ toolchain is configured or available, this can cause a trivial `py_binary` to fail analysis even though the target itself does not build native code.

From a user perspective, I would expect a pure `py_binary` with no native extensions and no C/C++ deps to avoid requiring successful C++ toolchain resolution, or at least for the requirement to be documented if it is intentional.

## 🔬 Minimal Reproduction

`MODULE.bazel`
```starlark
module(
name = "bazel_hello_py",
version = "0.1.0",
)

bazel_dep(name = "rules_shell", version = "0.6.1")
bazel_dep(name = "rules_python", version = "1.7.0")
```
`BUILD.bazel`

```starlark
load("@rules_python//python:defs.bzl", "py_binary")

py_binary(
name = "hello_world",
srcs = ["hello_world.py"],
)
```

`hello_world.py`

```python
print("hello world")
```

```starlark
bazel run //:hello_world --repo_env=BAZEL_DO_NOT_DETECT_CPP_TOOLCHAIN=<0|1>
bazel cquery //:hello_world --toolchain_resolution_debug='.*'
bazel aquery //:hello_world
```

Observed behavior:

1. `bazel run //:hello_world` succeeds if the `repo_env` is set to `0` but fails on `1`
2. `cquery shows that @@bazel_tools//tools/cpp:toolchain_type` is resolved for the target.
3. `aquery` shows only Python-related actions and no C++ compile/link actions.

This suggests the C++ toolchain resolution is happening even for a pure-Python binary with no actual C++ build work.

## 🔥 Exception or Error

```bash
$ bazel run //:hello_world --repo_env=BAZEL_DO_NOT_DETECT_CPP_TOOLCHAIN=1
ERROR: .../external/bazel_tools/src/tools/launcher/BUILD:75:10: While resolving toolchains for target @@bazel_tools//src/tools/launcher:launcher_maker (04bf134): No matching toolchains found for types:
@@bazel_tools//tools/cpp:toolchain_type
To debug, rerun with --toolchain_resolution_debug='@@bazel_tools//tools/cpp:toolchain_type'
For more information on platforms or toolchains see https://bazel.build/concepts/platforms-intro.
ERROR: Analysis of target '//:hello_world' failed; build aborted: Analysis failed
INFO: Elapsed time: 0.107s, Critical Path: 0.01s
INFO: 1 process: 1 internal.
ERROR: Build did NOT complete successfully
ERROR: Build failed. Not running target
```

## 🌍 Your Environment

**Operating System:**

  

Linux (Ubuntu LTS 24.04)

**Output of `bazel version`:**

  

Bazelisk version: v1.29.0 Build label: 9.2.0 Build target: @@//src/main/java/com/google/devtools/build/lib/bazel:BazelServer Build time: Mon Jul 13 18:15:04 2026 (1783966504) Build timestamp: 1783966504 Build timestamp as int: 1783966504

**Rules_python version:**

  

1.7.0

**Anything else relevant?**

Related issues I found while searching:
rules_python #1857 discusses py_binary and C++ toolchain resolution in cross-compilation scenarios.
rules_python #2500 discusses replacing the stage1 bootstrap with a native launcher.

My main question is whether this C++ toolchain resolution for a pure py_binary is intentional.

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

Commencez par l’exemple minimal de MODULE.bazel et BUILD.bazel, puis exécutez les commandes bazel run, cquery et aquery signalées avec BAZEL_DO_NOT_DETECT_CPP_TOOLCHAIN défini à 1. Comparez les toolchains et les actions résolues afin de déterminer si un py_binary pur peut éviter la résolution de la toolchain C++ ; le travail est terminé lorsque le comportement est corrigé ou que son exigence intentionnelle est documentée.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
python
Domaine
build-system
Type d'issue
Bug
Difficulté
4/5
Temps estimé
3-5 jours
Activité
Calme
Clarté
Plutôt claire
Accessibilité débutants
50/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.