Dove sono documentate le funzioni Python di bitbake

Question

Sto cercando di trovare la documentazione per "bb.utils.contains". Ho trovato il codice in pokey/bitbake/lib/utils.py, ma quel codice è scarsamente documentato. Ad esempio, richiede un parametro denominato "d". Cos'è "d"? Come si inizia anche con un nome breve non descrittivo come quello?

Ho scaricato e cercato tutti i documenti yocto e poky e ho eseguito un numero di ricerche sul Web, inutilmente.

Qualcuno sa di un buon riferimento alle utilità di python bitbake integrate?

Answer 1

'd' è il dizionario corrente di tutti i valori estratti dall'ambiente e dalle ricette. Vedi data.py e data_smart.py.

Sono d'accordo che i documenti bitbake non sono sempre completi, ma esiste anche una mailing list bitbake-dev che può essere d'aiuto.

Answer 2

La documentazione migliore che ho trovato erano le docstring nel codice stesso. Vedi qui: 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. 
    """