Read Python version from .tool-versions (#996)

## Summary - read the Python version from an explicitly selected `.tool-versions` file - preserve `python-version` and existing `UV_PYTHON` precedence - add parser, input, and workflow coverage and update documentation and bundled action artifacts ## Validation - `npm run all` - `actionlint .github/workflows/test.yml` - `uvx zizmor .github/workflows/test.yml` Closes #983 Refs: pi-session 019ff01a-544c-79f3-8f73-a00132af39f5
2026-08-25 11:33:53 +00:00 · 2026-08-11 14:26:03 +02:00
parent 8ed89c5114
commit 46f427bd47
12 changed files with 400 additions and 49 deletions
@@ -26998,7 +26998,7 @@ __export(save_cache_exports, {
  run: () => run
 });
 module.exports = __toCommonJS(save_cache_exports);
-var fs7 = __toESM(require("node:fs"), 1);
+var fs9 = __toESM(require("node:fs"), 1);

 // node_modules/@actions/core/lib/command.js
 var os = __toESM(require("os"), 1);
@@ -61845,10 +61845,54 @@ var STATE_UV_PATH = "uv-path";
 var STATE_UV_VERSION = "uv-version";

 // src/utils/inputs.ts
+var import_node_fs4 = __toESM(require("node:fs"), 1);
 var import_node_path = __toESM(require("node:path"), 1);

-// src/utils/config-file.ts
+// src/version/tool-versions-file.ts
 var import_node_fs2 = __toESM(require("node:fs"), 1);
+function getPythonVersionFromToolVersions(filePath) {
+  const versions = getToolVersions(filePath, "python");
+  if (versions === void 0 || versions.length === 0) {
+    return void 0;
+  }
+  if (versions.length > 1) {
+    warning(
+      "Multiple Python versions in .tool-versions are not supported. The Python entry will be ignored."
+    );
+    return void 0;
+  }
+  const version3 = stripVersionPrefix(versions[0]);
+  if (version3 === "system" || version3.startsWith("ref:") || version3.startsWith("path:")) {
+    warning(
+      `The Python version ${versions[0]} in .tool-versions is not supported. The Python entry will be ignored.`
+    );
+    return void 0;
+  }
+  return version3;
+}
+function getToolVersions(filePath, toolName) {
+  if (!filePath.endsWith(".tool-versions")) {
+    return void 0;
+  }
+  const fileContents = import_node_fs2.default.readFileSync(filePath, "utf8");
+  for (const line of fileContents.split("\n")) {
+    const content = line.split("#", 1)[0].trim();
+    if (content === "") {
+      continue;
+    }
+    const [tool, ...versions] = content.split(/\s+/);
+    if (tool === toolName) {
+      return versions;
+    }
+  }
+  return void 0;
+}
+function stripVersionPrefix(version3) {
+  return version3.startsWith("v") ? version3.slice(1) : version3;
+}
+
+// src/utils/config-file.ts
+var import_node_fs3 = __toESM(require("node:fs"), 1);

 // node_modules/smol-toml/dist/date.js
 var DATE_TIME_RE = /^(\d{4}-\d{2}-\d{2})?[T ]?(?:(\d{2}):\d{2}(?::\d{2}(?:\.\d+)?)?)?(Z|[-+]\d{2}:\d{2})?$/i;
@@ -62532,10 +62576,10 @@ function parse3(toml, { maxDepth = 1e3, integersAsBigInt } = {}) {

 // src/utils/config-file.ts
 function getConfigValueFromTomlFile(filePath, key) {
-  if (!import_node_fs2.default.existsSync(filePath) || !filePath.endsWith(".toml")) {
+  if (!import_node_fs3.default.existsSync(filePath) || !filePath.endsWith(".toml")) {
    return void 0;
  }
-  const fileContent = import_node_fs2.default.readFileSync(filePath, "utf-8");
+  const fileContent = import_node_fs3.default.readFileSync(filePath, "utf-8");
  return getConfigValueFromTomlContent(filePath, fileContent, key);
 }
 function getConfigValueFromTomlContent(filePath, fileContent, key) {
@@ -62555,7 +62599,7 @@ function loadInputs() {
  const workingDirectory = getInput("working-directory");
  const version3 = getInput("version");
  const versionFile = getVersionFile(workingDirectory);
-  const pythonVersion = getInput("python-version");
+  const pythonVersion = getPythonVersion(versionFile);
  const activateEnvironment = getBooleanInput("activate-environment");
  const noProject = getBooleanInput("no-project");
  const venvPath = getVenvPath(workingDirectory, activateEnvironment);
@@ -62621,6 +62665,26 @@ function getVersionFile(workingDirectory) {
  }
  return versionFileInput;
 }
+function getPythonVersion(versionFile) {
+  const pythonVersionInput = getInput("python-version");
+  if (pythonVersionInput !== "") {
+    return pythonVersionInput;
+  }
+  if (process.env.UV_PYTHON !== void 0 && process.env.UV_PYTHON !== "") {
+    return "";
+  }
+  if (versionFile === "" || !import_node_fs4.default.existsSync(versionFile)) {
+    return "";
+  }
+  try {
+    return getPythonVersionFromToolVersions(versionFile) ?? "";
+  } catch (err) {
+    warning2(
+      `Error while parsing Python version from ${versionFile}: ${err.message}`
+    );
+    return "";
+  }
+}
 function getVenvPath(workingDirectory, activateEnvironment) {
  const venvPathInput = getInput("venv-path");
  if (venvPathInput !== "") {
@@ -62864,7 +62928,7 @@ async function saveCache3(inputs) {
      await pruneCache();
    }
    const actualCachePath = getUvCachePath(inputs);
-    if (!fs7.existsSync(actualCachePath)) {
+    if (!fs9.existsSync(actualCachePath)) {
      if (inputs.ignoreNothingToCache) {
        info2(
          "No cacheable uv cache paths were found. Ignoring because ignore-nothing-to-cache is enabled."
@@ -62884,7 +62948,7 @@ async function saveCache3(inputs) {
    }
  }
  if (inputs.cachePython) {
-    if (!fs7.existsSync(inputs.pythonDir)) {
+    if (!fs9.existsSync(inputs.pythonDir)) {
      warning2(
        `Python cache path ${inputs.pythonDir} does not exist on disk. Skipping Python cache save because no managed Python installation was found. If you want uv to install managed Python instead of using a system interpreter, set UV_PYTHON_PREFERENCE=only-managed.`
      );
@@ -56054,7 +56054,7 @@ var require_semver5 = __commonJS({
 });

 // src/setup-uv.ts
-var import_node_fs8 = __toESM(require("node:fs"), 1);
+var import_node_fs9 = __toESM(require("node:fs"), 1);
 var path16 = __toESM(require("node:path"), 1);

 // node_modules/@actions/core/lib/command.js
@@ -98258,29 +98258,59 @@ function getUvVersionFromDependency(dependency) {
 // src/version/tool-versions-file.ts
 var import_node_fs4 = __toESM(require("node:fs"), 1);
 function getUvVersionFromToolVersions(filePath) {
+  const versions = getToolVersions(filePath, "uv");
+  if (versions === void 0 || versions.length !== 1) {
+    return void 0;
+  }
+  const version3 = stripVersionPrefix(versions[0]);
+  if (version3.startsWith("ref")) {
+    warning(
+      "The ref syntax of .tool-versions is not supported. Please use a released version instead."
+    );
+    return void 0;
+  }
+  return version3;
+}
+function getPythonVersionFromToolVersions(filePath) {
+  const versions = getToolVersions(filePath, "python");
+  if (versions === void 0 || versions.length === 0) {
+    return void 0;
+  }
+  if (versions.length > 1) {
+    warning(
+      "Multiple Python versions in .tool-versions are not supported. The Python entry will be ignored."
+    );
+    return void 0;
+  }
+  const version3 = stripVersionPrefix(versions[0]);
+  if (version3 === "system" || version3.startsWith("ref:") || version3.startsWith("path:")) {
+    warning(
+      `The Python version ${versions[0]} in .tool-versions is not supported. The Python entry will be ignored.`
+    );
+    return void 0;
+  }
+  return version3;
+}
+function getToolVersions(filePath, toolName) {
  if (!filePath.endsWith(".tool-versions")) {
    return void 0;
  }
  const fileContents = import_node_fs4.default.readFileSync(filePath, "utf8");
-  const lines = fileContents.split("\n");
-  for (const line of lines) {
-    if (line.trim().startsWith("#")) {
+  for (const line of fileContents.split("\n")) {
+    const content = line.split("#", 1)[0].trim();
+    if (content === "") {
      continue;
    }
-    const match2 = line.match(/^\s*uv\s*v?\s*(?<version>[^\s]+)\s*$/);
-    if (match2) {
-      const matchedVersion = match2.groups?.version.trim();
-      if (matchedVersion?.startsWith("ref")) {
-        warning(
-          "The ref syntax of .tool-versions is not supported. Please use a released version instead."
-        );
-        return void 0;
-      }
-      return matchedVersion;
+    const [tool, ...versions] = content.split(/\s+/);
+    if (tool === toolName) {
+      return versions;
    }
  }
  return void 0;
 }
+function stripVersionPrefix(version3) {
+  return version3.startsWith("v") ? version3.slice(1) : version3;
+}

 // src/version/uv-lock-file.ts
 var import_node_fs5 = __toESM(require("node:fs"), 1);
@@ -98734,12 +98764,13 @@ function getExtension(platform2) {
 }

 // src/utils/inputs.ts
+var import_node_fs8 = __toESM(require("node:fs"), 1);
 var import_node_path = __toESM(require("node:path"), 1);
 function loadInputs() {
  const workingDirectory = getInput("working-directory");
  const version3 = getInput("version");
  const versionFile = getVersionFile(workingDirectory);
-  const pythonVersion = getInput("python-version");
+  const pythonVersion = getPythonVersion(versionFile);
  const activateEnvironment2 = getBooleanInput("activate-environment");
  const noProject = getBooleanInput("no-project");
  const venvPath = getVenvPath(workingDirectory, activateEnvironment2);
@@ -98805,6 +98836,26 @@ function getVersionFile(workingDirectory) {
  }
  return versionFileInput;
 }
+function getPythonVersion(versionFile) {
+  const pythonVersionInput = getInput("python-version");
+  if (pythonVersionInput !== "") {
+    return pythonVersionInput;
+  }
+  if (process.env.UV_PYTHON !== void 0 && process.env.UV_PYTHON !== "") {
+    return "";
+  }
+  if (versionFile === "" || !import_node_fs8.default.existsSync(versionFile)) {
+    return "";
+  }
+  try {
+    return getPythonVersionFromToolVersions(versionFile) ?? "";
+  } catch (err) {
+    warning2(
+      `Error while parsing Python version from ${versionFile}: ${err.message}`
+    );
+    return "";
+  }
+}
 function getVenvPath(workingDirectory, activateEnvironment2) {
  const venvPathInput = getInput("venv-path");
  if (venvPathInput !== "") {
@@ -99018,7 +99069,7 @@ process.on("uncaughtException", (error2) => {
 process.on("unhandledRejection", (reason) => {
  failUnexpectedly("Unhandled promise rejection", reason);
 });
-async function getPythonVersion(inputs) {
+async function getPythonVersion2(inputs) {
  if (inputs.pythonVersion !== "") {
    return inputs.pythonVersion;
  }
@@ -99068,7 +99119,7 @@ async function run() {
    setOutput("uv-version", setupResult.version);
    saveState(STATE_UV_VERSION, setupResult.version);
    info2(`Successfully installed uv version ${setupResult.version}`);
-    const detectedPythonVersion = await getPythonVersion(inputs);
+    const detectedPythonVersion = await getPythonVersion2(inputs);
    setOutput("python-version", detectedPythonVersion);
    if (inputs.enableCache) {
      await restoreCache2(inputs, detectedPythonVersion);
@@ -99080,7 +99131,7 @@ async function run() {
  }
 }
 function detectEmptyWorkdir(inputs) {
-  if (import_node_fs8.default.readdirSync(inputs.workingDirectory).length === 0) {
+  if (import_node_fs9.default.readdirSync(inputs.workingDirectory).length === 0) {
    if (inputs.ignoreEmptyWorkdir) {
      info2(
        "Empty workdir detected. Ignoring because ignore-empty-workdir is enabled"