nebius.base.protos.descriptor.DescriptorWrap

class documentation

class DescriptorWrap(ABC, Generic[T]): (source)

Lazy resolver for protobuf descriptors by fully qualified name.

Instances are callable; the first call resolves and caches the descriptor.

Parameters
name	Fully qualified descriptor name. Leading `.` is allowed.
file_descriptor	Protobuf file descriptor to search within.
expected_type	Descriptor type expected by the caller.

Method	`__call__`	Retrieve the descriptor of the specified type using the fully qualified name.
Method	`__init__`	Create a descriptor wrapper.
Method	`_find_descriptor`	Recursively search for a descriptor by name.
Instance Variable	`_descriptor`	Cached resolved descriptor.
Instance Variable	`_expected_type`	Expected descriptor class.
Instance Variable	`_file_descriptor`	Root file descriptor used for lookup.
Instance Variable	`_name`	Normalized fully qualified name.

Retrieve the descriptor of the specified type using the fully qualified name.

def __init__(self, name: str, file_descriptor: pb.FileDescriptor, expected_type: type[T]): (source) ¶

Create a descriptor wrapper.

Parameters
name:`str`	Fully qualified descriptor name.
file_descriptor:`pb.FileDescriptor`	Protobuf file descriptor to search within.
expected_type:`type[T]`	Descriptor type expected by the caller.

Recursively search for a descriptor by name.

Parameters
container:`pb.FileDescriptor \| pb.Descriptor`	File or message descriptor to search within.
name:`str`	Fully qualified name to resolve.
Returns
`pb.Descriptor \| pb.EnumDescriptor \| pb.OneofDescriptor \| pb.ServiceDescriptor \| None`	Matching descriptor or `None` if not found.
Raises
`ValueError`	If the protobuf pool returns an unexpected type.

Cached resolved descriptor.

Expected descriptor class.

Root file descriptor used for lookup.

Normalized fully qualified name.