From 3a9dc19caa6b341ff34e68497002b37ed0724c1c Mon Sep 17 00:00:00 2001
From: selmankoc <selman.koc@volosoft.com>
Date: Thu, 11 Jun 2026 14:37:10 +0300
Subject: [PATCH] feat: add script to update studio version mapping

This script automates the process of updating the version mapping for ABP Studio in the documentation. It checks the provided studio and ABP versions, validates them, and updates the version mapping table accordingly, ensuring that existing ranges are extended or new mappings are added as necessary.
---
 .../scripts/update-studio-version-mapping.py  | 117 ++++++++++++++++++
 1 file changed, 117 insertions(+)
 create mode 100644 .github/scripts/update-studio-version-mapping.py

diff --git a/.github/scripts/update-studio-version-mapping.py b/.github/scripts/update-studio-version-mapping.py
new file mode 100644
index 0000000000..d22ee65574
--- /dev/null
+++ b/.github/scripts/update-studio-version-mapping.py
@@ -0,0 +1,117 @@
+import os
+import re
+from packaging.version import Version, InvalidVersion
+
+studio_ver = os.environ["STUDIO_VERSION"]
+abp_ver = os.environ["ABP_VERSION"]
+file_path = "docs/en/studio/version-mapping.md"
+
+try:
+    studio = Version(studio_ver)
+except InvalidVersion:
+    print(f"❌ Invalid Studio version: {studio_ver}")
+    raise SystemExit(1)
+
+with open(file_path, "r") as f:
+    lines = f.readlines()
+
+# Find table start (skip SEO and headers)
+table_start = 0
+table_end = 0
+for i, line in enumerate(lines):
+    if line.strip().startswith("|") and "**ABP Studio Version**" in line:
+        table_start = i
+    elif table_start > 0 and line.strip() and not line.strip().startswith("|"):
+        table_end = i
+        break
+
+if table_start == 0:
+    print("❌ Could not find version mapping table")
+    raise SystemExit(1)
+
+# If no end found, table goes to end of file
+if table_end == 0:
+    table_end = len(lines)
+
+# Extract sections
+before_table = lines[:table_start]
+table_header = lines[table_start : table_start + 2]
+data_rows = [l for l in lines[table_start + 2 : table_end] if l.strip().startswith("|")]
+after_table = lines[table_end:]
+
+new_rows = []
+handled = False
+
+
+def parse_version_range(version_str):
+    """Parse '2.1.5 - 2.1.9' or '2.1.5' into (start, end)"""
+    version_str = version_str.strip()
+
+    if "–" in version_str or "-" in version_str:
+        parts = re.split(r"\s*[–-]\s*", version_str)
+        if len(parts) == 2:
+            try:
+                return Version(parts[0].strip()), Version(parts[1].strip())
+            except InvalidVersion:
+                return None, None
+
+    try:
+        v = Version(version_str)
+        return v, v
+    except InvalidVersion:
+        return None, None
+
+
+def format_row(studio_range, abp_version):
+    """Format a table row with proper spacing"""
+    return f"| {studio_range:<22} | {abp_version:<27} |\n"
+
+
+# Process existing rows
+for row in data_rows:
+    match = re.match(r"\|\s*(.+?)\s*\|\s*(.+?)\s*\|", row)
+    if not match:
+        continue
+
+    existing_studio_range = match.group(1).strip()
+    existing_abp = match.group(2).strip()
+
+    if existing_abp != abp_ver:
+        new_rows.append(row)
+        continue
+
+    start_ver, end_ver = parse_version_range(existing_studio_range)
+
+    if start_ver is None or end_ver is None:
+        new_rows.append(row)
+        continue
+
+    if start_ver <= studio <= end_ver:
+        print(f"✅ Studio version {studio_ver} already covered in range {existing_studio_range}")
+        handled = True
+        new_rows.append(row)
+    elif end_ver < studio:
+        if (
+            start_ver.major == studio.major
+            and start_ver.minor == studio.minor
+            and studio.micro <= end_ver.micro + 5
+        ):
+            new_range = f"{start_ver} - {studio}"
+            new_rows.append(format_row(new_range, abp_ver))
+            print(f"✅ Extended range: {new_range}")
+            handled = True
+        else:
+            new_rows.append(row)
+    else:
+        new_rows.append(row)
+
+if not handled:
+    new_row = format_row(str(studio), abp_ver)
+    new_rows.insert(0, new_row)
+    print(f"✅ Added new mapping: {studio_ver} -> {abp_ver}")
+
+with open(file_path, "w") as f:
+    f.writelines(before_table)
+    f.writelines(table_header)
+    f.writelines(new_rows)
+    f.writelines(after_table)