Taken action from https://github.com/savente93/spec0-schedule

Author: nabobalis

.github/workflows/release_schedule.yaml

@@ -0,0 +1,68 @@
+name: Generate release schedule artifacts
+on:
+  schedule:
+    # At 00:00 on day-of-month 2 in every 3rd month. (i.e. every quarter)
+    # 2nd is chosen to avoid fencepost errors
+    - cron: "0 0 2 */3 *"
+  # On demand
+  workflow_dispatch:
+
+jobs:
+  create-artifacts:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          # We're going to make a tag that we can we release so we'll need the full history for that
+          fetch-depth: 0
+
+      - uses: prefix-dev/setup-pixi@v0.9.2
+        with:
+          pixi-version: "v0.49.0"
+
+      - name: Generate artifacts
+        run: |
+          pixi run generate-schedule --locked
+
+      - name: Test json artifact
+        run: |
+          cat schedule.json | jq
+
+      - name: setup git
+        run: |
+          # git will complain if we don't do this first
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: determine tag name
+        id: tag_name
+        run: |
+          echo "TAG_NAME=$(date '+%Y-Q%q')" >> "$GITHUB_OUTPUT"
+      - name: Commit artifacts and create tag
+        env:
+          GH_TOKEN: ${{ secrets.PAT }}
+        run: |
+          git add schedule.md chart.md schedule.json
+          git commit -m "generate schedule for ${{ steps.tag_name.outputs.TAG_NAME }} release" || echo "No changes to commit"
+          git tag ${{ steps.tag_name.outputs.TAG_NAME }}
+          git push origin main
+          git push origin tag ${{ steps.tag_name.outputs.TAG_NAME }}
+
+      - name: Publish github release
+        uses: softprops/action-gh-release@v2
+        env:
+          GH_TOKEN: ${{ secrets.PAT }}
+        with:
+          generate_release_notes: true
+          tag_name: ${{ steps.tag_name.outputs.TAG_NAME }}
+          make_latest: true
+          files: |
+            schedule.md
+            chart.md
+            schedule.json
+
+permissions:
+  contents: write

action.yaml

@@ -58,7 +58,7 @@ runs:
           echo "Regenerating schedule.json..."
           pixi run generate-schedule --locked
         if diff -q schedule.json "${{ github.workspace }}/$SCHEDULE_FILE" >/dev/null; then
-            echo "Source and destination have identical contents – nothing to move."
+            echo "Source and destination have identical contents - nothing to move."
         else
             mv schedule.json "${{ github.workspace }}/$SCHEDULE_FILE"
           fi

spec0_versions.py

@@ -1,101 +1,121 @@
 import requests
-import json
 import collections
 from datetime import datetime, timedelta
 
 import pandas as pd
-from packaging.version import Version
+from packaging.version import Version, InvalidVersion
 
 
-PY_RELEASES = {
+py_releases = {
     "3.8": "Oct 14, 2019",
     "3.9": "Oct 5, 2020",
     "3.10": "Oct 4, 2021",
     "3.11": "Oct 24, 2022",
     "3.12": "Oct 2, 2023",
     "3.13": "Oct 7, 2024",
+    "3.14": "Oct 7, 2025",
 }
-CORE_PACKAGES = [
-    "ipython",
-    "matplotlib",
-    "networkx",
+core_packages = [
+    # Path(x).stem for x in glob("../core-projects/*.md") if "_index" not in x
     "numpy",
+    "scipy",
+    "matplotlib",
     "pandas",
     "scikit-image",
+    "networkx",
     "scikit-learn",
-    "scipy",
     "xarray",
+    "ipython",
     "zarr",
 ]
-PLUS_36_MONTHS = timedelta(days=int(365 * 3))
-PLUS_24_MONTHS = timedelta(days=int(365 * 2))
+plus36 = timedelta(days=int(365 * 3))
+plus24 = timedelta(days=int(365 * 2))
 
 # Release data
-# We put the cutoff at 3 quarters ago - we do not use "just" -9 months
-# to avoid the content of the quarter to change depending on when we
-# generate this file during the current quarter.
-CURRENT_DATE = pd.Timestamp.now()
-CURRENT_QUARTER_START = pd.Timestamp(
-    CURRENT_DATE.year, (CURRENT_DATE.quarter - 1) * 3 + 1, 1
+
+# put cutoff 3 quarters ago – we do not use "just" -9 month,
+# to avoid the content of the quarter to change depending on when we generate this
+# file during the current quarter.
+
+current_date = pd.Timestamp.now()
+current_quarter_start = pd.Timestamp(
+    current_date.year, (current_date.quarter - 1) * 3 + 1, 1
 )
-CUTOFF = CURRENT_QUARTER_START - pd.DateOffset(months=9)
+cutoff = current_quarter_start - pd.DateOffset(months=9)
 
 
-def get_release_dates(package, support_time=PLUS_24_MONTHS):
+def get_release_dates(package, support_time=plus24):
     releases = {}
+
     print(f"Querying pypi.org for {package} versions...", end="", flush=True)
     response = requests.get(
         f"https://pypi.org/simple/{package}",
         headers={"Accept": "application/vnd.pypi.simple.v1+json"},
     ).json()
     print("OK")
+
     file_date = collections.defaultdict(list)
     for f in response["files"]:
-        if f["filename"].endswith(".tar.gz") or f["filename"].endswith(".zip"):
-            continue
         ver = f["filename"].split("-")[1]
         try:
             version = Version(ver)
-        except Exception:
+        except InvalidVersion as e:
+            print(f"Error: '{ver}' is an invalid version for '{package}'. Reason: {e}")
             continue
+
         if version.is_prerelease or version.micro != 0:
             continue
-        release_date = pd.Timestamp(f["upload-time"]).tz_localize(None)
+
+        release_date = None
+        for format in ["%Y-%m-%dT%H:%M:%S.%fZ", "%Y-%m-%dT%H:%M:%SZ"]:
+            try:
+                release_date = datetime.strptime(f["upload-time"], format)
+            except ValueError as e:
+                print(f"Error parsing invalid date: {e}")
+
         if not release_date:
             continue
+
         file_date[version].append(release_date)
+
     release_date = {v: min(file_date[v]) for v in file_date}
+
     for ver, release_date in sorted(release_date.items()):
         drop_date = release_date + support_time
-        if drop_date >= CUTOFF:
+        if drop_date >= cutoff:
             releases[ver] = {
                 "release_date": release_date,
                 "drop_date": drop_date,
             }
+
     return releases
 
 
 package_releases = {
     "python": {
         version: {
             "release_date": datetime.strptime(release_date, "%b %d, %Y"),
-            "drop_date": datetime.strptime(release_date, "%b %d, %Y") + PLUS_36_MONTHS,
+            "drop_date": datetime.strptime(release_date, "%b %d, %Y") + plus36,
         }
-        for version, release_date in PY_RELEASES.items()
+        for version, release_date in py_releases.items()
     }
 }
-package_releases |= {package: get_release_dates(package) for package in CORE_PACKAGES}
-# Filter all items whose drop_date are in the past
+
+package_releases |= {package: get_release_dates(package) for package in core_packages}
+
+# filter all items whose drop_date are in the past
 package_releases = {
     package: {
         version: dates
         for version, dates in releases.items()
-        if dates["drop_date"] > CUTOFF
+        if dates["drop_date"] > cutoff
     }
     for package, releases in package_releases.items()
 }
 
+
 # Save Gantt chart
+
 print("Saving Mermaid chart to chart.md")
 with open("chart.md", "w") as fh:
     fh.write(
@@ -104,6 +124,7 @@ def get_release_dates(package, support_time=PLUS_24_MONTHS):
 axisFormat %m / %Y
 title Support Window"""
     )
+
     for name, releases in package_releases.items():
         fh.write(f"\n\nsection {name}")
         for version, dates in releases.items():
@@ -113,6 +134,7 @@ def get_release_dates(package, support_time=PLUS_24_MONTHS):
     fh.write("\n")
 
 # Print drop schedule
+
 data = []
 for k, versions in package_releases.items():
     for v, dates in versions.items():
@@ -124,30 +146,15 @@ def get_release_dates(package, support_time=PLUS_24_MONTHS):
                 pd.to_datetime(dates["drop_date"]),
             )
         )
+
 df = pd.DataFrame(data, columns=["package", "version", "release", "drop"])
+
 df["quarter"] = df["drop"].dt.to_period("Q")
-df["new_min_version"] = (
-    df[["package", "version", "quarter"]].groupby("package").shift(-1)["version"]
-)
-dq = df.set_index(["quarter", "package"]).sort_index().dropna()
-new_min_versions = (
-    dq.groupby(["quarter", "package"]).agg({"new_min_version": "max"}).reset_index()
-)
 
-# We want to build a dict with the structure [{start_date: timestamp, packages: {package: lower_bound}}]
-new_min_versions_list = []
-for q, packages in new_min_versions.groupby("quarter"):
-    package_lower_bounds = {
-        p: str(v) for p, v in packages.drop("quarter", axis=1).itertuples(index=False)
-    }
-    # jq is really insistent the Z should be there
-    quarter_start_time_str = str(q.start_time.isoformat()) + "Z"
-    new_min_versions_list.append(
-        {"start_date": quarter_start_time_str, "packages": package_lower_bounds}
-    )
-print("Saving drop schedule to schedule.json")
-with open("schedule.json", "w") as f:
-    f.write(json.dumps(new_min_versions_list, sort_keys=True))
+dq = df.set_index(["quarter", "package"]).sort_index()
+
+
+print("Saving drop schedule to schedule.md")
 
 
 def pad_table(table):
@@ -165,6 +172,7 @@ def pad_table(table):
             line += f"| {str.ljust(entry, width)} "
         line += "|"
         padded_table.append(line)
+
     return padded_table
 
 
@@ -184,6 +192,7 @@ def make_table(sub):
             else f"{rel_min.strftime('%b %Y')} and {rel_max.strftime('%b %Y')}"
         )
         table.append(f"|{package:<15}|{version_range:<19}|released {rel_range}|")
+
     return pad_table(table)
 
 
@@ -195,13 +204,13 @@ def make_quarter(quarter, dq):
     return "\n".join(table)
 
 
-print("Saving drop schedule to schedule.md")
 with open("schedule.md", "w") as fh:
-    # We collect packages 6 month in the past, and drop the first quarter
+    # we collect package 6 month in the past, and drop the first quarter
     # as we might have filtered some of the packages out depending on
     # when we ran the script.
     tb = []
     for quarter in list(sorted(set(dq.index.get_level_values(0))))[1:]:
         tb.append(make_quarter(quarter, dq))
+
     fh.write("\n\n".join(tb))
     fh.write("\n")