cpp-python-build.yml

name: C/C++ build

on:
  push:
    branches-ignore:
      - 'dependabot/**'
    paths-ignore:
      - "**/*.md"
      - "joss_paper/**"
      - "CITATION.cff"
      - "**/*.ipynb"
  pull_request:
    paths-ignore:
      - "**/*.md"
      - "joss_paper/**"
      - "CITATION.cff"
      - "**/*.ipynb"

env:
  release: ${{ github.event_name == 'push' && (github.ref == 'refs/heads/master' || startsWith(github.ref, 'refs/tags/')) }}

permissions: {}

jobs:
  XML-validation:
    name: XML validation
    runs-on: ubuntu-latest
    steps:
      - name: Install Ubuntu packages
        run: |
          sudo apt-get update
          sudo apt-get install libxml2-utils
      - name: Checkout JSBSim
        uses: actions/checkout@v7
        with:
          persist-credentials: false
      - name: Validate scripts files
        run: |
          for filename in scripts/*.xml; do
            [ -e "$filename" ] || continue
            [ "$filename" != "scripts/kml_output.xml" ] || continue
            [ "$filename" != "scripts/plotfile.xml" ] || continue
            [ "$filename" != "scripts/unitconversions.xml" ] || continue
            xmllint --noout --schema JSBSimScript.xsd $filename
          done
      - name: Validate systems files
        run: |
          for filename in systems/*.xml; do
              [ -e "$filename" ] || continue
              xmllint --noout --schema JSBSimSystem.xsd $filename
          done
      - name: Valide aircraft files
        run: |
          for dir in $(ls -d aircraft/*); do
            base=$(basename $dir)
            [ "$base" != "blank" ] || continue
            filename="${dir}/${base}.xml"
            if [ -f "$filename" ]; then
                xmllint --noout --schema JSBSim.xsd $filename
            fi
          done

  MSIS-validation:
    name: MSIS code validation
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, macos-latest]
    runs-on: ${{matrix.os}}
    steps:
      - name: Checkout JSBSim
        uses: actions/checkout@v7
        with:
          persist-credentials: false
      - name: Configure the MSIS test program
        run: |
          mkdir build && cd build
          cmake ../src/models/atmosphere/MSIS
      - name: Build the JSBSim test program
        working-directory: build
        run: make --jobs=3
      - name: Run the NRLMSIS-00 C package
        working-directory: src/models/atmosphere/MSIS
        run: |
          if [[ $(head -261 DOCUMENTATION | tail -104 | diff -urN <(../../../../build/nrlmsise-test) - | wc -c) -ne 0 ]]; then
            echo "Failed."
            exit 1
          fi

  Linux:
    name: C/C++ build (Linux)
    needs: [XML-validation, MSIS-validation]
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-24.04]
        expat: [ON, OFF]
        shared_libs: [ON, OFF]
        build_julia: [OFF]
        display_stack_trace: [ON]
        include:
          - os: ubuntu-22.04
            expat: OFF
            shared_libs: OFF
            build_julia: ON
            display_stack_trace: OFF
    env:
      static_link: ${{ matrix.expat == 'OFF' && matrix.shared_libs == 'OFF' }}
    runs-on: ${{ matrix.os }}
    steps:
      - name: Install Ubuntu packages
        run: |
          sudo apt-get update
          sudo apt-get install cxxtest valgrind binutils-dev
      - name: Checkout JSBSim
        uses: actions/checkout@v7
        with:
          persist-credentials: false
      - name: Cache Python packages & CTest cost data
        # CTestCostData.txt is used by CTest to optimize the distribution of the
        # tests between the CPU cores and reduce execution time.
        uses: actions/cache@v6
        with:
          path: |
            ~/.cache/pip
            build/Testing/Temporary/CTestCostData.txt
          key: ${{ runner.os }}-3.10-${{ hashFiles('tests/CMakeLists.txt', 'python/requirements.txt') }}
      - name: Set up Python 3.10
        uses: actions/setup-python@v7
        with:
          python-version: '3.10'
      - name: Install Python packages
        run: |
          pip install -r python/requirements.txt
          pip install valgrindci
      - name: Configure Julia
        if: matrix.build_julia == 'ON'
        run: |
          julia -e "import Pkg;Pkg.add(\"CxxWrap\")"
          export CXXWRAP_PREFIX_PATH=`julia -e "using CxxWrap;print(CxxWrap.prefix_path())"`
          echo "JSBSIM_PREFIX_PATH=$CXXWRAP_PREFIX_PATH" >> $GITHUB_ENV
      - name: Checkout Backward-cpp
        if: matrix.display_stack_trace == 'ON'
        id: BackwardCppCheckout
        uses: actions/checkout@v7
        with:
          repository: bombela/backward-cpp
          ref: 'v1.6'
          path: backward-cpp
          persist-credentials: false
      - name: Configure Backward-cpp
        if: steps.BackwardCppCheckout.outcome == 'success'
        run: echo "JSBSIM_PREFIX_PATH=$PWD/backward-cpp" >> $GITHUB_ENV
      - name: Configure JSBSim
        run: |
          mkdir -p build && cd build
          cmake -DCPACK_GENERATOR=DEB -DINSTALL_JSBSIM_PYTHON_MODULE=ON -DCMAKE_C_FLAGS_DEBUG="-g -O2" -DCMAKE_CXX_FLAGS_DEBUG="-g -O2" -DCMAKE_BUILD_TYPE=Debug -DSYSTEM_EXPAT=${{matrix.expat}} -DBUILD_SHARED_LIBS=${{matrix.shared_libs}} -DBUILD_JULIA_PACKAGE=${{matrix.build_julia}} -DFPECTL_DISPLAY_STACK_TRACE=${{matrix.display_stack_trace}} -DCMAKE_PREFIX_PATH=$JSBSIM_PREFIX_PATH -DCMAKE_INSTALL_PREFIX=/usr ..
      - name: Build JSBSim
        working-directory: build
        run: make --jobs=$(nproc)
      - name: Test with Valgrind
        run: |
          valgrind --tool=memcheck --leak-check=full --leak-resolution=high --track-origins=yes --xml=yes --xml-file=valgrind_Short_S23_3.xml build/src/JSBSim scripts/Short_S23_3.xml --end-time=5.
          valgrind-ci valgrind_Short_S23_3.xml --abort-on-errors
      - name: Test the Display of the Stack Trace when an FPE is raised
        if: steps.BackwardCppCheckout.outcome == 'success'
        working-directory: build
        run: LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$PWD/src ctest -R fpectl -V
      - name: Test JSBSim
        working-directory: build
        run: LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$PWD/src ctest --parallel $(nproc) --output-on-failure
      - name: Build Ubuntu packages
        if: env.static_link == 'true'
        working-directory: build
        run: cpack

    # On failure, upload logs
      - name: On failure - Upload logs
        uses: actions/upload-artifact@v7
        if: failure()
        with:
          name: Linux-${{ matrix.os }}-system_expat_${{ matrix.expat }}-shared_libs_${{ matrix.shared_libs }}.logs
          path: |
            build/Testing/Temporary/*.log
            build/tests/*-build.log
            valgrind_Short_S23_3.xml
      - name: On failure - Display a summary of valgrind errors.
        if: failure()
        run: valgrind-ci valgrind_Short_S23_3.xml --number-of-errors --summary --source=.

      - name: Upload Files for Release
        uses: actions/upload-artifact@v7
        if: env.release == 'true' && env.static_link == 'true'
        with:
          name: Linux-${{ matrix.os }}.binaries
          path: build/*.deb

  Matlab-SFunction:
    name: Matlab S-Function
    needs: [ Linux, MacOS, Windows-MSVC ]
    strategy:
      fail-fast: false
      matrix:
        os: [ macos-15, ubuntu-22.04, windows-latest ]
    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout JSBSim
        uses: actions/checkout@v7
        with:
          persist-credentials: false
      - name: Set up Matlab
        uses: matlab-actions/setup-matlab@v3
        with:
          release: R2023b
          products: Simulink
      - name: Configure JSBSim
        run: |
          mkdir build
          cd build
          cmake -DBUILD_MATLAB_SFUNCTION=ON ..
      - name: Build JSBSim S-Function
        working-directory: build
        run: cmake --build . --config RelWithDebInfo --target JSBSim_SFunction --parallel 3
      - name: Prepare Tests
        working-directory: matlab
        # The script will be run from the directory 'matlab' so we need to copy
        # the folders that will be used by JSBSim
        run: |
          cp -R ../aircraft .
          cp -R ../engine .
          cp -R ../systems .
          cp -R ../scripts .
      - name: Force Matlab using the system libstdc++ rather than its own (Linux)
          # See https://stackoverflow.com/questions/37921139/error-version-glibcxx-3-4-21-not-found
        if: runner.os == 'Linux'
        run: echo "LD_PRELOAD=/lib/x86_64-linux-gnu/libstdc++.so.6" >> $GITHUB_ENV
      - name: Run Tests (Linux & MacOS)
        if: runner.os != 'Windows'
        id: tests-unix
        uses: matlab-actions/run-command@v3
        with:
          command: addpath('build/matlab'), run('matlab/TestJSBSim.m')
      - name: Run Tests (Windows)
        if: runner.os == 'Windows'
        id: tests-windows
        uses: matlab-actions/run-command@v3
        with:
          command: addpath('build/matlab/RelWithDebInfo'), run('matlab/TestJSBSim.m')

      - name: Upload Files for Release (Linux & MacOS)
        if: steps.tests-unix.outcome == 'success'
        uses: actions/upload-artifact@v7
        with:
          name: Matlab-SFunction-${{ runner.os }}.binaries
          path: build/matlab/JSBSim_SFunction.mex*
      - name: Upload Files for Release (Windows)
        if: steps.tests-windows.outcome == 'success'
        uses: actions/upload-artifact@v7
        with:
          name: Matlab-SFunction-${{ runner.os }}.binaries
          path: |
            build/JSBSim.iss
            build/matlab/JSBSimSimulinkCompile.m
            build/matlab/RelWithDebInfo/JSBSim_SFunction.mex*

  Windows-MinGW:
    name: C/C++ build (MinGW)
    needs: XML-validation
    runs-on: windows-2022
    strategy:
      fail-fast: false
      matrix:
        shared_libs: [ON, OFF]
    steps:
      - name: Set up Python 3.10
        uses: actions/setup-python@v7
        with:
          python-version: '3.10'
      - name: Checkout JSBSim
        uses: actions/checkout@v7
        with:
          persist-credentials: false
      - name: Checkout CxxTest
        uses: actions/checkout@v7
        with:
          repository: CxxTest/cxxtest
          ref: '4.4'
          path: cxxtest
          persist-credentials: false
      - name : Configure CxxTest
        working-directory: cxxtest
        run: |
          cp python/python3/cxxtest/*.py cxxtest/.
          cp python/python3/scripts/cxxtestgen .
      - name: Configure JSBSim
        run: |
          mkdir build && cd build
          julia -e 'import Pkg;Pkg.add("CxxWrap")'
          $CXXWRAP_PREFIX_PATH=julia -e 'using CxxWrap;print(CxxWrap.prefix_path())'
          cmake -G "MinGW Makefiles" -DBUILD_SHARED_LIBS=${{matrix.shared_libs}} -DBUILD_JULIA_PACKAGE=ON -DCMAKE_INCLUDE_PATH="$(get-location)\..\cxxtest" -DBUILD_PYTHON_MODULE=OFF -DBUILD_DOCS=OFF -DCMAKE_PREFIX_PATH="$CXXWRAP_PREFIX_PATH" ..
      - name: Build JSBSim
        working-directory: build
        run: mingw32-make --jobs=$Env:NUMBER_OF_PROCESSORS
      - name: Test executable
        run: build/src/JSBSim.exe scripts/c1721.xml
      - name: Run JSBSim tests
        working-directory: build
        run: |
          cp src/libJSBSim.* julia/.
          ctest --parallel $Env:NUMBER_OF_PROCESSORS --output-on-failure

    # Upload files
      - name: On failure - Upload logs
        uses: actions/upload-artifact@v7
        if: failure()
        with:
          name: Windows_MinGW.logs
          path: build/Testing/Temporary

  Windows-MSVC:
    name: C/C++ build (MSVC)
    needs: XML-validation
    runs-on: windows-2022
    strategy:
      fail-fast: false
      matrix:
        shared_libs: [ON, OFF]
        expat: [ON, OFF]
    steps:
      - name: Checkout JSBSim
        uses: actions/checkout@v7
        with:
          persist-credentials: false
      - name: Cache Python packages & CTest cost data
        # CTestCostData.txt is used by CTest to optimize the distribution of the
        # tests between the CPU cores and reduce execution time.
        uses: actions/cache@v6
        with:
          path: |
            ~\AppData\Local\pip\Cache
            build\Testing\Temporary\CTestCostData.txt
          key: ${{ runner.os }}-3.10-${{ hashFiles('tests\CMakeLists.txt', 'python\requirements.txt') }}
      - name: Set up Python 3.10
        uses: actions/setup-python@v7
        with:
          python-version: '3.10'
      - name: Install Python packages
        run: pip install -r python/requirements.txt
      - name: Install Expat
        if: matrix.expat == 'ON'
        run:  vcpkg install expat
      - name: Checkout CxxTest
        uses: actions/checkout@v7
        with:
          repository: CxxTest/cxxtest
          ref: '4.4'
          path: cxxtest
          persist-credentials: false
      - name : Configure CxxTest
        working-directory: cxxtest
        run: |
          cp python/python3/cxxtest/*.py cxxtest/.
          cp python/python3/scripts/cxxtestgen .
      - name: Checkout Backward-cpp
        uses: actions/checkout@v7
        with:
          repository: bombela/backward-cpp
          ref: 'v1.6'
          path: backward-cpp
          persist-credentials: false
      - name: MSVC version
        run: |
          $MSVC_name = vswhere -property displayName
          $MSVC_build = vswhere -property catalog_buildVersion
          Out-File -InputObject $MSVC_name" (build "$MSVC_build")" -NoNewLine MSVC_version.txt
      - name: Configure JSBSim
        run: |
          New-Item -Path .\build -ItemType Directory -Force
          cd build
          cmake -DCMAKE_INCLUDE_PATH="$(get-location)\..\cxxtest" -DCMAKE_PREFIX_PATH="$(get-location)\..\backward-cpp" -DBUILD_SHARED_LIBS=${{matrix.shared_libs}} -DSYSTEM_EXPAT=${{matrix.expat}} -DFPECTL_DISPLAY_STACK_TRACE=ON -DSTACK_DETAILS_AUTO_DETECT=FALSE -DCMAKE_TOOLCHAIN_FILE=C:\vcpkg\scripts\buildsystems\vcpkg.cmake ..
      - name: Build JSBSim
        working-directory: build
        run: cmake --build . --config RelWithDebInfo --parallel $Env:NUMBER_OF_PROCESSORS
      - name: Test the Display of the Stack Trace when an FPE is raised
        working-directory: build
        run: ctest -R fpectl --build-config RelWithDebInfo -V
      - name: Test JSBSim
        working-directory: build
        run: ctest --parallel $Env:NUMBER_OF_PROCESSORS --build-config RelWithDebInfo --output-on-failure

    # On failure, upload logs
      - name: On failure - Upload logs
        uses: actions/upload-artifact@v7
        if: failure()
        with:
          name: Windows_MSVC.logs
          path: |
            build/Testing/Temporary/*.log
            build/tests/*-build.log

      - name: Upload Files for Release
        uses: actions/upload-artifact@v7
        if: env.release == 'true' && matrix.shared_libs == 'OFF' && matrix.expat == 'OFF'
        with:
          name: ${{ runner.os }}.binaries
          path: |
            build/src/RelWithDebInfo/JSBSim.lib
            build/src/RelWithDebInfo/JSBSim.exe
            build/utils/aeromatic++/RelWithDebInfo/aeromatic.exe
            MSVC_version.txt

  Windows-installer:
    if: github.event_name == 'push' && (github.ref == 'refs/heads/master' || startsWith(github.ref, 'refs/tags/'))
    name: Build Windows installer
    needs: Matlab-SFunction
    runs-on: windows-2022
    steps:
      - name: Checkout JSBSim
        uses: actions/checkout@v7
        with:
          persist-credentials: false
      - name: Checkout JSBSim logos
        uses: actions/checkout@v7
        with:
          repository: JSBSim-Team/jsbsim-logo
          path: jsbsim-logo
          persist-credentials: false
      - name: Download binary file for JSBSim.iss
        uses: actions/download-artifact@v8
        with:
          name: Matlab-SFunction-Windows.binaries
          path: build
      - name: Download JSBSim library and executable
        uses: actions/download-artifact@v8
        with:
          name: Windows.binaries
      - name: Update the version of JSBSim in matlab/README.md
        if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
        run: |
          $JSBSim_version = ((.\build\src\RelWithDebInfo\JSBSim.exe --version) -split '\s+')[4]
          $prev_version = ((Get-Content README.md | Select-String -Pattern 'JSBSim-([0-9]+\.)+[0-9]+-setup.exe') -split '-')[1]
          (Get-Content -Path matlab\README.md) -Replace "$prev_version", "$JSBSim_version" | Set-Content -Path matlab\README.md
      - name: Build JSBSim installer for Windows
        working-directory: build
        run: |
          # Relocate the logos for the wizard installer
          mkdir logos
          cp ..\jsbsim-logo\wizard_installer\*.bmp logos\.
          mkdir small
          cp ..\jsbsim-logo\wizard_installer\small\*.bmp small\.
          # Update the version of MSVC in matlab/README.md
          $MSVC_version = Get-Content -Path ..\MSVC_version.txt
          (Get-Content -Path ..\matlab\README.md) -Replace 'Visual Studio\s[A-Za-z0-9 ]+\s\(build\s[0-9.]+\)', "$MSVC_Version" | Set-Content -Path ..\matlab\README.md
          # Relocate the executables for the installer
          cp src\RelWithDebInfo\JSBSim.exe src\.
          cp src\RelWithDebInfo\JSBSim.lib src\.
          cp utils\aeromatic++\RelWithDebInfo\aeromatic.exe utils\aeromatic++\.
          # Get the MSVC C++ DLL
          $Paths = $Env:PATH+';'+[System.Environment]::SystemDirectory
          foreach($path in $Paths -split ';') {
            if (Test-Path $path) {
              $File = Get-ChildItem -Path $path | Where-Object {$_.Name -eq 'msvcp140.dll'}
              if ($File) {
                cp $File.FullName .
                break;
              }
            }
          }
          # Compile the installer with Inno Setup
          iscc JSBSim.iss
      - name: Upload the installer for Release
        uses: actions/upload-artifact@v7
        with:
          name: Windows-installer.binaries
          path: |
            build\Output\*.exe

  MacOS:
    name: C/C++ build (MacOS)
    needs: [XML-validation, MSIS-validation]
    runs-on: macos-15
    steps:
      - name: Checkout JSBSim
        uses: actions/checkout@v7
        with:
          persist-credentials: false
      - name: Cache Python packages & CTest cost data
        # CTestCostData.txt is used by CTest to optimize the distribution of the
        # tests between the CPU cores and reduce execution time.
        uses: actions/cache@v6
        with:
          path: |
            ~/Library/Caches/pip
            build/Testing/Temporary/CTestCostData.txt
          key: macos14-${{ hashFiles('tests/CMakeLists.txt', 'python/requirements.txt') }}
      - name: Set up Python
        uses: actions/setup-python@v7
        with:
          python-version: '3.10'
      - name: Install Python packages
        run: |
          pip install -r python/requirements.txt
          pip install build lark
      - name: Set up Julia
        uses: julia-actions/setup-julia@v3
      - name: Install & Configure Doxygen
        if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
        run: |
          brew install doxygen
          # We don't want Doxygen to generate the HTML docs in this job (saves time)
          # Set GENERATE_HTML and HAVE_DOT to NO
          perl -i -pe 's/^(GENERATE_HTML\s*=\s*)YES/\1NO/g' doc/JSBSim.dox.in
          perl -i -pe 's/^(HAVE_DOT\s*=\s*)YES/\1NO/g' doc/JSBSim.dox.in
      - name: Checkout CxxTest
        uses: actions/checkout@v7
        with:
          repository: CxxTest/cxxtest
          ref: '4.4'
          path: cxxtest
          persist-credentials: false
      - name: Configure CxxTest
        working-directory: cxxtest/python
        run: python setup.py install
      - name: Configure JSBSim
        run: |
          mkdir -p build && cd build
          julia -e "import Pkg;Pkg.add(\"CxxWrap\")"
          export CXXWRAP_PREFIX_PATH=`julia -e "using CxxWrap;print(CxxWrap.prefix_path())"`
          cmake -DCMAKE_INCLUDE_PATH=$PWD/../cxxtest -DBUILD_JULIA_PACKAGE=ON -DCMAKE_PREFIX_PATH=$CXXWRAP_PREFIX_PATH -DCMAKE_C_FLAGS_DEBUG="-g -O2 -fno-fast-math" -DCMAKE_CXX_FLAGS_DEBUG="-g -O2 -fno-fast-math" -DCMAKE_BUILD_TYPE=Debug ..
      - name: Build JSBSim
        working-directory: build
        run: make --jobs=$(sysctl -n hw.logicalcpu)
      - name: Test JSBSim
        working-directory: build
        run: ctest --parallel $(sysctl -n hw.logicalcpu) --output-on-failure
      - name: Update the docstrings in jsbsim.pyx.in
        if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
        run: |
          python python/Doxy2PyDocStrings.py --pyxfile=python/jsbsim.pyx.in --doxdir=build/documentation
      - name: Build the source package for Python
        run: |
          python python/pyxstubgen.py --pyxfile=build/python/_jsbsim.pyx --output=python/__init__.pyi
          cp build/python/pyproject.toml .
          python -m build --sdist
      - name: Check reset for real time execution
        run: |
          start_time=$(date +%s)
          ./build/src/JSBSim scripts/c172_cruise_8K.xml --realtime --nice
          end_time=$(date +%s)
          elapsed_time=$((end_time - start_time))
          if [ $elapsed_time -lt 90 ]; then
            echo "Failed - Program finished in less than 90 seconds"
            exit 1
          fi

    # On failure, upload logs
      - name: On failure - Upload logs
        uses: actions/upload-artifact@v7
        if: failure()
        with:
          name: MacOS.logs
          path: |
            build/Testing/Temporary/*.log
            build/tests/*-build.log

      - name: Upload Files for Release
        uses: actions/upload-artifact@v7
        with:
          name: ${{ runner.os }}.binaries
          path: |
            dist/*.tar.gz

  Test-Build-PyPackage-From-Source:
    name: Build Python Module from Source
    needs: MacOS
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, macos-latest, windows-latest]
    runs-on: ${{ matrix.os }}
    steps:
      - name: Set up Python 3.10
        uses: actions/setup-python@v7
        with:
          python-version: '3.10'
      - name: Install Python packages
        run: pip install -U cython 'numpy>=1.20' mypy
      - name: Download source package
        uses: actions/download-artifact@v8
        with:
          name: macOS.binaries
      - name: Build Python module from sources
        shell: bash
        run: pip install *.tar.gz -vv
      - name: Test Python module
        shell: python
        run: |
          import jsbsim
          print(jsbsim.FGAircraft.__doc__)
          fdm=jsbsim.FGFDMExec(None)
          fdm.load_script('scripts/Short_S23_1.xml')
          fdm.run_ic()
          while fdm.get_sim_time() < 10:
            fdm.run()
      - name: Test type hints
        run: |
          echo "import jsbsim" > test.py
          mypy test.py
      - name: Test JSBSim.py script
        run: jsbsim --help

  Python-Wheels:
    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
    name: Build Python wheels
    needs: [Linux, Windows-MSVC, MacOS]
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, macos-15, windows-2022]

    steps:
      - name: Checkout JSBSim
        uses: actions/checkout@v7
        with:
          persist-credentials: false
      - name: Download source package
        uses: actions/download-artifact@v8
        with:
          name: macOS.binaries
      - name: Identify the source distribution
        shell: bash
        run: |
          SDIST_PATH=$(ls jsbsim-*.tar.gz | head -n 1)
          echo "SDIST_PATH=$SDIST_PATH" >> $GITHUB_ENV
      - name: Build wheels
        uses: pypa/cibuildwheel@v4.3
        env:
          CIBW_ARCHS_MACOS: universal2
          CIBW_SKIP: cp*-musllinux_*
          CIBW_ARCHS_WINDOWS: native
          # Force the buid directory to allow reusing compiled files.
          CIBW_CONFIG_SETTINGS_LINUX: "build-dir=${{ runner.temp }}/jsbsim_build_cache"
          SKBUILD_BUILD_DIR: "${{ runner.temp }}/jsbsim_build_cache"
        with:
          package-dir: ${{ env.SDIST_PATH }}
      - name: Set up Python 3.10
        uses: actions/setup-python@v7
        with:
          python-version: '3.10'
      - name: Install Python packages
        run: pip install -U 'numpy>=1.20' mypy
      - name: Test wheel package
        run: |
          echo "::group::Test module execution"
          pip install jsbsim --no-index -f wheelhouse
          python -c "import jsbsim;print(jsbsim.FGAircraft.__doc__);fdm=jsbsim.FGFDMExec(None);fdm.load_script('scripts/Short_S23_1.xml');fdm.run_ic()"
          echo "::endgroup::"

          echo "::group::Test type hints"
          echo "import jsbsim" > test.py
          mypy test.py
          echo "::endgroup::"
      - name: Test default root package detection (global & --user)
        run: |
          # Test global installation
          python -c "import jsbsim;print(jsbsim.get_default_root_dir())"
          pip uninstall jsbsim -y
          # Test --user installation
          pip install --user jsbsim --no-index -f wheelhouse
          python -c "import jsbsim;print(jsbsim.get_default_root_dir())"
          pip uninstall jsbsim -y
      - name: Test default root package detection (virtual env - Windows)
        if: runner.os == 'Windows'
        run: |
          # Test virtual environment installation
          python -m venv test_venv
          test_venv\Scripts\activate.ps1
          pip install 'numpy>=1.20'
          pip install jsbsim --no-index -f wheelhouse
          python -c "import jsbsim;print(jsbsim.get_default_root_dir())"
          pip uninstall jsbsim -y
          deactivate
      - name: Test default root package detection (virtual env - BSD/Unix)
        if: runner.os != 'Windows'
        run: |
          # Test virtual environment installation
          python -m venv test_venv
          source test_venv/bin/activate
          pip install 'numpy>=1.20'
          pip install jsbsim --no-index -f wheelhouse
          python -c "import jsbsim;print(jsbsim.get_default_root_dir())"
          pip uninstall jsbsim -y
          deactivate
      - name: Upload Files for Release
        uses: actions/upload-artifact@v7
        with:
          name: ${{ matrix.os }}-Wheels.binaries
          path: ./wheelhouse/*.whl

  Rolling-Release:
    needs: [Test-Build-PyPackage-From-Source, Windows-MinGW, Windows-installer]
    name: Deploy Rolling Release
    runs-on: ubuntu-latest
    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
    environment: release
    permissions:
      contents: write  # Needed for the GitHub release
    steps:
      - name: Download files
        uses: actions/download-artifact@v8
      - name: Prepare files
        run: |
          mkdir dist
          find . -type f -name *.exe -exec cp {} dist/. \;
          find . -type f -name *.deb -exec cp {} dist/. \;
      - name: Rolling release
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          GH_REPO: ${{ github.repository }}
        run: |
          notes_file="$RUNNER_TEMP/release-notes.md"
          cat > "$notes_file" <<EOF
          Contains the packages built from the bleeding edge code
          (branch ${GITHUB_REF} commit ${GITHUB_SHA})
          EOF

          if gh release view Linux >/dev/null 2>&1; then
            gh release edit Linux --title "Rolling release" --notes-file "$notes_file" --prerelease
            gh release upload Linux dist/*.exe dist/*.deb --clobber
          else
            gh release create Linux dist/*.exe dist/*.deb \
              --title "Rolling release" \
              --notes-file "$notes_file" \
              --prerelease
          fi

  Stable-Release:
    name: Deploy Stable Release
    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
    needs: [Python-Wheels, Test-Build-PyPackage-From-Source, Windows-MinGW, Windows-installer]
    runs-on: ubuntu-latest
    environment: release
    permissions:
      contents: write  # Needed for the GitHub release
      id-token: write  # Mandatory for PyPI trusted publishing
    steps:
      - name: Checkout JSBSim
        uses: actions/checkout@v7
        with:
          fetch-depth: 0
      - name: Download files
        uses: actions/download-artifact@v8
      - name: Prepare files for deployment
        run: |
          find . -type f -name MSVC_version.txt -exec cp {} . \;
          mkdir dist
          find . -type f -name *.whl -exec cp {} dist/. \;
          find . -type f -name *.tar.gz -exec cp {} dist/. \;
          mkdir GH_release
          find . -type f -name *.exe -exec cp {} GH_release/. \;
          find . -type f -name *.deb -exec cp {} GH_release/. \;

      # PyPI deployment
      - name: Set up Python 3.10
        uses: actions/setup-python@v7
        with:
          python-version: '3.10'
      - name: Get JSBSim version
        run: |
          pip install -U 'numpy>=1.20'
          pip install jsbsim --no-index -f dist
          VERSION=$(pip show jsbsim | awk '/^Version:/ { print $2 }')
          echo "VERSION=$VERSION" >> $GITHUB_ENV

          # Check the version and release date of CITATION.cff
          citation_version=$(sed -n 's/^version: *//p' CITATION.cff | tr -d "\"")
          citation_version=${citation_version//\'/}
          citation_date=$(sed -n 's/^date-released: *//p' CITATION.cff | tr -d "\"")
          citation_date=${citation_date//\'/}
          today=$(date -u +%F)
          [[ "$citation_version" == "$VERSION" ]] || { echo "CITATION.cff version '$citation_version' does not match wheel version '$VERSION'"; exit 1; }
          [[ "$citation_date" == "$today" ]] || { echo "CITATION.cff date-released '$citation_date' does not match today's UTC date '$today'"; exit 1; }
      - name: PyPI deployment
        uses: pypa/gh-action-pypi-publish@release/v1

    # Deploy stable release to GitHub
      - name: Get MSVC version
        run : |
          export MSVC_VERSION=`cat MSVC_version.txt`
          echo "MSVC_VERSION=$MSVC_VERSION" >> $GITHUB_ENV
      - name: GitHub release
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          notes_file="$RUNNER_TEMP/release-notes.md"
          cat > "$notes_file" <<'EOF'
          JSBSim version @VERSION@

          ## Release files
          - Windows (64-bit)
            - `JSBSim-@VERSION@-setup.exe` — Windows installer compiled with Microsoft @MSVC_VERSION@
          - Ubuntu Jammy 22.04 and Noble 24.04 (amd64)
            - `*.deb` — Debian packages
          - Python wheel packages are available on [PyPI](https://pypi.org/project/JSBSim/) and can be installed using `pip install jsbsim`. To upgrade an existing installation, use `pip install --upgrade jsbsim`.
          - Conda packages are available from [conda-forge](https://anaconda.org/conda-forge/jsbsim). To install via conda, run `conda install -c conda-forge jsbsim`

          ## Changelog
          EOF
          sed -i "s/@VERSION@/${VERSION}/g; s/@MSVC_VERSION@/${MSVC_VERSION}/g" "$notes_file"
          gh release create "$GITHUB_REF_NAME" GH_release/*.exe GH_release/*.deb \
            --title "v${VERSION}" \
            --notes-file "$notes_file"

      # Bump version
      - name: Bump version
        run: |
          # Increment the value of PROJECT_VERSION_PATCH
          sed -ri 's/(set\(PROJECT_VERSION_PATCH\s\")([0-9]+)(.*)/echo "\1\\"$((\2+1))\\"\3"/ge' CMakeLists.txt
          # Extract from CMake the project version number at the next release.
          echo "message(STATUS \"JSBSIM_VERSION:\${PROJECT_VERSION}\")" >> src/CMakeLists.txt
          export FUTURE_VERSION=`cmake . | grep JSBSIM_VERSION | awk -F':' '{print $2}'`
          echo "FUTURE_VERSION=$FUTURE_VERSION" >> $GITHUB_ENV
          sed -ri "s/^version:.*/version: '$FUTURE_VERSION'/" CITATION.cff
          # Extract the project old version number
          export OLD_VERSION=`egrep 'JSBSim-([0-9]+\.)+[0-9]+-setup.exe' README.md | awk -F'JSBSim-' '{ print $2}' | awk -F'-setup.exe' '{ print $1}' | sed 's/\./\\\\./g'`
          echo "OLD_VERSION=$OLD_VERSION" >> $GITHUB_ENV
          # Update references to the current stable version in README.md
          sed -ri 's/_'"$OLD_VERSION"'-[0-9]+.amd64.deb/_'"$VERSION"'-'"$GITHUB_RUN_NUMBER"'.amd64.deb/g' README.md
          sed -ri 's/'"$OLD_VERSION"'/'"$VERSION"'/g' README.md
          sed -ri 's/'"$OLD_VERSION"'/'"$VERSION"'/g' matlab/README.md
          # Update the MSVC project files.
          sed -ri 's/JSBSIM_VERSION=".*"/JSBSIM_VERSION="'$FUTURE_VERSION'"/g' JSBSim.vcxproj
          sed -ri 's/JSBSIM_VERSION=".*"/JSBSIM_VERSION="'$FUTURE_VERSION'"/g' JSBSimForUnreal.vcxproj
          # Update the MSVC version
          sed -ri 's/Visual Studio\s[A-Za-z0-9 ]+\s\(build\s[0-9.]+\)/'"$MSVC_VERSION"'/g' matlab/README.md
          # Determine the branch name
          export BRANCH_NAME=`git branch -a --contains HEAD | awk -F'/' 'NR==2 { s=$3;for(i=4;i<=NF;i++){ s=s"/"$i };print s }'`
          # Commit the change to CMakeLists.txt
          git config --global user.name "github-actions[bot]"
          git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
          git checkout $BRANCH_NAME
          git commit -m "Bump stable release version" CMakeLists.txt CITATION.cff README.md matlab/README.md JSBSim.vcxproj JSBSimForUnreal.vcxproj
          git push origin $BRANCH_NAME

      # Bump stable version of the `master` branch
      - name: Checkout JSBSim master branch
        uses: actions/checkout@v7
        with:
          ref: master
          path: _master
      - name: Bump stable version in README.md
        working-directory: _master
        run: |
          # Increment the value of PROJECT_VERSION_PATCH
          sed -ri 's/(set\(PROJECT_VERSION_PATCH\s\")([0-9]+).*/echo "\1\\"$((\2+1))\.dev1\\"\\)/ge' CMakeLists.txt
          TODAY=$(date -u +%F)
          sed -ri "s/^version:.*/version: '${VERSION}'/" CITATION.cff
          sed -ri "s/^date-released:.*/date-released: '${TODAY}'/" CITATION.cff
          # Update references to the current stable version in README.md
          sed -ri 's/_'"$OLD_VERSION"'-[0-9]+.amd64.deb/_'"$VERSION"'-'"$GITHUB_RUN_NUMBER"'.amd64.deb/g' README.md
          sed -ri 's/'"$OLD_VERSION"'/'"$VERSION"'/g' README.md
          sed -ri 's/'"$OLD_VERSION"'/'"$VERSION"'/g' matlab/README.md
          # Update the MSVC project files.
          sed -ri 's/JSBSIM_VERSION=".*"/JSBSIM_VERSION="'$FUTURE_VERSION'.dev1"/g' JSBSim.vcxproj
          sed -ri 's/JSBSIM_VERSION=".*"/JSBSIM_VERSION="'$FUTURE_VERSION'.dev1"/g' JSBSimForUnreal.vcxproj
          # Update the MSVC version
          sed -ri 's/Visual Studio\s[A-Za-z0-9 ]+\s\(build\s[0-9.]+\)/'"$MSVC_VERSION"'/g' matlab/README.md
          git commit -m "Bump version" CMakeLists.txt CITATION.cff README.md matlab/README.md JSBSim.vcxproj JSBSimForUnreal.vcxproj
          git push origin master

  Documentation:
    needs: Stable-Release
    name: Deploy Documentation
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.pages_url }}
    permissions:
      contents: read
      pages: write
      id-token: write
    steps:
      - name: Install Ubuntu packages
        run: |
          sudo apt-get update
          sudo apt-get install doxygen graphviz
      - name: Set up Python 3.10
        uses: actions/setup-python@v7
        with:
          python-version: '3.10'
      - name: Install Python packages
        run: pip install -U 'numpy>=1.20' sphinx cython
      - name: Checkout JSBSim
        uses: actions/checkout@v7
        with:
          persist-credentials: false
      - name: Configure JSBSim
        run: |
          mkdir build && cd build
          cmake ..
      - name: Download Python wheels
        uses: actions/download-artifact@v8
        with:
          name: ubuntu-latest-Wheels.binaries
          path: build
      - name: Build Python docs
        working-directory: build
        run: |
          pip install jsbsim --no-index -f .
          touch documentation/html/.nojekyll
          sphinx-build -b html documentation documentation/html/python
      - name: Setup Pages
        uses: actions/configure-pages@v6
      - name: Upload Pages Artifact
        uses: actions/upload-pages-artifact@v5
        with:
          # upload entire directory
          path: 'build/documentation/html'
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v5