doc: General improvements.

recipe_engine/loader.py

-# Copyright 2013 The LUCI Authors. All rights reserved.
+# Copyright 2016 The LUCI Authors. All rights reserved.
 # Use of this source code is governed under the Apache License, Version 2.0
 # that can be found in the LICENSE file.
 
 import collections
 import contextlib
 import imp
 import inspect
 import os
 import sys
 
@@ skipping 240 matching lines @@
     for path in self.package.recipe_dirs:
       for recipe in scan_directory(
           path, lambda f: f.endswith('.py') and f[0] != '_'):
         yield recipe, recipe[len(path)+1:-len('.py')]
     for path in self.package.module_dirs:
       for recipe in scan_directory(
           path, lambda f: f.endswith('example.py')):
         module_name = os.path.dirname(recipe)[len(path)+1:]
         yield recipe, '%s:example' % module_name
 
+  def loop_over_recipe_modules(self):
+    """Yields the paths to all the modules that this view can see."""
+    for path in self.package.module_dirs:
+      if os.path.isdir(path):
+        for item in os.listdir(path):
+          subpath = os.path.join(path, item)
+          if _is_recipe_module_dir(subpath):
+            yield os.path.basename(subpath)
+
 
 def _amend_exception(e, amendment):
   """Re-raise an exception e, appending amendment to the end of the message."""
   raise type(e), type(e)(e.message + '\n' + amendment), sys.exc_info()[2]
 
 
 def _is_recipe_module_dir(path):
   return (os.path.isdir(path) and
           os.path.isfile(os.path.join(path, '__init__.py')))
 
@@ skipping 272 matching lines @@
     modapi = (getattr(mod, 'TEST_API', None) or RecipeTestApi)(module=mod)
     for k,v in deps.iteritems():
       setattr(modapi.m, k, v)
     return modapi
 
   mapper = DependencyMapper(instantiator)
   api = RecipeTestApi(module=None)
   for k,v in toplevel_deps.iteritems():
     setattr(api, k, mapper.instantiate(v))
   return api