mark-release.sh

#!/usr/bin/env bash

read -r -d '' USAGE << EOUSAGE
Mark a release for project, ensure commits in master are in debian changelog.
If there are changes to release, update version and debian changelog,
also can tag and push the release.
If all commits are in changelog, won't change anything.

The last line of output indicates if a release is marked or not.

usage: $0 [options]

options:
    -a          automated mode (commit, tag, push)
    -c          commit the changes for marking the release
    -h          show this help and exit
    -p          git push HEAD and tags
    -t          tag the commit
    -v          verbose output

environment:
    AUTHOR      commit author (name <email>) format
    DEBFULLNAME changelog writer name
    DEBEMAIL    changelog writer email
    MESSAGE     commit message
EOUSAGE

# ==== opts ====
COMMIT=false
PUSH=false
TAG=false
VERBOSE=false

while getopts 'achptv' flag; do
case "$flag" in
    a)
        COMMIT=true
        TAG=true
        PUSH=true
        ;;
    c)
        COMMIT=true
        ;;
    h)
        echo "$USAGE"
        exit
        ;;
    p)
        PUSH=true
        ;;
    t)
        TAG=true
        ;;
    v)
        VERBOSE=true
        ;;
esac
done


set -o errexit

ROOT_DIR=$(realpath $(dirname $0))
CHANGELOG="$ROOT_DIR/debian/changelog"
VERSION=$(date "+%Y%m%d.%H%M%S")
LOG_USER="${SUDO_USER:-$USER}"

# === options from env ====

# committer info
AUTHOR="${AUTHOR:-}"
MESSAGE="${MESSAGE}"
if [[ -z "$MESSAGE" ]]; then
    MESSAGE="[automated] Marking Release $VERSION"
fi

# changelog writer info
export DEBFULLNAME="${DEBFULLNAME:-Hypernode team}"
export DEBEMAIL="${DEBMAIL:-hypernode@byte.nl}"


log() {
    logger --tag 'dehydrated-mark-release' "[$$ @$LOG_USER] $1"
    if $VERBOSE; then
        echo "$1"
    fi
}

# deb_changelog_updated: returns 0 if there are changes to be released or 1 otherwise
deb_changelog_updated() {
    log "checking if debian changelog needs update"
    # use gbp dch itself to see if there are any changes detected.
    # this way the logic of detecting changes is more consistent with
    # the rest of the system.
    # @TODO: use --debian-branch master instead of ignore-branch
    gbp dch --debian-tag="%(version)s" --ignore-branch
    # find changelog diff containing author names (in [ name ] format), which means
    # there are new commits in changelog
    local changed=$(git diff --text --ignore-all-space --unified=0 --no-color -G '\[ ' $CHANGELOG)
    log "reverting possible changes in debian changelog during update detection"
    git checkout -- $CHANGELOG
    if [[ -n "$changed" ]]; then
        return 0
    fi
    return 1
}

mark_release() {
    log "marking release $VERSION ..."

    log "generating debian changelog"
    # @TODO: use --debian-branch master instead of ignore-branch
    gbp dch --debian-tag="%(version)s" --new-version=$VERSION --ignore-branch
    git add $CHANGELOG
}

commit() {
    log "comitting the release changes"
    if [[ -z "$AUTHOR" ]]; then
        git commit --no-edit --message="$MESSAGE"
    else
        git commit --no-edit --message="$MESSAGE" --author "$AUTHOR"
    fi
}


if ! deb_changelog_updated; then
    log "detected no change, skipping marking release!"
    echo 'no change'
    exit
fi

mark_release

if $COMMIT; then
    commit
    if $TAG; then
        log "creating git tag '$VERSION' ..."
        git tag $VERSION
    fi

    if $PUSH; then
        log "pushing changes to origin ..."
        git push origin HEAD:debian
        if $TAG; then
            git push origin $VERSION
        fi
    fi
else
    log "not committing, skipping tagging and pushing!"
fi

echo "marked release $VERSION"