Renamed _import_site_symbol to drop the _ prefix and be used by other
modules. 

Signed-off-by: Mihai Rusu <dizzy@google.com>



git-svn-id: http://test.kernel.org/svn/autotest/trunk@2739 592f7852-d20e-0410-864c-8624ca9c26a4
diff --git a/client/common_lib/utils.py b/client/common_lib/utils.py
index efa64a7..a9a4027 100644
--- a/client/common_lib/utils.py
+++ b/client/common_lib/utils.py
@@ -800,7 +800,20 @@
             fn(*args, **dargs)
 
 
-def _import_site_symbol(path, module, name, dummy=None, modulefile=None):
+def import_site_symbol(path, module, name, dummy=None, modulefile=None):
+    """
+    Try to import site specific symbol from site specific file if it exists
+
+    @param path full filename of the source file calling this (ie __file__)
+    @param module full module name
+    @param name symbol name to be imported from the site file
+    @param dummy dummy value to return in case there is no symbol to import
+    @param modulefile module filename
+
+    @return site specific symbol or dummy
+
+    @exception ImportError if the site file exists but imports fails
+    """
     short_module = module[module.rfind(".") + 1:]
 
     if not modulefile:
@@ -837,7 +850,7 @@
     Raises: ImportError if the site file exists but imports fails
     """
 
-    res = _import_site_symbol(path, module, classname, None, modulefile)
+    res = import_site_symbol(path, module, classname, None, modulefile)
 
     if not res:
         # we cannot just return baseclass because some callers will want to
@@ -866,4 +879,4 @@
     Raises: ImportError if the site file exists but imports fails
     """
 
-    return _import_site_symbol(path, module, funcname, dummy, modulefile)
+    return import_site_symbol(path, module, funcname, dummy, modulefile)