merged main

Author: markleader

.github/workflows/basic_build.yml

@@ -346,3 +346,164 @@ jobs:
         with:
           files: release-dist/**
           generate_release_notes: true
+
+  bindc:
+    name: Build (${{ matrix.os }} / ${{ matrix.toolchain.ccompiler }} / ${{matrix.toolchain.fcompiler}})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-22.04, macos-latest, windows-latest]
+        toolchain:
+          - ccompiler: gcc
+            cversion: "11"
+            fcompiler: gcc
+            fversion: "11"
+        include:
+          - os: ubuntu-22.04
+            toolchain:
+              ccompiler: gcc
+              cversion: "13"
+              fcompiler: gcc
+              fversion: "13"
+          - os: ubuntu-22.04
+            toolchain:
+              ccompiler: intel
+              cversion: "2023.1"
+              fcompiler: intel
+              fversion: "2023.1"
+          - os: ubuntu-22.04
+            toolchain:
+              ccompiler: intel-classic
+              cversion: "2021.9"
+              fcompiler: intel-classic
+              fversion: "2021.9"
+          - os: windows-latest
+            toolchain: 
+              ccompiler: msvc
+              cversion: latest
+              fcompiler: intel
+              fversion: "2025.2"
+          - os: windows-latest
+            toolchain:
+              ccompiler: intel
+              cversion: "2025.2"
+              fcompiler: intel
+              fversion: "2025.2"
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - name: Check out CEA
+        uses: actions/checkout@v6
+
+      - name: Check out GFE
+        if: ${{ runner.os != 'Windows' }}
+        uses: actions/checkout@v6
+        with:
+          repository: Goddard-Fortran-Ecosystem/GFE
+          path: extern/gfe
+          submodules: true
+
+      - name: Set up Fortran compiler 
+        if: ${{ runner.os != 'Windows' || matrix.toolchain.fcompiler != 'gcc' }}
+        uses: fortran-lang/setup-fortran@v1
+        with:
+          compiler: ${{ matrix.toolchain.fcompiler }}
+          version: ${{ matrix.toolchain.fversion }}
+
+      - name: Set up Fortran compiler (Windows, gfortran)
+        if: ${{ runner.os == 'Windows' && matrix.toolchain.fcompiler == 'gcc' }}
+        run: |
+          # Use pre-installed MinGW on Windows runners to avoid Chocolatey issues
+          # GitHub Actions windows-latest runners include MinGW in C:\ProgramData\chocolatey\lib\mingw\tools\install\mingw64\bin
+          $mingwPath = "C:\ProgramData\chocolatey\lib\mingw\tools\install\mingw64\bin"
+          if (Test-Path $mingwPath) {
+            echo "$mingwPath" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
+            echo "FC=$mingwPath\gfortran.exe" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
+          } else {
+            # Fallback: search for gfortran in common locations
+            $gfortran = Get-Command gfortran -ErrorAction SilentlyContinue
+            if ($gfortran) {
+              echo "FC=$($gfortran.Source)" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
+            } else {
+              Write-Error "gfortran not found on Windows runner"
+              exit 1
+            }
+          }
+        shell: pwsh
+
+      - name: Set up C Compiler
+        if: ${{matrix.toolchain.ccompiler == 'msvc'}}
+        uses: ilammy/msvc-dev-cmd@v1
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install ninja setuptools numpy cython
+
+      - name: Record toolchain info
+        run: |
+          git --version
+          cmake --version
+          ninja --version
+          if command -v gfortran &> /dev/null; then gfortran --version; fi
+          if [ -n "${FC}" ]; then "${FC}" --version; fi
+
+      - name: Configure and Build GFE
+        if: ${{ runner.os != 'Windows' }}
+        run: |
+          cmake -S extern/gfe -B build/extern/gfe -GNinja \
+            -DCMAKE_INSTALL_PREFIX=build/install \
+            -DCMAKE_BUILD_TYPE=Release \
+            -DSKIP_MPI=YES \
+            -DSKIP_OPENMP=YES \
+            -DSKIP_FHAMCREST=YES \
+            -DSKIP_ESMF=YES \
+            -DSKIP_ROBUST=YES
+          cmake --build build/extern/gfe --target install
+
+      - name: Configure (linux)
+        if: ${{runner.os != 'Windows' || matrix.toolchain.ccompiler != 'msvc'}} 
+        run: |
+          cmake -S . -B build -G Ninja \
+            -DCMAKE_PREFIX_PATH=build/install \
+            -DCMAKE_BUILD_TYPE=Debug \
+            -DCEA_BUILD_TESTING=ON \
+            -DCEA_ENABLE_BIND_C=ON \
+            -DCEA_ENABLE_BIND_CXX=OFF \
+            -DCEA_ENABLE_BIND_PYTHON=OFF \
+            -DCEA_ENABLE_BIND_MATLAB=OFF \
+            -DCEA_ENABLE_BIND_EXCEL=OFF \
+            -DCMAKE_Fortran_FLAGS="-ffree-line-length-none"
+
+      - name: Configure (msvc)
+        if: ${{runner.os == 'Windows' && matrix.toolchain.ccompiler == 'msvc'}}
+        run: |
+          cmake -S . -B build -G Ninja \
+            -DCMAKE_BUILD_TYPE=Release \
+            -DCEA_BUILD_TESTING=ON \
+            -DCEA_ENABLE_BIND_C=ON \
+            -DCEA_ENABLE_BIND_CXX=OFF \
+            -DCEA_ENABLE_BIND_PYTHON=OFF \
+            -DCEA_ENABLE_BIND_MATLAB=OFF \
+            -DCEA_ENABLE_BIND_EXCEL=OFF \
+            -DCMAKE_C_COMPILER=cl \
+            -DCMAKE_WINDOWS_EXPORT_ALL_SYMBOLS=ON
+
+      - name: Build
+        run: |
+          cmake --build build
+
+      - name: Run smoke test (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          ./build/source/cea -h
+
+      - name: Run smoke test (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          ./build/source/cea.exe -h
+      
+      - name: Run ctest
+        run: ctest --test-dir build --output-on-failure

.github/workflows/publish_wheels.yml

@@ -5,6 +5,20 @@ on:
   push:
     tags:
       - "v*"
+  workflow_dispatch:
+    inputs:
+      repository:
+        description: "Package index target"
+        required: true
+        default: testpypi
+        type: choice
+        options:
+          - testpypi
+          - pypi
+
+permissions:
+  contents: read
+  id-token: write
 
 jobs:
   build-wheels:
@@ -81,16 +95,37 @@ jobs:
     name: Publish to PyPI
     needs: build-wheels
     runs-on: ubuntu-22.04
-    if: startsWith(github.ref, 'refs/tags/v')
+    if: startsWith(github.ref, 'refs/tags/v') || github.event_name == 'workflow_dispatch'
+    permissions:
+      contents: read
+      id-token: write
     steps:
       - name: Download artifacts
         uses: actions/download-artifact@v4
         with:
           path: dist
           merge-multiple: true
 
+      - name: Verify OIDC token availability
+        shell: bash
+        run: |
+          if [ -z "${ACTIONS_ID_TOKEN_REQUEST_TOKEN:-}" ] || [ -z "${ACTIONS_ID_TOKEN_REQUEST_URL:-}" ]; then
+            echo "OIDC token env vars are unavailable for this run."
+            echo "ACTIONS_ID_TOKEN_REQUEST_TOKEN set: $([ -n "${ACTIONS_ID_TOKEN_REQUEST_TOKEN:-}" ] && echo yes || echo no)"
+            echo "ACTIONS_ID_TOKEN_REQUEST_URL set: $([ -n "${ACTIONS_ID_TOKEN_REQUEST_URL:-}" ] && echo yes || echo no)"
+            echo "Ensure workflow/job has 'id-token: write' and repository/org policy permits OIDC."
+            exit 1
+          fi
+
       - name: Publish to PyPI
+        if: startsWith(github.ref, 'refs/tags/v') || (github.event_name == 'workflow_dispatch' && github.event.inputs.repository == 'pypi')
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist
+
+      - name: Publish to TestPyPI
+        if: github.event_name == 'workflow_dispatch' && github.event.inputs.repository == 'testpypi'
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
+          repository-url: https://test.pypi.org/legacy/
           packages-dir: dist
-          password: ${{ secrets.PYPI_API_TOKEN }}

.gitignore

@@ -5,6 +5,10 @@ docs/doctrees/
 docs/doxygen/
 docs/html/
 docs/source/_build/
+*.aux
+*.log
+*.toc
+*.out
 extern/gfe
 extern/install
 *.swp
@@ -15,21 +19,22 @@ extern/install
 *.csv
 *.xlsx
 *.pdf
-*.tex
-*.log
-*.aux
-*.toc
 *.bat
 *.lib
+*.dylib
+*.so
+*.dll
+*.pyc
+*.pyo
+*.pyd
+*.egg-info/
 !sampleThe/*.inp
 !test/main_interface/*.inp
 !test/main_interface/reference_output/*.out
 __pycache__/
 *.py[cod]
 *$py.class
-source/bind/excel/*.dylib
-source/bind/excel/*.so
-source/bind/excel/*.dll
 source/bind/excel/~$*.xlsm
 source/bind/excel/*.lib
 source/bind/python/samples
+source/bind/python/cea/samples/*.tex

CHANGELOG.md

@@ -10,7 +10,28 @@ All notable user-visible changes to this project are documented here.
 
 ### Added
 
-## [3.0.1] – Unreleased
+## [3.0.3] - 2026-02-20
+
+### Changed
+- Hardened PyPI publishing CI with OIDC preflight checks and manual `workflow_dispatch` target selection (`testpypi`/`pypi`); installation docs now lead with `python -m pip install cea` and mention GitHub Releases binary assets.
+
+### Fixed
+
+### Added
+
+## [3.0.2] – 2026-02-20
+
+### Added
+- Initial Microsoft Visual C++ (MSVC) support in the C bindings/build pipeline (`#29`).
+
+### Changed
+- `RocketSolver_solve` now treats `pi_p` as optional for better API compatibility and easier caller usage (`#36`).
+
+### Fixed
+- Corrected detonation-wave upstream enthalpy calculations and upstream molecular weight handling in the legacy interface (`#33`).
+- Resolved failing transport-property test cases to restore expected regression behavior (`#37`).
+
+## [3.0.1] – 2026-02-11
 
 ### Added
 - Python bindings and examples/tests for the CEA interface (`Feat/icx python binding`, #23).

CMakeLists.txt

@@ -53,9 +53,9 @@ endif()
 # Testing
 option(CEA_BUILD_TESTING "Build test harness for CEA" ${PROJECT_IS_TOP_LEVEL})
 if(CEA_BUILD_TESTING)
-    find_package(PFUNIT REQUIRED)
-    include(CTest)
+    find_package(PFUNIT)
 endif()
+include(CTest)
 
 set(CMAKE_POSITION_INDEPENDENT_CODE ON)
 

README.md

@@ -31,7 +31,23 @@ the CEA code base to adopt modern software engineering practices and improve
 CEA's ability to interface with other software packages and analysis environments
 via well-defined programming APIs in multiple languages.
 
-## Build and Install
+## Install (Recommended)
+
+For most users, install the published Python package directly:
+
+    python -m pip install cea
+
+This is the fastest path to start using the Python API (`import cea`) without
+building from source.
+
+If you need the legacy CLI executable (`cea`) or C/Fortran build artifacts, use
+the source build path below.
+
+Prebuilt release assets are also available on the GitHub Releases page,
+including platform executables and shared libraries (`.so`, `.dll`, `.lib`,
+`.dll.a`).
+
+## Build and Install from Source
 
 The CEA software package is compiled and installed using CMake v3.19+. The core
 software has no external dependencies, and is known to build successfully on a
@@ -85,10 +101,10 @@ If you are not using presets, set `-DCEA_ENABLE_BIND_PYTHON=OFF` and also disabl
 the MATLAB wrapper (it forces Python on). For Fortran-only, also set
 `-DCEA_ENABLE_BIND_C=OFF`.
 
-### Python Binding
+### Python Binding from a Source Checkout
 
 The new Python binding provides direct access to compiled CEA routines.
-The basic installation process is as follows:
+If you are developing locally or want to build from a checkout, use:
 
     cd <cea_source_dir>
     pip install .

docs/source/installation.rst

@@ -2,6 +2,26 @@ Install
 *******
 CEA can be installed on Windows, MacOS, and Linux systems.
 
+Recommended: Install from PyPI
+------------------------------
+
+For most users, the recommended installation path is the published Python
+package:
+
+::
+
+    python -m pip install cea
+
+This installs the Python API (``import cea``) without requiring a local source
+build.
+
+If you need the command-line executable (``cea``), C/Fortran artifacts, or
+custom compiler/toolchain control, follow the source build instructions below.
+
+Prebuilt release assets are also available on the GitHub Releases page,
+including platform executables and shared libraries (``.so``, ``.dll``,
+``.lib``, ``.dll.a``).
+
 Prerequisites
 -------------
 
@@ -19,8 +39,8 @@ Clone the repository::
     git clone https://github.com/nasa/cea
     cd cea
 
-Build and Install
------------------
+Build and Install from Source
+-----------------------------
 
 The CEA software package is compiled and installed using CMake. The basic
 installation process is as follows: