Deprecate get_search_path

Author: JelleZijlstra

README.rst

@@ -84,6 +84,7 @@ Changelog
 Unreleased
 
 - Drop support for Python 3.7
+- ``typeshed_client.finder.get_search_path()`` is now deprecated, as it is no longer useful
 
 Version 2.4.0 (September 29, 2023)
 

setup.py

@@ -46,7 +46,7 @@ def find_bundled_files() -> Iterable[str]:
     },
     license="MIT",
     packages=["typeshed_client"],
-    install_requires=["importlib_resources >= 1.4.0"],
+    install_requires=["importlib_resources >= 1.4.0", "typing-extensions>=4.5.0"],
     package_data={"typeshed_client": list(find_bundled_files())},
     classifiers=[
         "Development Status :: 3 - Alpha",

typeshed_client/finder.py

@@ -22,6 +22,7 @@
 )
 
 import importlib_resources
+from typing_extensions import deprecated
 
 PythonVersion = Tuple[int, int]
 ModulePath = NewType("ModulePath", Tuple[str, ...])
@@ -209,6 +210,10 @@ def _get_all_stub_files_from_directory(
 
 
 @lru_cache
+@deprecated(
+    "This function is not useful with the current layout of typeshed. "
+    "It may be removed from a future version of typeshed-client."
+)
 def get_search_path(typeshed_dir: Path, pyversion: Tuple[int, int]) -> Tuple[Path, ...]:
     # mirrors default_lib_path in mypy/build.py
     path: List[Path] = []