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 by adding files individually.

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 generate 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 decode_file_descriptor_proto<B>(
    &mut self,
    bytes: B
) -> Result<(), DescriptorError>where
    B: Buf,

Decode and 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.

Unlike when using add_file_descriptor_proto(), any extension options defined in the file descriptor are preserved.

pub fn decode_file_descriptor_set<B>(
    &mut self,
    bytes: B
) -> Result<(), DescriptorError>where
    B: Buf,

Decode and add a set of file descriptors to the 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.

Unlike when using add_file_descriptor_set(), any extension options defined in the file descriptors are preserved.

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

Gets an iterator over the file descriptors added to this pool.

pub fn get_file_by_name(&self, name: &str) -> Option<FileDescriptor>

Gets a file descriptor by its name, or None if no such file has been added.

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

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

pub fn encode<B>(&self, buf: B) -> Result<(), EncodeError>where
    B: BufMut,

Encodes the files contained within this DescriptorPool to their byte representation.

The encoded message is equivalent to a FileDescriptorSet, however also includes any extension options that were defined.

pub fn encode_to_vec(&self) -> Vec<u8>

Encodes the files contained within this DescriptorPool to a newly allocated buffer.

The encoded message is equivalent to a FileDescriptorSet, however also includes any extension options that were defined.

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 message types 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 enum types 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.

pub fn get_extension_by_name(&self, name: &str) -> Option<ExtensionDescriptor>

Gets an ExtensionDescriptor by its fully qualified name, for example my.package.my_extension.

pub fn get_service_by_name(&self, name: &str) -> Option<ServiceDescriptor>

Gets an ServiceDescriptor by its fully qualified name, for example my.package.MyService.

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 !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for DescriptorPool