my rage from v8 is spilling over
Go to file
2022-05-27 23:25:37 +00:00
.github Add a github action workflow to run CocoaPods validation. (#9800) 2022-04-26 09:43:54 -07:00
benchmarks Add a test for bazel-built dist archives (#9929) 2022-05-09 16:32:59 -07:00
build_defs Fixed the Windows build of protoc by statically linking deps. 2022-05-23 20:59:31 +00:00
cmake Revert "Fix cmake install targets (#9822)" (#10060) 2022-05-26 14:11:37 -07:00
conformance Add a test for bazel-built dist archives (#9929) 2022-05-09 16:32:59 -07:00
csharp Updating version.json and repo version numbers to: 21.1 2022-05-27 14:07:46 -04:00
docs fix some typos (#9771) 2022-04-26 10:29:00 -07:00
editors [editors/emacs] Fix protobuf-mode definition (#9572) 2022-03-03 09:16:46 -08:00
examples Rename all BUILD files to BUILD.bazel (#9892) 2022-04-29 17:57:55 -07:00
java Updating version.json and repo version numbers to: 21.1 2022-05-27 14:07:46 -04:00
kokoro Remove Abseil dependency from CMake build (#10056) 2022-05-26 12:13:41 -07:00
m4 Updated ax_pthread.m4 to its most recent upstream version 2020-11-20 16:36:56 -08:00
objectivec Remove the support for the kokoro cocoapods integration tests. 2022-05-03 15:34:36 -04:00
php Updating version.json and repo version numbers to: 21.1 2022-05-27 14:07:46 -04:00
pkg Fix protoc_release target 2022-05-16 22:48:41 +00:00
protoc-artifacts Updating version.json and repo version numbers to: 21.1 2022-05-27 14:07:46 -04:00
python Updating version.json and repo version numbers to: 21.1 2022-05-27 14:07:46 -04:00
ruby Updating version.json and repo version numbers to: 21.1 2022-05-27 14:07:46 -04:00
src Updating version.json and repo version numbers to: 21.1 2022-05-27 14:07:46 -04:00
third_party Remove Abseil dependency from CMake build (#10056) 2022-05-26 12:13:41 -07:00
toolchain Optimization is now working. 2022-05-10 02:06:31 +00:00
util/python Rename all BUILD files to BUILD.bazel (#9892) 2022-04-29 17:57:55 -07:00
.bazelignore Remove Abseil dependency from CMake build (#10056) 2022-05-26 12:13:41 -07:00
.gitignore Remove the JavaScript implementation (#9874) 2022-04-28 12:08:26 -07:00
.gitmodules Remove Abseil dependency from CMake build (#10056) 2022-05-26 12:13:41 -07:00
.readthedocs.yml python: publish sphinx docs to read the docs 2020-02-28 13:36:50 -06:00
appveyor.bat Update .NET SDKs to LTS versions 2021-11-10 08:49:53 +13:00
appveyor.yml Merge branch '3.6.x' into merge-3-6-x 2018-06-25 13:22:10 -07:00
autogen.sh Build updates (#5300) 2021-05-17 14:53:27 -07:00
build_files_updated_unittest.sh Fixed sort ordering and updated test to output context information. 2021-04-16 08:10:49 -07:00
BUILD.bazel Fixed the Windows build of protoc by statically linking deps. 2022-05-23 20:59:31 +00:00
CHANGES.txt Updated changelog 2022-05-27 14:07:46 -04:00
CMakeLists.txt Remove Abseil dependency from CMake build (#10056) 2022-05-26 12:13:41 -07:00
configure.ac Updating version.json and repo version numbers to: 21.1 2022-05-27 14:07:46 -04:00
CONTRIBUTING.md Replace master with main in URLs & docs 2022-04-12 10:25:08 -07:00
CONTRIBUTORS.txt Match service argument names to abstract interface (#9418) 2022-02-03 09:14:44 -08:00
fix_permissions.sh Set execute bit on files if and only if they begin with (#!). (#7347) 2020-04-01 15:28:25 -07:00
generate_changelog.py Remove the JavaScript implementation (#9874) 2022-04-28 12:08:26 -07:00
generate_descriptor_proto.sh Updated version to 3.12.3 and updated CHANGES.txt. (#7580) 2020-06-01 13:36:50 -07:00
global.json Update .NET SDKs to LTS versions 2021-11-10 08:49:53 +13:00
LICENSE Cleanup LICENSE file. 2018-03-26 15:03:41 -07:00
Makefile.am Remove Abseil dependency from CMake build (#10056) 2022-05-26 12:13:41 -07:00
maven_install.json Update Guava to 31.1 (#9707) 2022-03-30 16:52:15 -04:00
post_process_dist.sh Remove the JavaScript implementation (#9874) 2022-04-28 12:08:26 -07:00
protobuf_deps.bzl Update upb commit to include fix for segmentation fault when instantiating field via repeated field assignment (#10066) 2022-05-27 12:16:33 -04:00
protobuf_release.bzl Update protobuf_version.bzl to separate protoc and per-language java major version (#9900) 2022-05-03 11:58:31 -04:00
protobuf_version.bzl Updating version.json and repo version numbers to: 21.1 2022-05-27 14:07:46 -04:00
Protobuf-C++.podspec Updating version.json and repo version numbers to: 21.1 2022-05-27 14:07:46 -04:00
protobuf-lite.pc.in Remove references to HAVE_PTHREAD (#9100) 2021-10-15 13:10:38 -07:00
protobuf.bzl Make genrule portable for windows (#9889) 2022-04-29 10:24:10 -07:00
protobuf.pc.in Remove references to HAVE_PTHREAD (#9100) 2021-10-15 13:10:38 -07:00
Protobuf.podspec Updating version.json and repo version numbers to: 21.1 2022-05-27 14:07:46 -04:00
README.md Remove the JavaScript implementation (#9874) 2022-04-28 12:08:26 -07:00
SECURITY.md grammar nit 2021-08-13 14:50:07 -04:00
tests.sh Remove the support for the kokoro cocoapods integration tests. 2022-05-03 15:34:36 -04:00
update_compatibility_version.py Merge 3.11.0-rc1 changes to master (#6917) 2019-11-20 18:03:29 -08:00
update_file_lists.sh Enable GeneratedDescriptorTest.EnormousDescriptor test for GCC/Clang CMake builds (#9617) 2022-03-10 16:40:07 -08:00
update_version.py Remove the JavaScript implementation (#9874) 2022-04-28 12:08:26 -07:00
version.json Update version.json to: 21.2-dev 2022-05-27 23:19:49 +00:00
WORKSPACE Added a Bazel dependency for upb (#9812) 2022-04-25 15:00:57 -07:00

Protocol Buffers - Google's data interchange format

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/protocolbuffers/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 main 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
Ruby ruby
Go protocolbuffers/protobuf-go
PHP php
Dart dart-lang/protobuf

Quick Start

The best way to learn how to use protobuf is to follow the tutorials in our developer guide:

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

If you want to learn from code examples, take a look at the examples in the examples directory.

Documentation

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

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