starlark_doc_extract: document repository rules and module extensions

We introduce new message types in the proto for repository rules and for
module extensions. Note that this is a behavioral change compared to the
legacy Stardoc extractor, which extracted repository rule docs using RuleInfo
messages (i.e. same as ordinary rules) - which was very likely to lead to
reader confusion.

ModuleExtensionInfo messages for now get an OriginKey field without the original
name because ModuleExtension objects are not StarlarkExportable values, so
finding the name under which a ModuleExtension was originally defined means
searching through its defining module's globals (assuming it is in globals - it
may not be). This will be added as a follow-up, but is low priority (due to the
lower probability of name collisions for module extensions as compared to e.g.
providers and rules) and should not block the ability to document module
extensions in the first place.

PiperOrigin-RevId: 547496231
Change-Id: I1ecb7f9b8bf2b7be78e565cb03a57d7227cda58f
12 files changed
tree: 084c96ca27310faeb5242a023e59cd85a06f3c4e
  1. .bazelci/
  2. .github/
  3. examples/
  4. scripts/
  5. site/
  6. src/
  7. third_party/
  8. tools/
  9. .bazelrc
  10. .bazelversion
  11. .gitattributes
  12. .gitignore
  13. AUTHORS
  14. BUILD
  15. CHANGELOG.md
  16. CODE_OF_CONDUCT.md
  17. CODEOWNERS
  18. combine_distfiles.py
  19. combine_distfiles_to_tar.sh
  20. compile.sh
  21. CONTRIBUTING.md
  22. CONTRIBUTORS
  23. distdir.bzl
  24. distdir_deps.bzl
  25. extensions.bzl
  26. LICENSE
  27. maven_install.json
  28. MODULE.bazel
  29. README.md
  30. repositories.bzl
  31. SECURITY.md
  32. WORKSPACE
  33. WORKSPACE.bzlmod
README.md

Bazel

{Fast, Correct} - Choose two

Build and test software of any size, quickly and reliably.

  • Speed up your builds and tests: Bazel rebuilds only what is necessary. With advanced local and distributed caching, optimized dependency analysis and parallel execution, you get fast and incremental builds.

  • One tool, multiple languages: Build and test Java, C++, Android, iOS, Go, and a wide variety of other language platforms. Bazel runs on Windows, macOS, and Linux.

  • Scalable: Bazel helps you scale your organization, codebase, and continuous integration solution. It handles codebases of any size, in multiple repositories or a huge monorepo.

  • Extensible to your needs: Easily add support for new languages and platforms with Bazel's familiar extension language. Share and re-use language rules written by the growing Bazel community.

Getting Started

Documentation

Reporting a Vulnerability

To report a security issue, please email security@bazel.build with a description of the issue, the steps you took to create the issue, affected versions, and, if known, mitigations for the issue. Our vulnerability management team will respond within 3 working days of your email. If the issue is confirmed as a vulnerability, we will open a Security Advisory. This project follows a 90 day disclosure timeline.

Contributing to Bazel

See CONTRIBUTING.md

Build status