Google Git
Sign in
flutter / third_party / protobuf / 4b15cf3da2e3d4ec10961d02a25bbfbc2ac6d34a
commit4b15cf3da2e3d4ec10961d02a25bbfbc2ac6d34a[log] [tgz]
authorJoshua Haberman <jhaberman@gmail.com>Tue Feb 08 00:12:51 2022 -0800
committerGitHub <noreply@github.com>Tue Feb 08 00:12:51 2022 -0800
treed532b74d6d2910d2ebed5269cead8bfd2890ea92
parent6375267af4cfefa69e3c1063be11b9b7803bd41c [diff]
parenta07ac3fafcb56a9b6c168e5a7e2e6e2a7c087e7b [diff]
Merge pull request #499 from haberman/python-pkg

Added a Bazel rule to build a binary wheel for Python
tree: d532b74d6d2910d2ebed5269cead8bfd2890ea92
  1. .bazelci/
  2. .github/
  3. bazel/
  4. benchmarks/
  5. cmake/
  6. doc/
  7. python/
  8. tests/
  9. third_party/
  10. upb/
  11. upbc/
  12. .bazelignore
  13. .bazelrc
  14. .clang-format
  15. .gitignore
  16. BUILD
  17. CONTRIBUTING.md
  18. DESIGN.md
  19. LICENSE
  20. README.md
  21. rename.sed
  22. run_sed.sh
  23. WORKSPACE
README.md

μpb: small, fast C protos

μpb (often written ‘upb’) is a small protobuf implementation written in C.

upb is the core runtime for protobuf languages extensions in Ruby, PHP, and (soon) Python.

While upb offers a C API, the C API & ABI are not stable. For this reason, upb is not generally offered as a C library for direct consumption, and there are no releases.

Features

upb has comparable speed to protobuf C++, but is an order of magnitude smaller in code size.

Like the main protobuf implementation in C++, it supports:

  • a generated API (in C)
  • reflection
  • binary & JSON wire formats
  • text format serialization
  • all standard features of protobufs (oneofs, maps, unknown fields, extensions, etc.)
  • full conformance with the protobuf conformance tests

upb also supports some features that C++ does not:

  • optional reflection: generated messages are agnostic to whether reflection will be linked in or not.
  • no global state: no pre-main registration or other global state.
  • fast reflection-based parsing: messages loaded at runtime parse just as fast as compiled-in messages.

However there are a few features it does not support:

  • text format parsing
  • deep descriptor verification: upb's descriptor validation is not as exhaustive as protoc.

Install

For Ruby, use RubyGems:

$ gem install google-protobuf

For PHP, use PECL:

$ sudo pecl install protobuf

Contributing

Please see CONTRIBUTING.md.