ceedling 1.0.0 release candidate

.github/workflows/main.yml

@@ -1,9 +1,15 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-24 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
 ---
-# Continuous Integration Workflow: Test case suite run + validation build check
+# Continuous Integration Workflow
 name: CI
 
-# Controls when the action will run.
-# Triggers the workflow on push or pull request events but only for the master branch
+# Triggers the workflow on push or pull request events for master & test branches
 on:
   push:
     branches:
@@ -13,69 +19,269 @@ on:
     branches: [ master ]
   workflow_dispatch:
 
+
+# Needed by softprops/action-gh-release
+permissions:
+  # Allow built gem file push to Github release
+  contents: write
+
+
 jobs:
-  # Job: Unit test suite
-  unit-tests:
-    name: "Unit Tests"
+  # Job: Linux unit test suite
+  unit-tests-linux:
+    name: "Linux Test Suite"
     runs-on: ubuntu-latest
     strategy:
+      fail-fast: false
       matrix:
-        ruby: ['2.7', '3.0', '3.1']
+        ruby: ['3.0', '3.1', '3.2']
     steps:
-      # Install Binutils, Multilib, etc
-      - name: Install C dev Tools
+      # Use a cache for our tools to speed up testing
+      - uses: actions/cache@v4
+        with:
+          path: vendor/bundle
+          key: bundle-use-ruby-${{ matrix.os }}-${{ matrix.ruby-version }}-${{ hashFiles('**/Gemfile.lock') }}
+          restore-keys: |
+            bundle-use-ruby-${{ matrix.os }}-${{ matrix.ruby-version }}-
+
+      # Checks out repository under $GITHUB_WORKSPACE
+      - name: Checkout Latest Repo
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      # Setup Ruby Testing Tools to do tests on multiple ruby version
+      - name: Setup Ruby Testing Tools
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+
+      # Install Ruby Testing Tools (Bundler version should match the one in Gemfile.lock)
+      - name: Install Ruby Testing Tools
+        run: |
+          gem install rspec
+          gem install rubocop -v 0.57.2
+          gem install bundler -v "$(grep -A 1 "BUNDLED WITH" Gemfile.lock | tail -n 1)"
+          bundle update
+          bundle install
+
+      # Install gdb for backtrace feature testing
+      - name: Install gdb for Backtrace Feature Testing
         run: |
           sudo apt-get update -qq
-          sudo apt-get install --assume-yes --quiet gcc-multilib
-          sudo apt-get install -qq gcc-avr binutils-avr avr-libc gdb
+          sudo apt-get install --assume-yes --quiet gdb
 
-      # Install GCovr
-      - name: Install GCovr
+      # Install GCovr for Gcov plugin
+      - name: Install GCovr for Gcov Plugin Tests
         run: |
           sudo pip install gcovr
 
+      # Install ReportGenerator for Gcov plugin
+      # Fix PATH before tool installation
+      # https://stackoverflow.com/questions/59010890/github-action-how-to-restart-the-session
+      - name: Install ReportGenerator for Gcov Plugin Tests
+        run: |
+          mkdir --parents $HOME/.dotnet/tools
+          echo "$HOME/.dotnet/tools" >> $GITHUB_PATH
+          dotnet tool install --global dotnet-reportgenerator-globaltool
+
+      # Run Tests
+      - name: Run All Self Tests
+        run: |
+          rake ci
+
+      # Build & Install Gem
+      - name: Build and Install Gem
+        run: |
+          gem build ceedling.gemspec
+          gem install --local ceedling-*.gem
+
+      # Run temp_sensor
+      - name: Run Tests on temp_sensor Project
+        run: |
+          cd examples/temp_sensor
+          ceedling test:all
+          cd ../..
+
+      # Run FFF Plugin Tests
+      - name: Run Tests on FFF Plugin
+        run: |
+          cd plugins/fff
+          rake
+          cd ../..
+
+      # Run Module Generator Plugin Tests
+      - name: Run Tests on Module Generator Plugin
+        run: |
+          cd plugins/module_generator
+          rake
+          cd ../..
+
+      # Run Dependencies Plugin Tests
+      - name: Run Tests on Dependencies Plugin
+        run: |
+          cd plugins/dependencies
+          rake
+          cd ../..
+
+  # Job: Windows unit test suite
+  unit-tests-windows:
+    name: "Windows Test Suite"
+    runs-on: windows-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['3.0', '3.1', '3.2']
+    steps:
+      # Use a cache for our tools to speed up testing
+      - uses: actions/cache@v4
+        with:
+          path: vendor/bundle
+          key: bundle-use-ruby-${{ matrix.os }}-${{ matrix.ruby-version }}-${{ hashFiles('**/Gemfile.lock') }}
+          restore-keys: |
+            bundle-use-ruby-${{ matrix.os }}-${{ matrix.ruby-version }}-
+
       # Checks out repository under $GITHUB_WORKSPACE
       - name: Checkout Latest Repo
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           submodules: recursive
 
       # Setup Ruby Testing Tools to do tests on multiple ruby version
-      - name: Setup Ruby Testing Tools
+      - name: Set Up Ruby Testing Tools
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
-      # Install Ruby Testing Tools (Bundler version should match the one in Gemfile.lock)
+
+      # Install Ruby Testing Tools
+      # Bundler version should match the one in Gemfile.lock
       - name: Install Ruby Testing Tools
+        shell: bash
         run: |
           gem install rspec
           gem install rubocop -v 0.57.2
           gem install bundler -v "$(grep -A 1 "BUNDLED WITH" Gemfile.lock | tail -n 1)"
           bundle update
           bundle install
 
+      # Install GCovr for Gcov plugin test
+      - name: Install GCovr for Gcov Plugin Tests
+        run: |
+          pip install gcovr
+
+      # Install ReportGenerator for Gcov plugin test
+      - name: Install ReportGenerator for Gcov Plugin Tests
+        run: |
+          dotnet tool install --global dotnet-reportgenerator-globaltool
+
       # Run Tests
       - name: Run All Self Tests
         run: |
-          bundle exec rake ci
+          rake ci
 
       # Build & Install Gem
-      - name: Build and Install Gem
+      - name:  Build and Install Gem
         run: |
           gem build ceedling.gemspec
           gem install --local ceedling-*.gem
 
-      # Run Blinky
-      # Disabled because it's set up for avr-gcc
-      #- name: Run Tests On Blinky Project
-      #  run: |
-      #    cd examples/blinky
-      #    ceedling module:create[someNewModule] module:destroy[someNewModule] test:all
-      #    cd ../..
-
-      # Run Temp Sensor
-      - name: Run Tests On Temp Sensor Project
+      # Run temp_sensor example project
+      - name: Run Tests on temp_sensor Project
         run: |
           cd examples/temp_sensor
-          ceedling module:create[someNewModule] module:destroy[someNewModule] test:all
+          ceedling test:all
+          cd ../..
+
+      # Run FFF Plugin Tests
+      - name: Run Tests on FFF Plugin
+        run: |
+          cd plugins/fff
+          rake
+          cd ../..
+
+      # Run Module Generator Plugin Tests
+      - name: Run Tests on Module Generator Plugin
+        run: |
+          cd plugins/module_generator
+          rake
+          cd ../..
+
+      # Run Dependencies Plugin Tests
+      - name: Run Tests on Dependencies Plugin
+        run: |
+          cd plugins/dependencies
+          rake
           cd ../..
+
+  # Job: Automatic Minor Release
+  auto-release:
+    name: "Automatic Minor Release"
+    needs:
+      - unit-tests-linux
+      - unit-tests-windows
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby: [3.2]
+
+    steps:
+      # Checks out repository under $GITHUB_WORKSPACE
+      - name: Checkout Latest Repo
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      # Set Up Ruby Tools
+      - name: Set Up Ruby Tools
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+
+      # Generate the Version + Hash Name
+      - name: Version
+        id: versions
+        shell: bash
+        run: |
+          echo "short_ver=$(ruby ./lib/ceedling/version.rb)" >> $GITHUB_ENV
+          echo "full_ver=$(ruby ./lib/ceedling/version.rb)-$(git rev-parse --short HEAD)" >> $GITHUB_ENV
+
+      # Build Gem
+      - name:  Build Gem
+        run: |
+          gem build ceedling.gemspec
+
+      # Create Unofficial Release
+      - name: Create Pre-Release
+        uses: actions/create-release@v1
+        id: create_release
+        with:
+          draft: false
+          prerelease: true
+          release_name: ${{ env.full_ver }}
+          tag_name: ${{ env.full_ver }}
+          body: "Automatic pre-release for ${{ env.full_ver }}"
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+
+      # Post Gem to Unofficial Release
+      - name: Upload Pre-Release Gem
+        uses: actions/upload-release-asset@v1
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        with:
+          upload_url: ${{ steps.create_release.outputs.upload_url }}
+          asset_path: ./ceedling-${{ env.short_ver }}.gem
+          asset_name: ceedling-${{ env.full_ver }}.gem
+          asset_content_type: test/x-gemfile
+
+      # - name: Upload Pre-Release Gem
+      #   uses: softprops/action-gh-release@v2
+      #   with:
+      #     # repo_token: "${{ secrets.GITHUB_TOKEN }}"
+      #     body: |
+      #       [Release Notes](${{ github.workspace }}/docs/ReleaseNotes.md)
+      #     name: ${{ env.full_ver }}
+      #     prerelease: true
+      #     files: |
+      #       *.gem
+

.gitignore

@@ -7,10 +7,13 @@ out.fail
 tags
 *.taghl
 
-examples/blinky/build/
-examples/blinky/vendor/
 examples/temp_sensor/vendor/
 examples/temp_sensor/build/
+plugins/fff/examples/fff_example/build/
+plugins/module_generator/example/build/
+plugins/dependencies/example/boss/build/
+plugins/dependencies/example/boss/third_party/
+plugins/dependencies/example/supervisor/build/
 
 ceedling.sublime-project
 ceedling.sublime-workspace

.gitmodules

@@ -10,6 +10,3 @@
 	path = vendor/cmock
 	url = https://github.com/ThrowTheSwitch/CMock.git     
 	branch = master
-[submodule "plugins/fake_function_framework"]
-	path = plugins/fake_function_framework
-	url = https://github.com/ElectronVector/fake_function_framework.git

.rubocop.yml

@@ -1,3 +1,10 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-24 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
 # This is the configuration used to check the rubocop source code.
 
 #inherit_from: .rubocop_todo.yml

Gemfile

@@ -1,6 +1,13 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-24 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
 source "http://rubygems.org/"
 
-gem "bundler"
+gem "bundler", "~> 2.5"
 gem "rake"
 gem "rspec", "~> 3.8"
 gem "require_all"
@@ -9,6 +16,7 @@ gem "diy"
 gem "rr"
 gem "thor"
 gem "deep_merge"
+gem "unicode-display_width"
 
 #these will be used if present, but ignored otherwise
 #gem "curses"