Protocol Buffers - Google's data interchange format (grpc依赖) https://developers.google.com/protocol-buffers/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Jie Luo ea68c8a82b Fix an upb bug 1 year ago
.bazelci Build with incompatible_disallow_empty_glob 2 years ago
.github Drop Bazel 4 support in upb. 1 year ago
bazel Clean grep_includes 1 year ago
benchmarks upb: create upb/base/BUILD 1 year ago
cmake Auto-generate CMake file lists 1 year ago
docs upb: delete upb/reflection.h, upb/reflection.hpp 1 year ago
lua upb: delete upb/reflection.h, upb/reflection.hpp 1 year ago
protos upb: create upb/base/BUILD 1 year ago
protos_generator Automated visibility attribute cleanup. 1 year ago
python upb: delete upb/array.h, upb/map.h, upb/collections.h 1 year ago
third_party/lunit Switch to cmake fetch instead of git submodules 2 years ago
upb Fix an upb bug 1 year ago
upbc Internal change. 1 year ago
.bazelignore Added missing .bazelignore file. 3 years ago
.bazelrc Add windows CI 2 years ago
.clang-format Added .clang-format for the project. 3 years ago
.gitignore Added GitHub Action to build generated files and push them to the `generated` branch. 3 years ago
BUILD upb: delete upb/reflection.h, upb/reflection.hpp 1 year ago
CONTRIBUTING.md Updated some docs and removed/rearranged some obsolete stuff. 3 years ago
LICENSE Updated Google, Inc. to Google LLC. 4 years ago
README.md Update documentation about upb status 2 years ago
WORKSPACE Move to proto_common for all upb aspects to fix numerous tricky edge cases and simplify the code 2 years ago

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 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

For Python, use PyPI:

$ sudo pip install protobuf

Alternatively, you can build and install upb using vcpkg dependency manager:

git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg integrate install
./vcpkg install upb

The upb port in vcpkg is kept up to date by microsoft team members and community contributors.

If the version is out of date, please create an issue or pull request on the vcpkg repository.

Contributing

Please see CONTRIBUTING.md.