Update release versions

release.sh

@@ -2,14 +2,24 @@
 set -euo pipefail
 IFS=$'\n\t'
 
-# Fetch the JSON data from the specified URL
-JSON_DATA=$(curl -s https://api.wordpress.org/core/stable-check/1.0/)
+sed_inplace() {
+    if [[ "$(uname -s)" == Darwin ]]; then
+        sed -i '' "$@"
+    else
+        sed -i "$@"
+    fi
+}
 
-# Use jq to parse the JSON data and extract the version marked as "latest"
-TESTED_UP_TO=$(echo "$JSON_DATA" | jq -r 'to_entries[] | select(.value == "latest") | .key')
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+METADATA=$(python3 "$SCRIPT_DIR/scripts/get-wordpress-matrix.py" --metadata)
+
+TESTED_UP_TO=$(echo "$METADATA" | jq -r '.tested_up_to')
+REQUIRES_AT_LEAST=$(echo "$METADATA" | jq -r '.requires_at_least')
+REQUIRES_PHP=$(echo "$METADATA" | jq -r '.requires_php')
 
-# Read the TESTED_UP_TO value from config.json
 CONFIG_TESTED_UP_TO=$(jq -r '.TESTED_UP_TO' ./config.json)
+CONFIG_REQUIRES_AT_LEAST=$(jq -r '.REQUIRES_AT_LEAST // empty' ./config.json)
+CONFIG_REQUIRES_PHP=$(jq -r '.REQUIRES_PHP // empty' ./config.json)
 
 # Fetch the current STABLE_TAG value from config.json
 PREVIOUS_STABLE_TAG=$(jq -r '.STABLE_TAG' config.json)
@@ -30,14 +40,16 @@ if [[ -n "$COMMITS_SINCE_TAG" ]]; then
     CODE_CHANGED=true
 fi
 
-# Determine if the WordPress version has changed
-WP_VERSION_CHANGED=false
-if [[ "$TESTED_UP_TO" != "$CONFIG_TESTED_UP_TO" ]]; then
-    WP_VERSION_CHANGED=true
+# Determine if tested compatibility bounds changed (same source as CI matrix)
+COMPAT_CHANGED=false
+if [[ "$TESTED_UP_TO" != "$CONFIG_TESTED_UP_TO" ]] \
+    || [[ "$REQUIRES_AT_LEAST" != "$CONFIG_REQUIRES_AT_LEAST" ]] \
+    || [[ "$REQUIRES_PHP" != "$CONFIG_REQUIRES_PHP" ]]; then
+    COMPAT_CHANGED=true
 fi
 
-# Exit early if no code changes and WordPress version hasn't changed
-if [[ "$CODE_CHANGED" == false && "$WP_VERSION_CHANGED" == false ]]; then
+# Exit early if no code changes and compatibility metadata hasn't changed
+if [[ "$CODE_CHANGED" == false && "$COMPAT_CHANGED" == false ]]; then
     echo "### :no_good_woman: Didn't update versions :no_good:" >> "$GITHUB_STEP_SUMMARY"
     echo "" >> "$GITHUB_STEP_SUMMARY"
     echo "Stopped because there are no changes since the last release." >> "$GITHUB_STEP_SUMMARY"
@@ -51,24 +63,36 @@ STABLE_TAG=$(echo "$PREVIOUS_STABLE_TAG" | awk -F. '{$NF+=1} 1' OFS='.')
 echo "### :rocket: Updated versions :rocket:" >> "$GITHUB_STEP_SUMMARY"
 echo "" >> "$GITHUB_STEP_SUMMARY"
 echo "- New stable tag: $STABLE_TAG (was $PREVIOUS_STABLE_TAG)" >> "$GITHUB_STEP_SUMMARY"
-echo "- New WordPress version: $TESTED_UP_TO (was $CONFIG_TESTED_UP_TO)" >> "$GITHUB_STEP_SUMMARY"
+echo "- Tested up to: $TESTED_UP_TO (was $CONFIG_TESTED_UP_TO)" >> "$GITHUB_STEP_SUMMARY"
+echo "- Requires at least: $REQUIRES_AT_LEAST (was $CONFIG_REQUIRES_AT_LEAST)" >> "$GITHUB_STEP_SUMMARY"
+echo "- Requires PHP: $REQUIRES_PHP (was $CONFIG_REQUIRES_PHP)" >> "$GITHUB_STEP_SUMMARY"
 
-# Use sed to replace the version lines in some files
-sed -i -e "s/^Tested up to: [0-9.]*$/Tested up to: $TESTED_UP_TO/" \
+sed_inplace -e "s/^Tested up to: [0-9.]*$/Tested up to: $TESTED_UP_TO/" \
+       -e "s/^Requires at least: [0-9.]*$/Requires at least: $REQUIRES_AT_LEAST/" \
+       -e "s/^Requires PHP: [0-9.]*$/Requires PHP: $REQUIRES_PHP/" \
        -e "s/^Stable tag: [0-9.]*$/Stable tag: $STABLE_TAG/" ./readme.txt
 
-sed -i -e "s/^Tested up to: [0-9.]*$/Tested up to: $TESTED_UP_TO/" \
-       -e "s/^Version: [0-9.]*$/Version: $STABLE_TAG/" ./simple-analytics.php
+if ! grep -q 'Requires PHP:' ./simple-analytics.php; then
+    sed_inplace "/\* Requires at least:/a\\
+ * Requires PHP: $REQUIRES_PHP" ./simple-analytics.php
+fi
+
+sed_inplace -e "s/^ \* Tested up to: [0-9.]*/ * Tested up to: $TESTED_UP_TO/" \
+       -e "s/^ \* Requires at least: [0-9.]*/ * Requires at least: $REQUIRES_AT_LEAST/" \
+       -e "s/^ \* Requires PHP: [0-9.]*/ * Requires PHP: $REQUIRES_PHP/" \
+       -e "s/^ \* Version: [0-9.]*/ * Version: $STABLE_TAG/" ./simple-analytics.php
 
 # Get the current date in the specified format
 DATE=$(date +"%Y-%m-%d")
 
 # Prepare the changelog entry
 CHANGELOG_ENTRY=$(printf "= %s =\n* %s" "$STABLE_TAG" "$DATE")
 
-# Add WordPress version update to changelog if it has changed
-if [[ "$WP_VERSION_CHANGED" == true ]]; then
+# Add compatibility update to changelog if tested bounds changed
+if [[ "$COMPAT_CHANGED" == true ]]; then
     CHANGELOG_ENTRY=$(printf "%s\n* Tested up to WordPress %s" "$CHANGELOG_ENTRY" "$TESTED_UP_TO")
+    CHANGELOG_ENTRY=$(printf "%s\n* Requires WordPress %s" "$CHANGELOG_ENTRY" "$REQUIRES_AT_LEAST")
+    CHANGELOG_ENTRY=$(printf "%s\n* Requires PHP %s" "$CHANGELOG_ENTRY" "$REQUIRES_PHP")
 fi
 
 # Add commit messages to changelog if there are code changes
@@ -77,7 +101,6 @@ if [[ "$CODE_CHANGED" == true ]]; then
     CHANGELOG_ENTRY=$(printf "%s\n%s" "$CHANGELOG_ENTRY" "$COMMITS_SINCE_TAG")
 fi
 
-# Insert the new changelog entry below the line "== Changelog =="
 awk -v changelog="$CHANGELOG_ENTRY" '
     /== Changelog ==/ {
         print $0 "\n"
@@ -86,17 +109,18 @@ awk -v changelog="$CHANGELOG_ENTRY" '
     }
     { print }' readme.txt > readme.txt.tmp && mv readme.txt.tmp readme.txt
 
-# Update the config.json file
 echo "{
   \"TESTED_UP_TO\": \"$TESTED_UP_TO\",
+  \"REQUIRES_AT_LEAST\": \"$REQUIRES_AT_LEAST\",
+  \"REQUIRES_PHP\": \"$REQUIRES_PHP\",
   \"STABLE_TAG\": \"$STABLE_TAG\"
 }" > config.json
 
 # Prepare release name and body
-if [[ "$WP_VERSION_CHANGED" == true && "$CODE_CHANGED" == true ]]; then
-    RELEASE_NAME="Release $STABLE_TAG: Code updates and support for WordPress $TESTED_UP_TO"
-elif [[ "$WP_VERSION_CHANGED" == true ]]; then
-    RELEASE_NAME="Release $STABLE_TAG: Support for WordPress $TESTED_UP_TO"
+if [[ "$COMPAT_CHANGED" == true && "$CODE_CHANGED" == true ]]; then
+    RELEASE_NAME="Release $STABLE_TAG: Code updates and tested on WordPress ${REQUIRES_AT_LEAST}-${TESTED_UP_TO}"
+elif [[ "$COMPAT_CHANGED" == true ]]; then
+    RELEASE_NAME="Release $STABLE_TAG: Tested on WordPress ${REQUIRES_AT_LEAST}-${TESTED_UP_TO}"
 elif [[ "$CODE_CHANGED" == true ]]; then
     RELEASE_NAME="Release $STABLE_TAG: Code updates"
 else
@@ -110,7 +134,7 @@ echo "tested-up-to=$TESTED_UP_TO" >> "$GITHUB_OUTPUT"
 echo "stable-tag=$STABLE_TAG" >> "$GITHUB_OUTPUT"
 echo "has-changed=true" >> "$GITHUB_OUTPUT"
 echo "code-changed=$CODE_CHANGED" >> "$GITHUB_OUTPUT"
-echo "wp-version-changed=$WP_VERSION_CHANGED" >> "$GITHUB_OUTPUT"
+echo "compat-changed=$COMPAT_CHANGED" >> "$GITHUB_OUTPUT"
 
 # Output RELEASE_NAME (in case it contains special characters)
 echo "release-name=$RELEASE_NAME" >> "$GITHUB_OUTPUT"

scripts/get-wordpress-matrix.py

@@ -254,5 +254,38 @@ def build_matrix() -> dict:
     return {"include": include}
 
 
+def format_requires_php(php: str) -> str:
+    """readme.txt uses a three-part PHP version (e.g. 7.2.0)."""
+    if php.count(".") == 1:
+        return f"{php}.0"
+    return php
+
+
+def tested_versions_metadata() -> dict:
+    """Bounds of the CI matrix for release/readme metadata."""
+    matrix = build_matrix()
+    wp_versions = sorted(
+        {entry["wp"] for entry in matrix["include"]},
+        key=version_tuple,
+    )
+    php_versions = sorted(
+        {entry["php"] for entry in matrix["include"]},
+        key=version_tuple,
+    )
+    min_php = php_versions[0]
+    return {
+        "tested_up_to": wp_versions[-1],
+        "requires_at_least": wp_versions[0],
+        "requires_php": format_requires_php(min_php),
+        "wp_versions": wp_versions,
+        "php_versions": php_versions,
+    }
+
+
 if __name__ == "__main__":
-    print(json.dumps(build_matrix()))
+    import sys
+
+    if "--metadata" in sys.argv:
+        print(json.dumps(tested_versions_metadata()))
+    else:
+        print(json.dumps(build_matrix()))