DescriptorLibrary Functions

A descriptor library is an object that contains known definitions. It contains a cache of descriptor objects mapped by definition name, and contains all types of descriptors except for file sets.

If the application provides a definition name that is not in the library, the application can include a descriptor loader that attempts to resolve the missing descriptor.

DescriptorLibrary is provided by the protorpc.descriptor module.

Functions

DescriptorLibrary provides the following functions:

lookup_descriptor(definition_name)

Gets a descriptor from the library for the given definition name. If the descriptor is not found, attempts to find it using the descriptor loader.

Arguments
definition_name
The definition name for which to find a descriptor.

Returns a descriptor describing the definition name.

Raises a DefinitionNotFoundError error if no descriptor exists for the given definition name.

lookup_package(definition_name)

Determines the package name that any definition name belongs to. May check the parent for the package name. Attempts to resolve missing descriptors if provided a descriptor loader.

Arguments
definition_name
The definition name for which to find a package.

Returns a descriptor object describing the package name.