Files
Behdad Esfahbod 4fd912a3c8 [ci] Avoid saving unchanged compiler-cache snapshots
Restore compiler caches through a shared setup action and save them
explicitly only when compilation reports cache misses. Keep existing
restore prefixes and make cache-save failures nonfatal. Before saving
ccache, prune entries that were not used during the job.

This avoids duplicate snapshots on fully cached runs and removes
unrelated restored objects from changed snapshots. Key the MSVC
installed prefix by its dependency build inputs rather than unrelated
workflow edits; dependency options remain in the hashed helper project.

Validation: actual ccache 4.9.1 cold/warm and pruning checks; sccache
statistics and failure-path checks; nine workflow setup/save pairs;
actionlint, git diff --check, and meson test -C build
(302 passed, one skipped). Remote uploads remain for CI.

Assisted-by: OpenAI Codex
2026-11-11 19:48:07 -06:00

94 lines
2.8 KiB
YAML

name: docs
on:
push:
branches: [ main ]
tags: ["*.*.*"]
pull_request:
branches: [ main ]
concurrency:
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.run_id }}
cancel-in-progress: ${{ github.event_name == 'pull_request' }}
permissions:
contents: read
jobs:
docs:
runs-on: ubuntu-24.04
steps:
- name: Checkout
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
- name: Setup Ccache
id: compiler-cache
uses: ./.github/actions/compiler-cache
with:
key: ${{ github.workflow }}-${{ runner.os }}-${{ runner.arch }}
- name: Install Dependencies
run: |
sudo rm -f /etc/apt/sources.list.d/google-chrome.list
sudo rm -f /etc/apt/sources.list.d/microsoft-prod.list
sudo apt-get update
sudo apt-get install \
gcc \
gobject-introspection \
gtk-doc-tools \
libcairo2-dev \
libfreetype6-dev \
libgirepository1.0-dev \
libglib2.0-dev \
libgraphite2-dev \
libicu-dev \
libpng-dev \
pkg-config \
zlib1g-dev \
help2man
- name: Setup Emscripten
uses: mymindstorm/setup-emsdk@4528d102f7230f0e7b276855c01ea1159be0e984 # v16
with:
version: latest
- name: Setup Python
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
with:
python-version: '3.12'
- name: Install Python Dependencies
run: pip3 install -r .ci/requirements.txt --require-hashes
- name: Build HarfBuzz
run: |
ccache --version
meson setup build \
-Dauto_features=enabled \
-Doptimization=2 \
-Ddoc_tests=true \
-Dgpu_demo=disabled \
-Dchafa=disabled
meson compile -Cbuild
- name: Generate Documentation
run: ninja -Cbuild harfbuzz-doc
- name: Run Doc Tests
run: meson test -Cbuild --print-errorlogs harfbuzz-doc-check
- name: Build Web Demos
run: |
bash util/gpu/web/build.sh
bash util/gpu/web/build-webgpu.sh
cp util/gpu/web/dom.html util/gpu/web/out/
- name: Stage for deployment
run: |
mkdir -p build/docs/html/hb-gpu-demo
cp util/gpu/web/out/* build/docs/html/hb-gpu-demo/
- name: Deploy
if: github.ref_type == 'tag'
run: .ci/deploy-docs.sh
env:
GH_TOKEN: ${{ secrets.DOCS_PUSH_TOKEN }}
REVISION: ${{ github.sha }}
- name: Save Compiler Cache
if: ${{ !cancelled() && steps.compiler-cache.outcome == 'success' }}
uses: ./.github/actions/save-compiler-cache
with:
key: ${{ steps.compiler-cache.outputs.key }}
variant: ${{ steps.compiler-cache.outputs.variant }}
start: ${{ steps.compiler-cache.outputs.start }}