Une bibliothèque de descripteurs est un objet qui contient des définitions connues. Elle contient un cache d'objets descripteurs mappés par nom de définition et contient tous les types de descripteurs, sauf pour les ensembles de fichiers.
Si l'application propose un nom de définition qui ne se trouve pas dans la bibliothèque, elle peut inclure un outil de chargement de descripteurs qui va tenter de retrouver le descripteur manquant.
DescriptorLibrary est fourni par le module protorpc.descriptor.
Fonctions
DescriptorLibrary propose les fonctions suivantes :
- lookup_descriptor(definition_name)
-
Récupère un descripteur dans la bibliothèque pour le nom de définition donné. Si le descripteur est introuvable, tente de le trouver à l'aide de l'outil de chargement de descripteurs.
Arguments- definition_name
- Nom de définition pour lequel rechercher un descripteur.
Renvoie un descripteur qui décrit le nom de définition.
Génère une erreur DefinitionNotFoundError s'il n'existe aucun descripteur pour le nom de définition donné.
- lookup_package(definition_name)
-
Détermine le nom de package auquel appartient un nom de définition. Peut vérifier le parent du nom de package. Tente de retrouver les descripteurs manquants si un outil de chargement de descripteurs est fourni.
Arguments- definition_name
- Nom de définition pour lequel rechercher un package.
Renvoie un objet descripteur qui décrit le nom de package.