302 lines
10 KiB
Bash
Executable File
302 lines
10 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
set -e
|
|
|
|
# Make sure, everything is English...
|
|
export LANG=C.UTF-8
|
|
|
|
# verify the current directory
|
|
if [ ! -f pom.xml ] || [ ! -d ../pmd.github.io ]; then
|
|
echo "You seem to be in the wrong working directory or you don't have pmd.github.io checked out..."
|
|
echo
|
|
echo "Expected:"
|
|
echo "* You are currently in the pmd repository"
|
|
echo "* ../pmd.github.io is the pmd.github.io repository"
|
|
echo
|
|
exit 1
|
|
fi
|
|
|
|
CURRENT_BRANCH=
|
|
|
|
echo "-------------------------------------------"
|
|
echo "Releasing PMD"
|
|
echo "-------------------------------------------"
|
|
|
|
# allow to override the release version, e.g. via "RELEASE_VERSION=7.0.0-rc1 ./do-release.sh"
|
|
if [ "$RELEASE_VERSION" = "" ]; then
|
|
CURRENT_VERSION=$(./mvnw org.apache.maven.plugins:maven-help-plugin:3.2.0:evaluate -Dexpression=project.version -q -DforceStdout)
|
|
RELEASE_VERSION=${CURRENT_VERSION%-SNAPSHOT}
|
|
fi
|
|
|
|
MAJOR=$(echo "$RELEASE_VERSION" | cut -d . -f 1)
|
|
MINOR=$(echo "$RELEASE_VERSION" | cut -d . -f 2)
|
|
PATCH=$(echo "$RELEASE_VERSION" | cut -d . -f 3)
|
|
if [ "$PATCH" == "0" ]; then
|
|
NEXT_MINOR=$(("${MINOR}" + 1))
|
|
NEXT_PATCH="0"
|
|
LAST_MINOR=$(("${MINOR}" - 1))
|
|
LAST_PATCH="0"
|
|
else
|
|
# this is a bugfixing release
|
|
NEXT_MINOR="${MINOR}"
|
|
NEXT_PATCH=$(("${PATCH}" + 1))
|
|
LAST_MINOR="${MINOR}"
|
|
LAST_PATCH=$(("${PATCH}" - 1))
|
|
fi
|
|
|
|
# allow to override the next version, e.g. via "DEVELOPMENT_VERSION=7.0.0-SNAPSHOT ./do-release.sh"
|
|
if [ "$DEVELOPMENT_VERSION" = "" ]; then
|
|
DEVELOPMENT_VERSION="$MAJOR.$NEXT_MINOR.$NEXT_PATCH-SNAPSHOT"
|
|
fi
|
|
|
|
# allow to override the last version, e.g. via "LAST_VERSION=6.55.0 ./do-release.sh"
|
|
if [ "$LAST_VERSION" = "" ]; then
|
|
LAST_VERSION="$MAJOR.$LAST_MINOR.$LAST_PATCH"
|
|
fi
|
|
|
|
# http://stackoverflow.com/questions/1593051/how-to-programmatically-determine-the-current-checked-out-git-branch
|
|
CURRENT_BRANCH=$(git symbolic-ref -q HEAD)
|
|
CURRENT_BRANCH=${CURRENT_BRANCH##refs/heads/}
|
|
CURRENT_BRANCH=${CURRENT_BRANCH:-HEAD}
|
|
|
|
echo "LAST_VERSION: ${LAST_VERSION}"
|
|
echo "RELEASE_VERSION: ${RELEASE_VERSION} (this release)"
|
|
echo "DEVELOPMENT_VERSION: ${DEVELOPMENT_VERSION} (the next version after the release)"
|
|
echo "CURRENT_BRANCH: ${CURRENT_BRANCH}"
|
|
|
|
echo
|
|
echo "Is this correct?"
|
|
echo
|
|
echo "Press enter to continue... (or CTRL+C to cancel)"
|
|
read -r
|
|
|
|
export LAST_VERSION
|
|
export RELEASE_VERSION
|
|
export DEVELOPMENT_VERSION
|
|
export CURRENT_BRANCH
|
|
|
|
# check for SNAPSHOT version of pmd.build-tools.version
|
|
BUILD_TOOLS_VERSION=$(./mvnw org.apache.maven.plugins:maven-help-plugin:3.2.0:evaluate -Dexpression=pmd.build-tools.version -q -DforceStdout)
|
|
BUILD_TOOLS_VERSION_RELEASE=${BUILD_TOOLS_VERSION%-SNAPSHOT}
|
|
if [ "${BUILD_TOOLS_VERSION}" != "${BUILD_TOOLS_VERSION_RELEASE}" ]; then
|
|
echo "Error: version pmd.build-tools.version is ${BUILD_TOOLS_VERSION} - snapshot is not allowed"
|
|
exit 1
|
|
fi
|
|
|
|
RELEASE_RULESET="pmd-core/src/main/resources/rulesets/releases/${RELEASE_VERSION//\./}.xml"
|
|
|
|
echo "* Update date info in **docs/_config.yml**."
|
|
echo " date: $(date -u +%d-%B-%Y)"
|
|
echo
|
|
echo "* Update version info in **docs/_config.yml**."
|
|
echo " remove the SNAPSHOT from site.pmd.version"
|
|
echo
|
|
echo "* Ensure all the new rules are listed in the proper file:"
|
|
echo " ${RELEASE_RULESET}"
|
|
echo
|
|
echo "* Update **pmd-apex/src/main/resources/rulesets/apex/quickstart.xml** and"
|
|
echo " **pmd-java/src/main/resources/rulesets/java/quickstart.xml** with the new rules."
|
|
echo
|
|
echo "* Update **docs/pages/next_major_development.md** with the API changes for"
|
|
echo " the new release based on the release notes. Also add any deprecated rules to the list."
|
|
echo
|
|
echo "* Update **../pmd.github.io/_config.yml** to mention the new release"
|
|
echo
|
|
echo "* Update property \`pmd-designer.version\` in **pom.xml** to reference the version, that will be released"
|
|
echo " later in this process."
|
|
echo
|
|
echo "Press enter to continue..."
|
|
read -r
|
|
|
|
|
|
# calculating stats for release notes
|
|
|
|
STATS=$(
|
|
echo "### 📈 Stats"
|
|
echo "* $(git log pmd_releases/"${LAST_VERSION}"..HEAD --oneline --no-merges |wc -l) commits"
|
|
echo "* $(curl -s "https://api.github.com/repos/pmd/pmd/milestones?state=all&direction=desc&per_page=5"|jq ".[] | select(.title == \"$RELEASE_VERSION\") | .closed_issues") closed tickets & PRs"
|
|
echo "* Days since last release: $(( ( $(date +%s) - $(git log --max-count=1 --format="%at" pmd_releases/"${LAST_VERSION}") ) / 86400))"
|
|
)
|
|
|
|
TEMP_RELEASE_NOTES=$(cat docs/pages/release_notes.md)
|
|
TEMP_RELEASE_NOTES=${TEMP_RELEASE_NOTES/\{\% endtocmaker \%\}/${STATS//\&/\\\&}$'\n'$'\n'\{\% endtocmaker \%\}$'\n'}
|
|
echo "${TEMP_RELEASE_NOTES}" > docs/pages/release_notes.md
|
|
|
|
echo
|
|
echo "Updated stats in release notes:"
|
|
echo "$STATS"
|
|
echo
|
|
echo "Please verify docs/pages/release_notes.md"
|
|
echo
|
|
echo "Press enter to continue..."
|
|
read -r
|
|
|
|
# install bundles needed for rendering release notes
|
|
bundle config set --local path vendor/bundle
|
|
bundle config set --local with release_notes_preprocessing
|
|
bundle install
|
|
|
|
RELEASE_NOTES_POST="_posts/$(date -u +%Y-%m-%d)-PMD-${RELEASE_VERSION}.md"
|
|
export RELEASE_NOTES_POST
|
|
echo "Generating ../pmd.github.io/${RELEASE_NOTES_POST}..."
|
|
NEW_RELEASE_NOTES=$(bundle exec docs/render_release_notes.rb docs/pages/release_notes.md | tail -n +6)
|
|
cat > "../pmd.github.io/${RELEASE_NOTES_POST}" <<EOF
|
|
---
|
|
layout: post
|
|
title: PMD ${RELEASE_VERSION} released
|
|
---
|
|
${NEW_RELEASE_NOTES}
|
|
EOF
|
|
|
|
echo "Committing current changes (pmd)"
|
|
|
|
if [[ -e "${RELEASE_RULESET}" ]]
|
|
then
|
|
git add "${RELEASE_RULESET}"
|
|
fi
|
|
|
|
git commit -a -m "Prepare pmd release ${RELEASE_VERSION}"
|
|
(
|
|
cd ../pmd.github.io
|
|
git add "${RELEASE_NOTES_POST}"
|
|
changes=$(git status --porcelain 2>/dev/null| grep -c -E "^[AMDRC]")
|
|
if [ "$changes" -gt 0 ]; then
|
|
echo "Committing current changes (pmd.github.io)"
|
|
git commit -a -m "Prepare pmd release ${RELEASE_VERSION}" && git push
|
|
fi
|
|
)
|
|
|
|
./mvnw -B release:clean release:prepare \
|
|
-Dtag="pmd_releases/${RELEASE_VERSION}" \
|
|
-DreleaseVersion="${RELEASE_VERSION}" \
|
|
-DdevelopmentVersion="${DEVELOPMENT_VERSION}" \
|
|
-DscmCommentPrefix="[release] " \
|
|
-Darguments='-Pgenerate-rule-docs,!cli-dist' \
|
|
'-Pgenerate-rule-docs,!cli-dist'
|
|
|
|
echo
|
|
echo "Tag has been pushed.... now check github actions: <https://github.com/pmd/pmd/actions>"
|
|
echo
|
|
echo
|
|
echo "Press enter to continue..."
|
|
read -r
|
|
|
|
echo
|
|
echo "Check the milestone on github:"
|
|
echo "<https://github.com/pmd/pmd/milestones>"
|
|
echo " --> move any open issues to the next milestone, close the current milestone"
|
|
echo
|
|
echo
|
|
echo "Prepare Next development version:"
|
|
echo "* Update version/date info in **docs/_config.yml**."
|
|
echo " move version to previous_version, increase version, make sure it is a SNAPSHOT version"
|
|
echo " otherwise the javadoc links won't work during development"
|
|
echo " also update the date, e.g. ??-month-year."
|
|
echo
|
|
echo
|
|
echo "Press enter to continue..."
|
|
read -r
|
|
|
|
# update release_notes_old
|
|
OLD_RELEASE_NOTES=$(tail -n +8 docs/pages/release_notes_old.md)
|
|
OLD_RELEASE_NOTES_HEADER=$(head -n 7 docs/pages/release_notes_old.md)
|
|
echo "${OLD_RELEASE_NOTES_HEADER}
|
|
${NEW_RELEASE_NOTES}
|
|
|
|
${OLD_RELEASE_NOTES}" > docs/pages/release_notes_old.md
|
|
|
|
# reset release notes template
|
|
cat > docs/pages/release_notes.md <<EOF
|
|
---
|
|
title: PMD Release Notes
|
|
permalink: pmd_release_notes.html
|
|
keywords: changelog, release notes
|
|
---
|
|
|
|
## {{ site.pmd.date }} - {{ site.pmd.version }}
|
|
|
|
The PMD team is pleased to announce PMD {{ site.pmd.version }}.
|
|
|
|
This is a {{ site.pmd.release_type }} release.
|
|
|
|
{% tocmaker is_release_notes_processor %}
|
|
|
|
### 🚀 New and noteworthy
|
|
|
|
### 🐛 Fixed Issues
|
|
|
|
### 🚨 API Changes
|
|
|
|
### ✨ External Contributions
|
|
|
|
{% endtocmaker %}
|
|
|
|
EOF
|
|
|
|
git commit -a -m "Prepare next development version [skip ci]"
|
|
git push origin "${CURRENT_BRANCH}"
|
|
./mvnw -B release:clean
|
|
|
|
echo
|
|
echo
|
|
echo
|
|
echo "* Wait until the new version is synced to maven central and appears as latest version in"
|
|
echo " <https://repo.maven.apache.org/maven2/net/sourceforge/pmd/pmd/maven-metadata.xml>."
|
|
echo
|
|
echo
|
|
echo "Then proceed with releasing pmd-designer..."
|
|
echo "<https://github.com/pmd/pmd-designer/blob/master/releasing.md>"
|
|
echo
|
|
echo "Press enter to continue when pmd-designer is available in maven-central..."
|
|
echo "<https://repo.maven.apache.org/maven2/net/sourceforge/pmd/pmd-ui/maven-metadata.xml>."
|
|
read -r
|
|
|
|
echo
|
|
echo "Continuing with release of pmd-cli and pmd-dist..."
|
|
git checkout "pmd_releases/${RELEASE_VERSION}"
|
|
./mvnw versions:update-parent -DparentVersion="${RELEASE_VERSION}" -DskipResolution=true -DgenerateBackupPoms=false -pl pmd-cli,pmd-dist
|
|
git add pmd-cli/pom.xml pmd-dist/pom.xml
|
|
git commit -m "[release] prepare release pmd_releases/${RELEASE_VERSION}-dist"
|
|
git tag -m "[release] copy for tag pmd_releases/${RELEASE_VERSION}-dist" "pmd_releases/${RELEASE_VERSION}-dist"
|
|
git push origin tag "pmd_releases/${RELEASE_VERSION}-dist"
|
|
git checkout master
|
|
# make sure parent reference is correct
|
|
./mvnw versions:update-parent -DparentVersion="${DEVELOPMENT_VERSION}" -DskipResolution=true -DgenerateBackupPoms=false -pl pmd-cli,pmd-dist
|
|
git add pmd-cli/pom.xml pmd-dist/pom.xml
|
|
changes=$(git status --porcelain 2>/dev/null | grep -c -E "^[AMDRC]" || true)
|
|
if [ "$changes" -gt 0 ]; then
|
|
git commit -m "Prepare next development version [skip ci]"
|
|
git push origin "${CURRENT_BRANCH}"
|
|
fi
|
|
|
|
echo
|
|
echo "Second tag 'pmd_releases/${RELEASE_VERSION}-dist' has been pushed ... now check github actions: <https://github.com/pmd/pmd/actions>"
|
|
echo
|
|
echo
|
|
echo "Verify the new release on github: <https://github.com/pmd/pmd/releases/tag/pmd_releases/${RELEASE_VERSION}>"
|
|
echo "and the news entry at <https://sourceforge.net/p/pmd/news/>"
|
|
echo
|
|
echo "* Send out an announcement mail to the mailing list:"
|
|
echo
|
|
echo "To: PMD Developers List <pmd-devel@lists.sourceforge.net>"
|
|
echo "Subject: [ANNOUNCE] PMD ${RELEASE_VERSION} released"
|
|
echo
|
|
echo " You can copy the same text from <https://sourceforge.net/p/pmd/news/>."
|
|
echo
|
|
echo
|
|
tweet="PMD ${RELEASE_VERSION} released: https://github.com/pmd/pmd/releases/tag/pmd_releases/${RELEASE_VERSION} #PMD"
|
|
tweet="${tweet// /%20}"
|
|
tweet="${tweet//:/%3A}"
|
|
tweet="${tweet//#/%23}"
|
|
tweet="${tweet//\//%2F}"
|
|
tweet="${tweet//$'\r'/}"
|
|
tweet="${tweet//$'\n'/%0A}"
|
|
echo "* Tweet about this release on https://twitter.com/pmd_analyzer:"
|
|
echo " <https://twitter.com/intent/tweet?text=$tweet>"
|
|
echo
|
|
echo "------------------------------------------"
|
|
echo "Done."
|
|
echo "------------------------------------------"
|
|
echo
|
|
|
|
|