Struct prost_reflect::DescriptorPool

pub struct DescriptorPool { /* private fields */ }

A DescriptorPool is a collection of related descriptors. Typically it will be created from a FileDescriptorSet output by the protobuf compiler (see DescriptorPool::from_file_descriptor_set) but it may also be built up manually by adding individual files.

Methods like MessageDescriptor::extensions will be scoped to just the files contained within the parent DescriptorPool.

This type is uses reference counting internally so it is cheap to clone. Modifying an instance of a pool will not update any existing clones of the instance.

Implementations

impl DescriptorPool

pub fn new() -> Self

Creates a new, empty DescriptorPool.

For the common case of creating a DescriptorPool from a single FileDescriptorSet, see DescriptorPool::from_file_descriptor_set or DescriptorPool::decode.

pub fn from_file_descriptor_set(
    file_descriptor_set: FileDescriptorSet
) -> Result<Self, DescriptorError>

Creates a DescriptorPool from a FileDescriptorSet.

This is equivalent to calling DescriptorPool::add_file_descriptor_set on an empty DescriptorPool instance. See that method’s documentation for details.

pub fn decode<B>(bytes: B) -> Result<Self, DescriptorError> where
    B: Buf, 

Decodes a FileDescriptorSet from its protobuf byte representation and creates a new DescriptorPool wrapping it.

pub fn add_file_descriptor_set(
    &mut self,
    file_descriptor_set: FileDescriptorSet
) -> Result<(), DescriptorError>

Adds a new FileDescriptorSet to this DescriptorPool.

A file descriptor set may be generated by running the protobuf compiler with the --descriptor_set_out flag. If you are using prost-build, then Config::file_descriptor_set_path is a convenient way to generated it as part of your build.

This method may return an error if file_descriptor_set is invalid, for example it contains references to types not in the set. If file_descriptor_set was created by the protobuf compiler, these error cases should never occur since it performs its own validation.

pub fn add_file_descriptor_protos<I>(
    &mut self,
    files: I
) -> Result<(), DescriptorError> where
    I: IntoIterator<Item = FileDescriptorProto>, 

Adds a collection of file descriptors to this pool.

The file descriptors may be provided in any order, however all types referenced must be defined either in one of the files provided, or in a file previously added to the pool.

Duplicate file descriptors are ignored, however adding two different files with the same name will return an error.

pub fn add_file_descriptor_proto(
    &mut self,
    file: FileDescriptorProto
) -> Result<(), DescriptorError>

Add a single file descriptor to the pool.

All types referenced by the file must be defined either in the file itself, or in a file previously added to the pool.

pub fn file_descriptor_protos(
    &self
) -> impl ExactSizeIterator<Item = &FileDescriptorProto> + '_

Gets a iterator over the raw FileDescriptorProto instances wrapped by this DescriptorPool.

pub fn services(&self) -> impl ExactSizeIterator<Item = ServiceDescriptor> + '_

Gets an iterator over the services defined in these protobuf files.

pub fn all_messages(
    &self
) -> impl ExactSizeIterator<Item = MessageDescriptor> + '_

Gets an iterator over all messages defined in these protobuf files.

The iterator includes nested messages defined in another message.

pub fn all_enums(&self) -> impl ExactSizeIterator<Item = EnumDescriptor> + '_

Gets an iterator over all enums defined in these protobuf files.

The iterator includes nested enums defined in another message.

pub fn all_extensions(
    &self
) -> impl ExactSizeIterator<Item = ExtensionDescriptor> + '_

Gets an iterator over all extension fields defined in these protobuf files.

The iterator includes nested extension fields defined in another message.

pub fn get_message_by_name(&self, name: &str) -> Option<MessageDescriptor>

Gets a MessageDescriptor by its fully qualified name, for example my.package.MessageName.

pub fn get_enum_by_name(&self, name: &str) -> Option<EnumDescriptor>

Gets an EnumDescriptor by its fully qualified name, for example my.package.EnumName.

Trait Implementations

impl Clone for DescriptorPool

fn clone(&self) -> DescriptorPool

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DescriptorPool

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DescriptorPool

fn default() -> DescriptorPool

Returns the “default value” for a type.

impl PartialEq<DescriptorPool> for DescriptorPool

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl Eq for DescriptorPool