Google Git
Sign in
android / platform / external / bazelbuild-rules-proto / refs/heads/main
commitedb8085c816c2465361d50f3e378f10123432e9d[log] [tgz]
authorUlises Mendez Martinez <[email protected]>Thu Feb 29 10:09:03 2024 +0000
committerUlises Mendez Martinez <[email protected]>Thu Feb 29 10:16:29 2024 +0000
treebad2f7136b11a5dafcb55f54ddd1b10fa1bfd96a
parentd343481b6af548fd10e489ac83f51f517911f7da [diff]
Add OWNERS, METADATA & LICENSE files.

* Setting owners to Kleaf team + default janitors.

Bug: 254734455
Change-Id: If8b5d562525efa038e72efe189c7051bdd8852c5
Signed-off-by: Ulises Mendez Martinez <[email protected]>
3 files changed
tree: bad2f7136b11a5dafcb55f54ddd1b10fa1bfd96a
  1. .bazelci/
  2. .bcr/
  3. .github/
  4. docs/
  5. proto/
  6. tests/
  7. tools/
  8. .bazelrc
  9. .gitattributes
  10. .gitignore
  11. .pre-commit-config.yaml
  12. AUTHORS
  13. BUILD
  14. CODEOWNERS
  15. CONTRIBUTING.md
  16. dev_deps.bzl
  17. LICENSE
  18. METADATA
  19. MODULE.bazel
  20. MODULE.bazel.lock
  21. MODULE_LICENSE_APACHE2
  22. OWNERS
  23. README.md
  24. WORKSPACE
  25. WORKSPACE.bzlmod
README.md

Protobuf Rules for Bazel

  • Postsubmit Build status

This repository contains a Starlark implementation of proto_library and related “base layer” rules in Bazel. It does not provide rules for any specific languages. These are typically expected to be provided in the ruleset for the language.

For a high-level overview of using Protocol Buffers and gRPC with Bazel, see https://bazel-contrib.github.io/SIG-rules-authors/proto-grpc.html.

For the list of Proto rules, see the Bazel documentation.

Roadmap

As of September 2023, this repo is mostly empty and contains stubs for proto_library, ProtoInfo and other proto toolchain support rules.

This will change soon, around the time Bazel 7 is released (in Oct/Nov 2023), because the stubs will be replaced with actual implementations. We plan to remove the native implementations in Bazel 8, at which point rules_proto will be the only way to build Protobuf rules.

As such it's recommended to use this repository now, so that the removal of implementations from Bazel 8 does not cause you problems.

Getting Started

To get started with rules_proto, add the WORKSPACE file snippet from the latest release.

Then, in your BUILD files, import and use the rules:

load("@rules_proto//proto:defs.bzl", "proto_library")
proto_library(
    ...
)

If you're migrating from the native proto rules to rules_proto, you can use the following buildifier command to automate the changes to your BUILD and .bzl files:

buildifier --lint=fix --warnings=native-proto <path/to/BUILD>

Contributing

Bazel and rules_proto are the work of many contributors. We appreciate your help!

To contribute, please read the contribution guidelines: CONTRIBUTING.md.

Note that the rules_proto use the GitHub issue tracker for bug reports and feature requests only.

For asking questions see: