Class DescriptorPool

Check if the descriptor name conflicts with another of the same name.

Args:
  desc: Descriptor of a message, enum, service, extension or enum value.
  desc_name: the full name of desc.
  file_name: The file name of descriptor.

Adds a Descriptor to the pool, non-recursively.

If the Descriptor contains nested messages or enums, the caller must
explicitly register them. This method also registers the FileDescriptor
associated with the message.

Args:
  desc: A Descriptor.

Adds an EnumDescriptor to the pool.

This method also registers the FileDescriptor associated with the enum.

Args:
  enum_desc: An EnumDescriptor.

Adds a ServiceDescriptor to the pool.

Args:
  service_desc: A ServiceDescriptor.

Adds a FieldDescriptor describing an extension to the pool.

Args:
  extension: A FieldDescriptor.

Raises:
  AssertionError: when another extension with the same number extends the
    same message.
  TypeError: when the specified extension is not a
    descriptor.FieldDescriptor.

Adds a FileDescriptor to the pool, non-recursively.

If the FileDescriptor contains messages or enums, the caller must explicitly
register them.

Args:
  file_desc: A FileDescriptor.

Adds a FileDescriptor to the pool, non-recursively.

If the FileDescriptor contains messages or enums, the caller must explicitly
register them.

Args:
  file_desc: A FileDescriptor.

Gets the already built FileDescriptor containing the specified symbol.

Args:
  symbol: The name of the symbol to search for.

Returns:
  A FileDescriptor that contains the specified symbol.

Raises:
  KeyError: if the file cannot be found in the pool.

Try to Load extensions from decriptor db.

Args:
  message_descriptor: descriptor of the extended message.
  number: the extension number that needs to be loaded.

Finds the file in descriptor DB containing the specified symbol.

Args:
  symbol: The name of the symbol to search for.

Returns:
  A FileDescriptor that contains the specified symbol.

Raises:
  KeyError: if the file cannot be found in the descriptor database.

Creates a FileDescriptor from a proto or returns a cached copy.

This method also has the side effect of loading all the symbols found in
the file into the appropriate dictionaries in the pool.

Args:
  file_proto: The proto to convert.

Returns:
  A FileDescriptor matching the passed in proto.

Adds the proto to the pool in the specified package.

Args:
  desc_proto: The descriptor_pb2.DescriptorProto protobuf message.
  package: The package the proto should be located in.
  file_desc: The file containing this message.
  scope: Dict mapping short and full symbols to message and enum types.
  syntax: string indicating syntax of the file ("proto2" or "proto3")

Returns:
  The added descriptor.

Make a protobuf EnumDescriptor given an EnumDescriptorProto protobuf.

Args:
  enum_proto: The descriptor_pb2.EnumDescriptorProto protobuf message.
  package: Optional package name for the new message EnumDescriptor.
  file_desc: The file containing the enum descriptor.
  containing_type: The type containing this enum.
  scope: Scope containing available types.
  top_level: If True, the enum is a top level symbol. If False, the enum
      is defined inside a message.

Returns:
  The added descriptor

Creates a field descriptor from a FieldDescriptorProto.

For message and enum type fields, this method will do a look up
in the pool for the appropriate descriptor for that type. If it
is unavailable, it will fall back to the _source function to
create it. If this type is still unavailable, construction will
fail.

Args:
  field_proto: The proto describing the field.
  message_name: The name of the containing message.
  index: Index of the field
  file_desc: The file containing the field descriptor.
  is_extension: Indication that this field is for an extension.

Returns:
  An initialized FieldDescriptor object

Sets all the descriptor's fields's types.

This method also sets the containing types on any extensions.

Args:
  package: The current package of desc_proto.
  desc_proto: The message descriptor to update.
  scope: Enclosing scope of available types.

Sets the field's type, cpp_type, message_type and enum_type.

Args:
  field_proto: Data about the field in proto format.
  field_desc: The descriptor to modiy.
  package: The package the field's container is in.
  scope: Enclosing scope of available types.

Creates a enum value descriptor object from a enum value proto.

Args:
  value_proto: The proto describing the enum value.
  index: The index of the enum value.

Returns:
  An initialized EnumValueDescriptor object.

Make a protobuf ServiceDescriptor given a ServiceDescriptorProto.

Args:
  service_proto: The descriptor_pb2.ServiceDescriptorProto protobuf message.
  service_index: The index of the service in the File.
  scope: Dict mapping short and full symbols to message and enum types.
  package: Optional package name for the new message EnumDescriptor.
  file_desc: The file containing the service descriptor.

Returns:
  The added descriptor.

Creates a method descriptor from a MethodDescriptorProto.

Args:
  method_proto: The proto describing the method.
  service_name: The name of the containing service.
  package: Optional package name to look up for types.
  scope: Scope containing available types.
  index: Index of the method in the service.

Returns:
  An initialized MethodDescriptor object.

Pulls out all the symbols from descriptor protos.

Args:
  descriptors: The messages to extract descriptors from.
Yields:
  A two element tuple of the type name and descriptor object.

Recursively finds dependencies for file protos.

Args:
  dependencies: The names of the files being depended on.

Yields:
  Each direct and indirect dependency.

Finds a given type name in the current scope.

Args:
  package: The package the proto should be located in.
  type_name: The name of the type to be found in the scope.
  scope: Dict mapping short and full symbols to message and enum types.

Returns:
  The descriptor for the requested type.