dlldep Namespace Reference

Classes
class	Cache
class	Color
class	SharedLib
class	Stats

Functions
	anaLib (lib, opt, cache, select=[], ignore=[], depth=0)
	processLib (lib, opt, dotFileName=None)
	printStats ()
	main ()

Function Documentation

anaLib()

dlldep.anaLib	(		lib,
			opt,
			cache,
			select = [],
			ignore = [],
			depth = 0 )

Get dependencies of shared library recursively

Definition at line 141 of file dlldep.py.

def anaLib(lib, opt, cache, select = [], ignore = [], depth = 0):
   """Get dependencies of shared library recursively"""
 
   def process(path):
      """Should this lib be processed?"""
      for regexp in select:
         if regexp.match(path): return True
      if len(select)>0: return False
      
      for regexp in ignore:
         if regexp.match(path): return False
      return True
 
   if opt.maxdepth and depth>=opt.maxdepth: return
   
   # Check if we analyzed this lib already
   cachedlib = cache.myfiles.get(lib)
   if cachedlib:
      # Always save minimum distance
      if depth<cachedlib.distance: cachedlib.distance=depth
      return
 
   shlib = SharedLib(depth, lib)
   cache.add(shlib)
   
   for l in shlib.deplibs:
      if process(l):
         cache.dot('  "%s" -> "%s"' % (basename(lib), basename(l)))
         anaLib(l, opt, cache, select, ignore, depth+1)
         
   return
 
 

main()

dlldep.main

(

)

Definition at line 236 of file dlldep.py.

def main():
 
   import optparse
   parser = optparse.OptionParser(description="Create runtime dependecy graph for shared library. The output is a graph in DOT language. To visualize it use, e.g. 'dot -O -Tps mygraph.dot'. The rectangular nodes represent direct dependencies. Nodes belonging to the same project have the same color.",
                                  usage="%prog [OPTIONS] LIB [LIB...]")
 
   parser.add_option("-o", "--output",
                     help="File for DOT source code (default is LIB.dot)")
 
   parser.add_option("-d", "--maxdepth", type="int",
                     help="Maximum depth of dependency tree [1..]")
 
   parser.add_option("-f", "--filter", action="append",
                     help="Only analyze libraries matching regular expression (can be specified multiple times) [default: .*atlas/software.*]")
   
   parser.add_option("--nocolor", action="store_true",
                     help="Do not use colors")
 
   parser.add_option("-s", "--stats", action="store_true",
                     help="Print statistics")
 
   (opt, args) = parser.parse_args()
   if len(args)==0:
      parser.error("Invalid number of arguments specified")
      
 
   if len(args)>1 and opt.output:
      print ("Multiple libraries specified. Ignoring output file name.")
      opt.output = None
      
   for lib in args:
      processLib(lib, opt, opt.output)
 
   if opt.stats:
      printStats()
      
   return 0
 
 

printStats()

dlldep.printStats

(

)

Print statistics

Definition at line 224 of file dlldep.py.

def printStats():
   """Print statistics"""
   import operator
   
   print ("%-50s %7s %7s" % ("Library dependencies","Direct","Total"))
   print ("-"*70)
   for s in sorted(Cache.stats, key=operator.attrgetter("depDirect"), reverse=True):
      print ("%-50s %7d %7d" % (basename(s.lib), s.depDirect, s.depTotal))
 
   return
 
      

processLib()

dlldep.processLib	(		lib,
			opt,
			dotFileName = None )

Process one library

Definition at line 174 of file dlldep.py.

def processLib(lib, opt, dotFileName = None):
   """Process one library"""
 
   cache = Cache()
   dot = cache.dot   # shortcut
   
   dot('digraph DependencyTree {')
   dot('  ratio=0.9 nodesep=0.05')         # some reasonable default values
   dot('  "%s" [shape=box]' % basename(lib))
 
   select = []
   ignore = []   # currently not used
   if opt.filter:
      for f in opt.filter: select += [re.compile(f)]
   else:
      select = [re.compile(".*atlas/software.*")]
 
   anaLib(lib, opt, cache, select, ignore)
 
   # Declare style of all nodes
   for l,v in cache.myfiles.items():
      style = {}
      # Special style for direct dependencies
      if v.distance==1:
         style["shape"] = "box"
         
      if not opt.nocolor:
         style["style"] = "filled"
         style["fillcolor"] = Color.get(l)
         
      dot('  "%s"' % (basename(l)), style)
      
   dot('}')
   
   # Write output to file
   if dotFileName: outFile = open(dotFileName, "w")
   else: outFile = open(basename(lib)+".dot", "w")
   
   cache.writeDOT(outFile)
 
   # Calculate statistics
   if opt.stats:
      st = Stats(lib, cache)
      Cache.stats += [st]
      return st
 
   return None