arduino-home-assistant/scripts/prepare-release.sh

#!/usr/bin/env bash
set -euo pipefail

usage() {
    echo "Usage: $0 vMAJOR.MINOR.PATCH [--tag]"
    exit 2
}

tag="${1:-}"
[[ "$tag" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]] || usage
[[ "${2:-}" == "" || "${2:-}" == "--tag" ]] || usage

root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
version="${tag#v}"
manifest_version="$(sed -n 's/.*"version": "\([^"]*\)".*/\1/p' "$root/library.json" | head -n 1)"

if [[ "$manifest_version" != "$version" ]]; then
    echo "library.json is $manifest_version; expected $version for $tag" >&2
    exit 1
fi
defines_file="$root/src/ArduinoHADefines.h"
version_macro_count="$(grep -Ec '^#define ARDUINOHA_LIBRARY_VERSION "[0-9]+\.[0-9]+\.[0-9]+"$' "$defines_file" || true)"
if [[ "$version_macro_count" -ne 1 ]]; then
    echo "src/ArduinoHADefines.h must contain exactly one ARDUINOHA_LIBRARY_VERSION macro." >&2
    exit 1
fi

defines_version="$(sed -n 's/^#define ARDUINOHA_LIBRARY_VERSION "\([^"]*\)"$/\1/p' "$defines_file")"
if [[ "$defines_version" != "$version" ]]; then
    echo "src/ArduinoHADefines.h is $defines_version; expected $version for $tag" >&2
    exit 1
fi

if [[ -f "$root/library.properties" ]]; then
    properties_version="$(sed -n 's/^version=//p' "$root/library.properties" | head -n 1)"
    if [[ "$properties_version" != "$version" ]]; then
        echo "library.properties is $properties_version; expected $version for $tag" >&2
        exit 1
    fi
fi

if ! grep -q "^## ${version}$" "$root/CHANGELOG.md"; then
    echo "CHANGELOG.md is missing a ## ${version} section" >&2
    exit 1
fi

if awk -v heading="## $version" '
    $0 == heading { found = 1; next }
    found && /^## / { exit }
    found { print }
' "$root/CHANGELOG.md" | grep -Fq 'TODO: Describe this release.'; then
    echo "CHANGELOG.md still has the generated TODO for $version" >&2
    exit 1
fi
repo_url="https://github.com/alexhopeoconnor/arduino-home-assistant.git"
validate_reference() {
    local file="$1"
    local reference_count
    reference_count="$(grep -F "$repo_url#v" "$root/$file" | wc -l)"
    [[ "$reference_count" -eq 1 ]] || { echo "$file must contain exactly one canonical release reference" >&2; exit 1; }
    grep -Fq "$repo_url#$tag" "$root/$file" || { echo "$file does not reference $tag" >&2; exit 1; }
}
validate_reference README.md
validate_reference docs/getting-started.md

git -C "$root" diff --check

package_dir="$(mktemp -d)"
trap 'rm -rf "$package_dir"' EXIT
pio pkg pack "$root" --output "$package_dir/package.tar.gz" >/dev/null
echo "Validated release metadata and PlatformIO package for $tag"

if [[ "${2:-}" == "--tag" ]]; then
    git -C "$root" diff --quiet
    git -C "$root" diff --cached --quiet
    git -C "$root" tag -a "$tag" -m "Release $tag"
    echo "Created $tag. Push the branch and tag; GitHub Actions will publish the release."
fi