12022-09-29 version 3.20.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby) 2 3 42022-09-27 version 3.20.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby) 5 Java 6 * Refactoring java full runtime to reuse sub-message builders and prepare to 7 migrate parsing logic from parse constructor to builder. 8 * Move proto wireformat parsing functionality from the private "parsing 9 constructor" to the Builder class. 10 * Change the Lite runtime to prefer merging from the wireformat into mutable 11 messages rather than building up a new immutable object before merging. This 12 way results in fewer allocations and copy operations. 13 * Make message-type extensions merge from wire-format instead of building up 14 instances and merging afterwards. This has much better performance. 15 * Fix TextFormat parser to build up recurring (but supposedly not repeated) 16 sub-messages directly from text rather than building a new sub-message and 17 merging the fully formed message into the existing field. 18 192022-09-13 version 3.20.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby) 20 21C++ 22* Reduce memory consumption of MessageSet parsing 23 242022-04-05 version 3.20.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 25 26 PHP 27 * Fix building packaged PHP extension (#9727) 28 * Fixed composer.json to only advertise compatibility with PHP 7.0+. (#9819) 29 30 Ruby 31 * Disable the aarch64 build on macOS until it can be fixed. (#9816) 32 33 Other 34 * Fix versioning issues in 3.20.0 35 362022-03-04 version 3.20.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 37 38 Ruby 39 * Dropped Ruby 2.3 and 2.4 support for CI and releases. (#9311) 40 * Added Ruby 3.1 support for CI and releases (#9566). 41 * Message.decode/encode: Add recursion_limit option (#9218/#9486) 42 * Allocate with xrealloc()/xfree() so message allocation is visible to the 43 Ruby GC. In certain tests this leads to much lower memory usage due to more 44 frequent GC runs (#9586). 45 * Fix conversion of singleton classes in Ruby (#9342) 46 * Suppress warning for intentional circular require (#9556) 47 * JSON will now output shorter strings for double and float fields when possible 48 without losing precision. 49 * Encoding and decoding of binary format will now work properly on big-endian 50 systems. 51 * UTF-8 verification was fixed to properly reject surrogate code points. 52 * Unknown enums for proto2 protos now properly implement proto2's behavior of 53 putting such values in unknown fields. 54 55 Java 56 * Revert "Standardize on Array copyOf" (#9400) 57 * Resolve more java field accessor name conflicts (#8198) 58 * Don't support map fields in DynamicMessage.Builder.{getFieldBuilder,getRepeatedFieldBuilder} 59 * Fix parseFrom to only throw InvalidProtocolBufferException 60 * InvalidProtocolBufferException now allows arbitrary wrapped Exception types. 61 * Fix bug in `FieldSet.Builder.mergeFrom` 62 * Flush CodedOutputStream also flushes underlying OutputStream 63 * When oneof case is the same and the field type is Message, merge the 64 subfield. (previously it was replaced.)’ 65 * Add @CheckReturnValue to some protobuf types 66 * Report original exceptions when parsing JSON 67 * Add more info to @deprecated javadoc for set/get/has methods 68 * Fix initialization bug in doc comment line numbers 69 * Fix comments for message set wire format. 70 71 Kotlin 72 * Add test scope to kotlin-test for protobuf-kotlin-lite (#9518) 73 * Add orNull extensions for optional message fields. 74 * Add orNull extensions to all proto3 message fields. 75 76 Python 77 * Dropped support for Python < 3.7 (#9480) 78 * Protoc is now able to generate python stubs (.pyi) with --pyi_out 79 * Pin multibuild scripts to get manylinux1 wheels back (#9216) 80 * Fix type annotations of some Duration and Timestamp methods. 81 * Repeated field containers are now generic in field types and could be used 82 in type annotations. 83 * Protobuf python generated codes are simplified. Descriptors and message 84 classes' definitions are now dynamic created in internal/builder.py. 85 Insertion Points for messages classes are discarded. 86 * has_presence is added for FieldDescriptor in python 87 * Loosen indexing type requirements to allow valid __index__() implementations 88 rather than only PyLongObjects. 89 * Fix the deepcopy bug caused by not copying message_listener. 90 * Added python JSON parse recursion limit (default 100) 91 * Path info is added for python JSON parse errors 92 * Pure python repeated scalar fields will not able to pickle. Convert to list 93 first. 94 * Timestamp.ToDatetime() now accepts an optional tzinfo parameter. If 95 specified, the function returns a timezone-aware datetime in the given time 96 zone. If omitted or None, the function returns a timezone-naive UTC datetime 97 (as previously). 98 * Adds client_streaming and server_streaming fields to MethodDescriptor. 99 * Add "ensure_ascii" parameter to json_format.MessageToJson. This allows smaller 100 JSON serializations with UTF-8 or other non-ASCII encodings. 101 * Added experimental support for directly assigning numpy scalars and array. 102 * Improve the calculation of public_dependencies in DescriptorPool. 103 * [Breaking Change] Disallow setting fields to numpy singleton arrays or repeated fields to numpy 104 multi-dimensional arrays. Numpy arrays should be indexed or flattened explicitly before assignment. 105 106 Compiler 107 * Migrate IsDefault(const std::string*) and UnsafeSetDefault(const std::string*) 108 * Implement strong qualified tags for TaggedPtr 109 * Rework allocations to power-of-two byte sizes. 110 * Migrate IsDefault(const std::string*) and UnsafeSetDefault(const std::string*) 111 * Implement strong qualified tags for TaggedPtr 112 * Make TaggedPtr Set...() calls explicitly spell out the content type. 113 * Check for parsing error before verifying UTF8. 114 * Enforce a maximum message nesting limit of 32 in the descriptor builder to 115 guard against stack overflows 116 * Fixed bugs in operators for RepeatedPtrIterator 117 * Assert a maximum map alignment for allocated values 118 * Fix proto1 group extension protodb parsing error 119 * Do not log/report the same descriptor symbol multiple times if it contains 120 more than one invalid character. 121 * Add UnknownFieldSet::SerializeToString and SerializeToCodedStream. 122 * Remove explicit default pointers and deprecated API from protocol compiler 123 124 Arenas 125 * Change Repeated*Field to reuse memory when using arenas. 126 * Implements pbarenaz for profiling proto arenas 127 * Introduce CreateString() and CreateArenaString() for cleaner semantics 128 * Fix unreferenced parameter for MSVC builds 129 * Add UnsafeSetAllocated to be used for one-of string fields. 130 * Make Arena::AllocateAligned() a public function. 131 * Determine if ArenaDtor related code generation is necessary in one place. 132 * Implement on demand register ArenaDtor for InlinedStringField 133 134 C++ 135 * Enable testing via CTest (#8737) 136 * Add option to use external GTest in CMake (#8736) 137 * CMake: Set correct sonames for libprotobuf-lite.so and libprotoc.so (#8635) (#9529) 138 * Add cmake option `protobuf_INSTALL` to not install files (#7123) 139 * CMake: Allow custom plugin options e.g. to generate mocks (#9105) 140 * CMake: Use linker version scripts (#9545) 141 * Manually *struct Cord fields to work better with arenas. 142 * Manually destruct map fields. 143 * Generate narrower code 144 * Fix https://github.com/protocolbuffers/protobuf/issues/9378 by removing 145 shadowed _cached_size_ field 146 * Remove GetPointer() and explicit nullptr defaults. 147 * Add proto_h flag for speeding up large builds 148 * Add missing overload for reference wrapped fields. 149 * Add MergedDescriptorDatabase::FindAllFileNames() 150 * RepeatedField now defines an iterator type instead of using a pointer. 151 * Remove obsolete macros GOOGLE_PROTOBUF_HAS_ONEOF and GOOGLE_PROTOBUF_HAS_ARENAS. 152 153 PHP 154 * Fix: add missing reserved classnames (#9458) 155 * PHP 8.1 compatibility (#9370) 156 157 C# 158 * Fix trim warnings (#9182) 159 * Fixes NullReferenceException when accessing FieldDescriptor.IsPacked (#9430) 160 * Add ToProto() method to all descriptor classes (#9426) 161 * Add an option to preserve proto names in JsonFormatter (#6307) 162 163 Objective-C 164 * Add prefix_to_proto_package_mappings_path option. (#9498) 165 * Rename `proto_package_to_prefix_mappings_path` to `package_to_prefix_mappings_path`. (#9552) 166 * Add a generation option to control use of forward declarations in headers. (#9568) 167 1682022-01-28 version 3.19.4 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 169 170 Python 171 * Make libprotobuf symbols local on OSX to fix issue #9395 (#9435) 172 173 Ruby 174 * Fixed a data loss bug that could occur when the number of `optional` 175 fields in a message is an exact multiple of 32. (#9440). 176 177 PHP 178 * Fixed a data loss bug that could occur when the number of `optional` 179 fields in a message is an exact multiple of 32. (#9440). 180 1812022-01-10 version 3.19.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 182 183 Python 184 * Fix missing Windows wheel for Python 3.10 on PyPI 185 1862022-01-05 version 3.19.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 187 188 Java 189 * Improve performance characteristics of UnknownFieldSet parsing (#9371) 190 * This release addresses a Security Advisory for Java users 191 (https://github.com/protocolbuffers/protobuf/security/advisories/GHSA-wrvw-hg22-4m67) 192 1932022-01-05 version 3.18.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 194 195 Java 196 * Improve performance characteristics of UnknownFieldSet parsing (#9371) 197 * This release addresses a Security Advisory for Java users 198 (https://github.com/protocolbuffers/protobuf/security/advisories/GHSA-wrvw-hg22-4m67) 199 2002022-01-05 version 3.16.1 (Java) 201 202 Java 203 * Improve performance characteristics of UnknownFieldSet parsing (#9371) 204 * This release addresses a Security Advisory for Java users 205 (https://github.com/protocolbuffers/protobuf/security/advisories/GHSA-wrvw-hg22-4m67) 206 2072021-10-28 version 3.19.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 208 209 Bazel 210 * Ensure that release archives contain everything needed for Bazel (#9131) 211 * Align dependency handling with Bazel best practices (#9165) 212 213 JavaScript 214 * Fix `ReferenceError: window is not defined` when getting the global object (#9156) 215 216 Ruby 217 * Fix memory leak in MessageClass.encode (#9150) 218 2192021-10-15 version 3.19.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 220 221 C++ 222 * Make proto2::Message::DiscardUnknownFields() non-virtual 223 * Separate RepeatedPtrField into its own header file 224 * For default floating point values of 0, consider all bits significant 225 * cmake: support `MSVC_RUNTIME_LIBRARY` property (#8851) 226 * Fix shadowing warnings (#8926) 227 * Fix for issue #8484, constant initialization doesn't compile in msvc clang-cl environment (#8993) 228 * Fix build on AIX and SunOS (#8373) (#9065) 229 * Add Android stlport and default toolchains to BUILD. (#8290) 230 231 Java 232 * For default floating point values of 0, consider all bits significant 233 * Annotate `//java/com/google/protobuf/util/...` with nullness annotations 234 * Use ArrayList copy constructor (#7853) 235 236 Kotlin 237 * Switch Kotlin proto DSLs to be implemented with inline value classes 238 * Fix inlining and deprecation for repeated string fields in kotlin (#9120) 239 240 Python 241 * Proto2 DecodeError now includes message name in error message 242 * Make MessageToDict convert map keys to strings (#8122) 243 * Add python-requires in setup.py (#8989) 244 * Add python 3.10 (#9034) 245 246 JavaScript 247 * Skip exports if not available by CommonJS (#8856) 248 * JS: Comply with CSP no-unsafe-eval. (#8864) 249 250 PHP 251 * Added "object" as a reserved name for PHP (#8962) 252 253 Ruby 254 * Override Map.clone to use Map's dup method (#7938) 255 * Ruby: build extensions for arm64-darwin (#8232) 256 * Add class method Timestamp.from_time to ruby well known types (#8562) 257 * Adopt pure ruby DSL implementation for JRuby (#9047) 258 * Add size to Map class (#8068) 259 * Fix for descriptor_pb.rb: google/protobuf should be required first (#9121) 260 261 C# 262 * Correctly set ExtensionRegistry when parsing with MessageParser, but using an already existing CodedInputStream (#7246) 263 * [C#] Make FieldDescriptor propertyName public (#7642) 264 2652021-10-04 version 3.18.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 266 267 Python 268 * Update setup.py to reflect that we now require at least Python 3.5 (#8989) 269 * Performance fix for DynamicMessage: force GetRaw() to be inlined (#9023) 270 271 Ruby 272 * Update ruby_generator.cc to allow proto2 imports in proto3 (#9003) 273 2742021-09-13 version 3.18.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 275 276 Python 277 * Removed Python 2.x support. 278 * Pure python descriptor_pool.AddSerializedFile() will always build the 279 file and return FileDescriptor which is same with python c++ extension 280 * type errors thrown by MergeFrom now report fully qualified class names 281 * Protobuf python generated code are simplified. Some platforms that uses 282 "is"("is not") to compare the enum or descriptor's label/type may fail, 283 should use "=="("!=") instead. 284 285 C++ 286 * Generated code now uses the c++11 standard integer types int{32,64}_t and 287 uint{32,64}_t 288 * Reduce memory usage of the DescriptorPool type. 289 * Moved the zero-argument New() method on messages to the base class (internal 290 optimization). 291 * Unused return values marked with `PROTOBUF_MUST_USE_RESULT` are now 292 correctly attributed. 293 * Demotes PrintPath log for maps in MessageDifferencer down from WARNING to 294 INFO. 295 * Make sure FullMessageName() is always private. 296 * Fix race condition in EnumDescriptor. 297 * Remove MessageLite::GetMaybeArenaPointer. 298 299 Java 300 * Add @deprecated javadoc for set/get/has methods 301 * correctly decode \? escape sequence in text protos 302 * Avoid depending on Objects.requireNonNull() until we can verify that no 303 users are depending on older Android versions. 304 * disallow null string map values in put and putAll 305 * Add `@CheckReturnValue` to `ByteString` API. 306 * Make the `hasPresence` method public in `FieldDescriptor`. 307 * Report more detailed messages in Duration and Timestamp proto parsing 308 errors. 309 * New Timestamps.fromDate utility method that converts a java.util.Date to a 310 Timestamp proto object. 311 312 Kotlin 313 * Generated Kotlin code is Explicit API mode compatible 314 3152021-09-13 version 3.18.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 316 C++ 317 * Fix warnings raised by clang 11 (#8664) 318 * Make StringPiece constructible from std::string_view (#8707) 319 * Add missing capability attributes for LLVM 12 (#8714) 320 * Stop using std::iterator (deprecated in C++17). (#8741) 321 * Move field_access_listener from libprotobuf-lite to libprotobuf (#8775) 322 * Fix #7047 Safely handle setlocale (#8735) 323 * Remove deprecated version of SetTotalBytesLimit() (#8794) 324 * Support arena allocation of google::protobuf::AnyMetadata (#8758) 325 * Fix undefined symbol error around SharedCtor() (#8827) 326 * Fix default value of enum(int) in json_util with proto2 (#8835) 327 * Better Smaller ByteSizeLong 328 * Introduce event filters for inject_field_listener_events 329 * Reduce memory usage of DescriptorPool 330 * For lazy fields copy serialized form when allowed. 331 * Re-introduce the InlinedStringField class 332 * v2 access listener 333 * Reduce padding in the proto's ExtensionRegistry map. 334 * GetExtension performance optimizations 335 * Make tracker a static variable rather than call static functions 336 * Support extensions in field access listener 337 * Annotate MergeFrom for field access listener 338 * Fix incomplete types for field access listener 339 * Add map_entry/new_map_entry to SpecificField in MessageDifferencer. They 340 record the map items which are different in MessageDifferencer's reporter. 341 * Reduce binary size due to fieldless proto messages 342 * TextFormat: ParseInfoTree supports getting field end location in addition to 343 start. 344 * Fix repeated enum extension size in field listener 345 * Enable Any Text Expansion for Descriptors::DebugString() 346 * Switch from int{8,16,32,64} to int{8,16,32,64}_t 347 * Reduce memory usage of the DescriptorPool type. 348 349 Java 350 * Fix errorprone conflict (#8723) 351 * Removing deprecated TimeUtil class. (#8749) 352 * Optimized FieldDescriptor.valueOf() to avoid array copying. 353 * Removing deprecated TimeUtil class. 354 * Add Durations.parseUnchecked(String) and Timestamps.parseUnchecked(String) 355 * FieldMaskUtil: Add convenience method to mask the fields out of a given proto. 356 357 JavaScript 358 * Optimize binary parsing of repeated float64 359 * Fix for optimization when reading doubles from binary wire format 360 * Replace toArray implementation with toJSON. 361 362 Python 363 * Drops support for 2.7 and 3.5. 364 365 PHP 366 * Migrate PHP & Ruby to ABSL wyhash (#8854) 367 * Added support for PHP 8.1 (currently in RC1) to the C extension (#8964) 368 * Fixed PHP SEGV when constructing messages from a destructor. (#8969) 369 370 Ruby 371 * Move DSL implementation from C to pure Ruby (#8850) 372 * Fixed a memory bug with RepeatedField#+. (#8970) 373 374 Other 375 * [csharp] ByteString.CreateCodedInput should use ArraySegment offset and count (#8740) 376 * [ObjC] Add support for using the proto package to prefix symbols. (#8760) 377 * field_presence.md: fix Go example (#8788) 378 379 380 Kotlin 381 * Suppress NOTHING_TO_INLINE in Kotlin generated inline functions. 382 3832021-06-04 version 3.17.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 384 Python 385 * Note: This is the last release to support Python 2.7. Future releases will 386 require Python >= 3.5. 387 388 C++ 389 * Introduce FieldAccessListener. 390 * Stop emitting boilerplate {Copy/Merge}From in each ProtoBuf class 391 * Fixed some uninitialized variable warnings in generated_message_reflection.cc. 392 393 Kotlin 394 * Fix duplicate proto files error (#8699) 395 396 Java 397 * Fixed parser to check that we are at a proper limit when a sub-message has 398 finished parsing. 399 4002021-05-25 version 3.17.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 401 Kotlin 402 * Fix duplicate class error (#8653) 403 404 PHP 405 * Fixed SEGV in sub-message getters for well-known types when message is unset 406 (#8670) 407 4082021-05-07 version 3.17.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 409 PHP 410 * Fixed PHP memory leaks and arginfo errors. (#8614) 411 * Fixed JSON parser to allow multiple values from the same oneof as long as 412 all but one are null. 413 414 Ruby 415 * Fixed memory bug: properly root repeated/map field when assigning. (#8639) 416 * Fixed JSON parser to allow multiple values from the same oneof as long as 417 all but one are null. 418 419 4202021-05-07 version 3.17.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 421 422 Protocol Compiler 423 * Fix the generated source information for reserved values in Enums. 424 425 C++ 426 * Fix -Wunused-parameter in map<string, int> fields (fixes #8494) (#8500) 427 * Use byteswap.h when building against musl libc (#8503) 428 * Fix -Wundefined-inline error when using SharedCtor() or SharedDtor() (#8532) 429 * Fix bug where `Descriptor::DebugString()` printed proto3 synthetic oneofs. 430 * Provide stable versions of `SortAndUnique()`. 431 * Make sure to cache proto3 optional message fields when they are cleared. 432 * Expose UnsafeArena methods to Reflection. 433 * Use std::string::empty() rather than std::string::size() > 0. 434 435 Kotlin 436 * Restrict extension setter and getter operators to non-nullable T. 437 438 Java 439 * updating GSON and Guava to more recent versions (#8524) 440 * Reduce the time spent evaluating isExtensionNumber by storing the extension 441 ranges in a TreeMap for faster queries. This is particularly relevant for 442 protos which define a large number of extension ranges, for example when 443 each tag is defined as an extension. 444 * Fix java bytecode estimation logic for optional fields. 445 * Optimize Descriptor.isExtensionNumber. 446 447 Python 448 * Add MethodDescriptor.CopyToProto() (#8327) 449 * Remove unused python_protobuf.{cc,h} (#8513) 450 * Start publishing python aarch64 manylinux wheels normally (#8530) 451 * Fix constness issue detected by MSVC standard conforming mode (#8568) 452 * Make JSON parsing match C++ and Java when multiple fields from the same 453 oneof are present and all but one is null. 454 455 Ruby 456 * Add support for proto3 json_name in compiler and field definitions (#8356) 457 * Fixed memory leak of Ruby arena objects. (#8461) 458 * Fix source gem compilation (#8471) 459 * Fix various exceptions in Ruby on 64-bit Windows (#8563) 460 * Fix crash when calculating Message hash values on 64-bit Windows (#8565) 461 462 Conformance Tests 463 * Added a conformance test for the case of multiple fields from the same 464 oneof. 465 4662021-04-06 version 3.16.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 467 Other 468 * Opensourcing kotlin protos (#8272) 469 * Use a newer version of rules_proto, with the new rule `proto_descriptor_set` (#8469) 470 471 C++ 472 * Fix compiler warnings issue found in conformance_test_runner #8189 (#8190) 473 * Fix MinGW-w64 build issues. (#8286) 474 * [Protoc] C++ Resolved an issue where NO_DESTROY and CONSTINIT are in incorrect order (#8296) 475 * Fix PROTOBUF_CONSTINIT macro redefinition (#8323) 476 * Delete StringPiecePod (#8353) 477 * Fix gcc error: comparison of unsigned expression in '>= 0' is always … (#8309) 478 * Fix cmake install on iOS (#8301) 479 * Create a CMake option to control whether or not RTTI is enabled (#8347) 480 * Fix endian.h location on FreeBSD (#8351) 481 * Refactor util::Status (#8354) 482 * Make util::Status more similar to absl::Status (#8405) 483 * Fix -Wsuggest-destructor-override for generated C++ proto classes. (#8408) 484 * Refactor StatusOr and StringPiece (#8406) 485 * Refactor uint128 (#8416) 486 * The ::pb namespace is no longer exposed due to conflicts. 487 * Allow MessageDifferencer::TreatAsSet() (and friends) to override previous 488 calls instead of crashing. 489 * Reduce the size of generated proto headers for protos with `string` or 490 `bytes` fields. 491 * Move arena() operation on uncommon path to out-of-line routine 492 * For iterator-pair function parameter types, take both iterators by value. 493 * Code-space savings and perhaps some modest performance improvements in 494 RepeatedPtrField. 495 * Eliminate nullptr check from every tag parse. 496 * Remove unused _$name$_cached_byte_size_ fields. 497 * Serialize extension ranges together when not broken by a proto field in the 498 middle. 499 * Do out-of-line allocation and deallocation of string object in ArenaString. 500 * Streamline ParseContext::ParseMessage<T> to avoid code bloat and improve 501 performance. 502 * New member functions RepeatedField::Assign, RepeatedPtrField::{Add, Assign}. 503 * Fix undefined behavior warning due to innocuous uninitialization of value 504 on an error path. 505 * Avoid expensive inlined code space for encoding message length for messages 506 >= 128 bytes and instead do a procedure call to a shared out-of-line routine. 507 * util::DefaultFieldComparator will be final in a future version of protobuf. 508 Subclasses should inherit from SimpleFieldComparator instead. 509 510 C# 511 * Add .NET 5 target and improve WriteString performance with SIMD (#8147) 512 513 Java 514 * deps: update JUnit and Truth (#8319) 515 * Detect invalid overflow of byteLimit and return InvalidProtocolBufferException as documented. 516 * Exceptions thrown while reading from an InputStream in parseFrom are now 517 included as causes. 518 * Support potentially more efficient proto parsing from RopeByteStrings. 519 * Clarify runtime of ByteString.Output.toStringBuffer(). 520 * Added UnsafeByteOperations to protobuf-lite (#8426) 521 522 JavaScript 523 * Make Any.pack() chainable. 524 525 Python 526 * Fix some constness / char literal issues being found by MSVC standard conforming mode (#8344) 527 * Switch on "new" buffer API (#8339) 528 * Enable crosscompiling aarch64 python wheels under dockcross manylinux docker image (#8280) 529 * Fixed a bug in text format where a trailing colon was printed for repeated field. 530 * When TextFormat encounters a duplicate message map key, replace the current 531 one instead of merging. 532 533 Objective-C 534 * Move the class map to a CFDictionary. (#8328) 535 536 PHP 537 * read_property() handler is not supposed to return NULL (#8362) 538 * Changed parameter type from long to integer (#7613) 539 * fix: README supported PHP version for C extension (#8236) 540 541 Ruby 542 * Fixed quadratic memory usage when appending to arrays. (#8364) 543 * Fixed memory leak of Ruby arena objects. (#8461) 544 * Add support for proto3 json_name in compiler and field definitions. (#8356) 545 546 Other 547 * Some doc on AOT compilation and protobuf (#8294) 548 * [CMake] Ability to pass options to protoc executable from cmake (#8374) 549 * Add --fatal_warnings flag to treat warnings as errors (#8131) 550 * [bazel] Remove deprecated way to depend on googletest (#8396) 551 * add error returns missing from protoc to prevent it from exiting with… (#8409) 552 553 5542021-04-07 version 3.15.8 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 555 556 Ruby 557 * Fixed memory leak of Ruby arena objects (#8461) 558 5592021-04-02 version 3.15.7 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 560 561 C++ 562 * Remove the ::pb namespace (alias) (#8423) 563 564 Ruby 565 * Fix unbounded memory growth for Ruby <2.7 (#8429) 566 * Fixed message equality in cases where the message type is different (#8434) 567 5682021-03-10 version 3.15.6 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 569 570 Ruby 571 * Fixed bug in string comparison logic (#8386) 572 5732021-03-04 version 3.15.5 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 574 575 Ruby 576 * Fixed quadratic memory use in array append (#8379) 577 578 PHP 579 * Fixed quadratic memory use in array append (#8379) 580 581 C++ 582 * Do not disable RTTI by default in the CMake build (#8377) 583 5842021-03-02 version 3.15.4 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 585 586 Ruby 587 * Fixed SEGV when users pass nil messages (#8363) 588 * Fixed quadratic memory usage when appending to arrays (#8364) 589 590 C++ 591 * Create a CMake option to control whether or not RTTI is enabled (#8361) 592 593 PHP 594 * read_property() handler is not supposed to return NULL (#8362) 595 5962021-02-25 version 3.15.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 597 598 Ruby 599 * Ruby <2.7 now uses WeakMap too, which prevents memory leaks. (#8341) 600 6012021-02-23 version 3.15.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 602 603 Ruby 604 * Fix for FieldDescriptor.get(msg) (#8330) 605 606 C++ 607 * Fix PROTOBUF_CONSTINIT macro redefinition (#8323) 608 6092021-02-05 version 3.15.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 610 611 Ruby 612 * Bugfix for Message.[] for repeated or map fields (#8313) 613 6142021-02-05 version 3.15.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 615 616 Protocol Compiler 617 * Optional fields for proto3 are enabled by default, and no longer require 618 the --experimental_allow_proto3_optional flag. 619 620 C++ 621 * MessageDifferencer: fixed bug when using custom ignore with multiple 622 unknown fields 623 * Use init_seg in MSVC to push initialization to an earlier phase. 624 * Runtime no longer triggers -Wsign-compare warnings. 625 * Fixed -Wtautological-constant-out-of-range-compare warning. 626 * DynamicCastToGenerated works for nullptr input for even if RTTI is disabled 627 * Arena is refactored and optimized. 628 * Clarified/specified that the exact value of Arena::SpaceAllocated() is an 629 implementation detail users must not rely on. It should not be used in 630 unit tests. 631 * Change the signature of Any::PackFrom() to return false on error. 632 * Add fast reflection getter API for strings. 633 * Constant initialize the global message instances 634 * Avoid potential for missed wakeup in UnknownFieldSet 635 * Now Proto3 Oneof fields have "has" methods for checking their presence in 636 C++. 637 * Bugfix for NVCC 638 * Return early in _InternalSerialize for empty maps. 639 * Adding functionality for outputting map key values in proto path logging 640 output (does not affect comparison logic) and stop printing 'value' in the 641 path. The modified print functionality is in the 642 MessageDifferencer::StreamReporter. 643 * Fixed https://github.com/protocolbuffers/protobuf/issues/8129 644 * Ensure that null char symbol, package and file names do not result in a 645 crash. 646 * Constant initialize the global message instances 647 * Pretty print 'max' instead of numeric values in reserved ranges. 648 * Removed remaining instances of std::is_pod, which is deprecated in C++20. 649 * Changes to reduce code size for unknown field handling by making uncommon 650 cases out of line. 651 * Fix std::is_pod deprecated in C++20 (#7180) 652 * Fix some -Wunused-parameter warnings (#8053) 653 * Fix detecting file as directory on zOS issue #8051 (#8052) 654 * Don't include sys/param.h for _BYTE_ORDER (#8106) 655 * remove CMAKE_THREAD_LIBS_INIT from pkgconfig CFLAGS (#8154) 656 * Fix TextFormatMapTest.DynamicMessage issue#5136 (#8159) 657 * Fix for compiler warning issue#8145 (#8160) 658 * fix: support deprecated enums for GCC < 6 (#8164) 659 * Fix some warning when compiling with Visual Studio 2019 on x64 target (#8125) 660 661 Python 662 * Provided an override for the reverse() method that will reverse the internal 663 collection directly instead of using the other methods of the BaseContainer. 664 * MessageFactory.CreateProtoype can be overridden to customize class creation. 665 * Fix PyUnknownFields memory leak (#7928) 666 * Add macOS Big Sur compatibility (#8126) 667 668 JavaScript 669 * Generate `getDescriptor` methods with `*` as their `this` type. 670 * Enforce `let/const` for generated messages. 671 * js/binary/utils.js: Fix jspb.utils.joinUnsignedDecimalString to work with negative bitsLow and low but non-zero bitsHigh parameter. (#8170) 672 673 PHP 674 * Added support for PHP 8. (#8105) 675 * unregister INI entries and fix invalid read on shutdown (#8042) 676 * Fix PhpDoc comments for message accessors to include "|null". (#8136) 677 * fix: convert native PHP floats to single precision (#8187) 678 * Fixed PHP to support field numbers >=2**28. (#8235) 679 * feat: add support for deprecated fields to PHP compiler (#8223) 680 * Protect against stack overflow if the user derives from Message. (#8248) 681 * Fixed clone for Message, RepeatedField, and MapField. (#8245) 682 * Updated upb to allow nonzero offset minutes in JSON timestamps. (#8258) 683 684 Ruby 685 * Added support for Ruby 3. (#8184) 686 * Rewrote the data storage layer to be based on upb_msg objects from the 687 upb library. This should lead to much better parsing performance, 688 particularly for large messages. (#8184). 689 * Fill out JRuby support (#7923) 690 * [Ruby] Fix: (SIGSEGV) gRPC-Ruby issue on Windows. memory alloc infinite 691 recursion/run out of memory (#8195) 692 * Fix jruby support to handle messages nested more than 1 level deep (#8194) 693 694 Java 695 * Avoid possible UnsupportedOperationException when using CodedInputSteam 696 with a direct ByteBuffer. 697 * Make Durations.comparator() and Timestamps.comparator() Serializable. 698 * Add more detailed error information for dynamic message field type 699 validation failure 700 * Removed declarations of functions declared in java_names.h from 701 java_helpers.h. 702 * Now Proto3 Oneof fields have "has" methods for checking their presence in 703 Java. 704 * Annotates Java proto generated *_FIELD_NUMBER constants. 705 * Add -assumevalues to remove JvmMemoryAccessor on Android. 706 707 C# 708 * Fix parsing negative Int32Value that crosses segment boundary (#8035) 709 * Change ByteString to use memory and support unsafe create without copy (#7645) 710 * Optimize MapField serialization by removing MessageAdapter (#8143) 711 * Allow FileDescriptors to be parsed with extension registries (#8220) 712 * Optimize writing small strings (#8149) 713 7142020-11-11 version 3.14.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 715 716 Protocol Compiler 717 * The proto compiler no longer requires a .proto filename when it is not 718 generating code. 719 * Added flag `--deterministic_output` to `protoc --encode=...`. 720 * Fixed deadlock when using google.protobuf.Any embedded in aggregate options. 721 722 C++ 723 * Arenas are now unconditionally enabled. cc_enable_arenas no longer has 724 any effect. 725 * Removed inlined string support, which is incompatible with arenas. 726 * Fix a memory corruption bug in reflection when mixing optional and 727 non-optional fields. 728 * Make SpaceUsed() calculation more thorough for map fields. 729 * Add stack overflow protection for text format with unknown field values. 730 * FieldPath::FollowAll() now returns a bool to signal if an out-of-bounds 731 error was encountered. 732 * Performance improvements for Map. 733 * Minor formatting fix when dumping a descriptor to .proto format with 734 DebugString. 735 * UBSAN fix in RepeatedField (#2073). 736 * When running under ASAN, skip a test that makes huge allocations. 737 * Fixed a crash that could happen when creating more than 256 extensions in 738 a single message. 739 * Fix a crash in BuildFile when passing in invalid descriptor proto. 740 * Parser security fix when operating with CodedInputStream. 741 * Warn against the use of AllowUnknownExtension. 742 * Migrated to C++11 for-range loops instead of index-based loops where 743 possible. This fixes a lot of warnings when compiling with -Wsign-compare. 744 * Fix segment fault for proto3 optional (#7805) 745 * Adds a CMake option to build `libprotoc` separately (#7949) 746 747 Java 748 * Bugfix in mergeFrom() when a oneof has multiple message fields. 749 * Fix RopeByteString.RopeInputStream.read() returning -1 when told to read 750 0 bytes when not at EOF. 751 * Redefine remove(Object) on primitive repeated field Lists to avoid 752 autoboxing. 753 * Support "\u" escapes in textformat string literals. 754 * Trailing empty spaces are no longer ignored for FieldMask. 755 * Fix FieldMaskUtil.subtract to recursively remove mask. 756 * Mark enums with `@java.lang.Deprecated` if the proto enum has option 757 `deprecated = true;`. 758 * Adding forgotten duration.proto to the lite library (#7738) 759 760 Python 761 * Print google.protobuf.NullValue as null instead of "NULL_VALUE" when it is 762 used outside WKT Value/Struct. 763 * Fix bug occurring when attempting to deep copy an enum type in python 3. 764 * Add a setuptools extension for generating Python protobufs (#7783) 765 * Remove uses of pkg_resources in non-namespace packages. (#7902) 766 * [bazel/py] Omit google/__init__.py from the Protobuf runtime. (#7908) 767 * Removed the unnecessary setuptools package dependency for Python package (#7511) 768 * Fix PyUnknownFields memory leak (#7928) 769 770 PHP 771 * Added support for "==" to the PHP C extension (#7883) 772 * Added `==` operators for Map and Array. (#7900) 773 * Native C well-known types (#7944) 774 * Optimized away hex2bin() call in generated code (#8006) 775 * New version of upb, and a new hash function wyhash in third_party. (#8000) 776 * add missing hasOneof method to check presence of oneof fields (#8003) 777 778 Go: 779 * Update go_package options to reference google.golang.org/protobuf module. 780 781 C#: 782 * annotate ByteString.CopyFrom(ReadOnlySpan<byte>) as SecuritySafeCritical (#7701) 783 * Fix C# optional field reflection when there are regular fields too (#7705) 784 * Fix parsing negative Int32Value that crosses segment boundary (#8035) 785 786 Javascript: 787 * JS: parse (un)packed fields conditionally (#7379) 788 7892020-07-14 version 3.13.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 790 791 PHP: 792 * The C extension is completely rewritten. The new C extension has significantly 793 better parsing performance and fixes a handful of conformance issues. It will 794 also make it easier to add support for more features like proto2 and proto3 presence. 795 * The new C extension does not support PHP 5.x. PHP 5.x users can still use pure-PHP. 796 797 C++: 798 * Removed deprecated unsafe arena string accessors 799 * Enabled heterogeneous lookup for std::string keys in maps. 800 * Removed implicit conversion from StringPiece to std::string 801 * Fix use-after-destroy bug when the Map is allocated in the arena. 802 * Improved the randomness of map ordering 803 * Added stack overflow protection for text format with unknown fields 804 * Use std::hash for proto maps to help with portability. 805 * Added more Windows macros to proto whitelist. 806 * Arena constructors for map entry messages are now marked "explicit" 807 (for regular messages they were already explicit). 808 * Fix subtle aliasing bug in RepeatedField::Add 809 * Fix mismatch between MapEntry ByteSize and Serialize with respect to unset 810 fields. 811 812 Python: 813 * JSON format conformance fixes: 814 * Reject lowercase t for Timestamp json format. 815 * Print full_name directly for extensions (no camelCase). 816 * Reject boolean values for integer fields. 817 * Reject NaN, Infinity, -Infinity that is not quoted. 818 * Base64 fixes for bytes fields: accept URL-safe base64 and missing padding. 819 * Bugfix for fields/files named "async" or "await". 820 * Improved the error message when AttributeError is returned from __getattr__ 821 in EnumTypeWrapper. 822 823 Java: 824 * Fixed a bug where setting optional proto3 enums with setFooValue() would 825 not mark the value as present. 826 * Add Subtract function to FieldMaskUtil. 827 828 C#: 829 * Dropped support for netstandard1.0 (replaced by support for netstandard1.1). 830 This was required to modernize the parsing stack to use the `Span<byte>` 831 type internally. (#7351) 832 * Add `ParseFrom(ReadOnlySequence<byte>)` method to enable GC friendly 833 parsing with reduced allocations and buffer copies. (#7351) 834 * Add support for serialization directly to a `IBufferWriter<byte>` or 835 to a `Span<byte>` to enable GC friendly serialization. 836 The new API is available as extension methods on the `IMessage` type. (#7576) 837 * Add `GOOGLE_PROTOBUF_REFSTRUCT_COMPATIBILITY_MODE` define to make 838 generated code compatible with old C# compilers (pre-roslyn compilers 839 from .NET framework and old versions of mono) that do not support 840 ref structs. Users that are still on a legacy stack that does 841 not support C# 7.2 compiler might need to use the new define 842 in their projects to be able to build the newly generated code. (#7490) 843 * Due to the major overhaul of parsing and serialization internals (#7351 and #7576), 844 it is recommended to regenerate your generated code to achieve the best 845 performance (the legacy generated code will still work, but might incur 846 a slight performance penalty). 847 8482020-07-28 version 3.12.4 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 849 850This release contains no significant changes, but exists because 3.12.3 was 851mistakenly tagged at the wrong commit. 852 8532020-06-01 version 3.12.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 854 855 Objective-C 856 * Tweak the union used for Extensions to support old generated code. #7573 857 8582020-05-26 version 3.12.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 859 860 C++ 861 * Simplified the template export macros to fix the build for mingw32. (#7539) 862 863 Objective-C 864 * Fix for the :protobuf_objc target in the Bazel BUILD file. (#7538) 865 8662020-05-20 version 3.12.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 867 868 Ruby 869 * Re-add binary gems for Ruby 2.3 and 2.4. These are EOL upstream, however 870 many people still use them and dropping support will require more 871 coordination. 872 8732020-05-12 version 3.12.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 874 875 Protocol Compiler 876 * [experimental] Singular, non-message typed fields in proto3 now support 877 presence tracking. This is enabled by adding the "optional" field label and 878 passing the --experimental_allow_proto3_optional flag to protoc. 879 * For usage info, see docs/field_presence.md. 880 * During this experimental phase, code generators should update to support 881 proto3 presence, see docs/implementing_proto3_presence.md for instructions. 882 * Allow duplicate symbol names when multiple descriptor sets are passed on 883 the command-line, to match the behavior when multiple .proto files are passed. 884 * Deterministic `protoc --descriptor_set_out` (#7175) 885 886 C++ 887 * [experimental] Added proto3 presence support. 888 * New descriptor APIs to support proto3 presence. 889 * Enable Arenas by default on all .proto files. 890 * Documented that users are not allowed to subclass Message or MessageLite. 891 * Mark generated classes as final; inheriting from protos is strongly discouraged. 892 * Add stack overflow protection for text format with unknown fields. 893 * Add accessors for map key and value FieldDescriptors. 894 * Add FieldMaskUtil::FromFieldNumbers(). 895 * MessageDifferencer: use ParsePartial() on Any fields so the diff does not 896 fail when there are missing required fields. 897 * ReflectionOps::Merge(): lookup messages in the right factory, if it can. 898 * Added Descriptor::WellKnownTypes enum and Descriptor::well_known_type() 899 accessor as an easier way of determining if a message is a Well-Known Type. 900 * Optimized RepeatedField::Add() when it is used in a loop. 901 * Made proto move/swap more efficient. 902 * De-virtualize the GetArena() method in MessageLite. 903 * Improves performance of json_stream_parser.cc by factor 1000 (#7230) 904 * bug: #7076 undefine Windows OUT and OPTIONAL macros (#7087) 905 * Fixed a bug in FieldDescriptor::DebugString() that would erroneously print 906 an "optional" label for a field in a oneof. 907 * Fix bug in parsing bool extensions that assumed they are always 1 byte. 908 * Fix off-by-one error in FieldOptions::ByteSize() when extensions are present. 909 * Clarified the comments to show an example of the difference between 910 Descriptor::extension and DescriptorPool::FindAllExtensions. 911 * Add a compiler option 'code_size' to force optimize_for=code_size on all 912 protos where this is possible. 913 914 Java 915 * [experimental] Added proto3 presence support. 916 * Mark java enum _VALUE constants as @Deprecated if the enum field is deprecated 917 * reduce <clinit> size for enums with allow_alias set to true. 918 * Sort map fields alphabetically by the field's key when printing textproto. 919 * Fixed a bug in map sorting that appeared in -rc1 and -rc2 (#7508). 920 * TextFormat.merge() handles Any as top level type. 921 * Throw a descriptive IllegalArgumentException when calling 922 getValueDescriptor() on enum special value UNRECOGNIZED instead of 923 ArrayIndexOutOfBoundsException. 924 * Fixed an issue with JsonFormat.printer() where setting printingEnumsAsInts() 925 would override the configuration passed into includingDefaultValueFields(). 926 * Implement overrides of indexOf() and contains() on primitive lists returned 927 for repeated fields to avoid autoboxing the list contents. 928 * Add overload to FieldMaskUtil.fromStringList that accepts a descriptor. 929 * [bazel] Move Java runtime/toolchains into //java (#7190) 930 931 Python 932 * [experimental] Added proto3 presence support. 933 * [experimental] fast import protobuf module, only works with cpp generated code linked in. 934 * Truncate 'float' fields to 4 bytes of precision in setters for pure-Python 935 implementation (C++ extension was already doing this). 936 * Fixed a memory leak in C++ bindings. 937 * Added a deprecation warning when code tries to create Descriptor objects 938 directly. 939 * Fix unintended comparison between bytes and string in descriptor.py. 940 * Avoid printing excess digits for float fields in TextFormat. 941 * Remove Python 2.5 syntax compatibility from the proto compiler generated _pb2.py module code. 942 * Drop 3.3, 3.4 and use single version docker images for all python tests (#7396) 943 944 JavaScript 945 * Fix js message pivot selection (#6813) 946 947 PHP 948 * Persistent Descriptor Pool (#6899) 949 * Implement lazy loading of php class for proto messages (#6911) 950 * Correct @return in Any.unpack docblock (#7089) 951 * Ignore unknown enum value when ignore_unknown specified (#7455) 952 953 Ruby 954 * [experimental] Implemented proto3 presence for Ruby. (#7406) 955 * Stop building binary gems for ruby <2.5 (#7453) 956 * Fix for wrappers with a zero value (#7195) 957 * Fix for JSON serialization of 0/empty-valued wrapper types (#7198) 958 * Call "Class#new" over rb_class_new_instance in decoding (#7352) 959 * Build extensions for Ruby 2.7 (#7027) 960 * assigning 'nil' to submessage should clear the field. (#7397) 961 962 C# 963 * [experimental] Add support for proto3 presence fields in C# (#7382) 964 * Mark GetOption API as obsolete and expose the "GetOptions()" method on descriptors instead (#7491) 965 * Remove Has/Clear members for C# message fields in proto2 (#7429) 966 * Enforce recursion depth checking for unknown fields (#7132) 967 * Fix conformance test failures for Google.Protobuf (#6910) 968 * Cleanup various bits of Google.Protobuf (#6674) 969 * Fix latest ArgumentException for C# extensions (#6938) 970 * Remove unnecessary branch from ReadTag (#7289) 971 972 Objective-C 973 * [experimental] ObjC Proto3 optional support (#7421) 974 * Block subclassing of generated classes (#7124) 975 * Use references to Obj C classes instead of names in descriptors. (#7026) 976 * Revisit how the WKTs are bundled with ObjC. (#7173) 977 978 Other 979 * Add a proto_lang_toolchain for javalite (#6882) 980 * [bazel] Update gtest and deprecate //external:{gtest,gtest_main} (#7237) 981 * Add application note for explicit presence tracking. (#7390) 982 * Howto doc for implementing proto3 presence in a code generator. (#7407) 983 984 9852020-02-14 version 3.11.4 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 986 987 C# 988 * Fix latest ArgumentException for C# extensions (#7188) 989 * Enforce recursion depth checking for unknown fields (#7210) 990 991 Ruby 992 * Fix wrappers with a zero value (#7195) 993 * Fix JSON serialization of 0/empty-valued wrapper types (#7198) 994 9952020-01-31 version 3.11.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 996 997 C++ 998 * Add OUT and OPTIONAL to windows portability files (#7087) 999 1000 PHP 1001 * Refactored ulong to zend_ulong for php7.4 compatibility (#7147) 1002 * Call register_class before getClass from desc to fix segfault (#7077) 1003 1004 10052019-12-10 version 3.11.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 1006 1007 PHP 1008 * Make c extension portable for php 7.4 (#6968) 1009 1010 10112019-12-02 version 3.11.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 1012 1013 PHP 1014 * Extern declare protobuf_globals (#6946) 1015 1016 10172019-11-19 version 3.11.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 1018 1019 C++ 1020 * Make serialization method naming consistent 1021 * Make proto runtime + generated code free of deprecation warnings 1022 * Moved ShutdownProtobufLibrary() to message_lite.h. For backward compatibility a declaration is still available in stubs/common.h, but users should prefer message_lite.h 1023 * Removed non-namespace macro EXPECT_OK() 1024 * Removed mathlimits.h from stubs in favor of using std::numeric_limits from C++11 1025 * Fixed bug in parser when ending on a group tag 1026 * Add a helper function to UnknownFieldSet to deal with the changing return value of message::unknown_fields() 1027 * Fix incorrect use of string_view iterators 1028 * Support direct pickling of nested messages 1029 * Skip extension tag validation for MessageSet if unknown dependencies are allowed 1030 * Updated deprecation macros to annotate deprecated code (#6612) 1031 * Remove conversion warning in MapEntryFuncs::ByteSizeLong (#6766) 1032 * Revert "Make shared libraries be able to link to MSVC static runtime libraries, so that VC runtime is not required." (#6914) 1033 1034 Java 1035 * Remove the usage of MethodHandle, so that Android users prior to API version 26 can use protobuf-java 1036 * Publish ProGuard config for javalite 1037 * Fix for StrictMode disk read violation in ExtensionRegistryLite 1038 * Include part of the ByteString's content in its toString(). 1039 * Include unknown fields when merging proto3 messages in Java lite builders 1040 1041 Python 1042 * Add float_precision option in json format printer 1043 * Optionally print bytes fields as messages in unknown fields, if possible 1044 * FieldPath: fix testing IsSet on root path '' 1045 * Experimental code gen (fast import protobuf module) which only work with cpp generated code linked in 1046 1047 JavaScript 1048 * Remove guard for Symbol iterator for jspb.Map 1049 1050 PHP 1051 * Avoid too much overhead in layout_init (#6716) 1052 * Lazily Create Singular Wrapper Message (#6833) 1053 * Implement lazy loading of php class for proto messages (#6911) 1054 1055 Ruby 1056 * Ruby lazy wrappers optimization (#6797) 1057 1058 C# 1059 * (RepeatedField): Capacity property to resize the internal array (#6530) 1060 * Experimental proto2 support is now officially available (#4642, #5183, #5350, #5936) 1061 * Getting started doc: https://github.com/protocolbuffers/protobuf/blob/master/docs/csharp/proto2.md 1062 * Add length checks to ExtensionCollection (#6759) 1063 * Optimize parsing of some primitive and wrapper types (#6843) 1064 * Use 3 parameter Encoding.GetString for default string values (#6828) 1065 * Change _Extensions property to normal body rather than expression (#6856) 1066 1067 Objective C 1068 * Fixed unaligned reads for 32bit arm with newer Xcode versions (#6678) 1069 1070 10712019-09-03 version 3.10.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 1072 1073 C++ 1074 * Switch the proto parser to the faster MOMI parser. 1075 * Properly escape Struct keys in the proto3 JSON serializer. 1076 * Fix crash on uninitialized map entries. 1077 * Informed the compiler of has-bit invariant to produce better code 1078 * Unused imports of files defining descriptor extensions will now be reported 1079 * Add proto2::util::RemoveSubranges to remove multiple subranges in linear time. 1080 * Added BaseTextGenerator::GetCurrentIndentationSize() 1081 * Made implicit weak fields compatible with the Apple linker 1082 * Support 32 bit values for ProtoStreamObjectWriter to Struct. 1083 * Removed the internal-only header coded_stream_inl.h and the internal-only methods defined there. 1084 * Enforced no SWIG wrapping of descriptor_database.h (other headers already had this restriction). 1085 * Implementation of the equivalent of the MOMI parser for serialization. This removes one of the two serialization routines, by making the fast array serialization routine completely general. SerializeToCodedStream can now be implemented in terms of the much much faster array serialization. The array serialization regresses slightly, but when array serialization is not possible this wins big. 1086 * Do not convert unknown field name to snake case to accurately report error. 1087 * Fix a UBSAN warnings. (#6333) 1088 * Add podspec for C++ (#6404) 1089 * protoc: fix source code info location for missing label (#6436) 1090 * C++ Add move constructor for Reflection's SetString (#6477) 1091 1092 Java 1093 * Call loadDescriptor outside of synchronized block to remove one possible source of deadlock. 1094 * Have oneof enums implement a separate interface (other than EnumLite) for clarity. 1095 * Opensource Android Memory Accessors 1096 * Update TextFormat to make use of the new TypeRegistry. 1097 * Support getFieldBuilder and getRepeatedFieldBuilder in ExtendableBuilder 1098 * Update JsonFormat to make use of the new TypeRegistry. 1099 * Add proguard config generator for GmmBenchmarkSuiteLite. 1100 * Change ProtobufArrayList to use Object[] instead of ArrayList for 5-10% faster parsing 1101 * Implement ProtobufArrayList.add(E) for 20% (5%-40%) faster overall protolite2 parsing 1102 * Make a copy of JsonFormat.TypeRegistry at the protobuf top level package. This will eventually replace JsonFormat.TypeRegistry. 1103 * Fix javadoc warnings in generated files (#6231) 1104 * Java: Add Automatic-Module-Name entries to the Manifest (#6568) 1105 1106 Python 1107 * Add descriptor methods in descriptor_pool are deprecated. 1108 * Uses explicit imports to prevent multithread test failures in py3. 1109 * Added __delitem__ for Python extension dict 1110 * Update six version to 1.12.0 and fix legacy_create_init issue (#6391) 1111 1112 JavaScript 1113 * Remove deprecated boolean option to getResultBase64String(). 1114 * Fix sint64 zig-zag encoding. 1115 * Simplify hash64 string conversion to avoid DIGIT array. Should reduce overhead if these functions aren't used, and be more efficient by avoiding linear array searches. 1116 * Change the parameter types of binaryReaderFn in ExtensionFieldBinaryInfo to (number, ?, ?). 1117 * Create dates.ts and time_of_days.ts to mirror Java versions. This is a near-identical conversion of c.g.type.util.{Dates,TimeOfDays} respectively. 1118 * Migrate moneys to TypeScript. 1119 1120 PHP 1121 * Fix incorrect leap day for Timestamp (#6696) 1122 * Initialize well known type values (#6713) 1123 1124 Ruby 1125 * Fix scope resolution for Google namespace (#5878) 1126 * Support hashes for struct initializers (#5716) 1127 * Optimized away the creation of empty string objects. (#6502) 1128 * Roll forward Ruby upb changes now that protobuf Ruby build is fixed (#5866) 1129 * Optimized layout_mark() for Ruby (#6521) 1130 * Optimization for layout_init() (#6547) 1131 * Fix for GC of Ruby map frames. (#6533) 1132 * Fixed leap year handling by reworking upb_mktime() -> upb_timegm(). (#6695) 1133 1134 Objective C 1135 * Remove OSReadLittle* due to alignment requirements (#6678) 1136 * Don't use unions and instead use memcpy for the type swaps. (#6672) 1137 1138 Other 1139 * Override CocoaPods module to lowercase (#6464) 1140 1141 11422019-06-28 version 3.9.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 1143 1144 C++ 1145 * Optimize and simplify implementation of RepeatedPtrFieldBase 1146 * Don't create unnecessary unknown field sets. 1147 * Remove branch from accessors to repeated field element array. 1148 * Added delimited parse and serialize util. 1149 * Reduce size by not emitting constants for fieldnumbers 1150 * Fix a bug when comparing finite and infinite field values with explicit tolerances. 1151 * TextFormat::Parser should use a custom Finder to look up extensions by number if one is provided. 1152 * Add MessageLite::Utf8DebugString() to make MessageLite more compatible with Message. 1153 * Fail fast for better performance in DescriptorPool::FindExtensionByNumber() if descriptor has no defined extensions. 1154 * Adding the file name to help debug colliding extensions 1155 * Added FieldDescriptor::PrintableNameForExtension() and DescriptorPool::FindExtensionByPrintableName(). 1156 The latter will replace Reflection::FindKnownExtensionByName(). 1157 * Replace NULL with nullptr 1158 * Created a new Add method in repeated field that allows adding a range of elements all at once. 1159 * Enabled enum name-to-value mapping functions for C++ lite 1160 * Avoid dynamic initialization in descriptor.proto generated code 1161 * Move stream functions to MessageLite from Message. 1162 * Move all zero_copy_stream functionality to io_lite. 1163 * Do not create array of matched fields for simple repeated fields 1164 * Enabling silent mode by default to reduce make compilation noise. (#6237) 1165 1166 Java 1167 * Expose TextFormat.Printer and make it configurable. Deprecate the static methods. 1168 * Library for constructing google.protobuf.Struct and google.protobuf.Value 1169 * Make OneofDescriptor extend GenericDescriptor. 1170 * Expose streamingness of service methods from MethodDescriptor. 1171 * Fix a bug where TextFormat fails to parse Any filed with > 1 embedded message sub-fields. 1172 * Establish consistent JsonFormat behavior for nulls in oneofs, regardless of order. 1173 * Update GSON version to 3.8.5. (#6268) 1174 * Add `protobuf_java_lite` Bazel target. (#6177) 1175 1176 Python 1177 * Change implementation of Name() for enums that allow aliases in proto2 in Python 1178 to be in line with claims in C++ implementation (to return first value). 1179 * Explicitly say what field cannot be set when the new value fails a type check. 1180 * Duplicate register in descriptor pool will raise errors 1181 * Add __slots__ to all well_known_types classes, custom attributes are not allowed anymore. 1182 * text_format only present 8 valid digits for float fields by default 1183 1184 JavaScript 1185 * Add Oneof enum to the list of goog.provide 1186 1187 PHP 1188 * Make php message class final to avoid mocking. (#6277) 1189 * Rename get/setXXXValue to get/setXXXWrapper. (#6295) 1190 1191 Ruby 1192 * Remove to_hash methods. (#6166) 1193 1194 11952019-04-29 version 3.8.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 1196 1197 C++ 1198 * Use std::atomic<int32> in case of myriad2 platform 1199 * Always declare enums to be int-sized 1200 * Added DebugString() and ShortDebugString() methods on MessageLite 1201 * Specialized different parse loop control flows 1202 * Make hasbits potentially in register. The or's start forming an obstacle because it's a read modify store on the same mem address on each iteration. 1203 * Move to an internal MACRO for parser validity checks. 1204 * Improve map parsing performance. 1205 * Make MergePartialFromCodedStream non virtual. This allows direct calls, potential inlining and is also a code health improvement 1206 * Add an overall limit to parse_context to prevent reading past it. This allows to remove a annoying level of indirection. 1207 * Fix a mistake, we shouldn't verify map key/value strings for utf8 in opt mode for proto2. 1208 * Further improvements to cut binary size. 1209 * Prepare to make MergePartialFromCodedStream non-virtual. 1210 * A report on some interesting behavior change in python (caused by b/27494216) made me realize there is a check that needs to be done in case the parse ended on a end group tag. 1211 * Add a note of caution to the comments around skip in CodedOutputStream. 1212 * Simplify end check. 1213 * Add overload for ParseMessage for MessageLite/Message types. If the explicit type is not known inlining won't help de-virtualizing the virtual call. 1214 * Reduce linker input. It turns out that ParseMessage is not inlined, producing template instantiations that are used only once and save nothing but cost more. 1215 * Improve the parser. 1216 * [c++17] Changed proto2::RepeatedPtrField iterators to no longer derive from the deprecated std::iterator class. 1217 * Change the default value of case_insensitive_enum_parsing to false for JsonStringToMessage. 1218 * Add a warning if a field name doesn't match the style guide. 1219 * Fix TextFormat not round-trip correctly when float value is max float. 1220 * Added locationed info for some errors at compiler 1221 * Python reserved keywords are now working with getattr()/setattr() for most descriptors. 1222 * Added AllowUnknownField() in text_format 1223 * Append '_' to C++ reserved keywords for message, enum, extension 1224 * Fix MSVC warning C4244 in protobuf's parse_context.h. 1225 * Updating Iterators to be compatible with C++17 in MSVC. 1226 * Use capability annotation in mutex.h 1227 * Fix "UndefinedBehaviorSanitizer: cfi-bad-type" 1228 * CriticalSectionLock class as a lightweight replacement for std::mutex on Windows platforms. 1229 * Removed vestigial wire_format_lite_inl.h 1230 1231 C# 1232 * Added System.Memory dependency. 1233 1234 Java 1235 * Make Java protoc code generator ignore optimize_for LITE_RUNTIME. Users should instead use the Java lite protoc plugin. 1236 * Change Extension getMessageDefaultInstance() to return Message instead of MessageLite. 1237 * Prevent malicious input streams from leaking buffers for ByteString or ByteBuffer parsing. 1238 * Release new Javalite runtime. 1239 * Show warning in case potential file name conflict. 1240 * Allow Java reserved keywords to be used in extensions. 1241 * Added setAllowUnknownFields() in text format 1242 * Add memoization to ExtensionRegistryLite.getEmptyRegistry() 1243 * Improve performance of CodedOutputStream.writeUInt32NoTag 1244 * Add an optimized mismatch-finding algorithm to UnsafeUtil. 1245 * When serializing uint32 varints, check that we have MAX_VARINT32_SIZE bytes left, not just MAX_VARINT_SIZE. 1246 * Minor optimization to RopeByteString.PieceIterator 1247 1248 JavaScript 1249 * Simplify generated toObject code when the default value is used. 1250 1251 Python 1252 * Changes implementation of Name() for enums that allow aliases in proto2 in Python to be in line with claims in C++ implementation (to return first value). 1253 * Added double_format option in text format printer. 1254 * Added iter and __contains__ to extension dict 1255 * Added allow_unknown_field option in python text format parser 1256 * Fixed Timestamp.ToDatetime() loses precision issue 1257 * Support unknown field in text format printer. 1258 * Float field will be convert to inf if bigger than struct.unpack('f', b'\xff\xff\x7f\x7f')[0] which is about 3.4028234664e+38, 1259 convert to -inf if smaller than -3.4028234664e+38 1260 * Allowed casting str->bytes in Message.__setstate__ 1261 1262 Ruby 1263 * Helper methods to get enum name for Ruby. 1264 1265 12662019-01-24 version 3.7.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 1267 1268 C++ 1269 * Introduced new MOMI (maybe-outside-memory-interval) parser. 1270 * Add an option to json_util to parse enum as case-insensitive. In the future, enum parsing in json_util will become case-sensitive. 1271 * Added conformance test for enum aliases 1272 * Added support for --cpp_out=speed:... 1273 * Added use of C++ override keyword where appropriate 1274 * Many other cleanups and fixes. 1275 1276 Java 1277 * Fix illegal reflective access warning in JDK 9+ 1278 * Add BOM 1279 1280 Python 1281 * Added Python 3.7 compatibility. 1282 * Modified ParseFromString to return bytes parsed . 1283 * Introduce Proto C API. 1284 * FindFileContainingSymbol in descriptor pool is now able to find field and enum values. 1285 * reflection.MakeClass() and reflection.ParseMessage() are deprecated. 1286 * Added DescriptorPool.FindMethodByName() method in pure python (c extension already has it) 1287 * Flipped proto3 to preserve unknown fields by default. 1288 * Added support for memoryview in python3 proto message parsing. 1289 * Added MergeFrom for repeated scalar fields in c extension (pure python already has it) 1290 * Surrogates are now rejected at setters in python3. 1291 * Added public unknown field API. 1292 * RecursionLimit is also set to max if allow_oversize_protos is enabled. 1293 * Disallow duplicate scalars in proto3 text_format parse. 1294 * Fix some segment faults for c extension map field. 1295 1296 PHP 1297 * Most issues for json encoding/decoding in the c extension have been fixed. There are still some edge cases not fixed. For more details, check conformance/failure_list_php_c.txt. 1298 * Supports php 7.3 1299 * Added helper methods to convert between enum values and names. 1300 * Allow setting/getting wrapper message fields using primitive values. 1301 * Various bug fixes. 1302 1303 Ruby 1304 * Ruby 2.6 support. 1305 * Drops support for ruby < 2.3. 1306 * Most issues for json encoding/decoding in the c extension have been fixed. There are still some edge cases not fixed. For more details, check conformance/failure_list_ruby.txt. 1307 * Json parsing can specify an option to ignore unknown fields: msg.decode_json(data, {ignore_unknown_fields: true}). 1308 * Added support for proto2 syntax (partially). 1309 * Various bug fixes. 1310 1311 Csharp 1312 * More support for FieldMask include merge, intersect and more. 1313 * Increasing the default recursion limit to 100. 1314 * Support loading FileDescriptors dynamically. 1315 * Provide access to comments from descriptors. 1316 * Added Any.Is method. 1317 * Compatible with C# 6 1318 * Added IComparable and comparison operators on Timestamp. 1319 1320 Objective C 1321 * Add ability to introspect list of enum values (#4678) 1322 * Copy the value when setting message/data fields (#5215) 1323 * Support suppressing the objc package prefix checks on a list of files (#5309) 1324 * More complete keyword and NSObject method (via categories) checks for field names, can result in more fields being rename, but avoids the collisions at runtime (#5289) 1325 * Small fixes to TextFormat generation for extensions (#5362) 1326 * Provide more details/context in deprecation messages (#5412) 1327 * Array/Dictionary enumeration blocks NS_NOESCAPE annotation for Swift (#5421) 1328 * Properly annotate extensions for ARC when their names imply behaviors (#5427) 1329 * Enum alias name collision improvements (#5480) 1330 1331 13322018-07-27 version 3.6.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 1333 1334 C++ 1335 * Introduced workaround for Windows issue with std::atomic and std::once_flag 1336 initialization (#4777, #4773). 1337 1338 PHP 1339 * Added compatibility with PHP 7.3 (#4898). 1340 1341 Ruby 1342 * Fixed Ruby crash involving Any encoding (#4718). 1343 13442018-06-01 version 3.6.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 1345 1346 C++ 1347 * Starting from this release, we now require C++11. For those we cannot yet 1348 upgrade to C++11, we will try to keep the 3.5.x branch updated with 1349 critical bug fixes only. If you have any concerns about this, please 1350 comment on issue #2780. 1351 * Moved to C++11 types like std::atomic and std::unique_ptr and away from our 1352 old custom-built equivalents. 1353 * Added support for repeated message fields in lite protos using implicit 1354 weak fields. This is an experimental feature that allows the linker to 1355 strip out more unused messages than previously was possible. 1356 * Fixed SourceCodeInfo for interpreted options and extension range options. 1357 * Fixed always_print_enums_as_ints option for JSON serialization. 1358 * Added support for ignoring unknown enum values when parsing JSON. 1359 * Create std::string in Arena memory. 1360 * Fixed ValidateDateTime to correctly check the day. 1361 * Fixed bug in ZeroCopyStreamByteSink. 1362 * Various other cleanups and fixes. 1363 1364 Java 1365 * Dropped support for Java 6. 1366 * Added a UTF-8 decoder that uses Unsafe to directly decode a byte buffer. 1367 * Added deprecation annotations to generated code for deprecated oneof 1368 fields. 1369 * Fixed map field serialization in DynamicMessage. 1370 * Cleanup and documentation for Java Lite runtime. 1371 * Various other fixes and cleanups 1372 * Fixed unboxed arraylists to handle an edge case 1373 * Improved performance for copying between unboxed arraylists 1374 * Fixed lite protobuf to avoid Java compiler warnings 1375 * Improved test coverage for lite runtime 1376 * Performance improvements for lite runtime 1377 1378 Python 1379 * Fixed bytes/string map key incompatibility between C++ and pure-Python 1380 implementations (issue #4029) 1381 * Added __init__.py files to compiler and util subpackages 1382 * Use /MT for all Windows versions 1383 * Fixed an issue affecting the Python-C++ implementation when used with 1384 Cython (issue #2896) 1385 * Various text format fixes 1386 * Various fixes to resolve behavior differences between the pure-Python and 1387 Python-C++ implementations 1388 1389 PHP 1390 * Added php_metadata_namespace to control the file path of generated metadata 1391 file. 1392 * Changed generated classes of nested message/enum. E.g., Foo.Bar, which 1393 previously generates Foo_Bar, now generates Foo/Bar 1394 * Added array constructor. When creating a message, users can pass a php 1395 array whose content is field name to value pairs into constructor. The 1396 created message will be initialized according to the array. Note that 1397 message field should use a message value instead of a sub-array. 1398 * Various bug fixes. 1399 1400 Objective-C 1401 * We removed some helper class methods from GPBDictionary to shrink the size 1402 of the library, the functionary is still there, but you may need to do some 1403 specific +alloc / -init… methods instead. 1404 * Minor improvements in the performance of object field getters/setters by 1405 avoiding some memory management overhead. 1406 * Fix a memory leak during the raising of some errors. 1407 * Make header importing completely order independent. 1408 * Small code improvements for things the undefined behaviors compiler option 1409 was flagging. 1410 1411 Ruby 1412 * Added ruby_package file option to control the module of generated class. 1413 * Various bug fixes. 1414 1415 Javascript 1416 * Allow setting string to int64 field. 1417 1418 Csharp 1419 * Unknown fields are now parsed and then sent back on the wire. They can be 1420 discarded at parse time via a CodedInputStream option. 1421 * Movement towards working with .NET 3.5 and Unity 1422 * Expression trees are no longer used 1423 * AOT generics issues in Unity/il2cpp have a workaround (see this commit for 1424 details) 1425 * Floating point values are now compared bitwise (affects NaN value 1426 comparisons) 1427 * The default size limit when parsing is now 2GB rather than 64MB 1428 * MessageParser now supports parsing from a slice of a byte array 1429 * JSON list parsing now accepts null values where the underlying proto 1430 representation does 1431 14322017-12-20 version 3.5.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 1433 Planned Future Changes 1434 * Make C++ implementation C++11 only: we plan to require C++11 to build 1435 protobuf code starting from 3.6.0 release. Please join this github issue: 1436 https://github.com/protocolbuffers/protobuf/issues/2780 to provide your feedback. 1437 1438 protoc 1439 * Fixed a bug introduced in 3.5.0 and protoc in Windows now accepts non-ascii 1440 characters in paths again. 1441 1442 C++ 1443 * Removed several usages of C++11 features in the code base. 1444 * Fixed some compiler warnings. 1445 1446 PHP 1447 * Fixed memory leak in C-extension implementation. 1448 * Added discardUnknokwnFields API. 1449 * Removed duplicated typedef in C-extension headers. 1450 * Avoided calling private php methods (timelib_update_ts). 1451 * Fixed Any.php to use fully-qualified name for DescriptorPool. 1452 1453 Ruby 1454 * Added Google_Protobuf_discard_unknown for discarding unknown fields in 1455 messages. 1456 1457 C# 1458 * Unknown fields are now preserved by default. 1459 * Floating point values are now bitwise compared, affecting message equality 1460 check and Contains() API in map and repeated fields. 1461 1462 14632017-11-13 version 3.5.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 1464 Planned Future Changes 1465 * Make C++ implementation C++11 only: we plan to require C++11 to build 1466 protobuf code starting from 3.6.0 release. Please join this github issue: 1467 https://github.com/protocolbuffers/protobuf/issues/2780 to provide your feedback. 1468 1469 General 1470 * Unknown fields are now preserved in proto3 for most of the language 1471 implementations for proto3 by default. See the per-language section for 1472 details. 1473 * reserve keyword are now supported in enums 1474 1475 C++ 1476 * Proto3 messages are now preserving unknown fields by default. If you rely on 1477 unknowns fields being dropped. Please use DiscardUnknownFields() explicitly. 1478 * Deprecated the unsafe_arena_release_* and unsafe_arena_add_allocated_* 1479 methods for string fields. 1480 * Added move constructor and move assignment to RepeatedField, 1481 RepeatedPtrField and google::protobuf::Any. 1482 * Added perfect forwarding in Arena::CreateMessage 1483 * In-progress experimental support for implicit weak fields with lite protos. 1484 This feature allows the linker to strip out more unused messages and reduce 1485 binary size. 1486 * Various performance optimizations. 1487 1488 Java 1489 * Proto3 messages are now preserving unknown fields by default. If you’d like 1490 to drop unknown fields, please use the DiscardUnknownFieldsParser API. For 1491 example: 1492 Parser<Foo> parser = DiscardUnknownFieldsParser.wrap(Foo.parser()); 1493 Foo foo = parser.parseFrom(input); 1494 * Added a new CodedInputStream decoder for Iterable<ByteBuffer> with direct 1495 ByteBuffers. 1496 * TextFormat now prints unknown length-delimited fields as messages if 1497 possible. 1498 * FieldMaskUtil.merge() no longer creates unnecessary empty messages when a 1499 message field is unset in both source message and destination message. 1500 * Various performance optimizations. 1501 1502 Python 1503 * Proto3 messages are now preserving unknown fields by default. Use 1504 message.DiscardUnknownFields() to drop unknown fields. 1505 * Add FieldDescriptor.file in generated code. 1506 * Add descriptor pool FindOneofByName in pure python. 1507 * Change unknown enum values into unknown field set . 1508 * Add more Python dict/list compatibility for Struct/ListValue. 1509 * Add utf-8 support for text_format.Merge()/Parse(). 1510 * Support numeric unknown enum values for proto3 JSON format. 1511 * Add warning for Unexpected end-group tag in cpp extension. 1512 1513 PHP 1514 * Proto3 messages are now preserving unknown fields. 1515 * Provide well known type messages in runtime. 1516 * Add prefix ‘PB’ to generated class of reserved names. 1517 * Fixed all conformance tests for encode/decode json in php runtime. C 1518 extension needs more work. 1519 1520 Objective-C 1521 * Fixed some issues around copying of messages with unknown fields and then 1522 mutating the unknown fields in the copy. 1523 1524 C# 1525 * Added unknown field support in JsonParser. 1526 * Fixed oneof message field merge. 1527 * Simplify parsing messages from array slices. 1528 1529 Ruby 1530 * Unknown fields are now preserved by default. 1531 * Fixed several bugs for segment fault. 1532 1533 Javascript 1534 * Decoder can handle both paced and unpacked data no matter how the proto is 1535 defined. 1536 * Decoder now accept long varint for 32 bit integers. 1537 1538 15392017-08-14 version 3.4.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 1540 Planned Future Changes 1541 * There are some changes that are not included in this release but are planned 1542 for the near future 1543 - Preserve unknown fields in proto3: We are going to bring unknown fields 1544 back into proto3. In this release, some languages start to support 1545 preserving unknown fields in proto3, controlled by flags/options. Some 1546 languages also introduce explicit APIs to drop unknown fields for 1547 migration. Please read the change log sections by languages for details. 1548 For general timeline and plan: 1549 1550 https://docs.google.com/document/d/1KMRX-G91Aa-Y2FkEaHeeviLRRNblgIahbsk4wA14gRk/view 1551 1552 For issues and discussions: 1553 1554 https://github.com/protocolbuffers/protobuf/issues/272 1555 1556 - Make C++ implementation C++11 only: we plan to require C++11 to build 1557 protobuf code starting from 3.5.0 or 3.6.0 release, after unknown fields 1558 semantic changes are finished. Please join this 1559 github issue: 1560 1561 https://github.com/protocolbuffers/protobuf/issues/2780 1562 1563 to provide your feedback. 1564 1565 General 1566 * Extension ranges now accept options and are customizable. 1567 * "reserve" keyword now supports “max” in field number ranges, 1568 e.g. reserve 1000 to max; 1569 1570 C++ 1571 * Proto3 messages are now able to preserve unknown fields. The default 1572 behavior is still to drop unknowns, which will be flipped in a future 1573 release. If you rely on unknowns fields being dropped. Please use 1574 Message::DiscardUnknownFields() explicitly. 1575 * Packable proto3 fields are now packed by default in serialization. 1576 * Following C++11 features are introduced when C++11 is available: 1577 - move-constructor and move-assignment are introduced to messages 1578 - Repeated fields constructor now takes std::initializer_list 1579 - rvalue setters are introduced for string fields 1580 * Experimental Table-Driven parsing and serialization available to test. To 1581 enable it, pass in table_driven_parsing table_driven_serialization protoc 1582 generator flags for C++ 1583 1584 $ protoc --cpp_out=table_driven_parsing,table_driven_serialization:./ \ 1585 test.proto 1586 1587 * lite generator parameter supported by the generator. Once set, all generated 1588 files, use lite runtime regardless of the optimizer_for setting in the 1589 .proto file. 1590 * Various optimizations to make C++ code more performant on PowerPC platform 1591 * Fixed maps data corruption when the maps are modified by both reflection API 1592 and generated API. 1593 * Deterministic serialization on maps reflection now uses stable sort. 1594 * file() accessors are introduced to various *Descriptor classes to make 1595 writing template function easier. 1596 * ByteSize() and SpaceUsed() are deprecated.Use ByteSizeLong() and 1597 SpaceUsedLong() instead 1598 * Consistent hash function is used for maps in DEBUG and NDEBUG build. 1599 * "using namespace std" is removed from stubs/common.h 1600 * Various performance optimizations and bug fixes 1601 1602 Java 1603 * Introduced new parser API DiscardUnknownFieldsParser in preparation of 1604 proto3 unknown fields preservation change. Users who want to drop unknown 1605 fields should migrate to use this new parser API. For example: 1606 1607 Parser<Foo> parser = DiscardUnknownFieldsParser.wrap(Foo.parser()); 1608 Foo foo = parser.parseFrom(input); 1609 1610 * Introduced new TextFormat API printUnicodeFieldValue() that prints field 1611 value without escaping unicode characters. 1612 * Added Durations.compare(Duration, Duration) and 1613 Timestamps.compare(Timestamp, Timestamp). 1614 * JsonFormat now accepts base64url encoded bytes fields. 1615 * Optimized CodedInputStream to do less copies when parsing large bytes 1616 fields. 1617 * Optimized TextFormat to allocate less memory when printing. 1618 1619 Python 1620 * SerializeToString API is changed to SerializeToString(self, **kwargs), 1621 deterministic parameter is accepted for deterministic serialization. 1622 * Added sort_keys parameter in json format to make the output deterministic. 1623 * Added indent parameter in json format. 1624 * Added extension support in json format. 1625 * Added __repr__ support for repeated field in cpp implementation. 1626 * Added file in FieldDescriptor. 1627 * Added pretty-print filter to text format. 1628 * Services and method descriptors are always printed even if generic_service 1629 option is turned off. 1630 * Note: AppEngine 2.5 is deprecated on June 2017 that AppEngine 2.5 will 1631 never update protobuf runtime. Users who depend on AppEngine 2.5 should use 1632 old protoc. 1633 1634 PHP 1635 * Support PHP generic services. Specify file option php_generic_service=true 1636 to enable generating service interface. 1637 * Message, repeated and map fields setters take value instead of reference. 1638 * Added map iterator in c extension. 1639 * Support json encode/decode. 1640 * Added more type info in getter/setter phpdoc 1641 * Fixed the problem that c extension and php implementation cannot be used 1642 together. 1643 * Added file option php_namespace to use custom php namespace instead of 1644 package. 1645 * Added fluent setter. 1646 * Added descriptor API in runtime for custom encode/decode. 1647 * Various bug fixes. 1648 1649 Objective-C 1650 * Fix for GPBExtensionRegistry copying and add tests. 1651 * Optimize GPBDictionary.m codegen to reduce size of overall library by 46K 1652 per architecture. 1653 * Fix some cases of reading of 64bit map values. 1654 * Properly error on a tag with field number zero. 1655 * Preserve unknown fields in proto3 syntax files. 1656 * Document the exceptions on some of the writing apis. 1657 1658 C# 1659 * Implemented IReadOnlyDictionary<K,V> in MapField<K,V> 1660 * Added TryUnpack method for Any message in addition to Unpack. 1661 * Converted C# projects to MSBuild (csproj) format. 1662 1663 Ruby 1664 * Several bug fixes. 1665 1666 Javascript 1667 * Added support of field option js_type. Now one can specify the JS type of a 1668 64-bit integer field to be string in the generated code by adding option 1669 [jstype = JS_STRING] on the field. 1670 16712017-04-05 version 3.3.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript) 1672 Planned Future Changes 1673 * There are some changes that are not included in this release but are 1674 planned for the near future: 1675 - Preserve unknown fields in proto3: please read this doc: 1676 1677 https://docs.google.com/document/d/1KMRX-G91Aa-Y2FkEaHeeviLRRNblgIahbsk4wA14gRk/view 1678 1679 for the timeline and follow up this github issue: 1680 1681 https://github.com/protocolbuffers/protobuf/issues/272 1682 1683 for discussion. 1684 - Make C++ implementation C++11 only: we plan to require C++11 to build 1685 protobuf code starting from 3.4.0 or 3.5.0 release. Please join this 1686 github issue: 1687 1688 https://github.com/protocolbuffers/protobuf/issues/2780 1689 1690 to provide your feedback. 1691 1692 C++ 1693 * Fixed map fields serialization of DynamicMessage to correctly serialize 1694 both key and value regardless of their presence. 1695 * Parser now rejects field number 0 correctly. 1696 * New API Message::SpaceUsedLong() that’s equivalent to 1697 Message::SpaceUsed() but returns the value in size_t. 1698 * JSON support 1699 - New flag always_print_enums_as_ints in JsonPrintOptions. 1700 - New flag preserve_proto_field_names in JsonPrintOptions. It will instruct 1701 the JSON printer to use the original field name declared in the .proto 1702 file instead of converting them to lowerCamelCase when printing JSON. 1703 - JsonPrintOptions.always_print_primtive_fields now works for oneof message 1704 fields. 1705 - Fixed a bug that doesn’t allow different fields to set the same json_name 1706 value. 1707 - Fixed a performance bug that causes excessive memory copy when printing 1708 large messages. 1709 * Various performance optimizations. 1710 1711 Java 1712 * Map field setters eagerly validate inputs and throw NullPointerExceptions 1713 as appropriate. 1714 * Added ByteBuffer overloads to the generated parsing methods and the Parser 1715 interface. 1716 * proto3 enum's getNumber() method now throws on UNRECOGNIZED values. 1717 * Output of JsonFormat is now locale independent. 1718 1719 Python 1720 * Added FindServiceByName() in the pure-Python DescriptorPool. This works only 1721 for descriptors added with DescriptorPool.Add(). Generated descriptor_pool 1722 does not support this yet. 1723 * Added a descriptor_pool parameter for parsing Any in text_format.Parse(). 1724 * descriptor_pool.FindFileContainingSymbol() now is able to find nested 1725 extensions. 1726 * Extending empty [] to repeated field now sets parent message presence. 1727 1728 PHP 1729 * Added file option php_class_prefix. The prefix will be prepended to all 1730 generated classes defined in the file. 1731 * When encoding, negative int32 values are sign-extended to int64. 1732 * Repeated/Map field setter accepts a regular PHP array. Type checking is 1733 done on the array elements. 1734 * encode/decode are renamed to serializeToString/mergeFromString. 1735 * Added mergeFrom, clear method on Message. 1736 * Fixed a bug that oneof accessor didn’t return the field name that is 1737 actually set. 1738 * C extension now works with php7. 1739 * This is the first GA release of PHP. We guarantee that old generated code 1740 can always work with new runtime and new generated code. 1741 1742 Objective-C 1743 * Fixed help for GPBTimestamp for dates before the epoch that contain 1744 fractional seconds. 1745 * Added GPBMessageDropUnknownFieldsRecursively() to remove unknowns from a 1746 message and any sub messages. 1747 * Addressed a threading race in extension registration/lookup. 1748 * Increased the max message parsing depth to 100 to match the other languages. 1749 * Removed some use of dispatch_once in favor of atomic compare/set since it 1750 needs to be heap based. 1751 * Fixes for new Xcode 8.3 warnings. 1752 1753 C# 1754 * Fixed MapField.Values.CopyTo, which would throw an exception unnecessarily 1755 if provided exactly the right size of array to copy to. 1756 * Fixed enum JSON formatting when multiple names mapped to the same numeric 1757 value. 1758 * Added JSON formatting option to format enums as integers. 1759 * Modified RepeatedField<T> to implement IReadOnlyList<T>. 1760 * Introduced the start of custom option handling; it's not as pleasant as it 1761 might be, but the information is at least present. We expect to extend code 1762 generation to improve this in the future. 1763 * Introduced ByteString.FromStream and ByteString.FromStreamAsync to 1764 efficiently create a ByteString from a stream. 1765 * Added whole-message deprecation, which decorates the class with [Obsolete]. 1766 1767 Ruby 1768 * Fixed Message#to_h for messages with map fields. 1769 * Fixed memcpy() in binary gems to work for old glibc, without breaking the 1770 build for non-glibc libc’s like musl. 1771 1772 Javascript 1773 * Added compatibility tests for version 3.0.0. 1774 * Added conformance tests. 1775 * Fixed serialization of extensions: we need to emit a value even if it is 1776 falsy (like the number 0). 1777 * Use closurebuilder.py in favor of calcdeps.py for compiling JavaScript. 1778 17792017-01-23 version 3.2.0 (C++/Java/Python/PHP/Ruby/Objective-C/C#/JavaScript/Lite) 1780 General 1781 * Added protoc version number to protoc plugin protocol. It can be used by 1782 protoc plugin to detect which version of protoc is used with the plugin and 1783 mitigate known problems in certain version of protoc. 1784 1785 C++ 1786 * The default parsing byte size limit has been raised from 64MB to 2GB. 1787 * Added rvalue setters for non-arena string fields. 1788 * Enabled debug logging for Android. 1789 * Fixed a double-free problem when using Reflection::SetAllocatedMessage() 1790 with extension fields. 1791 * Fixed several deterministic serialization bugs: 1792 * MessageLite::SerializeAsString() now respects the global deterministic 1793 serialization flag. 1794 * Extension fields are serialized deterministically as well. Fixed protocol 1795 compiler to correctly report importing-self as an error. 1796 * Fixed FileDescriptor::DebugString() to print custom options correctly. 1797 * Various performance/codesize optimizations and cleanups. 1798 1799 Java 1800 * The default parsing byte size limit has been raised from 64MB to 2GB. 1801 * Added recursion limit when parsing JSON. 1802 * Fixed a bug that enumType.getDescriptor().getOptions() doesn't have custom 1803 options. 1804 * Fixed generated code to support field numbers up to 2^29-1. 1805 1806 Python 1807 * You can now assign NumPy scalars/arrays (np.int32, np.int64) to protobuf 1808 fields, and assigning other numeric types has been optimized for 1809 performance. 1810 * Pure-Python: message types are now garbage-collectable. 1811 * Python/C++: a lot of internal cleanup/refactoring. 1812 1813 PHP (Alpha) 1814 * For 64-bit integers type (int64/uint64/sfixed64/fixed64/sint64), use PHP 1815 integer on 64-bit environment and PHP string on 32-bit environment. 1816 * PHP generated code also conforms to PSR-4 now. 1817 * Fixed ZTS build for c extension. 1818 * Fixed c extension build on Mac. 1819 * Fixed c extension build on 32-bit linux. 1820 * Fixed the bug that message without namespace is not found in the descriptor 1821 pool. (#2240) 1822 * Fixed the bug that repeated field is not iterable in c extension. 1823 * Message names Empty will be converted to GPBEmpty in generated code. 1824 * Added phpdoc in generated files. 1825 * The released API is almost stable. Unless there is large problem, we won't 1826 change it. See 1827 https://developers.google.com/protocol-buffers/docs/reference/php-generated 1828 for more details. 1829 1830 Objective-C 1831 * Added support for push/pop of the stream limit on CodedInputStream for 1832 anyone doing manual parsing. 1833 1834 C# 1835 * No changes. 1836 1837 Ruby 1838 * Message objects now support #respond_to? for field getters/setters. 1839 * You can now compare “message == non_message_object” and it will return false 1840 instead of throwing an exception. 1841 * JRuby: fixed #hashCode to properly reflect the values in the message. 1842 1843 Javascript 1844 * Deserialization of repeated fields no longer has quadratic performance 1845 behavior. 1846 * UTF-8 encoding/decoding now properly supports high codepoints. 1847 * Added convenience methods for some well-known types: Any, Struct, and 1848 Timestamp. These make it easier to convert data between native JavaScript 1849 types and the well-known protobuf types. 1850 18512016-09-23 version 3.1.0 (C++/Java/Python/PHP/Ruby/Objective-C/C#/JavaScript/Lite) 1852 General 1853 * Proto3 support in PHP (alpha). 1854 * Various bug fixes. 1855 1856 C++ 1857 * Added MessageLite::ByteSizeLong() that’s equivalent to 1858 MessageLite::ByteSize() but returns the value in size_t. Useful to check 1859 whether a message is over the 2G size limit that protobuf can support. 1860 * Moved default_instances to global variables. This allows default_instance 1861 addresses to be known at compile time. 1862 * Adding missing generic gcc 64-bit atomicops. 1863 * Restore New*Callback into google::protobuf namespace since these are used 1864 by the service stubs code 1865 * JSON support. 1866 * Fixed some conformance issues. 1867 * Fixed a JSON serialization bug for bytes fields. 1868 1869 Java 1870 * Fixed a bug in TextFormat that doesn’t accept empty repeated fields (i.e., 1871 “field: [ ]”). 1872 * JSON support 1873 * Fixed JsonFormat to do correct snake_case-to-camelCase conversion for 1874 non-style-conforming field names. 1875 * Fixed JsonFormat to parse empty Any message correctly. 1876 * Added an option to JsonFormat.Parser to ignore unknown fields. 1877 * Experimental API 1878 * Added UnsafeByteOperations.unsafeWrap(byte[]) to wrap a byte array into 1879 ByteString without copy. 1880 1881 Python 1882 * JSON support 1883 * Fixed some conformance issues. 1884 1885 PHP (Alpha) 1886 * We have added the proto3 support for PHP via both a pure PHP package and a 1887 native c extension. The pure PHP package is intended to provide usability 1888 to wider range of PHP platforms, while the c extension is intended to 1889 provide higher performance. Both implementations provide the same runtime 1890 APIs and share the same generated code. Users don’t need to re-generate 1891 code for the same proto definition when they want to switch the 1892 implementation later. The pure PHP package is included in the php/src 1893 directory, and the c extension is included in the php/ext directory. 1894 1895 Both implementations provide idiomatic PHP APIs: 1896 * All messages and enums are defined as PHP classes. 1897 * All message fields can only be accessed via getter/setter. 1898 * Both repeated field elements and map elements are stored in containers 1899 that act like a normal PHP array. 1900 1901 Unlike several existing third-party PHP implementations for protobuf, our 1902 implementations are built on a "strongly-typed" philosophy: message fields 1903 and array/map containers will throw exceptions eagerly when values of the 1904 incorrect type (not including those that can be type converted, e.g., 1905 double <-> integer <-> numeric string) are inserted. 1906 1907 Currently, pure PHP runtime supports php5.5, 5.6 and 7 on linux. C 1908 extension runtime supports php5.5 and 5.6 on linux. 1909 1910 See php/README.md for more details about installment. See 1911 https://developers.google.com/protocol-buffers/docs/phptutorial for more 1912 details about APIs. 1913 1914 Objective-C 1915 * Helpers are now provided for working the Any well known type (see 1916 GPBWellKnownTypes.h for the api additions). 1917 * Some improvements in startup code (especially when extensions aren’t used). 1918 1919 Javascript 1920 * Fixed missing import of jspb.Map 1921 * Fixed valueWriterFn variable name 1922 1923 Ruby 1924 * Fixed hash computation for JRuby's RubyMessage 1925 * Make sure map parsing frames are GC-rooted. 1926 * Added API support for well-known types. 1927 1928 C# 1929 * Removed check on dependency in the C# reflection API. 1930 19312016-09-06 version 3.0.2 (C++/Java/Python/Ruby/Objective-C/C#/JavaScript/Lite) 1932 General 1933 * Various bug fixes. 1934 1935 Objective C 1936 * Fix for oneofs in proto3 syntax files where fields were set to the zero 1937 value. 1938 * Fix for embedded null character in strings. 1939 * CocoaDocs support 1940 1941 Ruby 1942 * Fixed memory corruption bug in parsing that could occur under GC pressure. 1943 1944 Javascript 1945 * jspb.Map is now properly exported to CommonJS modules. 1946 1947 C# 1948 * Removed legacy_enum_values flag. 1949 1950 19512016-07-27 version 3.0.0 (C++/Java/Python/Ruby/Objective-C/C#/JavaScript/Lite) 1952 General 1953 * This log only contains changes since the beta-4 release. Summarized change 1954 log since the last stable release (v2.6.1) can be found in the github 1955 release page. 1956 1957 Compatibility Notice 1958 * v3.0.0 is the first API stable release of the v3.x series. We do not expect 1959 any future API breaking changes. 1960 * For C++, Java Lite and Objective-C, source level compatibility is 1961 guaranteed. Upgrading from v3.0.0 to newer minor version releases will be 1962 source compatible. For example, if your code compiles against protobuf 1963 v3.0.0, it will continue to compile after you upgrade protobuf library to 1964 v3.1.0. 1965 * For other languages, both source level compatibility and binary level 1966 compatibility are guaranteed. For example, if you have a Java binary built 1967 against protobuf v3.0.0. After switching the protobuf runtime binary to 1968 v3.1.0, your built binary should continue to work. 1969 * Compatibility is only guaranteed for documented API and documented 1970 behaviors. If you are using undocumented API (e.g., use anything in the C++ 1971 internal namespace), it can be broken by minor version releases in an 1972 undetermined manner. 1973 1974 Ruby 1975 * When you assign a string field `a.string_field = "X"`, we now call 1976 #encode(UTF-8) on the string and freeze the copy. This saves you from 1977 needing to ensure the string is already encoded as UTF-8. It also prevents 1978 you from mutating the string after it has been assigned (this is how we 1979 ensure it stays valid UTF-8). 1980 * The generated file for `foo.proto` is now `foo_pb.rb` instead of just 1981 `foo.rb`. This makes it easier to see which imports/requires are from 1982 protobuf generated code, and also prevents conflicts with any `foo.rb` file 1983 you might have written directly in Ruby. It is a backward-incompatible 1984 change: you will need to update all of your `require` statements. 1985 * For package names like `foo_bar`, we now translate this to the Ruby module 1986 `FooBar`. This is more idiomatic Ruby than what we used to do (`Foo_bar`). 1987 1988 JavaScript 1989 * Scalar fields like numbers and boolean now return defaults instead of 1990 `undefined` or `null` when they are unset. You can test for presence 1991 explicitly by calling `hasFoo()`, which we now generate for scalar fields. 1992 1993 Java Lite 1994 * Java Lite is now implemented as a separate plugin, maintained in the 1995 `javalite` branch. Both lite runtime and protoc artifacts will be available 1996 in Maven. 1997 1998 C# 1999 * Target platforms now .NET 4.5, selected portable subsets and .NET Core. 2000 * legacy_enum_values option is no longer supported. 2001 20022016-07-15 version 3.0.0-beta-4 (C++/Java/Python/Ruby/Objective-C/C#/JavaScript) 2003 General 2004 * Added a deterministic serialization API for C++. The deterministic 2005 serialization guarantees that given a binary, equal messages will be 2006 serialized to the same bytes. This allows applications like MapReduce to 2007 group equal messages based on the serialized bytes. The deterministic 2008 serialization is, however, NOT canonical across languages; it is also 2009 unstable across different builds with schema changes due to unknown fields. 2010 Users who need canonical serialization, e.g. persistent storage in a 2011 canonical form, fingerprinting, etc, should define their own 2012 canonicalization specification and implement the serializer using reflection 2013 APIs rather than relying on this API. 2014 * Added OneofOptions. You can now define custom options for oneof groups. 2015 import "google/protobuf/descriptor.proto"; 2016 extend google.protobuf.OneofOptions { 2017 optional int32 my_oneof_extension = 12345; 2018 } 2019 message Foo { 2020 oneof oneof_group { 2021 (my_oneof_extension) = 54321; 2022 ... 2023 } 2024 } 2025 2026 C++ (beta) 2027 * Introduced a deterministic serialization API in 2028 CodedOutputStream::SetSerializationDeterministic(bool). See the notes about 2029 deterministic serialization in the General section. 2030 * Added google::protobuf::Map::swap() to swap two map fields. 2031 * Fixed a memory leak when calling Reflection::ReleaseMessage() on a message 2032 allocated on arena. 2033 * Improved error reporting when parsing text format protos. 2034 * JSON 2035 - Added a new parser option to ignore unknown fields when parsing JSON. 2036 - Added convenient methods for message to/from JSON conversion. 2037 * Various performance optimizations. 2038 2039 Java (beta) 2040 * File option "java_generate_equals_and_hash" is now deprecated. equals() and 2041 hashCode() methods are generated by default. 2042 * Added a new JSON printer option "omittingInsignificantWhitespace" to produce 2043 a more compact JSON output. The printer will pretty-print by default. 2044 * Updated Java runtime to be compatible with 2.5.0/2.6.1 generated protos. 2045 2046 Python (beta) 2047 * Added support to pretty print Any messages in text format. 2048 * Added a flag to ignore unknown fields when parsing JSON. 2049 * Bugfix: "@type" field of a JSON Any message is now correctly put before 2050 other fields. 2051 2052 Objective-C (beta) 2053 * Updated the code to support compiling with more compiler warnings 2054 enabled. (Issue 1616) 2055 * Exposing more detailed errors for parsing failures. (PR 1623) 2056 * Small (breaking) change to the naming of some methods on the support classes 2057 for map<>. There were collisions with the system provided KVO support, so 2058 the names were changed to avoid those issues. (PR 1699) 2059 * Fixed for proper Swift bridging of error handling during parsing. (PR 1712) 2060 * Complete support for generating sources that will go into a Framework and 2061 depend on generated sources from other Frameworks. (Issue 1457) 2062 2063 C# (beta) 2064 * RepeatedField optimizations. 2065 * Support for .NET Core. 2066 * Minor bug fixes. 2067 * Ability to format a single value in JsonFormatter (advanced usage only). 2068 * Modifications to attributes applied to generated code. 2069 2070 Javascript (alpha) 2071 * Maps now have a real map API instead of being treated as repeated fields. 2072 * Well-known types are now provided in the google-protobuf package, and the 2073 code generator knows to require() them from that package. 2074 * Bugfix: non-canonical varints are correctly decoded. 2075 2076 Ruby (alpha) 2077 * Accessors for oneof fields now return default values instead of nil. 2078 2079 Java Lite 2080 * Java lite support is removed from protocol compiler. It will be supported 2081 as a protocol compiler plugin in a separate code branch. 2082 20832016-05-16 version 3.0.0-beta-3 (C++/Java/Python/Ruby/Nano/Objective-C/C#/JavaScript) 2084 General 2085 * Supported Proto3 lite-runtime in C++/Java for mobile platforms. 2086 * Any type now supports APIs to specify prefixes other than 2087 type.googleapis.com 2088 * Removed javanano_use_deprecated_package option; Nano will always has its own 2089 ".nano" package. 2090 2091 C++ (Beta) 2092 * Improved hash maps. 2093 - Improved hash maps comments. In particular, please note that equal hash 2094 maps will not necessarily have the same iteration order and 2095 serialization. 2096 - Added a new hash maps implementation that will become the default in a 2097 later release. 2098 * Arenas 2099 - Several inlined methods in Arena were moved to out-of-line to improve 2100 build performance and code size. 2101 - Added SpaceAllocatedAndUsed() to report both space used and allocated 2102 - Added convenient class UnsafeArenaAllocatedRepeatedPtrFieldBackInserter 2103 * Any 2104 - Allow custom type URL prefixes in Any packing. 2105 - TextFormat now expand the Any type rather than printing bytes. 2106 * Performance optimizations and various bug fixes. 2107 2108 Java (Beta) 2109 * Introduced an ExperimentalApi annotation. Annotated APIs are experimental 2110 and are subject to change in a backward incompatible way in future releases. 2111 * Introduced zero-copy serialization as an ExperimentalApi 2112 - Introduction of the `ByteOutput` interface. This is similar to 2113 `OutputStream` but provides semantics for lazy writing (i.e. no 2114 immediate copy required) of fields that are considered to be immutable. 2115 - `ByteString` now supports writing to a `ByteOutput`, which will directly 2116 expose the internals of the `ByteString` (i.e. `byte[]` or `ByteBuffer`) 2117 to the `ByteOutput` without copying. 2118 - `CodedOutputStream` now supports writing to a `ByteOutput`. `ByteString` 2119 instances that are too large to fit in the internal buffer will be 2120 (lazily) written to the `ByteOutput` directly. 2121 - This allows applications using large `ByteString` fields to avoid 2122 duplication of these fields entirely. Such an application can supply a 2123 `ByteOutput` that chains together the chunks received from 2124 `CodedOutputStream` before forwarding them onto the IO system. 2125 * Other related changes to `CodedOutputStream` 2126 - Additional use of `sun.misc.Unsafe` where possible to perform fast 2127 access to `byte[]` and `ByteBuffer` values and avoiding unnecessary 2128 range checking. 2129 - `ByteBuffer`-backed `CodedOutputStream` now writes directly to the 2130 `ByteBuffer` rather than to an intermediate array. 2131 * Improved lite-runtime. 2132 - Lite protos now implement deep equals/hashCode/toString 2133 - Significantly improved the performance of Builder#mergeFrom() and 2134 Builder#mergeDelimitedFrom() 2135 * Various bug fixes and small feature enhancement. 2136 - Fixed stack overflow when in hashCode() for infinite recursive oneofs. 2137 - Fixed the lazy field parsing in lite to merge rather than overwrite. 2138 - TextFormat now supports reporting line/column numbers on errors. 2139 - Updated to add appropriate @Override for better compiler errors. 2140 2141 Python (Beta) 2142 * Added JSON format for Any, Struct, Value and ListValue 2143 * [ ] is now accepted for both repeated scalar fields and repeated message 2144 fields in text format parser. 2145 * Numerical field name is now supported in text format. 2146 * Added DiscardUnknownFields API for python protobuf message. 2147 2148 Objective-C (Beta) 2149 * Proto comments now come over as HeaderDoc comments in the generated sources 2150 so Xcode can pick them up and display them. 2151 * The library headers have been updated to use HeaderDoc comments so Xcode can 2152 pick them up and display them. 2153 * The per message and per field overhead in both generated code and runtime 2154 object sizes was reduced. 2155 * Generated code now include deprecated annotations when the proto file 2156 included them. 2157 2158 C# (Beta) 2159 In general: some changes are breaking, which require regenerating messages. 2160 Most user-written code will not be impacted *except* for the renaming of enum 2161 values. 2162 2163 * Allow custom type URL prefixes in `Any` packing, and ignore them when 2164 unpacking 2165 * `protoc` is now in a separate NuGet package (Google.Protobuf.Tools) 2166 * New option: `internal_access` to generate internal classes 2167 * Enum values are now PascalCased, and if there's a prefix which matches the 2168 name of the enum, that is removed (so an enum `COLOR` with a value 2169 `COLOR_BLUE` would generate a value of just `Blue`). An option 2170 (`legacy_enum_values`) is temporarily available to disable this, but the 2171 option will be removed for GA. 2172 * `json_name` option is now honored 2173 * If group tags are encountered when parsing, they are validated more 2174 thoroughly (although we don't support actual groups) 2175 * NuGet dependencies are better specified 2176 * Breaking: `Preconditions` is renamed to `ProtoPreconditions` 2177 * Breaking: `GeneratedCodeInfo` is renamed to `GeneratedClrTypeInfo` 2178 * `JsonFormatter` now allows writing to a `TextWriter` 2179 * New interface, `ICustomDiagnosticMessage` to allow more compact 2180 representations from `ToString` 2181 * `CodedInputStream` and `CodedOutputStream` now implement `IDisposable`, 2182 which simply disposes of the streams they were constructed with 2183 * Map fields no longer support null values (in line with other languages) 2184 * Improvements in JSON formatting and parsing 2185 2186 Javascript (Alpha) 2187 * Better support for "bytes" fields: bytes fields can be read as either a 2188 base64 string or UInt8Array (in environments where TypedArray is supported). 2189 * New support for CommonJS imports. This should make it easier to use the 2190 JavaScript support in Node.js and tools like WebPack. See js/README.md for 2191 more information. 2192 * Some significant internal refactoring to simplify and modularize the code. 2193 2194 Ruby (Alpha) 2195 * JSON serialization now properly uses camelCased names, with a runtime option 2196 that will preserve original names from .proto files instead. 2197 * Well-known types are now included in the distribution. 2198 * Release now includes binary gems for Windows, Mac, and Linux instead of just 2199 source gems. 2200 * Bugfix for serializing oneofs. 2201 2202 C++/Java Lite (Alpha) 2203 A new "lite" generator parameter was introduced in the protoc for C++ and 2204 Java for Proto3 syntax messages. Example usage: 2205 2206 ./protoc --cpp_out=lite:$OUTPUT_PATH foo.proto 2207 2208 The protoc will treat the current input and all the transitive dependencies 2209 as LITE. The same generator parameter must be used to generate the 2210 dependencies. 2211 2212 In Proto3 syntax files, "optimized_for=LITE_RUNTIME" is no longer supported. 2213 2214 22152015-12-30 version 3.0.0-beta-2 (C++/Java/Python/Ruby/Nano/Objective-C/C#/JavaScript) 2216 General 2217 * Introduced a new language implementation: JavaScript. 2218 * Added a new field option "json_name". By default proto field names are 2219 converted to "lowerCamelCase" in proto3 JSON format. This option can be 2220 used to override this behavior and specify a different JSON name for the 2221 field. 2222 * Added conformance tests to ensure implementations are following proto3 JSON 2223 specification. 2224 2225 C++ (Beta) 2226 * Various bug fixes and improvements to the JSON support utility: 2227 - Duplicate map keys in JSON are now rejected (i.e., translation will 2228 fail). 2229 - Fixed wire-format for google.protobuf.Value/ListValue. 2230 - Fixed precision loss when converting google.protobuf.Timestamp. 2231 - Fixed a bug when parsing invalid UTF-8 code points. 2232 - Fixed a memory leak. 2233 - Reduced call stack usage. 2234 2235 Java (Beta) 2236 * Cleaned up some unused methods on CodedOutputStream. 2237 * Presized lists for packed fields during parsing in the lite runtime to 2238 reduce allocations and improve performance. 2239 * Improved the performance of unknown fields in the lite runtime. 2240 * Introduced UnsafeByteStrings to support zero-copy ByteString creation. 2241 * Various bug fixes and improvements to the JSON support utility: 2242 - Fixed a thread-safety bug. 2243 - Added a new option “preservingProtoFieldNames” to JsonFormat. 2244 - Added a new option “includingDefaultValueFields” to JsonFormat. 2245 - Updated the JSON utility to comply with proto3 JSON specification. 2246 2247 Python (Beta) 2248 * Added proto3 JSON format utility. It includes support for all field types 2249 and a few well-known types except for Any and Struct. 2250 * Added runtime support for Any, Timestamp, Duration and FieldMask. 2251 * [ ] is now accepted for repeated scalar fields in text format parser. 2252 * Map fields now have proper O(1) performance for lookup/insert/delete 2253 when using the Python/C++ implementation. They were previously using O(n) 2254 search-based algorithms because the C++ reflection interface didn't 2255 support true map operations. 2256 2257 Objective-C (Beta) 2258 * Various bug-fixes and code tweaks to pass more strict compiler warnings. 2259 * Now has conformance test coverage and is passing all tests. 2260 2261 C# (Beta) 2262 * Various bug-fixes. 2263 * Code generation: Files generated in directories based on namespace. 2264 * Code generation: Include comments from .proto files in XML doc 2265 comments (naively) 2266 * Code generation: Change organization/naming of "reflection class" (access 2267 to file descriptor) 2268 * Code generation and library: Add Parser property to MessageDescriptor, 2269 and introduce a non-generic parser type. 2270 * Library: Added TypeRegistry to support JSON parsing/formatting of Any. 2271 * Library: Added Any.Pack/Unpack support. 2272 * Library: Implemented JSON parsing. 2273 2274 Javascript (Alpha) 2275 * Added proto3 support for JavaScript. The runtime is written in pure 2276 JavaScript and works in browsers and in Node.js. To generate JavaScript 2277 code for your proto, invoke protoc with "--js_out". See js/README.md 2278 for more build instructions. 2279 22802015-08-26 version 3.0.0-beta-1 (C++/Java/Python/Ruby/Nano/Objective-C/C#) 2281 About Beta 2282 * This is the first beta release of protobuf v3.0.0. Not all languages 2283 have reached beta stage. Languages not marked as beta are still in 2284 alpha (i.e., be prepared for API breaking changes). 2285 2286 General 2287 * Proto3 JSON is supported in several languages (fully supported in C++ 2288 and Java, partially supported in Ruby/C#). The JSON spec is defined in 2289 the proto3 language guide: 2290 2291 https://developers.google.com/protocol-buffers/docs/proto3#json 2292 2293 We will publish a more detailed spec to define the exact behavior of 2294 proto3-conformant JSON serializers and parsers. Until then, do not rely 2295 on specific behaviors of the implementation if it’s not documented in 2296 the above spec. More specifically, the behavior is not yet finalized for 2297 the following: 2298 - Parsing invalid JSON input (e.g., input with trailing commas). 2299 - Non-camelCase names in JSON input. 2300 - The same field appears multiple times in JSON input. 2301 - JSON arrays contain “null” values. 2302 - The message has unknown fields. 2303 2304 * Proto3 now enforces strict UTF-8 checking. Parsing will fail if a string 2305 field contains non UTF-8 data. 2306 2307 C++ (Beta) 2308 * Introduced new utility functions/classes in the google/protobuf/util 2309 directory: 2310 - MessageDifferencer: compare two proto messages and report their 2311 differences. 2312 - JsonUtil: support converting protobuf binary format to/from JSON. 2313 - TimeUtil: utility functions to work with well-known types Timestamp 2314 and Duration. 2315 - FieldMaskUtil: utility functions to work with FieldMask. 2316 2317 * Performance optimization of arena construction and destruction. 2318 * Bug fixes for arena and maps support. 2319 * Changed to use cmake for Windows Visual Studio builds. 2320 * Added Bazel support. 2321 2322 Java (Beta) 2323 * Introduced a new util package that will be distributed as a separate 2324 artifact in maven. It contains: 2325 - JsonFormat: convert proto messages to/from JSON. 2326 - TimeUtil: utility functions to work with Timestamp and Duration. 2327 - FieldMaskUtil: utility functions to work with FieldMask. 2328 2329 * The static PARSER in each generated message is deprecated, and it will 2330 be removed in a future release. A static parser() getter is generated 2331 for each message type instead. 2332 * Performance optimizations for String fields serialization. 2333 * Performance optimizations for Lite runtime on Android: 2334 - Reduced allocations 2335 - Reduced method overhead after ProGuarding 2336 - Reduced code size after ProGuarding 2337 2338 Python (Alpha) 2339 * Removed legacy Python 2.5 support. 2340 * Moved to a single Python 2.x/3.x-compatible codebase, instead of using 2to3. 2341 * Fixed build/tests on Python 2.6, 2.7, 3.3, and 3.4. 2342 - Pure-Python works on all four. 2343 - Python/C++ implementation works on all but 3.4, due to changes in the 2344 Python/C++ API in 3.4. 2345 * Some preliminary work has been done to allow for multiple DescriptorPools 2346 with Python/C++. 2347 2348 Ruby (Alpha) 2349 * Many bugfixes: 2350 - fixed parsing/serialization of bytes, sint, sfixed types 2351 - other parser bugfixes 2352 - fixed memory leak affecting Ruby 2.2 2353 2354 JavaNano (Alpha) 2355 * JavaNano generated code now will be put in a nano package by default to 2356 avoid conflicts with Java generated code. 2357 2358 Objective-C (Alpha) 2359 * Added non-null markup to ObjC library. Requires SDK 8.4+ to build. 2360 * Many bugfixes: 2361 - Removed the class/enum filter. 2362 - Renamed some internal types to avoid conflicts with the well-known types 2363 protos. 2364 - Added missing support for parsing repeated primitive fields in packed or 2365 unpacked forms. 2366 - Added *Count for repeated and map<> fields to avoid auto-create when 2367 checking for them being set. 2368 2369 C# (Alpha) 2370 * Namespace changed to Google.Protobuf (and NuGet package will be named 2371 correspondingly). 2372 * Target platforms now .NET 4.5 and selected portable subsets only. 2373 * Removed lite runtime. 2374 * Reimplementation to use mutable message types. 2375 * Null references used to represent "no value" for message type fields. 2376 * Proto3 semantics supported; proto2 files are prohibited for C# codegen. 2377 Most proto3 features supported: 2378 - JSON formatting (a.k.a. serialization to JSON), including well-known 2379 types (except for Any). 2380 - Wrapper types mapped to nullable value types (or string/ByteString 2381 allowing nullability). JSON parsing is not supported yet. 2382 - maps 2383 - oneof 2384 - enum unknown value preservation 2385 23862015-05-25 version 3.0.0-alpha-3 (Objective-C/C#): 2387 General 2388 * Introduced two new language implementations (Objective-C, C#) to proto3. 2389 * Explicit "optional" keyword are disallowed in proto3 syntax, as fields are 2390 optional by default. 2391 * Group fields are no longer supported in proto3 syntax. 2392 * Changed repeated primitive fields to use packed serialization by default in 2393 proto3 (implemented for C++, Java, Python in this release). The user can 2394 still disable packed serialization by setting packed to false for now. 2395 * Added well-known type protos (any.proto, empty.proto, timestamp.proto, 2396 duration.proto, etc.). Users can import and use these protos just like 2397 regular proto files. Additional runtime support will be added for them in 2398 future releases (in the form of utility helper functions, or having them 2399 replaced by language specific types in generated code). 2400 * Added a "reserved" keyword in both proto2 and proto3 syntax. User can use 2401 this keyword to declare reserved field numbers and names to prevent them 2402 from being reused by other fields in the same message. 2403 2404 To reserve field numbers, add a reserved declaration in your message: 2405 2406 message TestMessage { 2407 reserved 2, 15, 9 to 11, 3; 2408 } 2409 2410 This reserves field numbers 2, 3, 9, 10, 11 and 15. If a user uses any of 2411 these as field numbers, the protocol buffer compiler will report an error. 2412 2413 Field names can also be reserved: 2414 2415 message TestMessage { 2416 reserved "foo", "bar"; 2417 } 2418 2419 * Various bug fixes since 3.0.0-alpha-2 2420 2421 Objective-C 2422 Objective-C includes a code generator and a native objective-c runtime 2423 library. By adding “--objc_out” to protoc, the code generator will generate 2424 a header(*.pbobjc.h) and an implementation file(*.pbobjc.m) for each proto 2425 file. 2426 2427 In this first release, the generated interface provides: enums, messages, 2428 field support(single, repeated, map, oneof), proto2 and proto3 syntax 2429 support, parsing and serialization. It’s compatible with ARC and non-ARC 2430 usage. Besides, user can also access it via the swift bridging header. 2431 2432 See objectivec/README.md for details. 2433 2434 C# 2435 * C# protobufs are based on project 2436 https://github.com/jskeet/protobuf-csharp-port. The original project was 2437 frozen and all the new development will happen here. 2438 * Codegen plugin for C# was completely rewritten to C++ and is now an 2439 integral part of protoc. 2440 * Some refactorings and cleanup has been applied to the C# runtime library. 2441 * Only proto2 is supported in C# at the moment, proto3 support is in 2442 progress and will likely bring significant breaking changes to the API. 2443 2444 See csharp/README.md for details. 2445 2446 C++ 2447 * Added runtime support for Any type. To use Any in your proto file, first 2448 import the definition of Any: 2449 2450 // foo.proto 2451 import "google/protobuf/any.proto"; 2452 message Foo { 2453 google.protobuf.Any any_field = 1; 2454 } 2455 message Bar { 2456 int32 value = 1; 2457 } 2458 2459 Then in C++ you can access the Any field using PackFrom()/UnpackTo() 2460 methods: 2461 2462 Foo foo; 2463 Bar bar = ...; 2464 foo.mutable_any_field()->PackFrom(bar); 2465 ... 2466 if (foo.any_field().IsType<Bar>()) { 2467 foo.any_field().UnpackTo(&bar); 2468 ... 2469 } 2470 * In text format, entries of a map field will be sorted by key. 2471 2472 Java 2473 * Continued optimizations on the lite runtime to improve performance for 2474 Android. 2475 2476 Python 2477 * Added map support. 2478 - maps now have a dict-like interface (msg.map_field[key] = value) 2479 - existing code that modifies maps via the repeated field interface 2480 will need to be updated. 2481 2482 Ruby 2483 * Improvements to RepeatedField's emulation of the Ruby Array API. 2484 * Various speedups and internal cleanups. 2485 24862015-02-26 version 3.0.0-alpha-2 (Python/Ruby/JavaNano): 2487 General 2488 * Introduced three new language implementations (Ruby, JavaNano, and 2489 Python) to proto3. 2490 * Various bug fixes since 3.0.0-alpha-1 2491 2492 Python: 2493 Python has received several updates, most notably support for proto3 2494 semantics in any .proto file that declares syntax="proto3". 2495 Messages declared in proto3 files no longer represent field presence 2496 for scalar fields (number, enums, booleans, or strings). You can 2497 no longer call HasField() for such fields, and they are serialized 2498 based on whether they have a non-zero/empty/false value. 2499 2500 One other notable change is in the C++-accelerated implementation. 2501 Descriptor objects (which describe the protobuf schema and allow 2502 reflection over it) are no longer duplicated between the Python 2503 and C++ layers. The Python descriptors are now simple wrappers 2504 around the C++ descriptors. This change should significantly 2505 reduce the memory usage of programs that use a lot of message 2506 types. 2507 2508 Ruby: 2509 We have added proto3 support for Ruby via a native C extension. 2510 2511 The Ruby extension itself is included in the ruby/ directory, and details on 2512 building and installing the extension are in ruby/README.md. The extension 2513 will also be published as a Ruby gem. Code generator support is included as 2514 part of `protoc` with the `--ruby_out` flag. 2515 2516 The Ruby extension implements a user-friendly DSL to define message types 2517 (also generated by the code generator from `.proto` files). Once a message 2518 type is defined, the user may create instances of the message that behave in 2519 ways idiomatic to Ruby. For example: 2520 2521 - Message fields are present as ordinary Ruby properties (getter method 2522 `foo` and setter method `foo=`). 2523 - Repeated field elements are stored in a container that acts like a native 2524 Ruby array, and map elements are stored in a container that acts like a 2525 native Ruby hashmap. 2526 - The usual well-known methods, such as `#to_s`, `#dup`, and the like, are 2527 present. 2528 2529 Unlike several existing third-party Ruby extensions for protobuf, this 2530 extension is built on a "strongly-typed" philosophy: message fields and 2531 array/map containers will throw exceptions eagerly when values of the 2532 incorrect type are inserted. 2533 2534 See ruby/README.md for details. 2535 2536 JavaNano: 2537 JavaNano is a special code generator and runtime library designed especially 2538 for resource-restricted systems, like Android. It is very resource-friendly 2539 in both the amount of code and the runtime overhead. Here is an an overview 2540 of JavaNano features compared with the official Java protobuf: 2541 2542 - No descriptors or message builders. 2543 - All messages are mutable; fields are public Java fields. 2544 - For optional fields only, encapsulation behind setter/getter/hazzer/ 2545 clearer functions is opt-in, which provide proper 'has' state support. 2546 - For proto2, if not opted in, has state (field presence) is not available. 2547 Serialization outputs all fields not equal to their defaults. 2548 The behavior is consistent with proto3 semantics. 2549 - Required fields (proto2 only) are always serialized. 2550 - Enum constants are integers; protection against invalid values only 2551 when parsing from the wire. 2552 - Enum constants can be generated into container interfaces bearing 2553 the enum's name (so the referencing code is in Java style). 2554 - CodedInputByteBufferNano can only take byte[] (not InputStream). 2555 - Similarly CodedOutputByteBufferNano can only write to byte[]. 2556 - Repeated fields are in arrays, not ArrayList or Vector. Null array 2557 elements are allowed and silently ignored. 2558 - Full support for serializing/deserializing repeated packed fields. 2559 - Support extensions (in proto2). 2560 - Unset messages/groups are null, not an immutable empty default 2561 instance. 2562 - toByteArray(...) and mergeFrom(...) are now static functions of 2563 MessageNano. 2564 - The 'bytes' type translates to the Java type byte[]. 2565 2566 See javanano/README.txt for details. 2567 25682014-12-01 version 3.0.0-alpha-1 (C++/Java): 2569 2570 General 2571 * Introduced Protocol Buffers language version 3 (aka proto3). 2572 2573 When protobuf was initially opensourced it implemented Protocol Buffers 2574 language version 2 (aka proto2), which is why the version number 2575 started from v2.0.0. From v3.0.0, a new language version (proto3) is 2576 introduced while the old version (proto2) will continue to be supported. 2577 2578 The main intent of introducing proto3 is to clean up protobuf before 2579 pushing the language as the foundation of Google's new API platform. 2580 In proto3, the language is simplified, both for ease of use and to 2581 make it available in a wider range of programming languages. At the 2582 same time a few features are added to better support common idioms 2583 found in APIs. 2584 2585 The following are the main new features in language version 3: 2586 2587 1. Removal of field presence logic for primitive value fields, removal 2588 of required fields, and removal of default values. This makes proto3 2589 significantly easier to implement with open struct representations, 2590 as in languages like Android Java, Objective C, or Go. 2591 2. Removal of unknown fields. 2592 3. Removal of extensions, which are instead replaced by a new standard 2593 type called Any. 2594 4. Fix semantics for unknown enum values. 2595 5. Addition of maps. 2596 6. Addition of a small set of standard types for representation of time, 2597 dynamic data, etc. 2598 7. A well-defined encoding in JSON as an alternative to binary proto 2599 encoding. 2600 2601 This release (v3.0.0-alpha-1) includes partial proto3 support for C++ and 2602 Java. Items 6 (well-known types) and 7 (JSON format) in the above feature 2603 list are not implemented. 2604 2605 A new notion "syntax" is introduced to specify whether a .proto file 2606 uses proto2 or proto3: 2607 2608 // foo.proto 2609 syntax = "proto3"; 2610 message Bar {...} 2611 2612 If omitted, the protocol compiler will generate a warning and "proto2" will 2613 be used as the default. This warning will be turned into an error in a 2614 future release. 2615 2616 We recommend that new Protocol Buffers users use proto3. However, we do not 2617 generally recommend that existing users migrate from proto2 from proto3 due 2618 to API incompatibility, and we will continue to support proto2 for a long 2619 time. 2620 2621 * Added support for map fields (implemented in C++/Java for both proto2 and 2622 proto3). 2623 2624 Map fields can be declared using the following syntax: 2625 2626 message Foo { 2627 map<string, string> values = 1; 2628 } 2629 2630 Data of a map field will be stored in memory as an unordered map and it 2631 can be accessed through generated accessors. 2632 2633 C++ 2634 * Added arena allocation support (for both proto2 and proto3). 2635 2636 Profiling shows memory allocation and deallocation constitutes a significant 2637 fraction of CPU-time spent in protobuf code and arena allocation is a 2638 technique introduced to reduce this cost. With arena allocation, new 2639 objects will be allocated from a large piece of preallocated memory and 2640 deallocation of these objects is almost free. Early adoption shows 20% to 2641 50% improvement in some Google binaries. 2642 2643 To enable arena support, add the following option to your .proto file: 2644 2645 option cc_enable_arenas = true; 2646 2647 Protocol compiler will generate additional code to make the generated 2648 message classes work with arenas. This does not change the existing API 2649 of protobuf messages and does not affect wire format. Your existing code 2650 should continue to work after adding this option. In the future we will 2651 make this option enabled by default. 2652 2653 To actually take advantage of arena allocation, you need to use the arena 2654 APIs when creating messages. A quick example of using the arena API: 2655 2656 { 2657 google::protobuf::Arena arena; 2658 // Allocate a protobuf message in the arena. 2659 MyMessage* message = Arena::CreateMessage<MyMessage>(&arena); 2660 // All submessages will be allocated in the same arena. 2661 if (!message->ParseFromString(data)) { 2662 // Deal with malformed input data. 2663 } 2664 // Must not delete the message here. It will be deleted automatically 2665 // when the arena is destroyed. 2666 } 2667 2668 Currently arena does not work with map fields. Enabling arena in a .proto 2669 file containing map fields will result in compile errors in the generated 2670 code. This will be addressed in a future release. 2671 26722014-10-20 version 2.6.1: 2673 2674 C++ 2675 * Added atomicops support for Solaris. 2676 * Released memory allocated by InitializeDefaultRepeatedFields() and 2677 GetEmptyString(). Some memory sanitizers reported them as memory leaks. 2678 2679 Java 2680 * Updated DynamicMessage.setField() to handle repeated enum values 2681 correctly. 2682 * Fixed a bug that caused NullPointerException to be thrown when 2683 converting manually constructed FileDescriptorProto to 2684 FileDescriptor. 2685 2686 Python 2687 * Fixed WhichOneof() to work with de-serialized protobuf messages. 2688 * Fixed a missing file problem of Python C++ implementation. 2689 26902014-08-15 version 2.6.0: 2691 2692 General 2693 * Added oneofs(unions) feature. Fields in the same oneof will share 2694 memory and at most one field can be set at the same time. Use the 2695 oneof keyword to define a oneof like: 2696 message SampleMessage { 2697 oneof test_oneof { 2698 string name = 4; 2699 YourMessage sub_message = 9; 2700 } 2701 } 2702 * Files, services, enums, messages, methods and enum values can be marked 2703 as deprecated now. 2704 * Added Support for list values, including lists of messages, when 2705 parsing text-formatted protos in C++ and Java. 2706 For example: foo: [1, 2, 3] 2707 2708 C++ 2709 * Enhanced customization on TestFormat printing. 2710 * Added SwapFields() in reflection API to swap a subset of fields. 2711 Added SetAllocatedMessage() in reflection API. 2712 * Repeated primitive extensions are now packable. The 2713 [packed=true] option only affects serializers. Therefore, it is 2714 possible to switch a repeated extension field to packed format 2715 without breaking backwards-compatibility. 2716 * Various speed optimizations. 2717 2718 Java 2719 * writeTo() method in ByteString can now write a substring to an 2720 output stream. Added endWith() method for ByteString. 2721 * ByteString and ByteBuffer are now supported in CodedInputStream 2722 and CodedOutputStream. 2723 * java_generate_equals_and_hash can now be used with the LITE_RUNTIME. 2724 2725 Python 2726 * A new C++-backed extension module (aka "cpp api v2") that replaces the 2727 old ("cpp api v1") one. Much faster than the pure Python code. This one 2728 resolves many bugs and is recommended for general use over the 2729 pure Python when possible. 2730 * Descriptors now have enum_types_by_name and extension_types_by_name dict 2731 attributes. 2732 * Support for Python 3. 2733 27342013-02-27 version 2.5.0: 2735 2736 General 2737 * New notion "import public" that allows a proto file to forward the content 2738 it imports to its importers. For example, 2739 // foo.proto 2740 import public "bar.proto"; 2741 import "baz.proto"; 2742 2743 // qux.proto 2744 import "foo.proto"; 2745 // Stuff defined in bar.proto may be used in this file, but stuff from 2746 // baz.proto may NOT be used without importing it explicitly. 2747 This is useful for moving proto files. To move a proto file, just leave 2748 a single "import public" in the old proto file. 2749 * New enum option "allow_alias" that specifies whether different symbols can 2750 be assigned the same numeric value. Default value is "true". Setting it to 2751 false causes the compiler to reject enum definitions where multiple symbols 2752 have the same numeric value. 2753 Note: We plan to flip the default value to "false" in a future release. 2754 Projects using enum aliases should set the option to "true" in their .proto 2755 files. 2756 2757 C++ 2758 * New generated method set_allocated_foo(Type* foo) for message and string 2759 fields. This method allows you to set the field to a pre-allocated object 2760 and the containing message takes the ownership of that object. 2761 * Added SetAllocatedExtension() and ReleaseExtension() to extensions API. 2762 * Custom options are now formatted correctly when descriptors are printed in 2763 text format. 2764 * Various speed optimizations. 2765 2766 Java 2767 * Comments in proto files are now collected and put into generated code as 2768 comments for corresponding classes and data members. 2769 * Added Parser to parse directly into messages without a Builder. For 2770 example, 2771 Foo foo = Foo.PARSER.ParseFrom(input); 2772 Using Parser is ~25% faster than using Builder to parse messages. 2773 * Added getters/setters to access the underlying ByteString of a string field 2774 directly. 2775 * ByteString now supports more operations: substring(), prepend(), and 2776 append(). The implementation of ByteString uses a binary tree structure 2777 to support these operations efficiently. 2778 * New method findInitializationErrors() that lists all missing required 2779 fields. 2780 * Various code size and speed optimizations. 2781 2782 Python 2783 * Added support for dynamic message creation. DescriptorDatabase, 2784 DescriptorPool, and MessageFactory work like their C++ counterparts to 2785 simplify Descriptor construction from *DescriptorProtos, and MessageFactory 2786 provides a message instance from a Descriptor. 2787 * Added pickle support for protobuf messages. 2788 * Unknown fields are now preserved after parsing. 2789 * Fixed bug where custom options were not correctly populated. Custom 2790 options can be accessed now. 2791 * Added EnumTypeWrapper that provides better accessibility to enum types. 2792 * Added ParseMessage(descriptor, bytes) to generate a new Message instance 2793 from a descriptor and a byte string. 2794 27952011-05-01 version 2.4.1: 2796 2797 C++ 2798 * Fixed the friendship problem for old compilers to make the library now gcc 3 2799 compatible again. 2800 * Fixed vcprojects/extract_includes.bat to extract compiler/plugin.h. 2801 2802 Java 2803 * Removed usages of JDK 1.6 only features to make the library now JDK 1.5 2804 compatible again. 2805 * Fixed a bug about negative enum values. 2806 * serialVersionUID is now defined in generated messages for java serializing. 2807 * Fixed protoc to use java.lang.Object, which makes "Object" now a valid 2808 message name again. 2809 2810 Python 2811 * Experimental C++ implementation now requires C++ protobuf library installed. 2812 See the README.txt in the python directory for details. 2813 28142011-02-02 version 2.4.0: 2815 2816 General 2817 * The RPC (cc|java|py)_generic_services default value is now false instead of 2818 true. 2819 * Custom options can have aggregate types. For example, 2820 message MyOption { 2821 optional string comment = 1; 2822 optional string author = 2; 2823 } 2824 extend google.protobuf.FieldOptions { 2825 optional MyOption myoption = 12345; 2826 } 2827 This option can now be set as follows: 2828 message SomeType { 2829 optional int32 field = 1 [(myoption) = { comment:'x' author:'y' }]; 2830 } 2831 2832 C++ 2833 * Various speed and code size optimizations. 2834 * Added a release_foo() method on string and message fields. 2835 * Fixed gzip_output_stream sub-stream handling. 2836 2837 Java 2838 * Builders now maintain sub-builders for sub-messages. Use getFooBuilder() to 2839 get the builder for the sub-message "foo". This allows you to repeatedly 2840 modify deeply-nested sub-messages without rebuilding them. 2841 * Builder.build() no longer invalidates the Builder for generated messages 2842 (You may continue to modify it and then build another message). 2843 * Code generator will generate efficient equals() and hashCode() 2844 implementations if new option java_generate_equals_and_hash is enabled. 2845 (Otherwise, reflection-based implementations are used.) 2846 * Generated messages now implement Serializable. 2847 * Fields with [deprecated=true] will be marked with @Deprecated in Java. 2848 * Added lazy conversion of UTF-8 encoded strings to String objects to improve 2849 performance. 2850 * Various optimizations. 2851 * Enum value can be accessed directly, instead of calling getNumber() on the 2852 enum member. 2853 * For each enum value, an integer constant is also generated with the suffix 2854 _VALUE. 2855 2856 Python 2857 * Added an experimental C++ implementation for Python messages via a Python 2858 extension. Implementation type is controlled by an environment variable 2859 PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION (valid values: "cpp" and "python") 2860 The default value is currently "python" but will be changed to "cpp" in 2861 future release. 2862 * Improved performance on message instantiation significantly. 2863 Most of the work on message instantiation is done just once per message 2864 class, instead of once per message instance. 2865 * Improved performance on text message parsing. 2866 * Allow add() to forward keyword arguments to the concrete class. 2867 E.g. instead of 2868 item = repeated_field.add() 2869 item.foo = bar 2870 item.baz = quux 2871 You can do: 2872 repeated_field.add(foo=bar, baz=quux) 2873 * Added a sort() interface to the BaseContainer. 2874 * Added an extend() method to repeated composite fields. 2875 * Added UTF8 debug string support. 2876 28772010-01-08 version 2.3.0: 2878 2879 General 2880 * Parsers for repeated numeric fields now always accept both packed and 2881 unpacked input. The [packed=true] option only affects serializers. 2882 Therefore, it is possible to switch a field to packed format without 2883 breaking backwards-compatibility -- as long as all parties are using 2884 protobuf 2.3.0 or above, at least. 2885 * The generic RPC service code generated by the C++, Java, and Python 2886 generators can be disabled via file options: 2887 option cc_generic_services = false; 2888 option java_generic_services = false; 2889 option py_generic_services = false; 2890 This allows plugins to generate alternative code, possibly specific to some 2891 particular RPC implementation. 2892 2893 protoc 2894 * Now supports a plugin system for code generators. Plugins can generate 2895 code for new languages or inject additional code into the output of other 2896 code generators. Plugins are just binaries which accept a protocol buffer 2897 on stdin and write a protocol buffer to stdout, so they may be written in 2898 any language. See src/google/protobuf/compiler/plugin.proto. 2899 **WARNING**: Plugins are experimental. The interface may change in a 2900 future version. 2901 * If the output location ends in .zip or .jar, protoc will write its output 2902 to a zip/jar archive instead of a directory. For example: 2903 protoc --java_out=myproto_srcs.jar --python_out=myproto.zip myproto.proto 2904 Currently the archive contents are not compressed, though this could change 2905 in the future. 2906 * inf, -inf, and nan can now be used as default values for float and double 2907 fields. 2908 2909 C++ 2910 * Various speed and code size optimizations. 2911 * DynamicMessageFactory is now fully thread-safe. 2912 * Message::Utf8DebugString() method is like DebugString() but avoids escaping 2913 UTF-8 bytes. 2914 * Compiled-in message types can now contain dynamic extensions, through use 2915 of CodedInputStream::SetExtensionRegistry(). 2916 * Now compiles shared libraries (DLLs) by default on Cygwin and MinGW, to 2917 match other platforms. Use --disable-shared to avoid this. 2918 2919 Java 2920 * parseDelimitedFrom() and mergeDelimitedFrom() now detect EOF and return 2921 false/null instead of throwing an exception. 2922 * Fixed some initialization ordering bugs. 2923 * Fixes for OpenJDK 7. 2924 2925 Python 2926 * 10-25 times faster than 2.2.0, still pure-Python. 2927 * Calling a mutating method on a sub-message always instantiates the message 2928 in its parent even if the mutating method doesn't actually mutate anything 2929 (e.g. parsing from an empty string). 2930 * Expanded descriptors a bit. 2931 29322009-08-11 version 2.2.0: 2933 2934 C++ 2935 * Lite mode: The "optimize_for = LITE_RUNTIME" option causes the compiler 2936 to generate code which only depends libprotobuf-lite, which is much smaller 2937 than libprotobuf but lacks descriptors, reflection, and some other features. 2938 * Fixed bug where Message.Swap(Message) was only implemented for 2939 optimize_for_speed. Swap now properly implemented in both modes 2940 (Issue 91). 2941 * Added RemoveLast and SwapElements(index1, index2) to Reflection 2942 interface for repeated elements. 2943 * Added Swap(Message) to Reflection interface. 2944 * Floating-point literals in generated code that are intended to be 2945 single-precision now explicitly have 'f' suffix to avoid pedantic warnings 2946 produced by some compilers. 2947 * The [deprecated=true] option now causes the C++ code generator to generate 2948 a GCC-style deprecation annotation (no-op on other compilers). 2949 * google::protobuf::GetEnumDescriptor<SomeGeneratedEnumType>() returns the 2950 EnumDescriptor for that type -- useful for templates which cannot call 2951 SomeGeneratedEnumType_descriptor(). 2952 * Various optimizations and obscure bug fixes. 2953 2954 Java 2955 * Lite mode: The "optimize_for = LITE_RUNTIME" option causes the compiler 2956 to generate code which only depends libprotobuf-lite, which is much smaller 2957 than libprotobuf but lacks descriptors, reflection, and some other features. 2958 * Lots of style cleanups. 2959 2960 Python 2961 * Fixed endianness bug with floats and doubles. 2962 * Text format parsing support. 2963 * Fix bug with parsing packed repeated fields in embedded messages. 2964 * Ability to initialize fields by passing keyword args to constructor. 2965 * Support iterators in extend and __setslice__ for containers. 2966 29672009-05-13 version 2.1.0: 2968 2969 General 2970 * Repeated fields of primitive types (types other that string, group, and 2971 nested messages) may now use the option [packed = true] to get a more 2972 efficient encoding. In the new encoding, the entire list is written 2973 as a single byte blob using the "length-delimited" wire type. Within 2974 this blob, the individual values are encoded the same way they would 2975 be normally except without a tag before each value (thus, they are 2976 tightly "packed"). 2977 * For each field, the generated code contains an integer constant assigned 2978 to the field number. For example, the .proto file: 2979 message Foo { optional int bar_baz = 123; } 2980 would generate the following constants, all with the integer value 123: 2981 C++: Foo::kBarBazFieldNumber 2982 Java: Foo.BAR_BAZ_FIELD_NUMBER 2983 Python: Foo.BAR_BAZ_FIELD_NUMBER 2984 Constants are also generated for extensions, with the same naming scheme. 2985 These constants may be used as switch cases. 2986 * Updated bundled Google Test to version 1.3.0. Google Test is now bundled 2987 in its verbatim form as a nested autoconf package, so you can drop in any 2988 other version of Google Test if needed. 2989 * optimize_for = SPEED is now the default, by popular demand. Use 2990 optimize_for = CODE_SIZE if code size is more important in your app. 2991 * It is now an error to define a default value for a repeated field. 2992 Previously, this was silently ignored (it had no effect on the generated 2993 code). 2994 * Fields can now be marked deprecated like: 2995 optional int32 foo = 1 [deprecated = true]; 2996 Currently this does not have any actual effect, but in the future the code 2997 generators may generate deprecation annotations in each language. 2998 * Cross-compiling should now be possible using the --with-protoc option to 2999 configure. See README.txt for more info. 3000 3001 protoc 3002 * --error_format=msvs option causes errors to be printed in Visual Studio 3003 format, which should allow them to be clicked on in the build log to go 3004 directly to the error location. 3005 * The type name resolver will no longer resolve type names to fields. For 3006 example, this now works: 3007 message Foo {} 3008 message Bar { 3009 optional int32 Foo = 1; 3010 optional Foo baz = 2; 3011 } 3012 Previously, the type of "baz" would resolve to "Bar.Foo", and you'd get 3013 an error because Bar.Foo is a field, not a type. Now the type of "baz" 3014 resolves to the message type Foo. This change is unlikely to make a 3015 difference to anyone who follows the Protocol Buffers style guide. 3016 3017 C++ 3018 * Several optimizations, including but not limited to: 3019 - Serialization, especially to flat arrays, is 10%-50% faster, possibly 3020 more for small objects. 3021 - Several descriptor operations which previously required locking no longer 3022 do. 3023 - Descriptors are now constructed lazily on first use, rather than at 3024 process startup time. This should save memory in programs which do not 3025 use descriptors or reflection. 3026 - UnknownFieldSet completely redesigned to be more efficient (especially in 3027 terms of memory usage). 3028 - Various optimizations to reduce code size (though the serialization speed 3029 optimizations increased code size). 3030 * Message interface has method ParseFromBoundedZeroCopyStream() which parses 3031 a limited number of bytes from an input stream rather than parsing until 3032 EOF. 3033 * GzipInputStream and GzipOutputStream support reading/writing gzip- or 3034 zlib-compressed streams if zlib is available. 3035 (google/protobuf/io/gzip_stream.h) 3036 * DescriptorPool::FindAllExtensions() and corresponding 3037 DescriptorDatabase::FindAllExtensions() can be used to enumerate all 3038 extensions of a given type. 3039 * For each enum type Foo, protoc will generate functions: 3040 const string& Foo_Name(Foo value); 3041 bool Foo_Parse(const string& name, Foo* result); 3042 The former returns the name of the enum constant corresponding to the given 3043 value while the latter finds the value corresponding to a name. 3044 * RepeatedField and RepeatedPtrField now have back-insertion iterators. 3045 * String fields now have setters that take a char* and a size, in addition 3046 to the existing ones that took char* or const string&. 3047 * DescriptorPool::AllowUnknownDependencies() may be used to tell 3048 DescriptorPool to create placeholder descriptors for unknown entities 3049 referenced in a FileDescriptorProto. This can allow you to parse a .proto 3050 file without having access to other .proto files that it imports, for 3051 example. 3052 * Updated gtest to latest version. The gtest package is now included as a 3053 nested autoconf package, so it should be able to drop new versions into the 3054 "gtest" subdirectory without modification. 3055 3056 Java 3057 * Fixed bug where Message.mergeFrom(Message) failed to merge extensions. 3058 * Message interface has new method toBuilder() which is equivalent to 3059 newBuilderForType().mergeFrom(this). 3060 * All enums now implement the ProtocolMessageEnum interface. 3061 * Setting a field to null now throws NullPointerException. 3062 * Fixed tendency for TextFormat's parsing to overflow the stack when 3063 parsing large string values. The underlying problem is with Java's 3064 regex implementation (which unfortunately uses recursive backtracking 3065 rather than building an NFA). Worked around by making use of possessive 3066 quantifiers. 3067 * Generated service classes now also generate pure interfaces. For a service 3068 Foo, Foo.Interface is a pure interface containing all of the service's 3069 defined methods. Foo.newReflectiveService() can be called to wrap an 3070 instance of this interface in a class that implements the generic 3071 RpcService interface, which provides reflection support that is usually 3072 needed by RPC server implementations. 3073 * RPC interfaces now support blocking operation in addition to non-blocking. 3074 The protocol compiler generates separate blocking and non-blocking stubs 3075 which operate against separate blocking and non-blocking RPC interfaces. 3076 RPC implementations will have to implement the new interfaces in order to 3077 support blocking mode. 3078 * New I/O methods parseDelimitedFrom(), mergeDelimitedFrom(), and 3079 writeDelimitedTo() read and write "delimited" messages from/to a stream, 3080 meaning that the message size precedes the data. This way, you can write 3081 multiple messages to a stream without having to worry about delimiting 3082 them yourself. 3083 * Throw a more descriptive exception when build() is double-called. 3084 * Add a method to query whether CodedInputStream is at the end of the input 3085 stream. 3086 * Add a method to reset a CodedInputStream's size counter; useful when 3087 reading many messages with the same stream. 3088 * equals() and hashCode() now account for unknown fields. 3089 3090 Python 3091 * Added slicing support for repeated scalar fields. Added slice retrieval and 3092 removal of repeated composite fields. 3093 * Updated RPC interfaces to allow for blocking operation. A client may 3094 now pass None for a callback when making an RPC, in which case the 3095 call will block until the response is received, and the response 3096 object will be returned directly to the caller. This interface change 3097 cannot be used in practice until RPC implementations are updated to 3098 implement it. 3099 * Changes to input_stream.py should make protobuf compatible with appengine. 3100 31012008-11-25 version 2.0.3: 3102 3103 protoc 3104 * Enum values may now have custom options, using syntax similar to field 3105 options. 3106 * Fixed bug where .proto files which use custom options but don't actually 3107 define them (i.e. they import another .proto file defining the options) 3108 had to explicitly import descriptor.proto. 3109 * Adjacent string literals in .proto files will now be concatenated, like in 3110 C. 3111 * If an input file is a Windows absolute path (e.g. "C:\foo\bar.proto") and 3112 the import path only contains "." (or contains "." but does not contain 3113 the file), protoc incorrectly thought that the file was under ".", because 3114 it thought that the path was relative (since it didn't start with a slash). 3115 This has been fixed. 3116 3117 C++ 3118 * Generated message classes now have a Swap() method which efficiently swaps 3119 the contents of two objects. 3120 * All message classes now have a SpaceUsed() method which returns an estimate 3121 of the number of bytes of allocated memory currently owned by the object. 3122 This is particularly useful when you are reusing a single message object 3123 to improve performance but want to make sure it doesn't bloat up too large. 3124 * New method Message::SerializeAsString() returns a string containing the 3125 serialized data. May be more convenient than calling 3126 SerializeToString(string*). 3127 * In debug mode, log error messages when string-type fields are found to 3128 contain bytes that are not valid UTF-8. 3129 * Fixed bug where a message with multiple extension ranges couldn't parse 3130 extensions. 3131 * Fixed bug where MergeFrom(const Message&) didn't do anything if invoked on 3132 a message that contained no fields (but possibly contained extensions). 3133 * Fixed ShortDebugString() to not be O(n^2). Durr. 3134 * Fixed crash in TextFormat parsing if the first token in the input caused a 3135 tokenization error. 3136 * Fixed obscure bugs in zero_copy_stream_impl.cc. 3137 * Added support for HP C++ on Tru64. 3138 * Only build tests on "make check", not "make". 3139 * Fixed alignment issue that caused crashes when using DynamicMessage on 3140 64-bit Sparc machines. 3141 * Simplify template usage to work with MSVC 2003. 3142 * Work around GCC 4.3.x x86_64 compiler bug that caused crashes on startup. 3143 (This affected Fedora 9 in particular.) 3144 * Now works on "Solaris 10 using recent Sun Studio". 3145 3146 Java 3147 * New overload of mergeFrom() which parses a slice of a byte array instead 3148 of the whole thing. 3149 * New method ByteString.asReadOnlyByteBuffer() does what it sounds like. 3150 * Improved performance of isInitialized() when optimizing for code size. 3151 3152 Python 3153 * Corrected ListFields() signature in Message base class to match what 3154 subclasses actually implement. 3155 * Some minor refactoring. 3156 * Don't pass self as first argument to superclass constructor (no longer 3157 allowed in Python 2.6). 3158 31592008-09-29 version 2.0.2: 3160 3161 General 3162 * License changed from Apache 2.0 to 3-Clause BSD. 3163 * It is now possible to define custom "options", which are basically 3164 annotations which may be placed on definitions in a .proto file. 3165 For example, you might define a field option called "foo" like so: 3166 import "google/protobuf/descriptor.proto" 3167 extend google.protobuf.FieldOptions { 3168 optional string foo = 12345; 3169 } 3170 Then you annotate a field using the "foo" option: 3171 message MyMessage { 3172 optional int32 some_field = 1 [(foo) = "bar"] 3173 } 3174 The value of this option is then visible via the message's 3175 Descriptor: 3176 const FieldDescriptor* field = 3177 MyMessage::descriptor()->FindFieldByName("some_field"); 3178 assert(field->options().GetExtension(foo) == "bar"); 3179 This feature has been implemented and tested in C++ and Java. 3180 Other languages may or may not need to do extra work to support 3181 custom options, depending on how they construct descriptors. 3182 3183 C++ 3184 * Fixed some GCC warnings that only occur when using -pedantic. 3185 * Improved static initialization code, making ordering more 3186 predictable among other things. 3187 * TextFormat will no longer accept messages which contain multiple 3188 instances of a singular field. Previously, the latter instance 3189 would overwrite the former. 3190 * Now works on systems that don't have hash_map. 3191 3192 Java 3193 * Print @Override annotation in generated code where appropriate. 3194 3195 Python 3196 * Strings now use the "unicode" type rather than the "str" type. 3197 String fields may still be assigned ASCII "str" values; they will 3198 automatically be converted. 3199 * Adding a property to an object representing a repeated field now 3200 raises an exception. For example: 3201 # No longer works (and never should have). 3202 message.some_repeated_field.foo = 1 3203 3204 Windows 3205 * We now build static libraries rather than DLLs by default on MSVC. 3206 See vsprojects/readme.txt for more information. 3207 32082008-08-15 version 2.0.1: 3209 3210 protoc 3211 * New flags --encode and --decode can be used to convert between protobuf text 3212 format and binary format from the command-line. 3213 * New flag --descriptor_set_out can be used to write FileDescriptorProtos for 3214 all parsed files directly into a single output file. This is particularly 3215 useful if you wish to parse .proto files from programs written in languages 3216 other than C++: just run protoc as a background process and have it output 3217 a FileDescriptorList, then parse that natively. 3218 * Improved error message when an enum value's name conflicts with another 3219 symbol defined in the enum type's scope, e.g. if two enum types declared 3220 in the same scope have values with the same name. This is disallowed for 3221 compatibility with C++, but this wasn't clear from the error. 3222 * Fixed absolute output paths on Windows. 3223 * Allow trailing slashes in --proto_path mappings. 3224 3225 C++ 3226 * Reflection objects are now per-class rather than per-instance. To make this 3227 possible, the Reflection interface had to be changed such that all methods 3228 take the Message instance as a parameter. This change improves performance 3229 significantly in memory-bandwidth-limited use cases, since it makes the 3230 message objects smaller. Note that source-incompatible interface changes 3231 like this will not be made again after the library leaves beta. 3232 * Heuristically detect sub-messages when printing unknown fields. 3233 * Fix static initialization ordering bug that caused crashes at startup when 3234 compiling on Mac with static linking. 3235 * Fixed TokenizerTest when compiling with -DNDEBUG on Linux. 3236 * Fixed incorrect definition of kint32min. 3237 * Fix bytes type setter to work with byte sequences with embedded NULLs. 3238 * Other irrelevant tweaks. 3239 3240 Java 3241 * Fixed UnknownFieldSet's parsing of varints larger than 32 bits. 3242 * Fixed TextFormat's parsing of "inf" and "nan". 3243 * Fixed TextFormat's parsing of comments. 3244 * Added info to Java POM that will be required when we upload the 3245 package to a Maven repo. 3246 3247 Python 3248 * MergeFrom(message) and CopyFrom(message) are now implemented. 3249 * SerializeToString() raises an exception if the message is missing required 3250 fields. 3251 * Code organization improvements. 3252 * Fixed doc comments for RpcController and RpcChannel, which had somehow been 3253 swapped. 3254 * Fixed text_format_test on Windows where floating-point exponents sometimes 3255 contain extra zeros. 3256 * Fix Python service CallMethod() implementation. 3257 3258 Other 3259 * Improved readmes. 3260 * VIM syntax highlighting improvements. 3261 32622008-07-07 version 2.0.0: 3263 3264 * First public release. 3265