Go to file
Chad Wilson c95ebb7bd8 deps: Update Guava to 32.0.1 (#13099)
Follow-up from #12953 to update to `32.0.1` to fix an issue on windows:

https://github.com/google/guava/releases/tag/v32.0.1

The underlying issue likely does not affect protobuf as it does not appear to (directly) use the affected `Files.createTempDir` or `FileBackedOutputStream` code which was apparently broken on Windows in `32.0.0`.

Seems best to update anyway.

Closes #13099

COPYBARA_INTEGRATE_REVIEW=https://github.com/protocolbuffers/protobuf/pull/13099 from chadlwilson:bump-guava-3201 30bd3f7563
PiperOrigin-RevId: 541960623
2023-06-20 09:59:40 -07:00
.github Delete codespell presubmit. 2023-06-14 13:13:10 -07:00
build_defs Fix protoc_nowkt linking on MacOS (#12320) 2023-04-24 20:18:30 -07:00
ci Force push auto-commits to bypass branch protection status checks 2023-06-09 10:01:40 -07:00
cmake CMake: Fix abseil_dll target name when using find_package(absl) (#12978) 2023-06-05 15:08:55 -07:00
conformance Added a conformance test for embedded nulls in JSON strings. 2023-04-28 10:15:24 -07:00
csharp Fix a typo 2023-06-14 12:40:52 -07:00
docs Reserve option for proto-telemetry (#12758) 2023-05-15 20:10:38 -07:00
editors protobuf-mode: Remove no-op easy-menu-add call. (#12674) 2023-05-05 20:30:44 -07:00
examples Remove ODR violation from WKT codegen (#12406) (#12419) 2023-04-06 15:34:09 -07:00
java deps: Update Guava to 32.0.1 (#13099) 2023-06-20 09:59:40 -07:00
objectivec Update the minimum macos to match cl/537907016 2023-06-08 06:20:36 -07:00
php Remove RegisterExtension in message class 2023-06-12 00:39:23 -07:00
pkg Internal changes 2023-04-28 18:55:27 -07:00
python Automated rollback of commit c4bc23782e. 2023-06-15 09:54:01 -07:00
ruby Remove RegisterExtension in message class 2023-06-12 00:39:23 -07:00
rust Internal Change 2023-06-15 08:13:08 -07:00
src Auto-generate files after cl/541943542 2023-06-20 16:22:15 +00:00
third_party Merge commit '4b414d60eeaa00f6fbbbdb2f937b26601e903ee9' into chore-deps-update-utf8-range 2023-05-26 22:35:17 +00:00
toolchain Add libm linkage to toolchains 2023-03-01 23:01:54 +00:00
.bazelignore Clean up leftover benchmark cruft (#10480) 2022-08-29 16:05:04 -04:00
.bazelrc Modify release artifacts for protoc to statically link system libraries. 2023-02-28 23:35:46 +00:00
.gitignore Migrate to composite GHA actions (#11718) 2023-02-01 11:34:03 -08:00
.gitmodules Fix abseil gitmodule date and add a step in tests to update the subrepo to catch errors like this in the future. 2023-04-12 15:48:22 -07:00
.readthedocs.yml python: publish sphinx docs to read the docs 2020-02-28 13:36:50 -06:00
BUILD.bazel Squashed 'third_party/utf8_range/' changes from 72c943dea..d863bc33e 2023-05-26 22:35:17 +00:00
CMakeLists.txt cleanup(cmake): prefer target over global options (#12916) 2023-05-30 14:56:51 -07:00
CODE_OF_CONDUCT.md Add a code of conduct based on https://www.contributor-covenant.org/ and https://github.com/carbon-language/carbon-lang/blob/trunk/CODE_OF_CONDUCT.md 2022-12-01 09:29:45 -08:00
CONTRIBUTING.md Squashed 'third_party/utf8_range/' content from commit 72c943dea 2023-01-19 16:02:55 -08:00
CONTRIBUTORS.txt Match service argument names to abstract interface (#9418) 2022-02-03 09:14:44 -08:00
LICENSE Squashed 'third_party/utf8_range/' content from commit 72c943dea 2023-01-19 16:02:55 -08:00
Protobuf-C++.podspec Sync up the min os versions between the C++ and ObjC CocoaPods support. 2023-06-05 10:04:26 -07:00
Protobuf.podspec Merge to main after 23.0 release (#12721) 2023-05-09 11:28:29 -07:00
README.md typo fix: Javascript -> JavaScript in protobuf readme 2023-06-14 20:56:29 -07:00
SECURITY.md grammar nit 2021-08-13 14:50:07 -04:00
WORKSPACE Update abseil dependency and reorder dependencies to ensure we use the version specified in protobuf_deps. 2023-05-02 20:14:36 +00:00
appveyor.bat [dotnet, csharp] Run tests for supported platforms .NET 6, .NET Framework 4.6.2 (#12378) 2023-04-10 13:28:23 -07:00
appveyor.yml Upgrade to MSVC 2017 (#10437) 2022-08-22 14:29:12 -07: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 Sync from Piper @484138213 2022-10-26 20:10:29 -07:00
generate_descriptor_proto.sh Migrate remaining macOS tests to GHA actions 2023-02-02 15:54:29 -08:00
global.json Update .NET SDKs to LTS versions 2021-11-10 08:49:53 +13:00
google3_export_generated_files.sh Bump protobuf to latest upb version. 2023-01-14 00:11:12 -08:00
maven_install.json deps: Update Guava to 32.0.1 (#13099) 2023-06-20 09:59:40 -07:00
protobuf.bzl Add missing mnemonic on a couple of proto compilation actions. 2023-01-17 11:00:10 -08:00
protobuf_deps.bzl deps: Update Guava to 32.0.1 (#13099) 2023-06-20 09:59:40 -07: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 Merge to main after 23.0 release (#12721) 2023-05-09 11:28:29 -07:00
regenerate_stale_files.sh [ObjC] Set up a stateless test for the WKTs. 2023-02-10 14:12:37 -08:00
update_subtrees.sh Fix declared dependencies for pkg-config (#12518) 2023-04-24 10:44:14 -07:00
version.json Updating version.json to: 23.1-dev 2023-05-08 09:48:50 -07:00

README.md

Protocol Buffers - Google's data interchange format

Copyright 2008 Google Inc.

Overview

Protocol Buffers (a.k.a., protobuf) are Google's language-neutral, platform-neutral, extensible mechanism for serializing structured data. You can learn more about it in protobuf's documentation.

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 GitHub release page.

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

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
JavaScript protocolbuffers/protobuf-javascript

Quick Start

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

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

Documentation

The complete documentation is available at the Protocol Buffers doc site.

Support Policy

Read about our version support policy to stay current on support timeframes for the language libraries.

Developer Community

To be alerted to upcoming changes in Protocol Buffers and connect with protobuf developers and users, join the Google Group.