Skip to content

Commit 6ea32ea

Browse files
authoredJan 28, 2025··
Update README.md (#510)
1 parent 7d6423c commit 6ea32ea

File tree

1 file changed

+10
-5
lines changed

1 file changed

+10
-5
lines changed
 

‎README.md

+10-5
Original file line numberDiff line numberDiff line change
@@ -16,20 +16,25 @@ However we try to maintain compatibility with rules_python's rules for most use
1616
| gazelle: generate BUILD files | rules_python | [`aspect configure`] |
1717
| rules: user-facing implementations | rules_python | **rules_py** |
1818

19-
Watch our video series for a quick tutorial on how rules_py makes it easy to do Python with Bazel:
20-
[![youtube playlist](https://i.ytimg.com/vi/Ms9qX0Yyn0s/hqdefault.jpg)](https://www.youtube.com/playlist?list=PLLU28e_DRwdu46fldnYzyFYvSJLjVFICd)
19+
[`aspect configure`]: https://docs.aspect.build/cli/commands/aspect_configure
2120

22-
_Need help?_ This ruleset has support provided by https://aspect.dev.
21+
## Learn about it
2322

24-
[`aspect configure`]: https://docs.aspect.build/cli/commands/aspect_configure
23+
Aspect provides a Bazel training course based on rules_py: [Bazel 102: Python](https://training.aspect.build/bazel-102)
24+
25+
Watch Alex's talk from Monorepo World for a quick demo on how rules_py makes it easy to do Python with Bazel:
26+
27+
[![Python Monorepo World](https://img.youtube.com/vi/en3ep4rw0oA/0.jpg)](https://www.youtube.com/watch?v=en3ep4rw0oA)
28+
29+
_Need help?_ This ruleset has support provided by https://aspect.dev.
2530

2631
## Differences
2732

2833
We think you'll love rules_py because it fixes many issues with rules_python's rule implementations:
2934

3035
- The launcher uses the Bash toolchain rather than Python, so we have no dependency on a system interpreter. Fixes:
3136
- [py_binary with hermetic toolchain requires a system interpreter](https://github.com/bazelbuild/rules_python/issues/691)
32-
- We don't mess with the Python `sys.path`/`$PYTHONPATH`. Instead we use the standard `site-packages` folder layout produced by `pip_install`. This avoids problems like package naming collisions with built-ins (e.g. `collections`) or where `argparse` comes from a transitive dependency instead. Fixes:
37+
- We don't mess with the Python `sys.path`/`$PYTHONPATH`. Instead we use the standard `site-packages` folder layout produced by `uv pip install`. This avoids problems like package naming collisions with built-ins (e.g. `collections`) or where `argparse` comes from a transitive dependency instead. Fixes:
3338
- [Issues with PYTHONPATH resolution in recent python/rules_python versions](https://github.com/bazelbuild/rules_python/issues/1221)
3439
- We run python in isolated mode so we don't accidentally break out of Bazel's action sandbox. Fixes:
3540
- [pypi libraries installed to system python are implicitly available to builds](https://github.com/bazelbuild/rules_python/issues/27)

0 commit comments

Comments
 (0)
Please sign in to comment.