Où sont documentées les fonctions du bitbake python

Question

J'essaie de trouver la documentation pour "bb.utils.contains". J'ai trouvé le code dans pokey/bitbake/lib/utils.py, mais ce code est mal documenté. Par exemple, il prend un paramètre nommé "d". Qu'est-ce que "d"? Comment commencez-vous avec un nom court et non-descriptif comme ça?

J'ai téléchargé et recherché tous les documents yocto et poky, et effectué un nombre de recherches sur le Web, en vain.

Est-ce que quelqu'un connaît une bonne référence aux utilitaires bitbake python intégrés?

Answer 1

'd' est le dictionnaire actuel de toutes les valeurs extraites de l'environnement et des recettes. Voir data.py et data_smart.py. Je suis d'accord que les documents bitbake ne sont pas toujours complets, mais il existe une liste de diffusion bitbake-dev qui peut aussi aider.

Answer 2

La meilleure documentation que j'ai pu trouver était les docstrings dans le code lui-même. Voir ici: https://github.com/openembedded/bitbake/blob/master/lib/bb/utils.py#L950

def contains(variable, checkvalues, truevalue, falsevalue, d): 
    """Check if a variable contains all the values specified. 
     Arguments: 
     variable -- the variable name. This will be fetched and expanded (using 
      d.getVar(variable, True)) and then split into a set(). 
     checkvalues -- if this is a string it is split on whitespace into a set(), 
      otherwise coerced directly into a set(). 
     truevalue -- the value to return if checkvalues is a subset of variable. 
     falsevalue -- the value to return if variable is empty or if checkvalues is 
      not a subset of variable. 
     d -- the data store. 
    """