prost-reflect-derive

Added

• Add OneofDescriptor::is_synthetic (#175)
• Add default_value method to FieldDescriptor, ExtensionDescriptor and Value for better visibility (#176)

Changed

• Update prost to 0.14.0 (#167)
• Fixed documentation for prost-reflect-build (#169)

Fixed

• The JSON deserializer now accepts messages with oneofs where multiple fields are set, but only one is non-null, to better conform to the specification. This does not apply to google.protobuf.Value or google.protobuf.NullValue.
• If the deny_unknown_fields field is set to false when deserializing from JSON, unknown enum fields will now be ignored, in addition to unknown fields. This matches the behaviour of this flag in other implementations.

Changed

• The minimum supported rust version is now 1.74.0.

Fixed

• Fixed an unused type parameter on DescriptorPool::add_file_descriptor_protos. ([#150])

Changed

• Updated to prost 0.13.0

Changed

• The minimum supported rust version is now 1.70.0.
• Updated the miette dependency to version 7.0.0.

Changed

• The minimum supported rust version is now 1.64.0.
• Updated to prost 0.12.0
• When adding files to a DescriptorPool, the library now validates that all referenced types are contained within the dependency files (including files imported using import public). Fixes [#57].

Added

• Added a global descriptor pool which can be fetched using DescriptorPool::global(). By default it just contains well-known types, but additional files can be added using DescriptorPool::decode_global_file_descriptor_set() and DescriptorPool::add_global_file_descriptor_proto(). ([#13])
• prost-reflect-derive Added the file_descriptor_set_bytes attribute as an alternative to descriptor_pool, which automatically registers the file with the global pool.
• prost-reflect-build Added Builder::file_descriptor_pool_bytes to set the file_descriptor_set_bytes derive attribute.

Changed

• Duplicate files are now always ignored when adding to a DescriptorPool (previously, the code would skip files with identical contents, but now it skips any file with the same name).
• prost-reflect-derive Update syn requirement from 1.0.84 to 2.0.3
• prost-reflect-build Breaking Renamed Builder::file_descriptor_expr to Builder::descriptor_pool.
• prost-reflect-build Breaking Removed the default behaviour of looking for the file descriptor under crate::DESCRIPTOR_POOL. One of descriptor_pool or file_descriptor_pool_bytes must be set explicitly.

Added

• Added the path() method to all descriptor types, which returns a path that can be used to get source code info by comparing against Location::path.
• Added the options() method to all descriptor types, which returns a message containing the options defined for the descriptor, including custom options.
• The uninterpreted_options field of options is now used to populate options if it is present.
  • Note that if the text-format feature flag is not enabled, then options set through the aggregate_value field will be ignored.
• Added several new validation checks when constructing a DescriptorPool instance.
• Added new file(), line() and column() methods to get more context information about errors.
• When the miette feature is enabled, DescriptorError now implements Diagnostic. When source code is provided through DescriptorError::with_source_code, and span information is provided in FileDescriptorProto::source_code_info, then the error will have labels annotating relevant portions of the source.

Changed

• The minimum supported rust version is now 1.60.0.
• Breaking: The FileDescriptor::dependencies now returns all imported files, instead of just those imported with import public. The new public_dependencies method preserves the old behaviour ([#19]).
• Breaking: The reflect-well-known-types feature flag has been removed, and the functionality is now always available.
• Updated the base64 dependency to version 0.20.0.

Added

• Added MessageDescriptor::get_extension_by_full_name().

Changed

• Updated to prost 0.11.0
• When the serde feature is enabled, the functions in prost-types for parsing and formatting time types are now used. This removes the time dependency.
• The minimum supported rust version is now 1.56.0.

Added

• DescriptorPool (formerly FileDescriptor) now supports adding individual FileDescriptorProto instances (#6).

Changed

• Breaking: FileDescriptor has been renamed to DescriptorPool. (The name FileDescriptor may be used in a future release to provide an API for inspecting individual source files)
  • FileDescriptor::new has been renamed to DescriptorPool::from_file_descriptor_set.
  • FileDescriptor::file_descriptor_set has been replaced by DescriptorPool::file_descriptor_protos to allow for it containing multiple sets of descriptors.
  • The parent_file method on all descriptor types has been renamed to parent_pool.
  • The file_descriptor parameter of the ReflectMessage derive macro has been renamed to descriptor_pool.
  • The default value of the descriptor pool expression for prost-reflect-build is changed from crate::FILE_DESCRIPTOR to crate::DESCRIPTOR_POOL.

Changed

• Updated to version 0.10.0 of prost.

Added

• The public dependencies prost, prost-types and bytes are now re-exported from the crate root.

Added

• Added implementations of [ReflectMessage] for the google well-known types in prost-types, behind a feature flag reflect-well-known-types.

Changed

• The minimum supported rust version is now 1.54.0.

Added

• Extension fields are now decoded from their byte representation
• Added APIs to get extensions for a given message.

Changed

• DynamicMessage::get_extension no longer returns an option.

Added

• New helper method DynamicMessage::decode.
• New APIs to get reserved names and fields for messages and enums
• New descriptor APIs to inspect extension fields
• New dynamic message APIs to get and set extension fields

Changed

• Renamed SerializeOptions::emit_unpopulated_fields to SerializeOptions::skip_default_fields (note the meaning is inverted as well!).
• DynamicMessage::{has_field,get_field,set_field,clear_field} now take a field descriptor instead of a number. Use the new _by_number variants for the old behavior.

Fixed

• The library now passes the protobuf conformance tests. This uncovered a number of edge cases:

  • Fixed unpacked fields not accepting packed bytes
  • Unknown fields are now preserved and roundtripped.
  • Fixed default value for enums with negative values
  • When receiving multiple fields of a oneof in the byte representation, only the last is set.
  • Trailing zeros (e.g. 10.00) are now accepted when parsing integers from the JSON representation.
  • Fixed handling of null in JSON deserialization.
  • Deserialization of google.protobuf.NullValue now accepts the "NULL_VALUE" string.
  • Deserialization of floats from JSON now validates the value is in range.
  • Nonzero trailing bits are allowed when deserializing JSON bytes from base64.
  • Serialization of google.protobuf.FieldMask fails if the path cannot be roundtripped through camelCase.
  • google.protobuf.Duration uses a different number of trailing zeroes depending on the precision of the input.
  • JSON serialization of google.protobuf.Timestamp and google.protobuf.Duration fails if it is outside the allowed range.
  • Duplicate oneof fields is now an error during JSON deserialization
  • Extensions are roundtripped though JSON format

Added

• Added support for JSON mapping of google.protobuf.Any.

Added

• Builder methods on SerializeOptions and DeserializeOptions are now const.

Fixed

• Fixed a case where serialization could produce invalid JSON.

Fixed

• Fixed docs for ReflectMessage macro.

Added

• Added parent_message() method to MessageDescriptor and EnumDescriptor to support inspecting the structure of nested types.
• Added package_name() method to MessageDescriptor, EnumDescriptor and ServiceDescriptor to determine which package they are defined in.
• Added ReflectMessage trait for types which can identify themselves with a MessageDescriptor.
• Added a derive macro which can be used as part of prost_build to generate ReflectMessage implementations.

Changed

• Renamed merge_from_message to transcode_from and to_message to transcode_to.