Name
Last commit
Last update
benchmarks Added C++ benchmark. (#1525)
cmake Merge pull request #2969 from laszlocsomor/master
conformance file() was removed in Python 3, use open() instead
csharp Detect invalid tags with a field number of 0 in C#
docs Update third party addons with ProfaneDB
editors Improve fix for https://github.com/google/protobuf/issues/295
examples print() function & define raw_input() for Python 3
java PROTBUF-3394 Potential SIGBUS with UnsafeUtil.getLong
javanano Add a notice for nano.
jenkins Update commit id in Dockerfile to reflect change in #3391 (#3459)
js Merge pull request #3375 from TeBoring/3.3.x
kokoro Add continuous testing config files for Kokoro
m4 Fixed cross compilations with the Autotools build
more_tests Add makefile for extended tests to be run before release.
objectivec Fix up Xcode 8.3.x support.
php Fix the bug in php c extension that setting one field can change another field's value. (#3455)
protoc-artifacts Merge pull request #3375 from TeBoring/3.3.x
python Old style exception --> new style exception
ruby Merge 3.3.x into master
src Fixing warning under Clang 6.x (-Wexpansion-to-defined) where the macro expansion producing 'defined' was warning on undefined behavior.
third_party Added C++ benchmark. (#1525)
util/python Remove hack for building Python support with Bazel.
.gitignore update .gitignore
.gitmodules Added C++ benchmark. (#1525)
.travis.yml Move travis to the Xcode 8.3 (8.3.3) image.
BUILD Loading commit data...
CHANGES.txt Loading commit data...
CONTRIBUTORS.txt Loading commit data...
LICENSE Loading commit data...
Makefile.am Loading commit data...
Protobuf.podspec Loading commit data...
README.md Loading commit data...
WORKSPACE Loading commit data...
appveyor.bat Loading commit data...
appveyor.yml Loading commit data...
autogen.sh Loading commit data...
composer.json Loading commit data...
configure.ac Loading commit data...
generate_changelog.py Loading commit data...
generate_descriptor_proto.sh Loading commit data...
gmock.BUILD Loading commit data...
post_process_dist.sh Loading commit data...
protobuf-lite.pc.in Loading commit data...
protobuf.bzl Loading commit data...
protobuf.pc.in Loading commit data...
six.BUILD Loading commit data...
tests.sh Loading commit data...
update_file_lists.sh Loading commit data...

Protocol Buffers - Google's data interchange format

Build Status Build status Build Status Build Status Build Status

Copyright 2008 Google Inc.

https://developers.google.com/protocol-buffers/

Overview

Protocol Buffers (a.k.a., protobuf) are Google's language-neutral, platform-neutral, extensible mechanism for serializing structured data. You can find protobuf's documentation on the Google Developers site.

This README file contains protobuf installation instructions. To install protobuf, you need to install the protocol compiler (used to compile .proto files) and the protobuf runtime for your chosen programming language.

Protocol Compiler Installation

The protocol compiler is written in C++. If you are using C++, please follow the C++ Installation Instructions to install protoc along with the C++ runtime.

For non-C++ users, the simplest way to install the protocol compiler is to download a pre-built binary from our release page:

https://github.com/google/protobuf/releases

In the downloads section of each release, you can find pre-built binaries in zip packages: protoc-$VERSION-$PLATFORM.zip. It contains the protoc binary as well as a set of standard .proto files distributed along with protobuf.

If you are looking for an old version that is not available in the release page, check out the maven repo here:

https://repo1.maven.org/maven2/com/google/protobuf/protoc/

These pre-built binaries are only provided for released versions. If you want to use the github master version at HEAD, or you need to modify protobuf code, or you are using C++, it's recommended to build your own protoc binary from source.

If you would like to build protoc binary from source, see the C++ Installation Instructions.

Protobuf Runtime Installation

Protobuf supports several different programming languages. For each programming language, you can find instructions in the corresponding source directory about how to install protobuf runtime for that specific language:

Language Source
C++ (include C++ runtime and protoc) src
Java java
Python python
Objective-C objectivec
C# csharp
JavaNano javanano
JavaScript js
Ruby ruby
Go golang/protobuf
PHP php
Dart dart-lang/protobuf

Usage

The complete documentation for Protocol Buffers is available via the web at:

https://developers.google.com/protocol-buffers/