add a script to assist in the release process

release.sh

@@ -0,0 +1,152 @@
+#!/usr/bin/env bash
+# ------------------------------------------------------------
+#  release.sh  – semi-automatic release helper
+# ------------------------------------------------------------
+set -euo pipefail
+set -o errtrace
+trap 'echo "❌  Error – aborting"; exit 1' ERR
+
+# -------- configurable -----------------
+APP_NAME="${1:-MyApp}"
+SECOND_DIR="${APP_NAME}_Second"
+THIRD_DIR="${APP_NAME}_Third"
+VERSION_FILE="Config.xcconfig"
+MARKETING_KEY="LOOP_FOLLOW_MARKETING_VERSION"
+DEV_BRANCH="dev"
+MAIN_BRANCH="main"
+PATCH_DIR="../${APP_NAME}_update_patches"
+# ---------------------------------------
+
+# --- functions here ---
+pause()     { read -rp "▶▶  Press Enter to continue (Ctrl-C to abort)…"; }
+echo_run()  { echo "+ $*"; "$@"; }
+
+push_cmds=()
+queue_push() { push_cmds+=("git -C \"$(pwd)\" $*"); echo "+ [queued] (in $(pwd)) git $*"; }
+
+queue_push_tag () {
+  local tag="$1"
+  queue_push push origin "refs/tags/$tag"
+}
+
+update_follower () {
+  local DIR="$1"
+  echo; echo "🔄  Updating $DIR …"
+  cd "$DIR"
+
+  # 1 · Make sure we’re on a clean, up-to-date main
+  echo_run git switch "$MAIN_BRANCH"
+  echo_run git fetch
+  echo_run git pull
+
+  # 2 · Apply the patch with 3-way fallback
+  if ! git apply --3way  --whitespace=nowarn "$PATCH_FILE"; then
+    echo "‼️  Some hunks could not be merged automatically."
+  fi
+
+  # 3 · Pause if any conflict markers remain
+  if git ls-files -u | grep -q .; then
+    echo "⚠️  Conflicts detected."
+    echo "    If Fastfile or build_LoopFollow.yml were modified, these are expected."
+    echo "    Open your merge tool, resolve, then press Enter."
+    pause
+  fi
+
+  # 4 · Single commit capturing all staged changes
+  git add -u
+  git add $(git ls-files --others --exclude-standard) 2>/dev/null || true
+  git commit -m "transfer v${new_ver} updates from LF to ${DIR}"
+
+  echo_run git status
+  pause                                     # build & test checkpoint
+  queue_push push origin "$MAIN_BRANCH"
+  cd ..
+}
+
+# ---------- PRIMARY REPO ----------
+PRIMARY_ABS_PATH="$(pwd -P)"
+echo "🏁  Working in $PRIMARY_ABS_PATH …"
+
+# --- start out in main to capture old_ver ---- 
+echo_run git switch "$MAIN_BRANCH"
+echo_run git fetch
+echo_run git pull
+
+# -------- version bump logic (unchanged) -----------
+old_ver=$(grep -E "^${MARKETING_KEY}[[:space:]]*=" "$VERSION_FILE" | awk '{print $3}')
+major_candidate="$(awk -F. '{printf "%d.0.0", $1 + 1}' <<<"$old_ver")"
+minor_candidate="$(awk -F. '{printf "%d.%d.0", $1, $2 + 1}' <<<"$old_ver")"
+
+echo
+echo "Which version bump do you want?"
+echo "  1) Major  →  $major_candidate"
+echo "  2) Minor  →  $minor_candidate"
+read -rp "Enter 1 or 2 (default = 2): " choice
+echo
+
+case "$choice" in
+  1) new_ver="$major_candidate" ;; ""|2) new_ver="$minor_candidate" ;;
+  *) echo "❌  Invalid choice – aborting."; exit 1 ;;
+esac
+
+echo "🔢  Bumping version: $old_ver  →  $new_ver"
+
+# --- switch to dev branch ----
+echo_run git switch "$DEV_BRANCH"
+echo_run git fetch
+echo_run git pull
+
+# --- update version number ----
+sed -i '' "s/${MARKETING_KEY}[[:space:]]*=.*/${MARKETING_KEY} = ${new_ver}/" "$VERSION_FILE"
+echo_run git diff "$VERSION_FILE"; pause
+echo_run git commit -m "update version to ${new_ver} [skip ci]" "$VERSION_FILE"
+
+echo "💻  Build & test dev branch now."; pause
+queue_push push origin "$DEV_BRANCH"
+
+# --- create a patch  ---------------------------
+mkdir -p "$PATCH_DIR"
+PATCH_FILE="${PATCH_DIR}/LF_diff_${old_ver}_to_${new_ver}.patch"
+
+git diff -M --binary "$MAIN_BRANCH" "$DEV_BRANCH"  \
+  > "$PATCH_FILE"
+
+# --- merge dev into main for new release
+echo_run git switch "$MAIN_BRANCH"
+echo_run git merge "$DEV_BRANCH"
+echo "💻  Build & test main branch now."; pause
+queue_push push origin "$MAIN_BRANCH"
+
+cd ..
+update_follower "$SECOND_DIR"
+update_follower "$THIRD_DIR"
+
+# ---------- GitHub Actions Test ---------
+echo; echo "💻  Test GitHub Build Actions and then continue."; pause
+
+# --- return to primary path
+cd ${PRIMARY_ABS_PATH}
+
+# ---------- push queue ----------
+echo; echo "🚀  Ready to tag and push changes upstream."
+echo_run git log --oneline -2
+
+read -rp "▶▶  Ready to tag? (y/N): " confirm
+if [[ $confirm =~ ^[Yy]$ ]]; then
+  git tag -a "v${new_ver}" -m "v${new_ver}"
+  queue_push_tag "v${new_ver}"
+  echo_run git log --oneline -2
+else
+  echo "🚫  tag skipped, can add later"
+fi
+
+read -rp "▶▶  Push everything now? (y/N): " confirm
+if [[ $confirm =~ ^[Yy]$ ]]; then
+  for cmd in "${push_cmds[@]}"; do echo "+ $cmd"; bash -c "$cmd"; done
+  echo "🎉  All pushes completed."
+  echo; echo "🎉  All repos updated to v${new_ver} (local)."
+  echo "👉  Remember to create a GitHub release for tag v${new_ver}."
+else
+  echo "🚫  Pushes skipped.  Run manually if needed:"; printf '   %s\n' "${push_cmds[@]}"
+  echo "🚫  Release not completed, pushes to GitHub were skipped"
+fi