Skip to content

docs(fetch): document --page flag for disambiguating frames #461

docs(fetch): document --page flag for disambiguating frames

docs(fetch): document --page flag for disambiguating frames #461

Workflow file for this run

name: CI
on:
push:
branches: ["main"]
pull_request:
branches: ["main"]
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
MISE_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
MISE_GITHUB_GITHUB_ATTESTATIONS: false
jobs:
lint:
name: Lint
runs-on: macos-15
steps:
- uses: actions/checkout@v6
with:
lfs: true
- uses: jdx/mise-action@v4
with:
experimental: true
github_token: ${{ secrets.GITHUB_TOKEN }}
- name: Check formatting (Swift + Markdown)
run: mise run format-check
- name: Lint (SwiftLint)
run: mise run lint
- name: Check llms.txt files are up to date
run: bash Scripts/generate-llms.sh && git diff --exit-code llms.txt llms-full.txt
build-macos:
name: Build & Test (macOS)
runs-on: macos-15
needs: lint
env:
DEVELOPER_DIR: "/Applications/Xcode_26.2.app/Contents/Developer"
steps:
- uses: actions/checkout@v6
with:
lfs: true
- name: Install Swift 6.3 toolchain
run: |
curl -fLo swift-6.3.pkg "https://download.swift.org/swift-6.3-release/xcode/swift-6.3-RELEASE/swift-6.3-RELEASE-osx.pkg"
sudo installer -pkg swift-6.3.pkg -target /
TOOLCHAINS=$(plutil -extract CFBundleIdentifier raw /Library/Developer/Toolchains/swift-6.3-RELEASE.xctoolchain/Info.plist)
echo "TOOLCHAINS=$TOOLCHAINS" >> "$GITHUB_ENV"
- name: Cache SPM dependencies
uses: actions/cache@v5
with:
path: .build
key: ${{ runner.os }}-swift-6.3-spm-${{ hashFiles('Package.swift', 'Package.resolved') }}
restore-keys: |
${{ runner.os }}-swift-6.3-spm-
- uses: jdx/mise-action@v4
with:
experimental: true
github_token: ${{ secrets.GITHUB_TOKEN }}
- name: Verify pkl installation
run: pkl --version
- name: Show Swift version
run: swift --version
- name: Build (including tests)
run: swift build --build-tests 2>&1 | xcsift
- name: Test
run: swift test --skip-build --parallel 2>&1 | xcsift
build-linux:
name: Build & Test (Linux)
runs-on: ubuntu-latest
needs: lint
container:
image: swift:6.3-jammy
steps:
- name: Install dependencies
run: |
apt-get update
apt-get install -y git-lfs curl
git lfs install
- uses: actions/checkout@v6
with:
lfs: true
- name: Cache SPM dependencies
uses: actions/cache@v5
with:
path: .build
key: ${{ runner.os }}-swift-6.3-spm-${{ hashFiles('Package.swift', 'Package.resolved') }}
restore-keys: |
${{ runner.os }}-swift-6.3-spm-
- uses: jdx/mise-action@v4
with:
experimental: true
github_token: ${{ secrets.GITHUB_TOKEN }}
- name: Install tools (xcsift, pkl)
run: |
mise install xcsift pkl
mise where xcsift >> "$GITHUB_PATH"
mise where pkl >> "$GITHUB_PATH"
- name: Verify pkl installation
run: pkl --version
- name: Show Swift version
run: swift --version
- name: Build (including tests)
run: swift build --build-tests 2>&1 | xcsift
- name: Run tests
# Build tests separately to avoid hangs from concurrent build + test execution
run: swift test --skip-build --parallel 2>&1 | xcsift
build-windows:
name: Build (Windows)
runs-on: windows-latest
needs: lint
steps:
- uses: actions/checkout@v6
- name: Install Swift
uses: compnerd/gha-setup-swift@v0.3.0
with:
branch: swift-6.3-release
tag: 6.3-RELEASE
- name: Cache SPM dependencies
uses: actions/cache@v5
with:
path: .build
key: ${{ runner.os }}-swift-6.3-spm-${{ hashFiles('Package.swift', 'Package.resolved') }}
restore-keys: |
${{ runner.os }}-swift-6.3-spm-
- name: Swift version
run: swift --version
- name: Resolve dependencies
run: swift package resolve
- name: Build (Debug)
run: swift build