Allow specifying a non-relative module name in config_path

When constructing the config search path, allow callers to directly pass
in a non-relative module name starting with `pkg://`.  This allows
callers to bypass the relative name lookup, and always get consistent
behavior regardless of the current environment variables at runtime.

This addresses issue #2564.

Author: Adam Simpkins

hydra/_internal/utils.py

@@ -123,9 +123,13 @@ def compute_search_path_dir(
     calling_module: Optional[str],
     config_path: Optional[str],
 ) -> Optional[str]:
-    if config_path is not None and os.path.isabs(config_path):
-        search_path_dir = config_path
-    elif calling_file is not None:
+    if config_path is not None:
+        if os.path.isabs(config_path):
+            return config_path
+        if config_path.startswith("pkg://"):
+            return config_path
+
+    if calling_file is not None:
         abs_base_dir = realpath(dirname(calling_file))
 
         if config_path is not None:

news/2564.feature

@@ -0,0 +1 @@
+Allow config_path to specify a non-relative module path, by starting with `pkg://`

tests/test_config_search_path.py

@@ -172,6 +172,7 @@ def test_prepend(
             "../conf",
             realpath(os.path.join(os.getcwd(), "../conf")),
         ),
+        (None, "package.module", "pkg://some/conf", "pkg://some/conf"),
     ],
 )
 def test_compute_search_path_dir(