Allow module self-reference in loader

recipe_engine/loader.py

 # 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 555 matching lines @@
     }
     prop_defs = mod.PROPERTIES
     mod_api = invoke_with_properties(
         mod.API, engine.properties, prop_defs, **kwargs)
     mod_api.test_api = (getattr(mod, 'TEST_API', None)
                         or RecipeTestApi)(module=mod)
     for k, v in deps.iteritems():
       setattr(mod_api.m, k, v)
       setattr(mod_api.test_api.m, k, v.test_api)
 
+    # It is useful to have module's self-reference under .m . This allows
+    # passing module's API to other objects within that module, still having
+    # access to the module itself, along with all its dependencies.
+    setattr(mod_api.m, mod.NAME, mod_api)
+
     # Replace class-level Requirements placeholders in the recipe API with
     # their instance-level real values.
     map(lambda (k, v): setattr(mod_api, k, _resolve_requirement(v, engine)),
         ((k, v) for k, v in type(mod_api).__dict__.iteritems()
          if isinstance(v, _UnresolvedRequirement)))
 
     mod_api.initialize()
     return mod_api
 
   mapper = DependencyMapper(instantiator)
@@ skipping 34 matching lines @@
   for k,v in toplevel_deps.iteritems():
     setattr(api, k, mapper.instantiate(v))
   return api
 
 
 def _resolve_requirement(req, engine):
   if req._typ == 'client':
     return engine._get_client(req._name)
   else:
     raise ValueError('Unknown requirement type [%s]' % (req._typ,))