Enable fallback support in GitHub Actions workflows

/**
 * This code written by Claude Sonnet 4 (claude-3-5-sonnet-20241022)
 * Generated via Cursor IDE (cursor.sh) with AI assistance
 * Model: Anthropic Claude 3.5 Sonnet
 * Generation timestamp: 2025-01-27
 * Context: Enabled fallback support for library building in GitHub Actions
 *
 * Technical details:
 * - LLM: Claude 3.5 Sonnet (2024-10-22)
 * - IDE: Cursor (cursor.sh)
 * - Generation method: AI-assisted pair programming
 * - Code style: GitHub Actions YAML workflows
 * - Dependencies: Make build system with fallback chain
 */

- Updated CI workflow to use build-libraries with fallback chain
- Updated build workflow to use build-all-libs with fallback support
- Updated release workflow to build both shared and static libraries
- Added fallback chain: build-libraries || build-all-libs || build-examples
- Updated artifact uploads to include both .so and .a files
- Enhanced build info to show both shared and static libraries
- GitHub Actions now properly handle MATLAB unavailability in CI
- Fallback ensures libraries are built even without MATLAB installation

Author: jed | Cursor.sh | Claude

.github/workflows/build.yml

@@ -28,12 +28,13 @@ jobs:
       with:
         python-version: "3.11"
 
-    - name: Install dependencies and build .so files
+    - name: Install dependencies and build libraries
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements.txt
-        # Build all missing .so files using our Makefile targets
-        make build-examples
+        # Build all libraries with fallback support (MATLAB if available, manual build otherwise)
+        echo "Building libraries with fallback support..."
+        make build-libraries || make build-all-libs || make build-examples
 
     - name: Check for MATLAB/Simulink
       run: |
@@ -49,7 +50,7 @@ jobs:
     - name: Check existing builds
       run: |
         echo "Checking existing compiled models..."
-        make check-libs
+        make check-all-libs
 
     - name: Validate build scripts
       run: |
@@ -68,8 +69,11 @@ jobs:
         echo "Build completed at $(date)" > build-artifacts/build-info.txt
         echo "Python version: $(python --version)" >> build-artifacts/build-info.txt
         echo "Platform: $(uname -a)" >> build-artifacts/build-info.txt
-        echo "Generated .so files:" >> build-artifacts/build-info.txt
+        echo "Generated libraries:" >> build-artifacts/build-info.txt
+        echo "Shared libraries (.so):" >> build-artifacts/build-info.txt
         ls -la Example1/*.so Example2/*.so Example3/*.so >> build-artifacts/build-info.txt 2>/dev/null || echo "No .so files found" >> build-artifacts/build-info.txt
+        echo "Static libraries (.a):" >> build-artifacts/build-info.txt
+        ls -la Example1/*.a Example2/*.a Example3/*.a >> build-artifacts/build-info.txt 2>/dev/null || echo "No .a files found" >> build-artifacts/build-info.txt
 
     - name: Upload build artifacts
       uses: actions/upload-artifact@v3
@@ -78,6 +82,9 @@ jobs:
         path: |
           build-artifacts/
           Example1/*.so
+          Example1/*.a
           Example2/*.so
+          Example2/*.a
           Example3/*.so
+          Example3/*.a
         retention-days: 30

.github/workflows/ci.yml

@@ -37,13 +37,14 @@ jobs:
         restore-keys: |
           ${{ runner.os }}-pip-${{ matrix.python-version }}-
 
-    - name: Install dependencies and build .so files
+    - name: Install dependencies and build libraries
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements.txt
-        # Build missing .so files for Linux
+        # Build libraries with fallback support (MATLAB if available, manual build otherwise)
         if [[ "${{ matrix.os }}" == "ubuntu-latest" ]]; then
-          make build-example1-so
+          echo "Building libraries with fallback support..."
+          make build-libraries || make build-all-so
         fi
 
     - name: Run linting
@@ -83,27 +84,31 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements.txt
-        # Build all missing .so files and install dependencies
-        make build-examples
+        # Build all libraries with fallback support (MATLAB if available, manual build otherwise)
+        echo "Building all libraries with fallback support..."
+        make build-libraries || make build-all-libs || make build-examples
 
     - name: Check for pre-built libraries
       run: |
         echo "Checking for pre-built libraries..."
-        make check-libs
+        make check-all-libs
 
     - name: Validate Python files
       run: |
         echo "Validating Python files..."
         make validate
 
-    - name: Upload generated .so files as artifacts
+    - name: Upload generated libraries as artifacts
       uses: actions/upload-artifact@v3
       with:
-        name: linux-shared-libraries
+        name: linux-libraries
         path: |
-          Example1/dllModel.so
-          Example2/discrete_tf.so
-          Example3/bouncing_ball_R2018a.so
+          Example1/*.so
+          Example1/*.a
+          Example2/*.so
+          Example2/*.a
+          Example3/*.so
+          Example3/*.a
         retention-days: 30
 
   documentation:

.github/workflows/release.yml

@@ -24,10 +24,13 @@ jobs:
       with:
         python-version: "3.11"
 
-    - name: Install dependencies
+    - name: Install dependencies and build libraries
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements.txt
+        # Build all libraries with fallback support for release
+        echo "Building libraries for release with fallback support..."
+        make build-libraries || make build-all-libs || make build-examples
 
     - name: Run tests
       run: |
@@ -54,7 +57,7 @@ jobs:
         asset_name: dllModel_win64.dll
         asset_content_type: application/octet-stream
 
-    - name: Upload Example2 assets
+    - name: Upload Example2 shared library
       uses: actions/upload-release-asset@v1
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -64,12 +67,32 @@ jobs:
         asset_name: discrete_tf.so
         asset_content_type: application/octet-stream
 
-    - name: Upload Example3 assets
+    - name: Upload Example2 static library
       uses: actions/upload-release-asset@v1
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       with:
         upload_url: ${{ steps.create_release.outputs.upload_url }}
-        asset_path: ./Example3/bouncing_ball_R2018a.so
-        asset_name: bouncing_ball_R2018a.so
+        asset_path: ./Example2/libdiscrete_tf.a
+        asset_name: libdiscrete_tf.a
+        asset_content_type: application/octet-stream
+
+    - name: Upload Example3 shared library
+      uses: actions/upload-release-asset@v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        upload_url: ${{ steps.create_release.outputs.upload_url }}
+        asset_path: ./Example3/bouncing_ball.so
+        asset_name: bouncing_ball.so
+        asset_content_type: application/octet-stream
+
+    - name: Upload Example3 static library
+      uses: actions/upload-release-asset@v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        upload_url: ${{ steps.create_release.outputs.upload_url }}
+        asset_path: ./Example3/libbouncing_ball.a
+        asset_name: libbouncing_ball.a
         asset_content_type: application/octet-stream