Jie Luo
ea68c8a82b
|
1 year ago | |
---|---|---|
.bazelci | 2 years ago | |
.github | 1 year ago | |
bazel | 1 year ago | |
benchmarks | 1 year ago | |
cmake | 1 year ago | |
docs | 1 year ago | |
lua | 1 year ago | |
protos | 1 year ago | |
protos_generator | 1 year ago | |
python | 1 year ago | |
third_party/lunit | 2 years ago | |
upb | 1 year ago | |
upbc | 1 year ago | |
.bazelignore | 3 years ago | |
.bazelrc | 2 years ago | |
.clang-format | 3 years ago | |
.gitignore | 3 years ago | |
BUILD | 1 year ago | |
CONTRIBUTING.md | 3 years ago | |
LICENSE | 4 years ago | |
README.md | 2 years ago | |
WORKSPACE | 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.