schema-publish.sh

#!/usr/bin/env bash

# Author: @ralfhandl

# Run this script from the root of the repo. It is designed to be run by a GitHub workflow.

schemaDir="src/schemas/validation"
branch=$(git branch --show-current)


if [ -z "$1" ]; then
  if [[ $branch =~ ^v([0-9]+\.[0-9]+)-dev$ ]]; then
    deploydir="./deploy/oas/${BASH_REMATCH[1]}"
  else
    echo "Unable to determine version from branch name; should be vX.Y-dev"
    exit 1
  fi
elif [ $1 = "src" ]; then
  deploydir="./deploy-preview"
else
  echo "Unrecognized argument"
  exit 1
fi

# create the date-stamped schemas
publish_schema() {
  local schema="$1"
  local date="$2"
  local sedCmd="$3"

  local base=$(basename $schema '.yaml')
  local target=$deploydir/$base/$date

  mkdir -p $deploydir/$base

  # replace the WORK-IN-PROGRESS placeholders
  sed ${sedCmd[@]} $schemaDir/$schema | npx yaml --json --indent 2 --single > $target

  # Find the jekyll lander markdown file for this iteration.
  local jekyllLander=$(find "$deploydir/$base" -maxdepth 1 -name "*.md")

  # Move the jekyll lander markdown for this iteration to the deploy destination.
  # The lander files only exist in the gh-pages branch.
  if [ ! -z "$jekyllLander" ]; then
    mv $jekyllLander $target.md
    echo " * $newestCommitDate: $schema & jekyll lander $(basename $jekyllLander)"
  else
    echo " * $newestCommitDate: $schema"
  fi

}

echo === Building schemas into $deploydir

# list of schemas to process, dependent schemas come first
schemas=(meta.yaml dialect.yaml schema.yaml schema-base.yaml)

# publish each schema using its or any of its dependencies newest commit date.
maxDate=""
sedCmds=()
for schema in "${schemas[@]}"; do
  if [ -f  "$schemaDir/$schema" ]; then
    newestCommitDate=$(git log -1 --format="%ad" --date=short "$schemaDir/$schema")

    # the newest date across a schema and all its dependencies is its date stamp
    if [ "$newestCommitDate" \> "$maxDate" ]; then
      maxDate=$newestCommitDate
    fi

    base=$(basename $schema '.yaml')
    # Add the replacement for this schema's placeholder to list of sed commands.
    sedCmds+=("s/${base}\/WORK-IN-PROGRESS/${base}\/${maxDate}/g")

    publish_schema "$schema" "$maxDate" $(printf '%s;' "${sedCmds[@]}")
  fi
done

echo === Built