v31.0: Protocol Buffers v31.0

Compare Source

Announcements

• Protobuf News may include additional announcements or pre-announcements for upcoming changes.

Bazel

• Loosen py_proto_library check to be on the import path instead of full directory (i.e. excluding external/module-name prefix). (protocolbuffers/protobuf@a4be867)

Compiler

• Add support for import option for protoc.(protocolbuffers/protobuf@9901db6)
• Add notices.h with information about our dependencies' licenses and add --notices flag to protoc to print the contents of that file. (protocolbuffers/protobuf@7a26486)
• Move upb minitable code generator into protoc (protocolbuffers/protobuf@dce6b0f)
• Upgrade abseil-cpp to 2025012 and use @​com_google_absl -> @​abseil-cpp and com_google_googletest -> @​googletest canonical BCR names. (protocolbuffers/protobuf@ba6b54d)

C++

• Remove fast-path check for non-clang compilers in MessageCreator. (protocolbuffers/protobuf@aa5410d)
• Add missing include. (protocolbuffers/protobuf@d390631)
• Add weak attribute to GetClassData to speed up clang builds. (protocolbuffers/protobuf@d896480)
• Add nontemporal software prefetcher to repeated ptr field dtor to improve performance. (protocolbuffers/protobuf@73f3469)
• Warn on unused RepeatedPtrField. (protocolbuffers/protobuf@683e9d2)
• Add notices.h with information about our dependencies' licenses and add --notices flag to protoc to print the contents of that file. (protocolbuffers/protobuf@7a26486)
• Fix a bug in handling of implicit-presence string_view fields. (protocolbuffers/protobuf@bd70a7c)
• Control bounds checks via BUILD flags. (protocolbuffers/protobuf@d21e8ef)
• Upgrade abseil-cpp to 2025012 and use @​com_google_absl -> @​abseil-cpp and com_google_googletest -> @​googletest canonical BCR names. (protocolbuffers/protobuf@ba6b54d)
• Create hardened versions of Get and Mutable for repeated_field. (protocolbuffers/protobuf@ffade4a)

Java

• Add weak attribute to GetClassData to speed up clang builds. (protocolbuffers/protobuf@d896480)
• Use ProtobufToStringOutput to control the output format of AbstractMessage.Builder.toString. (protocolbuffers/protobuf@f5cb162)
• Implement Protobuf Java Immutable API nest_in_file_class feature for Edition 2024. (protocolbuffers/protobuf@0416c3e)
• Introduce a Generated annotation to eventually replace javax.annotation.Generated (protocolbuffers/protobuf@31e57fc)
• Add volatile to featuresResolved (protocolbuffers/protobuf@9e03ca5)
• Fix Java concurrency issue in feature resolution for old <=3.25.x gencode using lazy feature resolution. (protocolbuffers/protobuf@fafb0fd)
• Remove Java runtime classes from kotlin release. (protocolbuffers/protobuf@079be27)
• Split maven dependencies into dev vs local (#​20549) (protocolbuffers/protobuf@e045fc6)
• Improve error messaging when detecting and erroring out on integer overflow of byte count limit variables. (protocolbuffers/protobuf@097fdb8)

Kotlin

• Remove Java runtime classes from kotlin release. (protocolbuffers/protobuf@079be27)

Csharp

• Remove "experimental API" warnings from members in the .NET protobuf runtime. (protocolbuffers/protobuf@afea52f)
• Improve performace of repeated packed fixedSize fields (#​19667) (protocolbuffers/protobuf@85507b9)

Objective-C

• [ObjC] Deprecate GPBFieldDescriptor.isOptional. (protocolbuffers/protobuf@86ab252)
• [ObjC] Raise the library version and enable new generated code. (protocolbuffers/protobuf@a639cf8)

Rust

• Cherry-pick Rust fix to 31.x (#​21617) (protocolbuffers/protobuf@01b42bb)
• Add upb_Map_GetMutable API to upb (protocolbuffers/protobuf@dd5bf5e)
• See also UPB changes below, which may affect Rust.

Python

• Update GetCurrentTime to use datetime.datetime.now (protocolbuffers/protobuf@01b154c)
• Make Py JSON float_precision apply to both float and double fields. (protocolbuffers/protobuf@5b54ee3)
• -Add '+' and '-' annotations for Timestamp and Duration in Python (protocolbuffers/protobuf@fff783e)
• Bug fix for FieldMask.MergeFrom() with unset fields. (protocolbuffers/protobuf@1c87ac3)
• Make python text_format able to skip unknown fields for repeated messages (protocolbuffers/protobuf@dcafca2)
• Fix segment fault for UPB Pyhon 'in' method of empty repeated extensions (protocolbuffers/protobuf@da04261)
• Fix upb to escape DefinitelyNeedsEscape (like " and ') for bytes field (protocolbuffers/protobuf@b234305)
• Check with fallback descriptorDB for FindExtensionByNumber()/FindAllExtensions in UPB python pool. (protocolbuffers/protobuf@9fd28d9)
• Add clear() method to repeated fields in Python. (protocolbuffers/protobuf@0324f39)
• Register Scalar/MessageMapContainerTypes as virtual subclasses of (protocolbuffers/protobuf@9a0b591)
• Fix python codegen crash when C++ features are used. (protocolbuffers/protobuf@308aaf4)
• Add more detail to the comment for GetMessageClassesForFiles (protocolbuffers/protobuf@9befb58)
• Add constructing unpack routine to Python Protobuf Any API. (protocolbuffers/protobuf@fb78c09)
• Implement typing for proto Timestamp/Duration assignments. (protocolbuffers/protobuf@0e3326b)

PHP

• Deprecate Descriptor Label. As an alternative, add helper methods for checking whether a field is required or repeated. (protocolbuffers/protobuf@d82de8f)
• Feat(php): improve return typehint when repeatedfield (#​11734) (protocolbuffers/protobuf@e04fe69)

PHP C-Extension

• Automated rollback of commit f9863df. (#​21355) (protocolbuffers/protobuf@a59988c)
• Deprecate Descriptor Label. As an alternative, add helper methods for checking whether a field is required or repeated. (protocolbuffers/protobuf@d82de8f)
• Ruby: Allow to get a file descriptor by a file name (#​20287) (protocolbuffers/protobuf@c398592)
• Feat(php): improve return typehint when repeatedfield (#​11734) (protocolbuffers/protobuf@e04fe69)
• See also UPB changes below, which may affect PHP C-Extension.

Ruby

• Fix silent failure of rb_test rules to run test (#​21733) (protocolbuffers/protobuf@0cf5489)
• Ruby | Add support for a protobuf debug build (#​21060) (protocolbuffers/protobuf@59e1f0f)
• Ruby | Support installing the gem via git and some other small build tweaks (#​21061) (protocolbuffers/protobuf@d3560e7)
• Deprecate Descriptor Label. As an alternative, add helper methods for checking whether a field is required or repeated. (protocolbuffers/protobuf@d82de8f)
• [Ruby]Implement #to_hash for message classes (#​20866) (protocolbuffers/protobuf@5596f6d)
• Drop Ruby 3.0 (protocolbuffers/protobuf@5de7c80)
• Fixes #​18726 by backslash escaping descriptor data containing # if the hashmark appears immediately before any of $, {, or @. (protocolbuffers/protobuf@fffa3da)
• Ruby: Allow to get a file descriptor by a file name (#​20287) (protocolbuffers/protobuf@c398592)
• Ruby: fix bug in Map.hash (protocolbuffers/protobuf@b968d0d)

Ruby C-Extension

• Ruby | Add support for a protobuf debug build (#​21060) (protocolbuffers/protobuf@59e1f0f)
• Deprecate Descriptor Label. As an alternative, add helper methods for checking whether a field is required or repeated. (protocolbuffers/protobuf@d82de8f)
• Ruby: Allow to get a file descriptor by a file name (#​20287) (protocolbuffers/protobuf@c398592)
• Ruby: fix bug in Map.hash (protocolbuffers/protobuf@b968d0d)
• See also UPB changes below, which may affect Ruby C-Extension.

UPB (Python/PHP/Ruby C-Extension)

• Fixed LTO-only linker error in upb linker arrays. (protocolbuffers/protobuf@3434a21)
• Deprecate Descriptor Label. As an alternative, add helper methods for checking whether a field is required or repeated. (protocolbuffers/protobuf@d82de8f)
• Add upb_Map_GetMutable API to upb (protocolbuffers/protobuf@dd5bf5e)
• Fix upb to escape DefinitelyNeedsEscape (like " and ') for bytes field (protocolbuffers/protobuf@b234305)
• Upb: delete functions in map_gencode_util. They're unused after the Map iterator API change. (protocolbuffers/protobuf@f398807)
• Upb: Update _upb_map_next signature to return a boolean and remove the _nextmutable Map iterator API. (protocolbuffers/protobuf@e4cdf44)
• Change upb C generated map iteration function to not hand out MapEntry pointers. (protocolbuffers/protobuf@3a3d697)
• Ruby: Allow to get a file descriptor by a file name (#​20287) (protocolbuffers/protobuf@c398592)
• Expose the upb_ByteSize function to upb clients. Note that the current naive implementation is no more efficient than serializing the message yourself and noting the resulting size. (protocolbuffers/protobuf@121fdaa)
• Move upb minitable code generator into protoc (protocolbuffers/protobuf@dce6b0f)
• Tolerate message set extensions encoded as normal deliminited submessages (protocolbuffers/protobuf@c63fd56)
• Automated rollback of commit 6bde8c4. (protocolbuffers/protobuf@8ef81fb)
• Fix UPB fast table build. (protocolbuffers/protobuf@46f9e29)

Other

• Patch rules_ruby to apply neverlink = True to the jars rule (#​21416) (#​21505) (protocolbuffers/protobuf@664d94a)
• Restore JDK8 compatibility in Bazel for libraries with dependencies from Maven (e.g. //java/util) (protocolbuffers/protobuf@e8edc5d)
• Protobuf: add //:go_features_proto Bazel alias (protocolbuffers/protobuf@f79be3e)
• Fixes -lpthread problem when building with android_arm64 config (#​20337) (protocolbuffers/protobuf@4f5968a)