search

bazel-contrib / SIG-rules-authors

Governance and admin for the rules authors Special Interest Group
https://bazel-contrib.github.io/SIG-rules-authors/
Apache License 2.0
28 stars 12 forks source link

Write a Tutorial for Python and Bazel #64

Open chrislovecnm opened 1 year ago

chrislovecnm commented 1 year ago

Write a tutorial for https://github.com/bazelbuild/rules_python. We can base the tutorial on demo code in the rules_python repository.

@cgrindel please assign this to me.

chrislovecnm commented 1 year ago

Also, should we use https://bazel.build/build/bzlmod in the demo? We had a question on the call: "What are you doing for bazel 6?" And I know that bzlmod is one of the key differences"

cgrindel commented 1 year ago

Great question. I don't have a good sense for how long it will take folks to transition to bzlmod. My initial thought is that we should write the tutorial to use 5.3.1. All of the tutorials will need to be updated at some point to support Bazel 6.0.

alexeagle commented 9 months ago

Bazel 7 will have bzlmod enabled by default, so if the SIG wants to fund this work, I think it's the right time now. Also @rickeylev indicated in an email to me that the rules_python bzlmod API surface is "stable enough" to rely on it for example code outside the repo that would accompany a tutorial.

Even though we put the content for the Go tutorial on the SIG GHPages site, we never added any further content like this. I think https://bazel.build/start is probably the better place for the content to live, assuming we have a Googler committed to help review and land the commits.

If so, then https://github.com/bazelbuild/examples is probably the repository where any code samples for the tutorial ought to go, as that's where the other language tutorials on https://bazel.build/start point.

chrislovecnm commented 9 months ago

@alexeagle happy to start on this. We need to update the Golang example as well.

alexeagle commented 9 months ago

For Go see https://github.com/bazelbuild/rules_go/issues/3717