Expose find_uv_bin and declare typing support (#1728)

Resolves https://github.com/astral-sh/uv/issues/1677

Signed-off-by: Bernát Gábor <bgabor8@bloomberg.net>

python/uv/__init__.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+import os
+import sys
+import sysconfig
+
+
+def find_uv_bin() -> str:
+    """Return the uv binary path."""
+
+    uv_exe = "uv" + sysconfig.get_config_var("EXE")
+
+    path = os.path.join(sysconfig.get_path("scripts"), uv_exe)
+    if os.path.isfile(path):
+        return path
+
+    if sys.version_info >= (3, 10):
+        user_scheme = sysconfig.get_preferred_scheme("user")
+    elif os.name == "nt":
+        user_scheme = "nt_user"
+    elif sys.platform == "darwin" and sys._framework:
+        user_scheme = "osx_framework_user"
+    else:
+        user_scheme = "posix_user"
+
+    path = os.path.join(sysconfig.get_path("scripts", scheme=user_scheme), uv_exe)
+    if os.path.isfile(path):
+        return path
+
+    raise FileNotFoundError(path)
+
+
+__all__ = [
+    "find_uv_bin",
+]