nix/scripts/release-notes

#!/usr/bin/env nix-shell
#!nix-shell -i bash ../shell.nix -I nixpkgs=channel:nixos-unstable-small
#                                   ^^^^^^^
#                Only used for bash. shell.nix goes to the flake.

# --- CONFIGURATION ---

# This does double duty for
# - including rl-next
# - marking where to insert new links (right after)
SUMMARY_MARKER_LINE='{{#include ./SUMMARY-rl-next.md}}'

# --- LIB ---

log() {
  echo 1>&2 "release-notes:" "$@"
}
logcmd() {
  local cmd="$1"
  shift
  logcmd2 "$cmd" "${*@Q}" "$cmd" "$@"
}
logcmd2() {
  local fakecmd="$1"
  local fakeargs="$2"
  shift
  shift
  printf 1>&2 "release-notes: \033[34;1m$fakecmd\033[0m "
  echo "$fakeargs" 1>&2
  "$@"
}
die() {
  # ANSI red
  printf 1>&2 "release-notes: \033[31;1merror:\033[0m"
  echo 1>&2 "" "$@"
  exit 1
}
confirm() {
  local answer
  echo 1>&2 "$@" "[y/n]"
  read -r answer
  case "$answer" in
    y|Y|yes|Yes|YES)
      return 0
      ;;
    n|N|no|No|NO)
      return 1
      ;;
    *)
      echo 1>&2 "please answer y or n"
      confirm "$@"
      ;;
  esac
}
report_done() {
  logcmd2 "git" "show" git -c pager.show=false show
  printf 1>&2 "release-notes: \033[32;1mdone\033[0m\n"
}

# --- PARSE ARGS ---

if [[ $# -gt 0 ]]; then
  die "Release notes takes no arguments, but make sure to set VERSION."
fi

# --- CHECKS ---

if [[ ! -e flake.nix ]] || [[ ! -e .git ]]; then
  die "must run in repo root"
  exit 1
fi

# repo must be clean
if ! git diff --quiet; then
  die "repo is dirty, please commit or stash changes"
fi

if ! git diff --quiet --cached; then
  die "repo has staged changes, please commit or stash them"
fi

if ! grep "$SUMMARY_MARKER_LINE" doc/manual/src/SUMMARY.md.in >/dev/null; then
  # would have been nice to catch this early, but won't be worth the extra infra
  die "SUMMARY.md.in is missing the marker line '$SUMMARY_MARKER_LINE', which would be used for inserting a new release notes page. Please fix the script."
fi

if [[ ! -n "${VERSION:-}" ]]; then
  die "please set the VERSION environment variable before invoking this script"
  exit 1
fi

case "$VERSION" in
  # FIXME: accepts "." without any real digits
  [[:digit:]]*.[[:digit:]]*)
    ;;
  *)
    die "VERSION must be MAJOR.MINOR, where each is a number, e.g. 2.20 (VERSION was set to $VERSION)"
    ;;
esac

# --- DEFAULTS ---

if [[ ! -n "${DATE:-}" ]]; then
  DATE="$(date +%Y-%m-%d)"
  log "DATE not set, using $DATE"
fi

case "$DATE" in
  [[:digit:]]*-[[:digit:]]*-[[:digit:]]*)
    ;;
  *)
    die "DATE must be YYYY-MM-DD, e.g. 2021-12-31 (DATE was set to $DATE)"
    ;;
esac

# --- DO THE WORK ---

basename=rl-$VERSION.md
file=doc/manual/src/release-notes/$basename
title="Release $VERSION ($DATE)"

(
  # TODO add minor number, and append?
  echo "# $title"
  echo
  changelog-d doc/manual/rl-next | sed -e 's/ *$//'
) > $file

log "Wrote $file"

NEW_SUMMARY_LINE="  - [$title](release-notes/$basename)"

# find the marker line, insert new link after it
escaped_marker="$(echo "$SUMMARY_MARKER_LINE" | sed -e 's/\//\\\//g' -e 's/ /\\ /g')"
escaped_line="$(echo "$NEW_SUMMARY_LINE" | sed -e 's/\//\\\//g' -e 's/ /\\ /g')"
logcmd sed -i -e "/$escaped_marker/a $escaped_line" doc/manual/src/SUMMARY.md.in

for f in doc/manual/rl-next/*.md; do
  if [[ config != "$(basename $f)" ]]; then
    logcmd git rm $f
  fi
done

logcmd git add $file doc/manual/src/SUMMARY.md.in
logcmd git status
logcmd git commit -m "release notes: $VERSION"

report_done