Google Jsonnet 项目中的 Python Bazel 规则迁移指南

在 Google Jsonnet 项目中，随着 Bazel 8.0.0 版本的发布，Python 相关的构建规则如 py_runtime 和 py_runtime_pair 已经从 Bazel 核心功能中移除。这一变化要求项目开发者需要将这些规则从 rules_python 仓库中导入，而不是继续依赖 Bazel 内置的支持。

背景与变化

Bazel 8.0.0 版本对 Python 支持进行了重构，将 Python 相关的构建规则从核心功能中剥离出来，转移到了独立的 rules_python 仓库。这一变化是 Bazel 模块化战略的一部分，旨在减少核心功能的体积，同时提高特定语言支持的灵活性和可维护性。

对于 Jsonnet 项目来说，这意味着需要更新构建配置，以显式地依赖 rules_python 仓库来获取 Python 构建支持。虽然 Bazel 8.0.0 仍然提供了临时兼容性支持，可以通过标志启用这些规则，但这种支持将在下一个主要版本中被完全移除。

解决方案

项目可以采用两种主要方式来解决这个问题：

方案一：直接导入 rules_python

开发者可以直接从 rules_python 仓库导入所需的 Python 构建规则。这种方式保持了与之前相似的构建逻辑，只是改变了规则的来源。

方案二：使用 Hermetic 工具链

更现代的解决方案是使用 rules_python 提供的 hermetic 工具链功能。这种方法提供了更好的隔离性和可重复性，是 Bazel 生态推荐的 Python 构建方式。

配置示例需要在 MODULE.bazel 文件中声明对 rules_python 的依赖，并设置相应的 Python 版本工具链。同时，需要更新 BUILD 文件中的依赖关系，将原来的 Python 头文件依赖替换为 rules_python 提供的当前 Python 头文件。

实施建议

对于 Jsonnet 项目，采用 hermetic 工具链方案更为推荐，因为它：

1. 提供了更好的构建隔离性
2. 简化了 Python 版本管理
3. 符合 Bazel 的最佳实践
4. 可以移除项目中原有的平台定义文件和 Python 仓库构建定义

实施这一变更后，项目将获得更稳定和可维护的 Python 构建支持，同时也为未来的 Bazel 版本升级做好了准备。

总结

Bazel 8.0.0 对 Python 支持的改变是构建系统演进的一部分，虽然需要项目进行一些调整，但最终会带来更好的模块化和可维护性。Jsonnet 项目团队应当优先考虑采用 hermetic 工具链方案，这不仅解决了当前的问题，也为项目的长期健康发展奠定了基础。