Systematically rename find_in_cuda_home → find_in_cuda_path

Author: rwgk

cuda_pathfinder/cuda/pathfinder/_dynamic_libs/search_steps.py

@@ -182,7 +182,7 @@ def find_in_conda(ctx: SearchContext) -> FindResult | None:
     return None
 
 
-def find_in_cuda_home(ctx: SearchContext) -> FindResult | None:
+def find_in_cuda_path(ctx: SearchContext) -> FindResult | None:
     """Search ``$CUDA_PATH`` / ``$CUDA_HOME``.
 
     On Windows, this is the normal fallback for system-installed CTK DLLs when
@@ -211,7 +211,7 @@ def find_in_cuda_home(ctx: SearchContext) -> FindResult | None:
 EARLY_FIND_STEPS: tuple[FindStep, ...] = (find_in_site_packages, find_in_conda)
 
 #: Find steps that run after system search fails.
-LATE_FIND_STEPS: tuple[FindStep, ...] = (find_in_cuda_home,)
+LATE_FIND_STEPS: tuple[FindStep, ...] = (find_in_cuda_path,)
 
 
 # ---------------------------------------------------------------------------

cuda_pathfinder/cuda/pathfinder/_headers/find_nvidia_headers.py

@@ -100,7 +100,7 @@ def find_in_conda(desc: HeaderDescriptor) -> LocatedHeaderDir | None:
     return None
 
 
-def find_in_cuda_home(desc: HeaderDescriptor) -> LocatedHeaderDir | None:
+def find_in_cuda_path(desc: HeaderDescriptor) -> LocatedHeaderDir | None:
     """Search ``$CUDA_PATH`` / ``$CUDA_HOME``."""
     cuda_home = get_cuda_path_or_home()
     if cuda_home is None:
@@ -150,7 +150,7 @@ def find_in_system_install_dirs(desc: HeaderDescriptor) -> LocatedHeaderDir | No
 FIND_STEPS: tuple[HeaderFindStep, ...] = (
     find_in_site_packages,
     find_in_conda,
-    find_in_cuda_home,
+    find_in_cuda_path,
     find_via_ctk_root_canary,
     find_in_system_install_dirs,
 )

cuda_pathfinder/tests/test_search_steps.py

@@ -19,7 +19,7 @@
     SearchContext,
     _find_lib_dir_using_anchor,
     find_in_conda,
-    find_in_cuda_home,
+    find_in_cuda_path,
     find_in_site_packages,
     run_find_steps,
 )
@@ -191,14 +191,14 @@ def test_found_windows(self, mocker, tmp_path):
 
 
 # ---------------------------------------------------------------------------
-# find_in_cuda_home
+# find_in_cuda_path
 # ---------------------------------------------------------------------------
 
 
 class TestFindInCudaHome:
     def test_returns_none_without_env_var(self, mocker):
         mocker.patch(f"{_STEPS_MOD}.get_cuda_path_or_home", return_value=None)
-        assert find_in_cuda_home(_ctx(platform=LinuxSearchPlatform())) is None
+        assert find_in_cuda_path(_ctx(platform=LinuxSearchPlatform())) is None
 
     def test_found_linux(self, mocker, tmp_path):
         lib_dir = tmp_path / "lib64"
@@ -208,7 +208,7 @@ def test_found_linux(self, mocker, tmp_path):
 
         mocker.patch(f"{_STEPS_MOD}.get_cuda_path_or_home", return_value=str(tmp_path))
 
-        result = find_in_cuda_home(_ctx(platform=LinuxSearchPlatform()))
+        result = find_in_cuda_path(_ctx(platform=LinuxSearchPlatform()))
         assert result is not None
         assert result.abs_path == str(so_file)
         assert result.found_via == "CUDA_PATH"
@@ -221,7 +221,7 @@ def test_found_windows(self, mocker, tmp_path):
 
         mocker.patch(f"{_STEPS_MOD}.get_cuda_path_or_home", return_value=str(tmp_path))
 
-        result = find_in_cuda_home(_ctx(platform=WindowsSearchPlatform()))
+        result = find_in_cuda_path(_ctx(platform=WindowsSearchPlatform()))
         assert result is not None
         assert result.abs_path == str(dll)
         assert result.found_via == "CUDA_PATH"
@@ -269,7 +269,7 @@ def test_early_find_steps_contains_expected(self):
         assert find_in_conda in EARLY_FIND_STEPS
 
     def test_late_find_steps_contains_expected(self):
-        assert find_in_cuda_home in LATE_FIND_STEPS
+        assert find_in_cuda_path in LATE_FIND_STEPS
 
     def test_early_and_late_are_disjoint(self):
         assert not set(EARLY_FIND_STEPS) & set(LATE_FIND_STEPS)
@@ -318,7 +318,7 @@ def test_find_lib_dir_returns_none_when_no_match(self, tmp_path):
         assert _find_lib_dir_using_anchor(desc, LinuxSearchPlatform(), str(tmp_path)) is None
 
     def test_nvvm_cuda_home_linux(self, mocker, tmp_path):
-        """End-to-end: find_in_cuda_home resolves nvvm under its custom subdir."""
+        """End-to-end: find_in_cuda_path resolves nvvm under its custom subdir."""
         mocker.patch(f"{_STEPS_MOD}.get_cuda_path_or_home", return_value=str(tmp_path))
 
         nvvm_dir = tmp_path / "nvvm" / "lib64"
@@ -331,7 +331,7 @@ def test_nvvm_cuda_home_linux(self, mocker, tmp_path):
             linux_sonames=("libnvvm.so",),
             anchor_rel_dirs_linux=("nvvm/lib64",),
         )
-        result = find_in_cuda_home(_ctx(desc, platform=LinuxSearchPlatform()))
+        result = find_in_cuda_path(_ctx(desc, platform=LinuxSearchPlatform()))
         assert result is not None
         assert result.abs_path == str(so_file)
         assert result.found_via == "CUDA_PATH"