/protobuf

Protocol Buffers - Google's data interchange format
  1. C++ 40.3%
  2. Java 17.5%
  3. Objective-C 12.0%
  4. C# 9.4%
  5. Protocol Buffer 7.2%
  6. C 5.1%
  7. Other 8.5%
C++ Java Objective-C C# Protocol Buffer C Other
Find file
Latest commit 8d8115b Aug 1, 2016 @haberman haberman committed on GitHub Merge pull request #1878 from haberman/rubywkt 
Ruby: added API support for well-known types.
Failed to load latest commit information.
benchmarks Add the missing maintiner-clean entry for benchmarks May 6, 2016
cmake CMake: remove repeated_field_reflection.h from extract list Aug 1, 2016
conformance Amend the conformance tests to only use Int64/Uint64 non-wrapped valu… Jul 31, 2016
csharp Merge pull request #1893 from google/3.0.0-GA Jul 29, 2016
docs Add https://github.com/os72/protobuf-dynamic May 31, 2016
editors down-integrate internal changes May 21, 2015
examples Integrate from internal code base. Jul 13, 2016
java Use 64-bit protoc binaries in compatibility tests. Aug 1, 2016
javanano Update version number to 3.0.0-beta-4 Jul 13, 2016
jenkins Keep cpp_distcheck on travis for now. Jul 22, 2016
js Merge pull request #1887 from sheffatguidance/fix-js-api-documentation Jul 29, 2016
m4 Merge pull request #789 from motahan/solaris64_fix Jan 20, 2016
more_tests Add makefile for extended tests to be run before release. Jan 12, 2010
objectivec Use public methods to fetch oneofs in generated code. Jul 18, 2016
php Fix spelling in strings and comments Jul 3, 2016
protoc-artifacts Fix the build-zip.sh to add .exe for win packages. Jul 29, 2016
python add setup.cfg for building wheels Jul 29, 2016
ruby Merge pull request #1878 from haberman/rubywkt Aug 1, 2016
src Merge pull request #1893 from google/3.0.0-GA Jul 29, 2016
util/python Remove hack for building Python support with Bazel. Feb 25, 2016
.gitignore Expand the OS X/Xcode gitignores May 19, 2016
.travis.yml Run Java compatibility tests on Travis. Jul 29, 2016
BUILD Bazel build: Keep generated sources and Python runtime in the same di… May 25, 2016
CHANGES.txt Change log for 3.0 GA release. Jul 27, 2016
CONTRIBUTORS.txt Add nano proto authors and update LICENSE file to include Android.mk. Nov 20, 2014
LICENSE Add support for POWER Linux Nov 3, 2015
Makefile.am Merge pull request #1878 from haberman/rubywkt Aug 2, 2016
Protobuf.podspec Bump version number for GA Jul 25, 2016
README.md Fix typos in README.md Jan 25, 2016
WORKSPACE add java/util support based on java/util/pom.xml Mar 11, 2016
appveyor.bat Move to dotnet cli for building, and .NET Core (netstandard1.0) as ta… Jul 14, 2016
appveyor.yml Move to dotnet cli for building, and .NET Core (netstandard1.0) as ta… Jul 14, 2016
autogen.sh Add support for arguments. Oct 13, 2015
configure.ac Bump version number for GA Jul 25, 2016
generate_descriptor_proto.sh Merge branch 'master' of github.com:google/protobuf Mar 30, 2016
gmock.BUILD Fix headers for gmock.BUILD Dec 1, 2015
post_process_dist.sh Add js to post_process_dist.sh. Dec 28, 2015
protobuf-lite.pc.in Uncomment conflict fields from pkg-config files. May 12, 2015
protobuf.bzl Bazel build: Keep generated sources and Python runtime in the same di… May 26, 2016
protobuf.pc.in Uncomment conflict fields from pkg-config files. May 12, 2015
six.BUILD Add srcs_version = "PY2AND3" in BUILD files Dec 3, 2015
tests.sh Run Java compatibility tests on Travis. Jul 29, 2016
update_file_lists.sh Fix bugs on windows Aug 25, 2015

README.md

Protocol Buffers - Google's data interchange format

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:

http://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 TBD

Usage

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

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