iframe-proxy | Sunbelt Computer Software

History

executable file

126 lines (108 loc) · 2.94 KB

Raw

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

#!/bin/bash

# SPDX-License-Identifier: Apache-2.0

set -euo pipefail

SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)

REPO_DIR=$(cd "${SCRIPT_DIR}/.." && pwd)

MODE="${1:-check}"

if [[ $# -gt 0 ]]; then

shift

usage() {

cat <<'EOF'

Usage: fern/build_docs.sh [check|preview|publish|dev] [fern arguments...]

Modes:

check Validate Fern configuration, links, and Markdown syntax.

preview Build and publish a Fern preview deployment.

publish Build and publish the production Fern docs site.

dev Start Fern's local docs preview server.

Examples:

fern/build_docs.sh

fern/build_docs.sh preview --id pr-123 --force

fern/build_docs.sh publish --instance rapids-cuvs.docs.buildwithfern.com

fern/build_docs.sh dev --port 3002

EOF

}

require_node_22() {

if ! command -v node >/dev/null 2>&1; then

echo "Fern docs require Node.js 22 or newer, but node was not found on PATH." >&2

echo "Install or activate Node.js 22+ before running fern/build_docs.sh." >&2

exit 1

local node_version

local node_major

node_version=$(node -p 'process.versions.node' 2>/dev/null || true)

node_major="${node_version%%.*}"

if [[ ! "${node_major}" =~ ^[0-9]+$ || "${node_major}" -lt 22 ]]; then

echo "Fern docs require Node.js 22 or newer, but found Node.js ${node_version:-unknown}." >&2

echo "Older Node.js versions can fail with errors such as \"SyntaxError: Unexpected token '.'.\"" >&2

echo "Install or activate Node.js 22+ before running fern/build_docs.sh." >&2

exit 1

}

require_node_22

fern_config_version() {

python3 - "${SCRIPT_DIR}/fern.config.json" <<'PY'

import json

import sys

with open(sys.argv[1], encoding="utf-8") as f:

print(json.load(f).get("version", "*"))

}

FERN_VERSION="$(fern_config_version)"

if [[ -n "${FERN_CLI:-}" ]]; then

FERN_CMD=("${FERN_CLI}")

elif [[ "${FERN_VERSION}" != "*" ]]; then

FERN_CMD=("npx" "--yes" "fern-api@${FERN_VERSION}")

elif command -v fern >/dev/null 2>&1; then

FERN_CMD=("fern")

else

FERN_CMD=("npx" "--yes" "fern-api")

run_fern() {

"${FERN_CMD[@]}" "$@"

}

generate_api_reference() {

python3 "${SCRIPT_DIR}/scripts/generate_api_reference.py"

}

run_checks() {

pushd "${REPO_DIR}" >/dev/null

run_fern check --warnings

run_fern docs md check

popd >/dev/null

}

case "${MODE}" in

check)

generate_api_reference

run_checks

;;

preview)

generate_api_reference

run_checks

pushd "${REPO_DIR}" >/dev/null

run_fern generate --docs --preview "$@"

popd >/dev/null

;;

publish)

generate_api_reference

run_checks

pushd "${REPO_DIR}" >/dev/null

run_fern generate --docs "$@"

popd >/dev/null

;;

dev)

generate_api_reference

pushd "${REPO_DIR}" >/dev/null

run_fern docs dev "$@"

popd >/dev/null

;;

-h|--help|help)

usage

;;

echo "Unknown mode: ${MODE}" >&2

echo >&2

usage >&2

exit 2

;;

esac

Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

FilesExpand file tree

build_docs.sh

Latest commit

History

build_docs.sh

File metadata and controls