Releases: Add a script that does a full release

tools/release-plugin.sh

@@ -0,0 +1,152 @@
+#!/usr/bin/env bash
+
+set -eo pipefail
+
+BASE=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)
+. "$BASE/tools/includes/check-osx-bash-version.sh"
+. "$BASE/tools/includes/chalk-lite.sh"
+. "$BASE/tools/includes/proceed_p.sh"
+. "$BASE/tools/includes/plugin-functions.sh"
+. "$BASE/tools/includes/version-compare.sh"
+. "$BASE/tools/includes/normalize-version.sh"
+
+
+# Instructions
+function usage {
+	cat <<-EOH
+		usage: $0 [options] <plugin> <version>
+
+		Conduct a full release of a specified plugin through release branch creation. The <plugin> must be the slug of the plugin, such as plugins/jetpack
+
+		Options:
+			-a Release an alpha version
+			-b Release a beta version
+	EOH
+	exit 1
+}
+
+# Get the options passed and parse them.
+ARGS=('-p')
+ALPHABETA=
+while getopts "v:abh" opt; do
+	case ${opt} in
+		a)
+			ALPHABETA='-a'
+			ARGS+=("$ALPHABETA")
+		;;
+		b)
+			ALPHABETA='-b'
+			ARGS+=("$ALPHABETA")
+		;;
+		h)
+			usage
+		;;
+		?)
+			error "Invalid argument"
+			echo ""
+			usage
+		;;
+	esac
+done
+shift "$(($OPTIND -1))"
+
+# If there are more than two arguments, bail.
+[[ $# -gt 2 ]] && die "Too many arguments specified! Only provide a project and a version number. Got:$(printf ' "%s"' "$@")"$'\n'"(note all options must come before the project slug)"
+
+# Get the project slug.
+PROJECT=
+for ARG in "$@"
+	do
+		SLUG="${ARG#projects/}" # DWIM
+		SLUG="${SLUG%/}" # Sanitize
+		if [[ -e "$BASE/projects/$SLUG/composer.json" ]]; then
+			yellow "Project found: $ARG"
+			PROJECT="$SLUG"
+			shift
+			break
+		fi
+	done
+[[ -z "$PROJECT" ]] && die "A valid project slug must be specified."
+
+# Determine the project version
+
+[[ -z $1 ]] && die "Please specify a version number"
+# Figure out the version(s) to use for the plugin(s).
+function check_ver {
+	normalize_version_number "$1"
+	if [[ ! "$NORMALIZED_VERSION" =~ ^[0-9]+(\.[0-9]+)+(-.*)?$ ]]; then
+		red "\"$NORMALIZED_VERSION\" does not appear to be a valid version number."
+		return 1
+	fi
+	local CUR_VERSION
+	CUR_VERSION=$("$BASE/tools/plugin-version.sh" "$PROJECT")
+	# shellcheck disable=SC2310
+	if version_compare "$CUR_VERSION" "$NORMALIZED_VERSION"; then
+		proceed_p "Version $NORMALIZED_VERSION <= $CUR_VERSION."
+		return $?
+	fi
+	return 0
+}
+
+if ! check_ver "$1"; then
+	die "Please specify a valid version number."
+fi
+VERSION="$1"
+
+proceed_p "Releasing $PROJECT $VERSION" "Proceed?"
+
+# Make sure we're standing on trunk and working directory is clean
+CURRENT_BRANCH="$( git rev-parse --abbrev-ref HEAD )"
+if [[ "$CURRENT_BRANCH" != "trunk" ]]; then
+	proceed_p "Not currently checked out to trunk." "Check out trunk before continuing?"
+	git checkout trunk && git pull
+fi
+
+if [[ "$(git status --porcelain)" ]]; then
+	red "Working directory not clean, make sure you're working from a clean checkout and try again." && die
+fi
+
+# Check out and push pre-release branch
+BRANCHES="$( git branch )"
+if [[ "$BRANCHES" =~ "prerelease" ]]; then
+	proceed_p "Existing prerelease branch found." "Delete it?"
+	git branch -D prerelease
+fi
+
+git checkout -b prerelease
+if ! git push -u origin HEAD; then
+	red "Branch push failed. Check #jetpack-releases and make sure no one is doing a release already, then delete the branch at https://github.com/Automattic/jetpack/branches"
+fi
+
+# Run the changelogger release script
+tools/changelogger-release.sh "${ARGS[@]}" "$PROJECT"
+
+# When it completes, wait for user to edit anything they want, then push key to continue.
+read -r -s -p $'Edit any changelog entries you want, then press enter to continue the release process.'
+echo ""
+
+echo "Committing changes..."
+git add --all
+git commit -am "Changelog edits for $PROJECT"
+
+# If we're running a beta, amend the changelog
+if [[ "$PROJECT" == "projects/jetpack" && "$ALPHABETA" == "-b" ]]; then
+	echo "Releasing a beta, amending the readme.txt"
+	jetpack changelog squash plugins/jetpack readme
+	git commit -am "Amend readme.txt"
+fi
+
+# Push the changes, then tell the user to wait for the builds to complete and things to update.
+git push -u origin prerelease
+
+yellow "Waiting for build to complete and push to mirror repos"
+BUILDID="$( gh run list --json headBranch,event,databaseId,workflowName --jq '.[] | select(.event=="push" and .headBranch=="prerelease" and .workflowName=="Build") | .databaseId' )"
+if ! gh run watch "${BUILDID[0]}" --exit-status; then
+	echo "Build failed! Check for build errors on GitHub for more information." && die
+fi 
+
+# After this, run tools/create-release-branch.sh to create a release branch.
+yellow "Build is complete. Creating a release branch."
+tools/create-release-branch.sh "$PROJECT" "$VERSION"
+
+echo "Release branch created!"