build: Starlarkify python flags

[mai93]

Add starlark flags for --python_path, --build_python_zip and --incompatible_default_to_explicit_init_py.

• The transitions logic is updated to set both the native and starlark versions of the flags to allow alternating between them until the native ones are removed.
• --build_python_zip is changed to boolean instead of Tristate with default value set to True on windows and False otherwise.
• scope = universal attribute is added to the starlark flags so they can be propagated to exec config on Bazel 9. This required upgrading bazel_skylib version to have scope attribute defined.

Work towards: #3252

cc @gregestren

[dougthor42]

One gazelle-specific comment, otherwise the Gazelle stuff LGTM.

I'll leave final approval to Richard or Aignas

[aignas]

Could you please add a note in Changes section of the changelog to note that bazel_skylib has been upgraded to 1.8.2? See the previous mentions for bazel_skylib for an example.

[rickeylev]

impl mostly looks good, though the logic for checking python_path i'm not sure of. Various nits about project-local styles.

[rickeylev]

@gemini-code-assist /review

[gemini-code-assist]

Code Review

This pull request continues the effort to migrate native Python flags to Starlark flags, which is a great improvement for the maintainability and future-proofing of rules_python. The changes introduce Starlark flags for --python_path, --build_python_zip, and --incompatible_default_to_explicit_init_py, and correctly update the transition logic to support both native and Starlark versions during the migration period. The upgrade of bazel_skylib to support the scope = universal attribute is also a necessary and well-executed change.

The implementation is solid and covers all the required aspects, including updating tests and examples. I have a couple of minor suggestions to improve the usability of the new flags by adding help text and making an error message more descriptive. Overall, this is a high-quality contribution.

[BryceBeagle]

Just commenting for other readers since I encountered this while upgrading rules_python to 1.7.0:

This change means rules_python now requires bazel-skylib>=1.8.0 which introduced scope in bazelbuild/bazel-skylib#546

If you're using an older version of skylib you will get:

❯ bzl build //domains/assistant/apps/apis/assistant_api/internal/...

ERROR: /private/var/tmp/.../external/rules_python/python/config_settings/BUILD.bazel:245:10: @@rules_python//python/config_settings:experimental_python_import_all_repositories: no such attribute 'scope' in 'bool_flag' rule
ERROR: /private/var/tmp/.../external/rules_python/python/config_settings/BUILD.bazel:252:10: @@rules_python//python/config_settings:build_python_zip: no such attribute 'scope' in 'bool_flag' rule
ERROR: /private/var/tmp/.../external/rules_python/python/config_settings/BUILD.bazel:260:10: @@rules_python//python/config_settings:incompatible_default_to_explicit_init_py: no such attribute 'scope' in 'bool_flag' rule
ERROR: /private/var/tmp/.../external/rules_python/python/config_settings/BILD.bazel:267:12: @@rules_python//python/config_settings:python_path: no such attribute 'scope' in 'string_flag' rule
WARNING: Target pattern parsing failed.
ERROR: Skipping '@rules_python//python/config_settings:bootstrap_impl': Error evaluating '@rules_python//python/config_settings:bootstrap_impl': error loading package '@@rules_python//python/config_settings': Package 'python/config_settings' contains errors
ERROR: @rules_python//python/config_settings:bootstrap_impl :: Error loading option @rules_python//python/config_settings:bootstrap_impl: Error evaluating '@rules_python//python/config_settings:bootstrap_impl': error loading package '@@rules_python//python/config_settings': Package 'python/config_settings' contains errors