d5a4d0e8ff
Some checks failed
C++ Tests / test-fast (pull_request) Failing after 2m7s
C++ Tests / quality-gates (pull_request) Has been skipped
C++ Tests / test-fast (push) Failing after 2m10s
C++ Tests / quality-gates (push) Has been skipped
API Docs / doc-build (push) Has been skipped
Markdown link check / check (push) Has been skipped
C++ Tests / test-cgal (pull_request) Has been skipped
C++ Tests / test-cgal (push) Has been skipped
Every container now has an explicit --memory limit so the OOM killer has clean boundaries to work with instead of letting any single job consume all available RAM: test-fast: 800m (build Eigen+GTest, run 26 tests) test-cgal: 2000m (LOW_MEMORY_BUILD, was already set) quality-gates: 600m (apt install + 4 script checks) doc-build: 800m (Doxygen HTML generation) markdown-links: 400m (pure Python, very lightweight) memory-swap = 1.5× memory in each case (150% total) so the OOM killer fires cleanly without exhausting the SD card. ⚠ This is workflow-side protection only. The runner-side fix (capacity: 1 in act-runner config) prevents parallel containers entirely and is the more reliable protection — see CLAUDE.md. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
63 lines
2.3 KiB
YAML
63 lines
2.3 KiB
YAML
name: API Docs
|
|
|
|
# Trigger: include "/docs" anywhere in the commit message.
|
|
#
|
|
# git commit -m "docs: update API examples /docs"
|
|
#
|
|
# Also available via workflow_dispatch for manual runs.
|
|
|
|
on:
|
|
push:
|
|
branches:
|
|
- main
|
|
- dev
|
|
- "claude/**"
|
|
- "feature/**"
|
|
- "review/**"
|
|
workflow_dispatch: {}
|
|
|
|
# ─────────────────────────────────────────────────────────────────────────────
|
|
# Doc-build — informational only
|
|
#
|
|
# Generates Doxygen HTML from the public headers and reports warning
|
|
# statistics. Does NOT block merges: `continue-on-error: true` ensures
|
|
# warnings or extraction issues never fail.
|
|
# ─────────────────────────────────────────────────────────────────────────────
|
|
jobs:
|
|
doc-build:
|
|
if: |
|
|
github.event_name == 'workflow_dispatch' ||
|
|
contains(github.event.head_commit.message, '/docs')
|
|
runs-on: eulernest
|
|
container:
|
|
image: git.eulernest.eu/conformallab/ci-cpp:latest
|
|
options: "--memory=800m --memory-swap=1200m"
|
|
continue-on-error: true # never block the merge
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
|
|
- name: Generate API documentation
|
|
run: doxygen Doxyfile 2>&1 | tee doxygen.log
|
|
|
|
- name: Summarise warnings
|
|
if: always()
|
|
run: |
|
|
if [ -f doc/doxygen/doxygen-warnings.log ]; then
|
|
warn=$(wc -l < doc/doxygen/doxygen-warnings.log)
|
|
echo "DOC ▸ Doxygen warnings: $warn"
|
|
echo ""
|
|
echo "First 20 warnings:"
|
|
head -20 doc/doxygen/doxygen-warnings.log
|
|
else
|
|
echo "DOC ▸ No warning log produced — check that Doxyfile WARN_LOGFILE points to doc/doxygen/doxygen-warnings.log"
|
|
fi
|
|
|
|
- name: Report HTML output
|
|
if: always()
|
|
run: |
|
|
if [ -d doc/doxygen/html ]; then
|
|
files=$(find doc/doxygen/html -type f | wc -l)
|
|
size=$(du -sh doc/doxygen/html | cut -f1)
|
|
echo "DOC ▸ HTML output: $files files, $size total"
|
|
fi
|