conary.query

displayTroves(db, cfg, troveSpecs=`[]`, pathList=`[]`, whatProvidesList=`[]`, info=False, digSigs=False, showBuildReqs=False, showDeps=False, ls=False, lsl=False, ids=False, sha1s=False, tags=False, fileDeps=False, fileVersions=False, fileFlavors=False, showTroves=False, recurse=None, showAllTroves=False, weakRefs=False, showTroveFlags=False, pristine=True, alwaysDisplayHeaders=False, exactFlavors=False)

Displays troves after finding them on the local system

Parameters:

db (local.database.Database) - Database instance to search for troves in
cfg (conarycfg.ConaryConfiguration) - conary config
troveSpecs (list of troveSpecs (n[=v][[f]])) - troves to search for
pathList (list of strings) - paths to match up to troves
whatProvidesList (list of strings) - list of dependencies to find provides for
info (bool) - If true, display general information about the trove
digSigs (bool) - If true, display digital signatures for a trove.
showBuildReqs (bool) - If true, display the versions and flavors of the build requirements that were used to build the given troves
showDeps (bool) - If true, display provides and requires information for the trove.
ls (bool) - If true, list files in the trove
lsl (bool) - If true, list files in the trove + ls -l information
ids (bool) - If true, list pathIds for files in the troves
sha1s (bool) - If true, list sha1s for files in the troves
tags (bool) - If true, list tags for files in the troves
fileDeps (bool) - If true, print file-level dependencies
fileVersions (bool) - If true, print fileversions
showTroves (bool) - If true, display byDefault True child troves of this trove
recurse (bool) - display child troves of this trove, recursively
showAllTroves (bool) - If true, display all byDefault False child troves of this trove
weakRefs (bool) - display both weak and strong references of this trove.
showTroveFlags (bool) - display [<flags>] list with information about the given troves.
pristine (bool) - If true, display the pristine version of this trove
alwaysDisplayHeaders (bool) - If true, display headers even when listing files.

Returns: None

getTrovesToDisplay(db, troveSpecs, pathList=`[]`, whatProvidesList=`[]`, exactFlavors=False)

PUBLIC API

Finds the given trove and path specifiers, and returns matching
       (n,v,f) tuples.
       @param db: database to search
       @type db: local.database.Database
       @param troveSpecs: troves to search for
       @type troveSpecs: list of troveSpecs (n[=v][[f]])
       @param pathList: paths which should be linked to some trove in this 
                        database.
       @type pathList: list of strings
       @param whatProvidesList: deps to search for providers of
       @type whatProvidesList: list of strings
     
       @raises TroveSpecError: Raised if one of the troveSpecs is of an 
                               invalid format

       @note: This function calls database routines which could raise any
              errors defined in L{dbstore.sqlerrors}

       @rtype: troveTupleList (list of (name, version, flavor) tuples), 
               and a boolean that stats whether the troves returned should
               be considered primary (and therefore not compressed ever).

Decorators:

@api.publicApi

Module query

getTrovesToDisplay(db, troveSpecs, pathList=[], whatProvidesList=[], exactFlavors=False)

getTrovesToDisplay(db, troveSpecs, pathList=`[]`, whatProvidesList=`[]`, exactFlavors=False)