Merge PR #138 (Migrate C-I tests from Azure to GitHub actions)

This merge brings PR #138 (Migrate C-I tests from Azure Dev Pipelines
to GitHub actions, by @yantosca) into the KPP 3.3.1 (or 3.4.0) development
stream.

PR #138 moves the C-I tests, which ran when pushes or pull requests
were made, from MS Azure Dev Pipelines to GitHub Actions.  This now
has the following advantages:

- We no longer need to maintain an external Azure Dev Pipelines account
- We can run the C-I tests on multiple compilers
- GitHub Actions has enough memory to run all C-I tests, including
  those for MCM (Azure did not)

Also we have added a "Lint" GitHub action to flag any security issues
with all other GitHub Actions configuration files.

Signed-off-by: Bob Yantosca <[email protected]>

Author: yantosca

.ci-pipelines/Dockerfile

@@ -0,0 +1,58 @@
+# Workflow to run linting checks on source
+name: Lint
+
+# Controls when the workflow will run
+on:
+  # Triggers the workflow on pushes to the "main" branch, i.e., PR merges
+  push:
+    branches: [ "main" ]
+
+  # Triggers the workflow on pushes to open pull requests with code changes
+  pull_request:
+    paths:
+      - '.github/workflows/*.yml'
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Cancel jobs running if new commits are pushed
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+# Workflow run - one or more jobs that can run sequentially or in parallel
+jobs:
+  # This workflow contains a single job called "lint"
+  lint:
+    # The type of runner that the job will run on
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+
+    # Steps represent a sequence of tasks that will be executed as part of the job
+    steps:
+      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+      - name: Checkout code
+        with:
+          persist-credentials: false
+        uses: actions/checkout@v4
+
+      - name: Install Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m venv ci_venv
+          . ci_venv/bin/activate
+          pip install zizmor==0.9.2
+
+      # Apply GitHub Actions linter, zizmor
+      - name: zizmor
+        if: always()
+        run: |
+          cd ${{ github.workspace }}
+          . ci_venv/bin/activate
+          zizmor .github/workflows/*.yml

.ci-pipelines/build-testing.yml

@@ -0,0 +1,68 @@
+---
+#
+# GitHub Action to run C-I tests with GCC compilers
+#
+name: Run C-I tests
+
+on:
+  push:
+    branches:
+      - '**'
+  pull_request:
+    branches:
+      - '**'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      KPP_HOME: ${{ github.workspace }}
+      KPP_FLEX_LIB_DIR: /usr/lib/x86_64-linux-gnu
+    strategy:
+      matrix:
+        gcc-version: [9, 10, 11, 12, 13]
+
+
+    name: Run C-I tests with GCC ${{ matrix.gcc-version }}
+    steps:
+      - name: Checkout KPP
+        uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+
+      - name: Install libraries
+        run: |
+          sudo apt update -y
+          sudo apt install -y flex bison libfl-dev
+          sudo apt install -y gcc-${{ matrix.gcc-version }} g++-${{ matrix.gcc-version }} gfortran-${{ matrix.gcc-version }}
+          sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-${{ matrix.gcc-version }} 100 \
+             --slave /usr/bin/g++ g++ /usr/bin/g++-${{ matrix.gcc-version }} \
+             --slave /usr/bin/gfortran gfortran /usr/bin/gfortran-${{ matrix.gcc-version }}
+
+
+      - name: Verify environment
+        run: |
+          echo '%%% COMPILERS %%%'
+          gcc --version
+          echo ''
+          g++ --version
+          echo ''
+          gfortran --version
+          echo ''
+          echo '%%% ENVIRONMENT %%%'
+          echo "flex             = $(which flex)"
+          echo "bison            = $(which bison)"
+          echo "KPP_HOME         = $KPP_HOME"
+          echo "KPP_FLEX_LIB_DIR = $KPP_FLEX_LIB_DIR"
+
+      - name: Compile with Make
+        run: |
+          cd $KPP_HOME/src
+          make all
+
+
+      - name: Run C-I tests
+        run: |
+          cd $KPP_HOME/.ci-pipelines
+          ./ci-testing-script.sh

.github/workflows/lint-ci-workflows.yml

@@ -11,6 +11,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased] - TBD
+### Added
+- Added GitHub Action to run C-I tests with GCC compilers v9, v10, v11, v12, and v13
+- Added "Lint" GitHub Action to check other actions for security issues
+
+### Changed
+- Updated ReadTheDocs documentation to reflect that C-I tests are now done as a GitHub Action
+
+### Removed
+- Removed C-I tests on Microsoft Azure Dev Pipelines
+
 ## [3.3.0] - 2025-07-17
 ### Added
 - New integrator: `rosenbrock_h211b_qssa.f90`