Create start-release.sh

Author: ralfhandl

scripts/start-release.sh

@@ -0,0 +1,100 @@
+#!/usr/bin/env bash
+
+# Author: @ralfhandl
+
+# Run this script from the root of the repo. It is designed to be run manually in a development branch.
+
+branch=$(git branch --show-current)
+
+if [[ ! $branch =~ ^v[0-9]+\.[0-9]+-dev$ ]]; then
+  echo "This script is intended to be run from a development branch, e.g. v3.2-dev"
+  exit 1
+fi
+
+vVersion=$(basename "$branch" "-dev")
+version=${vVersion:1}
+
+# Find last published spec version for this minor version
+lastSpec=$(git ls-tree origin/main versions/ --name-only | grep -E "/$version\.[0-9].md" | tail -1)
+
+if [ -z "$lastSpec" ]; then
+  # Find last published spec version
+  lastSpec=$(git ls-tree origin/main versions/ --name-only | grep -E "/.+\.[0-9].md" | tail -1)
+  nextPatch=0
+  releaseType="Release"
+else
+  lastPatch=$(basename "$lastSpec" ".md" | cut --delimiter=. --fields=3)
+  nextPatch=$((lastPatch + 1))
+  releaseType="Patch release"
+fi
+
+nextVersion="$version.$nextPatch"
+
+if [ -z "$lastSpec" ]; then
+  echo "Could not find any published specification version in origin/main"
+  exit 1
+fi
+
+lastVersion=$(basename "$lastSpec" ".md")
+echo === Initialize src/oas.md for $nextVersion from $lastVersion
+
+# Create PR branch from development branch
+prBranch="$branch-start-$nextVersion"
+if git ls-remote --exit-code --heads origin "$prBranch"; then
+  echo "=== Failed: PR branch $prBranch already exists on the remote, please delete it and try again"
+  exit 1  
+fi
+if ! git checkout -b "$prBranch"; then
+  echo "=== Failed: PR branch $prBranch already exists locally, please delete it and try again"
+  exit 1  
+fi
+
+# Create empty orphan branch and add src/oas.md with last spec's content and no history
+orphan="v$version-orphan"
+if ! git switch --orphan "$orphan"; then
+  git switch "$branch"
+  git branch -d "$prBranch"
+  echo "=== Failed: please delete branch $orphan and try again"
+  exit 1
+fi
+mkdir src
+git show "main:$lastSpec" > src/oas.md
+git add src/oas.md
+git commit -m "copy from $lastVersion"
+
+# Merge orphan branch into PR branch, favoring orphan's version of src/oas.md
+git switch "$prBranch"
+git merge "$orphan" -X theirs --allow-unrelated-histories -m "reset src/oas.md history"
+git branch -D "$orphan"
+
+# Bump version headline, add line to history table
+historyTableHeader="\n| Version | Date | Notes |\n| ---- | ---- | ---- |\n"
+sed -z -e "s/\n## Version $lastVersion\n/\n## Version $nextVersion\n/" \
+    -z -e "s/$historyTableHeader/$historyTableHeader| $nextVersion | TBD | $releaseType of the OpenAPI Specification $nextVersion |\n/" \
+    src/oas.md > temp.md
+mv -f temp.md src/oas.md
+
+git add src/oas.md
+git commit -m "bump version"
+
+echo === Initialized src/oas.md 
+
+# adjust tests when starting a new major or minor version
+if [ "$nextPatch" == "0" ]; then
+  echo === Adjust tests for new version $version
+
+  #TODO adjust test script
+  
+  #TODO adjust test data
+
+  # git commit -m "adjust test script and test data"
+
+  echo === Adjusted tests
+fi
+
+# Push PR branch to remote
+git push -u origin $prBranch
+
+# Clean up
+git switch "$branch"
+echo === Done