build.sh

#!/usr/bin/env bash
# Copyright (c) Ansible Project
# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
# SPDX-License-Identifier: GPL-3.0-or-later

# Created with antsibull-docs 2.5.0.post0

set -e

pushd "$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )"

# Temporary file used to capture the JSON manifest emitted by
# scripts/collection_cache.py. Cleaned up alongside the pushd/popd via trap.
CACHE_MANIFEST_FILE="$(mktemp)"
trap 'rm -f "${CACHE_MANIFEST_FILE}"; popd' EXIT

# shellcheck source=versions.env
source versions.env

# 0. Ensure the npm CLI tools (postcss, esbuild) are available. The container
#    image bakes them into /usr/src/node_modules; a plain CI runner or host
#    checkout has neither, so install them on demand. Skipped when a populated
#    node_modules already exists (container, or a previous run), keeping the
#    step idempotent. Requires npm only in the not-yet-installed case — GitHub
#    runners ship it, and the Docker image never reaches this branch.
if [ ! -x /usr/src/node_modules/.bin/postcss ] && [ ! -x node_modules/.bin/postcss ]; then
    echo "Installing npm dependencies (postcss, esbuild)..."
    if [ -f package-lock.json ]; then
        npm ci --no-audit --no-fund
    else
        npm install --no-audit --no-fund
    fi
fi

# 1. Build frontend artefacts (CSS + JS) from src/ into _static/
echo "Building frontend bundles..."
./scripts/build_frontend.sh

# 2. Ensure Ansible collections are present in the local cache
#    (replaces the former galaxy-install calls).
echo "Ensuring Ansible collection cache..."
CACHE_DIR="${ARILLSO_COLLECTIONS_CACHE:-${HOME}/.cache/arillso-collections}"
CACHE_ARGS=(--versions-file versions.env --cache-dir "${CACHE_DIR}")
if [ "${ARILLSO_OFFLINE:-0}" = "1" ]; then
    CACHE_ARGS+=(--offline)
fi
python3 scripts/collection_cache.py ensure "${CACHE_ARGS[@]}" > "${CACHE_MANIFEST_FILE}"

# Build ANSIBLE_COLLECTIONS_PATH from the manifest so antsibull-docs sees the
# cached collection tree. Each cached collection lives in a
# self-contained <path>/ansible_collections tree (the cache stores every pinned
# version in its own directory). ansible-doc resolves collections from the
# parent of an "ansible_collections" directory, so we join those per-collection
# parents — not the bare cache_root, which has no ansible_collections child.
ANSIBLE_COLLECTIONS_PATH="$(python3 -c "import json,sys; d=json.load(open(sys.argv[1])); print(':'.join(c['path'] + '/ansible_collections' for c in d['collections']))" "${CACHE_MANIFEST_FILE}")"
export ANSIBLE_COLLECTIONS_PATH

# 3. Create collection documentation into temporary directory
rm -rf temp-rst
mkdir -p temp-rst
chmod og-w temp-rst  # antsibull-docs wants that directory only readable by itself

antsibull-docs \
    --config-file antsibull-docs.cfg \
    collection \
    --use-current \
    --collection-version "arillso.system:${ARILLSO_SYSTEM_VERSION}" \
    --collection-version "arillso.agent:${ARILLSO_AGENT_VERSION}" \
    --collection-version "arillso.container:${ARILLSO_CONTAINER_VERSION}" \
    --dest-dir temp-rst \
    arillso.system arillso.agent arillso.container

# 4. Copy collection documentation into source directory
rsync -cprv --delete-after temp-rst/collections/ rst/collections/

# 5. Normalize collection names (token-based).
echo "Normalizing collection names..."
python3 scripts/normalize_collections.py --root rst

# 6. Build Sphinx site
sphinx-build -M html rst build -c . -W --keep-going

# Note: no separate post-Sphinx CSS optimization step. The frontend build
# (step 1) already runs custom.css through postcss.config.js, which applies
# autoprefixer and cssnano, so the asset Sphinx copies is final.