5e50b166ef
- Move remaining beach packages and embedded admin assets\n- Rewrite framework, example, build, and gate paths
61 lines
1.9 KiB
Bash
Executable File
61 lines
1.9 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# Generate the framework admin OpenAPI document and the admin SPA's TypeScript
|
|
# types from the swag annotations in cabana (D-15):
|
|
# swag v1.16.6 (Swagger 2.0) -> internal/tools/swagger2openapi (OpenAPI 3.0)
|
|
# -> openapi-typescript (admin devDependency) -> admin/src/api/schema.d.ts
|
|
# Without arguments the outputs replace admin/openapi/admin.json and
|
|
# admin/src/api/schema.d.ts. With --check nothing is written and the script
|
|
# exits non-zero when either committed file differs from a fresh generation.
|
|
set -euo pipefail
|
|
|
|
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
|
cd "$ROOT"
|
|
|
|
CHECK=0
|
|
case "${1:-}" in
|
|
"") ;;
|
|
--check) CHECK=1 ;;
|
|
*)
|
|
echo "usage: scripts/check-admin-openapi.sh [--check]" >&2
|
|
exit 2
|
|
;;
|
|
esac
|
|
|
|
if [[ ! -d admin/node_modules ]]; then
|
|
npm --prefix admin ci
|
|
fi
|
|
|
|
TMP="$(mktemp -d)"
|
|
trap 'rm -rf "$TMP"' EXIT
|
|
|
|
go run github.com/swaggo/swag/cmd/swag@v1.16.6 init \
|
|
--dir modules/cabana \
|
|
--generalInfo admin_openapi.go \
|
|
--output "$TMP" \
|
|
--outputTypes json \
|
|
--requiredByDefault \
|
|
--quiet
|
|
|
|
if [[ ! -s "$TMP/swagger.json" ]]; then
|
|
echo "check-admin-openapi: swag did not generate swagger.json" >&2
|
|
exit 1
|
|
fi
|
|
|
|
go run ./internal/tools/swagger2openapi "$TMP/swagger.json" > "$TMP/admin.json"
|
|
admin/node_modules/.bin/openapi-typescript "$TMP/admin.json" -o "$TMP/schema.d.ts"
|
|
|
|
if [[ "$CHECK" -eq 1 ]]; then
|
|
status=0
|
|
diff -u admin/openapi/admin.json "$TMP/admin.json" || status=1
|
|
diff -u admin/src/api/schema.d.ts "$TMP/schema.d.ts" || status=1
|
|
if [[ "$status" -ne 0 ]]; then
|
|
echo "check-admin-openapi: committed admin OpenAPI output is stale; run scripts/check-admin-openapi.sh" >&2
|
|
fi
|
|
exit "$status"
|
|
fi
|
|
|
|
mkdir -p admin/openapi admin/src/api
|
|
cp "$TMP/admin.json" admin/openapi/admin.json
|
|
cp "$TMP/schema.d.ts" admin/src/api/schema.d.ts
|
|
echo "check-admin-openapi: wrote admin/openapi/admin.json and admin/src/api/schema.d.ts"
|