mirror of
https://github.com/storytold/artcraft-services.git
synced 2026-11-19 08:53:03 +01:00
32 lines
1.1 KiB
Bash
32 lines
1.1 KiB
Bash
#!/bin/bash
|
|
#
|
|
# Regenerate the committed OpenAPI document served at storyteller-docs.artcraft.team.
|
|
#
|
|
# bash script/build_api_docs.sh
|
|
#
|
|
# The document is produced by the `docs-cli` binary (utoipa), which builds the
|
|
# whole workspace. Cloudflare Workers Builds cannot run that, so
|
|
# frontend/api_docs/public/api.json is committed and this script refreshes it.
|
|
# Run it after changing an endpoint or a request/response type, then commit the
|
|
# regenerated file with the change.
|
|
|
|
set -euo pipefail
|
|
|
|
cd "$(dirname "$0")/.."
|
|
|
|
export SQLX_OFFLINE=true
|
|
|
|
# boring-sys2 uses bindgen (libclang) to generate BoringSSL FFI bindings. On
|
|
# machines where clang cannot find stddef.h on its own, point it at GCC's own
|
|
# include directory instead of installing packages.
|
|
if command -v gcc >/dev/null 2>&1; then
|
|
export BINDGEN_EXTRA_CLANG_ARGS="-I$(gcc -print-file-name=include)"
|
|
fi
|
|
|
|
cargo run --bin docs-cli
|
|
|
|
# docs-cli writes api.json into the working directory, which is the repo root.
|
|
mv api.json frontend/api_docs/public/api.json
|
|
|
|
echo "Wrote frontend/api_docs/public/api.json ($(wc -c < frontend/api_docs/public/api.json) bytes)"
|