94870bc0f0## Problems - Old versions of GitHub Actions (they use old unsupported NodeJS v20, GitHub prints a ["Node.js 20 actions are deprecated" ](https://github.com/agama-project/agama/actions/runs/26086960005) warning) - Installing the needed Ruby gems takes quite long time (about [one and half minute](https://github.com/agama-project/agama/actions/runs/26175301761/job/77003739150#step:9:7)) ## Solution - Update the GitHub Action versions - Cache the installed Ruby gems, restoring the cache and running Bundler now takes [just about 15 seconds](https://github.com/agama-project/agama/actions/runs/26182626931/job/77029525706#step:8:17). So the test run is it at least more than one minute faster! ## Testing - Tested with the updated GitHub Actions
80 lines
2.2 KiB
YAML
80 lines
2.2 KiB
YAML
name: "CI - Documentation Check"
|
|
|
|
permissions:
|
|
contents: read
|
|
|
|
on:
|
|
push:
|
|
paths:
|
|
# NOTE: GitHub Actions do not allow using YAML references, the same path
|
|
# list is used below for the pull request event. Keep both lists in sync!!
|
|
|
|
# this file as well
|
|
- .github/workflows/ci-doc-check.yml
|
|
# all Ruby files
|
|
- service/Gemfile*
|
|
- service/*.gemspec
|
|
- service/**.rb
|
|
# the D-Bus introspection files
|
|
- doc/dbus/**.xml
|
|
|
|
pull_request:
|
|
paths:
|
|
# NOTE: GitHub Actions do not allow using YAML references, the same path
|
|
# list is used above for the push event. Keep both lists in sync!!
|
|
|
|
# this file as well
|
|
- .github/workflows/ci-doc-check.yml
|
|
# all Ruby files
|
|
- service/Gemfile*
|
|
- service/*.gemspec
|
|
- service/**.rb
|
|
# the D-Bus introspection files
|
|
- doc/dbus/**.xml
|
|
|
|
jobs:
|
|
doc_check:
|
|
runs-on: ubuntu-latest
|
|
|
|
container:
|
|
image: registry.opensuse.org/opensuse/tumbleweed:latest
|
|
|
|
steps:
|
|
|
|
- name: Git Checkout
|
|
uses: actions/checkout@v6
|
|
|
|
- name: Fix the file owner
|
|
# fix the file owner
|
|
run: chown -R -c 0 .
|
|
|
|
- name: Configure and refresh repositories
|
|
# disable unused repositories to have faster refresh
|
|
run: zypper modifyrepo -d repo-non-oss repo-openh264 repo-update && zypper ref
|
|
|
|
- name: Install Ruby development files and XML tooling
|
|
run: zypper --non-interactive install --no-recommends --allow-downgrade
|
|
gcc gcc-c++ make libopenssl-devel ruby-devel augeas-devel diff
|
|
libxslt-devel libxml2-devel xmlstarlet 'rubygem(ruby-augeas)'
|
|
|
|
- name: Cache RubyGems
|
|
uses: actions/cache@v5
|
|
with:
|
|
key: "Gemfile-${{ hashFiles('service/Gemfile.lock') }}"
|
|
path: service/vendor/bundle
|
|
|
|
- name: Install RubyGems
|
|
env:
|
|
NOKOGIRI_USE_SYSTEM_LIBRARIES: 1
|
|
run: |
|
|
bundle config set --local disable_shared_gems 0
|
|
bundle install
|
|
working-directory: ./service
|
|
|
|
- name: Generate doc
|
|
run: bundle exec yardoc --fail-on-warning
|
|
working-directory: ./service
|
|
|
|
- name: Check that introspected API and its docs have not diverged
|
|
run: make check
|
|
working-directory: ./doc
|