✨ feat(interpreter): increase query timeout to 15s with environment override

The 5s timeout was too aggressive for slower Windows environments where
Python startup can exceed this duration. Increase the default to 15s to
accommodate real-world conditions while still preventing infinite hangs.

Users experiencing timeouts can further customize the timeout via the
PY_DISCOVERY_TIMEOUT environment variable for their specific environment.

Author: gaborbernat

src/python_discovery/_cached_py_info.py

@@ -189,6 +189,7 @@ def _run_subprocess(
 ) -> tuple[Exception | None, PythonInfo | None]:
     start_cookie = gen_cookie()
     end_cookie = gen_cookie()
+    timeout = float(env.get("PY_DISCOVERY_TIMEOUT", "15"))
     with _resolve_py_info_script() as py_info_script:
         cmd = [exe, str(py_info_script), start_cookie, end_cookie]
         env = dict(env)
@@ -206,7 +207,7 @@ def _run_subprocess(
                 encoding="utf-8",
                 errors="backslashreplace",
             )
-            out, err = process.communicate(timeout=5)
+            out, err = process.communicate(timeout=timeout)
             code = process.returncode
         except TimeoutExpired:
             process.kill()

tests/test_cached_py_info.py

@@ -123,6 +123,17 @@ def test_run_subprocess_timeout(mocker: MockerFixture) -> None:
     assert mock_process.communicate.call_count == 2
 
 
+def test_run_subprocess_custom_timeout(mocker: MockerFixture) -> None:
+    mock_process = MagicMock()
+    mock_process.communicate.return_value = (json.dumps(PythonInfo().to_dict()), "")
+    mock_process.returncode = 0
+    mocker.patch("python_discovery._cached_py_info.Popen", return_value=mock_process)
+    env = dict(os.environ)
+    env["PY_DISCOVERY_TIMEOUT"] = "30"
+    _run_subprocess(PythonInfo, sys.executable, env)
+    mock_process.communicate.assert_called_once_with(timeout=30.0)
+
+
 def test_run_subprocess_nonzero_exit(mocker: MockerFixture) -> None:
     mock_process = MagicMock()
     mock_process.communicate.return_value = ("some output", "some error")