From 23f1e02649bc3dea933c0334d70285b97729abb9 Mon Sep 17 00:00:00 2001
From: Nikolai R Kristiansen <nikolai.kristiansen@remarkable.no>
Date: Wed, 19 Nov 2025 09:51:08 +0100
Subject: [PATCH] =?UTF-8?q?=F0=9F=90=9B=20Write=20all=20supported=20versio?=
 =?UTF-8?q?ns=20to=20version.json=20to=20avoid=20flapping?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/docker_python_nodejs/cli.py      | 15 ++++++++++++++-
 src/docker_python_nodejs/versions.py | 21 ++++++++++-----------
 tests/test_all.py                    |  4 ++--
 3 files changed, 26 insertions(+), 14 deletions(-)

diff --git a/src/docker_python_nodejs/cli.py b/src/docker_python_nodejs/cli.py
index 6bc7c31..d245dc4 100644
--- a/src/docker_python_nodejs/cli.py
+++ b/src/docker_python_nodejs/cli.py
@@ -44,8 +44,21 @@ def run_build_matrix(args: CLIArgs) -> None:
 
 
 def run_release(args: CLIArgs) -> None:
-    versions = load_build_contexts(args.builds_dir)
+    """Release new/updated version by updating versions.json and README.md.
+
+    Note: We fetch supported and available versions again here and update with the actual built digests"""
+
+    supported_python_versions, supported_nodejs_versions = supported_versions()
+    versions = decide_version_combinations(args.distros, supported_python_versions, supported_nodejs_versions)
+    # Update versions with build digests to allow pinning
+    built_versions = load_build_contexts(args.builds_dir)
     current_versions = load_versions()
+    for version in versions:
+        if version.key in built_versions:
+            version.digest = built_versions[version.key].digest
+        elif version.key in current_versions:
+            version.digest = current_versions[version.key].digest
+
     new_or_updated = find_new_or_updated(versions, current_versions, args.force)
     supported_python_versions, supported_nodejs_versions = supported_versions()
     if not new_or_updated:
diff --git a/src/docker_python_nodejs/versions.py b/src/docker_python_nodejs/versions.py
index 08a9eb4..43be7b9 100644
--- a/src/docker_python_nodejs/versions.py
+++ b/src/docker_python_nodejs/versions.py
@@ -262,47 +262,46 @@ def persist_versions(versions: list[BuildVersion], dry_run: bool = False) -> Non
         json.dump({"versions": version_dicts}, fp, indent=2)
 
 
-def load_versions() -> list[BuildVersion]:
+def load_versions() -> dict[str, BuildVersion]:
     with VERSIONS_PATH.open() as fp:
-        version_dicts = json.load(fp)["versions"]
-        return [BuildVersion(**version) for version in version_dicts]
+        versions = json.load(fp)["versions"]
+        return {version["key"]: BuildVersion(**version) for version in versions}
 
 
 def find_new_or_updated(
     versions: list[BuildVersion],
-    current_versions: list[BuildVersion],
+    current_versions: dict[str, BuildVersion],
     force: bool = False,
 ) -> list[BuildVersion]:
     if force:
         logger.warning("Generating full build matrix because --force is set")
 
-    current_versions_dict = {ver.key: ver for ver in current_versions}
     versions_dict = {ver.key: ver for ver in versions}
     new_or_updated: list[BuildVersion] = []
 
     for key, ver in versions_dict.items():
-        current_ver = current_versions_dict.get(key)
+        current_ver = current_versions.get(key)
         if current_ver is not None:
             current_ver.digest = ""  # Ignore digest when comparing
 
         # does key exist and are version dicts equal?
         updated = current_ver and ver != current_ver
-        new = key not in current_versions_dict
+        new = key not in current_versions
         if new or updated or force:
             new_or_updated.append(ver)
 
     return new_or_updated
 
 
-def load_build_contexts(builds_dir: Path) -> list[BuildVersion]:
+def load_build_contexts(builds_dir: Path) -> dict[str, BuildVersion]:
     """Find JSON files with build contexts and return the corresponding BuildVersion list"""
     logger.info(f"Loading builds metadata from {builds_dir.as_posix()}")
-    versions: list[BuildVersion] = []
+    versions: dict[str, BuildVersion] = {}
 
     for build_file in builds_dir.glob("*.json"):
         with build_file.open() as fp:
             build_data = json.load(fp)
         version = BuildVersion(**build_data)
-        versions.append(version)
+        versions[build_data["key"]] = version
 
-    return sorted_versions(versions)
+    return versions
diff --git a/tests/test_all.py b/tests/test_all.py
index 6834638..9720786 100644
--- a/tests/test_all.py
+++ b/tests/test_all.py
@@ -265,7 +265,7 @@ def test_load_build_contexts(build_version: BuildVersion, tmp_path: Path) -> Non
 
     versions = load_build_contexts(tmp_path)
     assert len(versions) == 1
-    assert versions[0].key == ver.key
+    assert next(iter(versions.values())).key == ver.key
 
 
 def test_find_new_or_updated_with_digest() -> None:
@@ -285,6 +285,6 @@ def test_find_new_or_updated_with_digest() -> None:
     existing = copy.deepcopy(new)
     existing.digest = "sha256:abcdef1234567890"
 
-    res = find_new_or_updated([new], [existing])
+    res = find_new_or_updated([new], {existing.key: existing})
 
     assert len(res) == 0