Cross-repo recipe package system.

third_party/recipe_engine/show_me_the_modules.py

 #!/usr/bin/env python
 # Copyright 2013 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 from __future__ import print_function
 
 import collections
 import inspect
 import os
 import sys
 
-sys.path.append(os.path.join(os.path.dirname(__file__), '..'))
-sys.path.append(os.path.join(os.path.dirname(__file__),
-                '..', '..', 'third_party'))
-
-from recipe_engine import main as recipe_main
-from recipe_engine import recipe_api
-from recipe_engine import loader
-
-from slave import recipe_universe
+from . import loader
+from . import main as recipe_main
+from . import package
+from . import recipe_api
 
 def trim_doc(docstring):
   """From PEP 257"""
   if not docstring:
     return ''
   # Convert tabs to spaces (following the normal Python rules)
   # and split into a list of lines:
   lines = docstring.expandtabs().splitlines()
   # Determine minimum indentation (first line doesn't count):
   indent = sys.maxint
@@ skipping 41 matching lines @@
     name = '@'+name
     if obj.fset:
       name += '(r/w)'
   p(indent_lvl, name, '', end='')
   if obj.__doc__:
     lines = trim_doc(obj.__doc__)
     p(0, '--', lines[0])
   else:
     p(0)
 
-def main():
+def main(package_cfg):
   common_methods = set(k for k, v in member_iter(recipe_api.RecipeApi))
   p(0, 'Common Methods -- %s' % os.path.splitext(recipe_api.__file__)[0])
   for method in sorted(common_methods):
     pmethod(1, method, getattr(recipe_api.RecipeApi, method))
 
-  universe = recipe_universe.get_universe()
-  deps = universe.deps_from_paths(
-      { modpath: modpath
-        for modpath in universe.loop_over_recipe_modules() },
-      base_path=None)
+  if isinstance(package_cfg, package.PackageDeps):
+    package_deps = package_cfg
+  else:
+    package_deps = package.PackageDeps.create(package_cfg)
+  universe = loader.RecipeUniverse(package_deps)
+  deps = universe.deps_from_spec(
+      # TODO(luqui): This doesn't handle name scoping correctly (e.g. same-named
+      # modules in different packages).
+      { modpath: modpath.split('/')[-1]
+        for modpath in universe.loop_over_recipe_modules() })
 
   inst = loader.create_recipe_api(
       deps, recipe_main.RecipeEngine(None, {}, None))
 
   for mod_name, mod in deps.iteritems():
     p(0)
     p(0, "(%s) -- %s" % (mod_name, mod.__path__[0]))
     if mod.LOADED_DEPS:
       p(1, 'DEPS:', list(mod.LOADED_DEPS))
 
     subinst = getattr(inst, mod_name)
     bases = set(subinst.__class__.__bases__)
     base_fns = set()
     for base in bases:
       for name, _ in inspect.getmembers(base):
         base_fns.add(name)
     for cool_base in bases - set((recipe_api.RecipeApi,)):
       p(1, 'behaves like %s' % map_to_cool_name(cool_base))
 
     if mod.API.__doc__:
       for line in trim_doc(mod.API.__doc__):
         p(2, '"', line)
 
     for fn_name, obj in member_iter(subinst):
       if fn_name in base_fns:
         continue
       pmethod(1, fn_name, obj)
-
-
-if __name__ == '__main__':
-  main()