ceedling 1.0.1 → 1.1.0

data/spec/{spec_system_helper.rb → system/support/common_test_cases.rb}

@@ -1,183 +1,16 @@
 # =========================================================================
 #   Ceedling - Test-Centered Build System for C
 #   ThrowTheSwitch.org
-#   Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
 #   SPDX-License-Identifier: MIT
 # =========================================================================
 
-require 'fileutils'
-require 'tmpdir'
-require 'ceedling/yaml_wrapper'
-require 'spec_helper'
-require 'deep_merge'
-
-def test_asset_path(asset_file_name)
-  File.join(File.dirname(__FILE__), '..', 'assets', asset_file_name)
-end
-
-def convert_slashes(path)
-  if RUBY_PLATFORM.downcase.match(/mingw|win32/)
-    path.gsub("/","\\")
-  else
-    path
-  end
-end
-
-class GemDirLayout
-  attr_reader :gem_dir_base_name
-
-  def initialize(install_dir)
-    @gem_dir_base_name = "gems"
-    @d = File.join install_dir, @gem_dir_base_name
-    FileUtils.mkdir_p @d
-  end
-
-  def install_dir; convert_slashes(@d)  end
-  def bin;         File.join(@d, 'bin') end
-  def lib;         File.join(@d, 'lib') end
-end
-
-class SystemContext
-  class VerificationFailed < RuntimeError; end
-  class InvalidBackupEnv < RuntimeError; end
-
-  attr_reader :dir, :gem
-
-  def initialize
-    @dir = Dir.mktmpdir
-    @gem = GemDirLayout.new(@dir)
-  end
-
-  def done!
-    FileUtils.rm_rf(@dir)
-  end
-
-  def deploy_gem
-    git_repo = File.expand_path( File.join( File.dirname( __FILE__ ), '..') )
-    bundler_gem_file_data = [
-      %Q{source "http://rubygems.org/"},
-      %Q{gem "rake"},
-      %Q{gem "constructor"},
-      %Q{gem "diy"},
-      %Q{gem "thor"},
-      %Q{gem "deep_merge"},
-      %Q{gem "unicode-display_width"},
-      %Q{gem "ceedling", :path => '#{git_repo}'}
-    ].join("\n")
-
-    File.open(File.join(@dir, "Gemfile"), "w+") do |f|
-      f.write(bundler_gem_file_data)
-    end
-
-    Dir.chdir @dir do
-      with_constrained_env do
-        `bundle config set --local path '#{@gem.install_dir}'`
-        `bundle install`
-        checks = ["bundle exec ruby -S ceedling 2>&1"]
-        checks.each do |c|
-          `#{c}`
-          #raise VerificationFailed.new(c) unless $?.success?
-        end
-      end
-    end
-
-  end
-
-  # Does a few things:
-  #   - Configures the environment.
-  #   - Runs the command from the temporary context directory.
-  #   - Restores everything to where it was when finished.
-  def context_exec(cmd, *args)
-    with_context do
-      `#{args.unshift(cmd).join(" ")}`
-    end
-  end
-
-  def with_context
-    Dir.chdir @dir do |current_dir|
-      with_constrained_env do
-        ENV['RUBYLIB'] = @gem.lib
-        ENV['RUBYPATH'] = @gem.bin
-
-        ENV['LANG'] = 'en_US.UTF-8'
-        ENV['LANGUAGE'] = 'en_US.UTF-8'
-        ENV['LC_ALL'] = 'en_US.UTF-8'
-
-        yield
-      end
-    end
-  end
-
-  ############################################################
-  # Functions for manipulating environment settings during tests:
-  def backup_env
-    @_env = ENV.to_hash
-  end
-
-  def reduce_env(destroy_keys=[])
-    ENV.keys.each {|k| ENV.delete(k) if destroy_keys.include?(k) }
-  end
-
-  def constrain_env
-    destroy_keys = %w{BUNDLE_GEMFILE BUNDLE_BIN_PATH RUBYOPT}
-    reduce_env(destroy_keys)
-  end
-
-  def restore_env
-    if @_env
-      # delete environment variables we've added since we started
-      ENV.to_hash.each_pair {|k,v| ENV.delete(k) unless @_env.include?(k) }
-
-      # restore environment variables we've modified since we started
-      @_env.each_pair {|k,v| ENV[k] = v}
-    else
-      raise InvalidBackupEnv.new
-    end
-  end
-
-  def with_constrained_env
-    begin
-      backup_env
-      constrain_env
-      yield
-    ensure
-      restore_env
-    end
-  end
-
-  ############################################################
-  # Functions for manipulating project.yml files during tests:
-  def merge_project_yml_for_test(settings, show_final=false)
-    yaml_wrapper = YamlWrapper.new
-    project_hash = yaml_wrapper.load('project.yml')
-    project_hash.deep_merge!(settings)
-    puts "\n\n#{project_hash.to_yaml}\n\n" if show_final
-    yaml_wrapper.dump('project.yml', project_hash)
-  end
-
-  def append_project_yml_for_test(new_args)
-    fake_prj_yml= "#{File.read('project.yml')}\n#{new_args}"
-    File.write('project.yml', fake_prj_yml, mode: 'w')
-  end
-
-  def uncomment_project_yml_option_for_test(option)
-    fake_prj_yml= File.read('project.yml').gsub(/\##{option}/,option)
-    File.write('project.yml', fake_prj_yml, mode: 'w')
-  end
-
-  def comment_project_yml_option_for_test(option)
-    fake_prj_yml= File.read('project.yml').gsub(/#{option}/,"##{option}")
-    File.write('project.yml', fake_prj_yml, mode: 'w')
-  end
-  ############################################################
-end
-
-module CeedlingTestCases
+module CommonSystemTestCases
   def can_report_version_no_git_commit_sha
     @c.with_context do
       # Version without Git commit short SHA file in project
-      output = `bundle exec ruby -S ceedling version 2>&1`
-      expect($?.exitstatus).to match(0)
+      output = @c.ceedling_appcmd_exec("version")
+      expect(@c.last_exit_status).to eq(0)
       expect(output).to match(/Ceedling => \d\.\d\.\d\n/)
     end
   end
@@ -190,8 +23,8 @@ module CeedlingTestCases
     end
 
     @c.with_context do
-      output = `bundle exec ruby -S ceedling version 2>&1`
-      expect($?.exitstatus).to match(0)
+      output = @c.ceedling_appcmd_exec("version")
+      expect(@c.last_exit_status).to eq(0)
       expect(output).to match(/Ceedling => \d\.\d\.\d----{-@\n/)
     end
   end
@@ -218,8 +51,8 @@ module CeedlingTestCases
 
   def can_upgrade_projects
     @c.with_context do
-      output = `bundle exec ruby -S ceedling upgrade #{@proj_name} 2>&1`
-      expect($?.exitstatus).to match(0)
+      output = @c.ceedling_appcmd_exec("upgrade #{@proj_name}")
+      expect(@c.last_exit_status).to eq(0)
       expect(output).to match(/Upgraded/i)
       Dir.chdir @proj_name do
         expect(File.exist?("project.yml")).to eq true
@@ -230,9 +63,9 @@ module CeedlingTestCases
     end
   end
 
-  def can_upgrade_projects_even_if_test_support_folder_does_not_exist
+  def can_upgrade_projects_with_no_test_support_folder
     @c.with_context do
-      output = `bundle exec ruby -S ceedling upgrade #{@proj_name} 2>&1`
+      output = @c.ceedling_appcmd_exec("upgrade #{@proj_name}")
       FileUtils.rm_rf("#{@proj_name}/test/support")
 
       updated_prj_yml = []
@@ -241,21 +74,20 @@ module CeedlingTestCases
       end
       File.write("#{@proj_name}/project.yml", updated_prj_yml.join("\n"), mode: 'w')
 
-      expect($?.exitstatus).to match(0)
+      expect(@c.last_exit_status).to eq(0)
       expect(output).to match(/Upgraded/i)
       Dir.chdir @proj_name do
         expect(File.exist?("project.yml")).to eq true
         expect(File.exist?("src")).to eq true
         expect(File.exist?("test")).to eq true
-        all_docs = Dir["vendor/ceedling/docs/*.pdf"].length + Dir["vendor/ceedling/docs/*.md"].length
       end
     end
   end
 
   def cannot_upgrade_non_existing_project
     @c.with_context do
-      output = `bundle exec ruby -S ceedling upgrade #{@proj_name} 2>&1`
-      expect($?.exitstatus).to match(1)
+      output = @c.ceedling_appcmd_exec("upgrade #{@proj_name}")
+      expect(@c.last_exit_status).to eq(1)
       expect(output).to match(/Could not find an existing project/i)
     end
   end
@@ -279,8 +111,8 @@ module CeedlingTestCases
   def contains_documentation
     @c.with_context do
       Dir.chdir @proj_name do
-        all_docs = Dir["docs/*.md"].length + Dir["vendor/ceedling/docs/*.md"].length
-        expect(all_docs).to be >= 4
+        all_docs = Dir["docs/*"]
+        expect(all_docs).to contain_exactly('docs/ceedling', 'docs/unity', 'docs/cmock', 'docs/c_exception', 'docs/license.txt')
       end
     end
   end
@@ -288,21 +120,20 @@ module CeedlingTestCases
   def does_not_contain_documentation
     @c.with_context do
       Dir.chdir @proj_name do
-        expect(File.exist?("vendor/ceedling/docs")).to eq false
-        expect(Dir["vendor/ceedling/**/*.pdf"].length).to eq 0
+        expect(Dir.exist?("docs/")).to eq false
       end
     end
   end
 
-  def can_test_projects_with_success
+  def test_project_success
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file_success.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling test:all 2>&1`
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        output = @c.ceedling_build_exec("test:all")
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
@@ -311,15 +142,15 @@ module CeedlingTestCases
     end
   end
 
-  def can_test_projects_with_success_test_alias
+  def test_project_with_test_all_alias
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file_success.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling test 2>&1`
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        output = @c.ceedling_build_exec("test")
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
@@ -328,15 +159,15 @@ module CeedlingTestCases
     end
   end
 
-  def can_test_projects_with_success_default
+  def test_project_success_default_task
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file_success.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling 2>&1`
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        output = @c.ceedling_build_exec
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
@@ -345,45 +176,45 @@ module CeedlingTestCases
     end
   end
 
-  def can_test_projects_with_named_verbosity
+  def test_project_with_named_verbosity
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file_success.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling --verbosity=obnoxious 2>&1`
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        output = @c.ceedling_build_exec("--verbosity=obnoxious")
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
         expect(output).to match(/IGNORED:\s+\d/)
 
-        expect(output).to match (/:post_test_fixture_execute/)
+        expect(output).to match(/:post_test_fixture_execute/)
       end
     end
   end
 
-  def can_test_projects_with_numerical_verbosity
+  def test_project_with_numerical_verbosity
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file_success.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling -v=4 2>&1`
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        output = @c.ceedling_build_exec("-v=4")
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
         expect(output).to match(/IGNORED:\s+\d/)
 
-        expect(output).to match (/:post_test_fixture_execute/)
+        expect(output).to match(/:post_test_fixture_execute/)
       end
     end
   end
 
-  def can_test_projects_with_unity_exec_time
+  def test_project_with_unity_exec_time
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
@@ -392,8 +223,8 @@ module CeedlingTestCases
         settings = { :unity => { :defines => [ "UNITY_INCLUDE_EXEC_TIME" ] } }
         @c.merge_project_yml_for_test(settings)
 
-        output = `bundle exec ruby -S ceedling 2>&1`
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        output = @c.ceedling_build_exec
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
@@ -402,7 +233,7 @@ module CeedlingTestCases
     end
   end
 
-  def can_test_projects_with_test_and_vendor_defines_with_success
+  def test_project_with_test_and_vendor_defines
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
@@ -413,8 +244,8 @@ module CeedlingTestCases
                    }
         @c.merge_project_yml_for_test(settings)
 
-        output = `bundle exec ruby -S ceedling 2>&1`
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        output = @c.ceedling_build_exec
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
@@ -423,19 +254,23 @@ module CeedlingTestCases
     end
   end
 
-  def can_test_projects_with_test_name_replaced_defines_with_success
+  def test_project_with_per_file_defines
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.copy_entry test_asset_path("tests_with_defines/src/"), 'src/'
         FileUtils.cp_r test_asset_path("tests_with_defines/test/."), 'test/'
-        settings = { :defines => { :test => { '*' => [ "TEST", "STANDARD_CONFIG" ],
-                                   'test_adc_hardware_special.c' => [ "TEST", "SPECIFIC_CONFIG" ],
-                                 } }
-                   }
+        settings = { 
+          :defines => { 
+            :test => {
+              '*' => [ "TEST", "STANDARD_CONFIG" ],
+              'test_adc_hardware_special.c' => [ "TEST", "SPECIFIC_CONFIG" ],
+            }
+          }
+        }
         @c.merge_project_yml_for_test(settings)
 
-        output = `bundle exec ruby -S ceedling 2>&1`
-        expect($?.exitstatus).to match(0) # Since a test either passes or is ignored, we return success here
+        output = @c.ceedling_build_exec
+        expect(@c.last_exit_status).to eq(0) # Since a test either passes or is ignored, we return success here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
@@ -445,7 +280,7 @@ module CeedlingTestCases
   end
 
   # Ceedling :use_test_preprocessor is disabled
-  def can_test_projects_unity_parameterized_test_cases_with_success
+  def test_project_unity_parameterized_test_cases
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("test_example_with_parameterized_tests.c"), 'test/'
@@ -454,8 +289,8 @@ module CeedlingTestCases
                    }
         @c.merge_project_yml_for_test(settings)
 
-        output = `bundle exec ruby -S ceedling 2>&1`
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        output = @c.ceedling_build_exec
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
@@ -464,27 +299,38 @@ module CeedlingTestCases
     end
   end
 
-  # NOTE: This is not supported in this release, therefore is not getting called.
-  def can_test_projects_unity_parameterized_test_cases_with_preprocessor_with_success
+  # assets/test_example_with_parameterized_tests.c declares 3 TEST_CASE values,
+  # TEST_RANGE([5,100,5]) (20 values), and TEST_RANGE([10,100,10],[5,10,5]) (10*2=20 values)
+  # for a total of 43 expanded test invocations. Asserting the exact counts (rather than
+  # the file's usual loose `\d` match) matters here specifically. A broken positional
+  # association would silently degrade to 3 un-parameterized tests (one per declared
+  # function) and a loose digit match would still pass.
+  def test_project_preprocessed_unity_parameterized_test_cases
     @c.with_context do
       Dir.chdir @proj_name do
-        FileUtils.cp test_asset_path("test_example_with_parameterized_tests.c"), 'test/'
-        settings = { :project => { :use_test_preprocessor => :all, :use_deep_preprocessor => :mocks },
+        # Short destination filename: Ceedling's directives-only preprocessing path
+        # repeats the test module name twice (.../preprocess/files/<name>/directives_only/raw/<name>.c).
+        # Combined with an already-deep Windows CI temp project path, the asset's original
+        # long filename pushed the full absolute path past Windows' 260-char MAX_PATH limit,
+        # causing gcc.exe to fail opening its own output file with a spurious
+        # "No such file or directory". Keeping the copied filename short avoids that.
+        FileUtils.cp test_asset_path("test_example_with_parameterized_tests.c"), 'test/test_ptc.c'
+        settings = { :project => { :use_test_preprocessor => :all },
                      :unity => { :use_param_tests => true }
                    }
         @c.merge_project_yml_for_test(settings)
 
-        output = `bundle exec ruby -S ceedling 2>&1`
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
-        expect(output).to match(/TESTED:\s+\d/)
-        expect(output).to match(/PASSED:\s+\d/)
-        expect(output).to match(/FAILED:\s+\d/)
-        expect(output).to match(/IGNORED:\s+\d/)
+        output = @c.ceedling_build_exec
+        expect(@c.last_exit_status).to eq(0)
+        expect(output).to match(/TESTED:\s+43/)
+        expect(output).to match(/PASSED:\s+43/)
+        expect(output).to match(/FAILED:\s+0/)
+        expect(output).to match(/IGNORED:\s+0/)
       end
     end
   end
 
-  def can_test_projects_with_preprocessing_for_test_files_symbols_undefined
+  def test_project_preprocessing_undefined_symbols
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("tests_with_preprocessing/test/test_adc_hardwareA.c"), 'test/'
@@ -497,8 +343,8 @@ module CeedlingTestCases
                    }
         @c.merge_project_yml_for_test(settings)
 
-        output = `bundle exec ruby -S ceedling test:adc_hardwareA 2>&1`
-        expect($?.exitstatus).to match(1) # Intentional test failure in successful build
+        output = @c.ceedling_build_exec("test:adc_hardwareA")
+        expect(@c.last_exit_status).to eq(1) # Intentional test failure in successful build
         expect(output).to match(/TESTED:\s+2/)
         expect(output).to match(/PASSED:\s+0/)
         expect(output).to match(/FAILED:\s+2/)
@@ -506,7 +352,7 @@ module CeedlingTestCases
     end
   end
 
-  def can_test_projects_with_preprocessing_for_test_files_symbols_defined
+  def test_project_preprocessing_defined_symbols
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("tests_with_preprocessing/test/test_adc_hardwareA.c"), 'test/'
@@ -519,8 +365,8 @@ module CeedlingTestCases
                    }
         @c.merge_project_yml_for_test(settings)
 
-        output = `bundle exec ruby -S ceedling test:adc_hardwareA 2>&1`
-        expect($?.exitstatus).to match(0) # Successful build and tests
+        output = @c.ceedling_build_exec("test:adc_hardwareA")
+        expect(@c.last_exit_status).to eq(0) # Successful build and tests
         expect(output).to match(/TESTED:\s+1/)
         expect(output).to match(/PASSED:\s+1/)
         expect(output).to match(/FAILED:\s+0/)
@@ -528,7 +374,7 @@ module CeedlingTestCases
     end
   end
 
-  def can_test_projects_with_preprocessing_for_mocks_success
+  def test_project_with_preprocessing_for_mocks
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("tests_with_preprocessing/test/test_adc_hardwareB.c"), 'test/'
@@ -541,8 +387,8 @@ module CeedlingTestCases
                    }
         @c.merge_project_yml_for_test(settings)
 
-        output = `bundle exec ruby -S ceedling test:adc_hardwareB 2>&1`
-        expect($?.exitstatus).to match(0) # Successful build and tests
+        output = @c.ceedling_build_exec("test:adc_hardwareB")
+        expect(@c.last_exit_status).to eq(0) # Successful build and tests
         expect(output).to match(/TESTED:\s+1/)
         expect(output).to match(/PASSED:\s+1/)
         expect(output).to match(/FAILED:\s+0/)
@@ -550,7 +396,7 @@ module CeedlingTestCases
     end
   end
 
-  def can_test_projects_with_preprocessing_for_mocks_intentional_build_failure
+  def test_project_with_preprocessing_for_missing_mock
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("tests_with_preprocessing/test/test_adc_hardwareB.c"), 'test/'
@@ -562,14 +408,14 @@ module CeedlingTestCases
                    }
         @c.merge_project_yml_for_test(settings)
 
-        output = `bundle exec ruby -S ceedling test:adc_hardwareB 2>&1`
-        expect($?.exitstatus).to match(1) # Failing build because of missing mock
+        output = @c.ceedling_build_exec("test:adc_hardwareB")
+        expect(@c.last_exit_status).to eq(1) # Failing build because of missing mock
         expect(output).to match(/(undeclared|undefined|implicit).+Adc_Reset/)
       end
     end
   end
 
-  def can_test_projects_with_preprocessing_all
+  def test_project_with_preprocessing_all
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("tests_with_preprocessing/test/test_adc_hardwareC.c"), 'test/'
@@ -582,8 +428,8 @@ module CeedlingTestCases
                    }
         @c.merge_project_yml_for_test(settings)
 
-        output = `bundle exec ruby -S ceedling test:adc_hardwareC 2>&1`
-        expect($?.exitstatus).to match(0) # Successful build and tests
+        output = @c.ceedling_build_exec("test:adc_hardwareC")
+        expect(@c.last_exit_status).to eq(0) # Successful build and tests
         expect(output).to match(/TESTED:\s+1/)
         expect(output).to match(/PASSED:\s+1/)
         expect(output).to match(/FAILED:\s+0/)
@@ -591,15 +437,15 @@ module CeedlingTestCases
     end
   end
 
-  def can_test_projects_with_fail
+  def test_project_fail
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling test:all 2>&1`
-        expect($?.exitstatus).to match(1) # Since a test fails, we return error here
+        output = @c.ceedling_build_exec("test:all")
+        expect(@c.last_exit_status).to eq(1) # Since a test fails, we return error here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
@@ -608,15 +454,15 @@ module CeedlingTestCases
     end
   end
 
-  def can_test_projects_with_fail_alias
+  def test_project_fail_alias
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling test 2>&1`
-        expect($?.exitstatus).to match(1) # Since a test fails, we return error here
+        output = @c.ceedling_build_exec("test")
+        expect(@c.last_exit_status).to eq(1) # Since a test fails, we return error here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
@@ -625,15 +471,15 @@ module CeedlingTestCases
     end
   end
 
-  def can_test_projects_with_fail_default
+  def test_project_fail_default
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling 2>&1`
-        expect($?.exitstatus).to match(1) # Since a test fails, we return error here
+        output = @c.ceedling_build_exec
+        expect(@c.last_exit_status).to eq(1) # Since a test fails, we return error here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
@@ -642,21 +488,21 @@ module CeedlingTestCases
     end
   end
 
-  def can_test_projects_with_compile_error
+  def test_project_with_compile_error
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file_boom.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling test:all 2>&1`
-        expect($?.exitstatus).to match(1) # Since a test explodes, we return error here
+        output = @c.ceedling_build_exec("test:all")
+        expect(@c.last_exit_status).to eq(1) # Since a test explodes, we return error here
         expect(output).to match(/(?:ERROR: Ceedling Failed)|(?:Ceedling could not complete operations because of errors)/)
       end
     end
   end
 
-  def can_test_projects_with_both_mock_and_real_header
+  def test_project_with_both_mock_and_real_header
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
@@ -665,8 +511,8 @@ module CeedlingTestCases
         FileUtils.cp test_asset_path("example_file_call.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file_with_mock.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling 2>&1`
-        expect($?.exitstatus).to match(0) # Since a test either passed or was ignored, we return success here
+        output = @c.ceedling_build_exec
+        expect(@c.last_exit_status).to eq(0) # Since a test either passed or was ignored, we return success here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
@@ -675,7 +521,7 @@ module CeedlingTestCases
     end
   end
 
-  def uses_report_tests_raw_output_log_plugin
+  def report_tests_raw_output_log_plugin
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
@@ -684,8 +530,8 @@ module CeedlingTestCases
 
         @c.uncomment_project_yml_option_for_test('- report_tests_raw_output_log')
 
-        output = `bundle exec ruby -S ceedling test:all 2>&1`
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        output = @c.ceedling_build_exec("test:all")
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)
@@ -695,24 +541,23 @@ module CeedlingTestCases
     end
   end
 
-
-  def can_fetch_non_project_help
+  def application_commands_help
     @c.with_context do
-      #notice we don't change directory into the project
-        output = `bundle exec ruby -S ceedling help`
-        expect($?.exitstatus).to match(0)
-        expect(output).to match(/ceedling example/i)
-        expect(output).to match(/ceedling new/i)
-        expect(output).to match(/ceedling upgrade/i)
-        expect(output).to match(/ceedling version/i)
+      # notice we don't change directory into the project
+      output = @c.ceedling_appcmd_exec("help")
+      expect(@c.last_exit_status).to eq(0)
+      expect(output).to match(/ceedling example/i)
+      expect(output).to match(/ceedling new/i)
+      expect(output).to match(/ceedling upgrade/i)
+      expect(output).to match(/ceedling version/i)
     end
   end
 
-  def can_fetch_project_help
+  def project_build_tasks_plugins_help
     @c.with_context do
       Dir.chdir @proj_name do
-        output = `bundle exec ruby -S ceedling help`
-        expect($?.exitstatus).to match(0)
+        output = @c.ceedling_appcmd_exec("help")
+        expect(@c.last_exit_status).to eq(0)
         expect(output).to match(/ceedling clean/i)
         expect(output).to match(/ceedling clobber/i)
         expect(output).to match(/ceedling module:create/i)
@@ -725,16 +570,16 @@ module CeedlingTestCases
     end
   end
 
-  def can_run_single_test_with_full_test_case_name_from_test_file_with_success
+  def run_single_test_with_full_name_filter
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file_success.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling test:test_example_file_success --test_case=test_add_numbers_adds_numbers 2>&1`
+        output = @c.ceedling_build_exec("test:test_example_file_success --test_case=test_add_numbers_adds_numbers")
 
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+1/)
         expect(output).to match(/PASSED:\s+1/)
         expect(output).to match(/FAILED:\s+0/)
@@ -743,16 +588,16 @@ module CeedlingTestCases
     end
   end
 
-  def can_run_single_test_with_partial_test_case_name_from_test_file_with_success
+  def run_single_test_with_partial_name_filter
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file_success.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling test:test_example_file_success --test_case=_adds_numbers 2>&1`
+        output = @c.ceedling_build_exec("test:test_example_file_success --test_case=_adds_numbers")
 
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+1/)
         expect(output).to match(/PASSED:\s+1/)
         expect(output).to match(/FAILED:\s+0/)
@@ -761,65 +606,46 @@ module CeedlingTestCases
     end
   end
 
-  def none_of_test_is_executed_if_test_case_name_passed_does_not_fit_defined_in_test_file
+  def no_tests_run_when_filter_matches_nothing
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file_success.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling test:test_example_file_success --test_case=zumzum 2>&1`
+        output = @c.ceedling_build_exec("test:test_example_file_success --test_case=zumzum")
 
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/No tests executed./)
       end
     end
   end
 
-  def none_of_test_is_executed_if_test_case_name_and_exclude_test_case_name_is_the_same
+  def no_tests_run_when_filter_and_exclusion_cancel
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file_success.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling test:test_example_file_success --test_case=_adds_numbers --exclude_test_case=_adds_numbers 2>&1`
+        output = @c.ceedling_build_exec("test:test_example_file_success --test_case=_adds_numbers --exclude_test_case=_adds_numbers")
 
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/No tests executed./)
       end
     end
   end
 
-  def confirm_if_notification_for_cmdline_args_not_enabled_is_disabled
+  def exclusion_filter_leaves_one_test_case
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file_success.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling test:test_example_file_success 2>&1`
+        output = @c.ceedling_build_exec("test:all --exclude_test_case=test_add_numbers_adds_numbers")
 
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
-        expect(output).to match(/TESTED:\s+2/)
-        expect(output).to match(/PASSED:\s+1/)
-        expect(output).to match(/FAILED:\s+0/)
-        expect(output).to match(/IGNORED:\s+1/)
-        expect(output).not_to match(/:cmdline_args/)
-      end
-    end
-  end
-
-  def exclude_test_case_name_filter_works_and_only_one_test_case_is_executed
-    @c.with_context do
-      Dir.chdir @proj_name do
-        FileUtils.cp test_asset_path("example_file.h"), 'src/'
-        FileUtils.cp test_asset_path("example_file.c"), 'src/'
-        FileUtils.cp test_asset_path("test_example_file_success.c"), 'test/'
-
-        output = `bundle exec ruby -S ceedling test:all --exclude_test_case=test_add_numbers_adds_numbers 2>&1`
-
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+1/)
         expect(output).to match(/PASSED:\s+0/)
         expect(output).to match(/FAILED:\s+0/)
@@ -828,16 +654,16 @@ module CeedlingTestCases
     end
   end
 
-  def run_one_testcase_from_one_test_file_when_test_case_name_is_passed
+  def run_one_test_case_with_name_filter
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
         FileUtils.cp test_asset_path("test_example_file_success.c"), 'test/'
 
-        output = `bundle exec ruby -S ceedling test:test_example_file_success --test_case=_adds_numbers 2>&1`
+        output = @c.ceedling_build_exec("test:test_example_file_success --test_case=_adds_numbers")
 
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+1/)
         expect(output).to match(/PASSED:\s+1/)
         expect(output).to match(/FAILED:\s+0/)
@@ -847,117 +673,242 @@ module CeedlingTestCases
   end
 
 
-  def test_run_of_projects_fail_because_of_crash_without_report
+  # Validates that a crash with :use_backtrace => :none reports "Test Executable Crashed"
+  # in Ceedling output and returns a failing exit code.
+  # Uses a SIGSEGV (null-pointer dereference) crash.
+  def crash_none_reports_executable_crashed
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
-        FileUtils.cp test_asset_path("test_example_file_crash.c"), 'test/'
+        FileUtils.cp test_asset_path("test_example_file_crash_sigsegv.c"), 'test/'
 
         @c.merge_project_yml_for_test({:project => { :use_backtrace => :none }})
 
-        output = `bundle exec ruby -S ceedling test:all 2>&1`
-        expect($?.exitstatus).to match(1) # Test should fail because of crash
+        output = @c.ceedling_build_exec("test:all")
+        expect(@c.last_exit_status).to eq(1) # Test should fail because of crash
         expect(output).to match(/Test Executable Crashed/i)
-        expect(output).to match(/Unit test failures./)
+        expect(output).to match(/Unit test failures/)
         expect(!File.exist?('./build/test/results/test_add.fail'))
       end
     end
   end
 
-  def test_run_of_projects_fail_because_of_crash_with_report
+  # Validates that a crash with :use_backtrace => :none writes a .fail results file
+  # containing the crashed test case name and crash location.
+  # Uses a SIGSEGV (null-pointer dereference) crash.
+  def crash_none_writes_fail_results_file
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
-        FileUtils.cp test_asset_path("test_example_file_crash.c"), 'test/'
+        FileUtils.cp test_asset_path("test_example_file_crash_sigsegv.c"), 'test/'
 
         @c.merge_project_yml_for_test({:project => { :use_backtrace => :none }})
 
-        output = `bundle exec ruby -S ceedling test:all 2>&1`
-        expect($?.exitstatus).to match(1) # Test should fail because of crash
+        output = @c.ceedling_build_exec("test:all")
+        expect(@c.last_exit_status).to eq(1) # Test should fail because of crash
         expect(output).to match(/Test Executable Crashed/i)
-        expect(output).to match(/Unit test failures./)
-        expect(File.exist?('./build/test/results/test_example_file_crash.fail'))
-        output_rd = File.read('./build/test/results/test_example_file_crash.fail')
-        expect(output_rd =~ /test_add_numbers_will_fail \(\) at test\/test_example_file_crash.c\:14/ )
+        expect(output).to match(/Unit test failures/)
+        expect(File.exist?('./build/test/results/test_example_file_crash_sigsegv.fail'))
+        output_rd = File.read('./build/test/results/test_example_file_crash_sigsegv.fail')
+        expect(output_rd =~ /test_add_numbers_will_fail \(\) at test\/test_example_file_crash_sigsegv.c\:\d+/ )
       end
     end
   end
 
-  def execute_all_test_cases_from_crashing_test_runner_and_return_test_report_with_failue
+  # Validates that :use_backtrace => :gdb runs all test cases, identifies the crashing
+  # one (SIGSEGV from null-pointer dereference), writes a gdb log file, and includes
+  # a log path reference in Ceedling output.
+  def crash_gdb_sigsegv_all_test_cases
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
-        FileUtils.cp test_asset_path("test_example_file_crash.c"), 'test/'
+        FileUtils.cp test_asset_path("test_example_file_crash_sigsegv.c"), 'test/'
 
         @c.merge_project_yml_for_test({:project => { :use_backtrace => :gdb }})
 
-        output = `bundle exec ruby -S ceedling test:all 2>&1`
-        expect($?.exitstatus).to match(1) # Test should fail because of crash
+        output = @c.ceedling_build_exec("test:all")
+        expect(@c.last_exit_status).to eq(1) # Test should fail because of crash
         expect(output).to match(/Test Case Crashed/i)
-        expect(output).to match(/Unit test failures./)
-        expect(File.exist?('./build/test/results/test_example_file_crash.fail'))
-        output_rd = File.read('./build/test/results/test_example_file_crash.fail')
-        expect(output_rd =~ /test_add_numbers_will_fail \(\) at test\/test_example_file_crash.c\:14/ )
+        expect(output).to match(/Unit test failures/)
+        expect(File.exist?('./build/test/results/test_example_file_crash_sigsegv.fail'))
+        output_rd = File.read('./build/test/results/test_example_file_crash_sigsegv.fail')
+        expect(output_rd).to match(/Test case crashed/)
+        expect(output_rd).to match(/SIGSEGV/i)
         expect(output).to match(/TESTED:\s+2/)
         expect(output).to match(/PASSED:\s+(?:0|1)/)
         expect(output).to match(/FAILED:\s+(?:1|2)/)
         expect(output).to match(/IGNORED:\s+0/)
+        log_path = './build/logs/test/test_example_file_crash_sigsegv/test_add_numbers_will_fail.gdb.log'
+        expect(File.exist?(log_path)).to be(true)
+        expect(File.read(log_path)).to match(/SIGSEGV|Segmentation fault/i)
+        expect(output).to match(/test_add_numbers_will_fail\.gdb\.log/)
       end
     end
   end
 
-  def execute_and_collect_debug_logs_from_crashing_test_case_defined_by_test_case_argument_with_enabled_debug
+  # Validates that :use_backtrace => :gdb respects --test_case filter, running only
+  # the named crashing test case (SIGSEGV) and writing a gdb log for it.
+  def crash_gdb_sigsegv_targets_test_case_filter
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
-        FileUtils.cp test_asset_path("test_example_file_crash.c"), 'test/'
+        FileUtils.cp test_asset_path("test_example_file_crash_sigsegv.c"), 'test/'
 
         @c.merge_project_yml_for_test({:project => { :use_backtrace => :gdb }})
 
-        output = `bundle exec ruby -S ceedling test:all --test_case=test_add_numbers_will_fail 2>&1`
-        expect($?.exitstatus).to match(1) # Test should fail because of crash
+        output = @c.ceedling_build_exec("test:all --test_case=test_add_numbers_will_fail")
+        expect(@c.last_exit_status).to eq(1) # Test should fail because of crash
         expect(output).to match(/Test Case Crashed/i)
-        expect(output).to match(/Unit test failures./)
-        expect(File.exist?('./build/test/results/test_example_file_crash.fail'))
-        output_rd = File.read('./build/test/results/test_example_file_crash.fail')
-        expect(output_rd =~ /test_add_numbers_will_fail \(\) at test\/test_example_file_crash.c\:14/ )
+        expect(output).to match(/Unit test failures/)
+        expect(File.exist?('./build/test/results/test_example_file_crash_sigsegv.fail'))
+        output_rd = File.read('./build/test/results/test_example_file_crash_sigsegv.fail')
+        expect(output_rd).to match(/Test case crashed/)
+        expect(output_rd).to match(/SIGSEGV/i)
         expect(output).to match(/TESTED:\s+1/)
         expect(output).to match(/PASSED:\s+(?:0|1)/)
         expect(output).to match(/FAILED:\s+(?:1|2)/)
         expect(output).to match(/IGNORED:\s+0/)
+        log_path = './build/logs/test/test_example_file_crash_sigsegv/test_add_numbers_will_fail.gdb.log'
+        expect(File.exist?(log_path)).to be(true)
+        expect(File.read(log_path)).to match(/SIGSEGV|Segmentation fault/i)
+        expect(output).to match(/test_add_numbers_will_fail\.gdb\.log/)
       end
     end
   end
 
-  def execute_and_collect_debug_logs_from_crashing_test_case_defined_by_exclude_test_case_argument_with_enabled_debug
+  # Validates that :use_backtrace => :gdb respects --exclude_test_case filter, running
+  # only the crashing test case (SIGSEGV) after the passing one is excluded, and writing a gdb log.
+  def crash_gdb_sigsegv_excludes_test_case_filter
     @c.with_context do
       Dir.chdir @proj_name do
         FileUtils.cp test_asset_path("example_file.h"), 'src/'
         FileUtils.cp test_asset_path("example_file.c"), 'src/'
-        FileUtils.cp test_asset_path("test_example_file_crash.c"), 'test/'
+        FileUtils.cp test_asset_path("test_example_file_crash_sigsegv.c"), 'test/'
 
         @c.merge_project_yml_for_test({:project => { :use_backtrace => :gdb }})
 
-        output = `bundle exec ruby -S ceedling test:all --exclude_test_case=add_numbers_adds_numbers 2>&1`
-        expect($?.exitstatus).to match(1) # Test should fail because of crash
+        output = @c.ceedling_build_exec("test:all --exclude_test_case=add_numbers_adds_numbers")
+        expect(@c.last_exit_status).to eq(1) # Test should fail because of crash
         expect(output).to match(/Test Case Crashed/i)
-        expect(output).to match(/Unit test failures./)
-        expect(File.exist?('./build/test/results/test_example_file_crash.fail'))
-        output_rd = File.read('./build/test/results/test_example_file_crash.fail')
-        expect(output_rd =~ /test_add_numbers_will_fail \(\) at test\/test_example_file_crash.c\:14/ )
+        expect(output).to match(/Unit test failures/)
+        expect(File.exist?('./build/test/results/test_example_file_crash_sigsegv.fail'))
+        output_rd = File.read('./build/test/results/test_example_file_crash_sigsegv.fail')
+        expect(output_rd).to match(/Test case crashed/)
+        expect(output_rd).to match(/SIGSEGV/i)
         expect(output).to match(/TESTED:\s+1/)
         expect(output).to match(/PASSED:\s+(?:0|1)/)
         expect(output).to match(/FAILED:\s+(?:1|2)/)
         expect(output).to match(/IGNORED:\s+0/)
+        log_path = './build/logs/test/test_example_file_crash_sigsegv/test_add_numbers_will_fail.gdb.log'
+        expect(File.exist?(log_path)).to be(true)
+        expect(File.read(log_path)).to match(/SIGSEGV|Segmentation fault/i)
+        expect(output).to match(/test_add_numbers_will_fail\.gdb\.log/)
+      end
+    end
+  end
+
+  # Validates that :use_backtrace => :gdb handles a SIGABRT crash from assert(0),
+  # surfacing the assertion expression (not bare "Aborted") in the crash summary,
+  # writing a gdb log containing the raw gdb output, and including a log path reference
+  # in Ceedling output. This is the core gdb-mode regression test for issue #1038.
+  def crash_gdb_sigabrt_assert_failure
+    @c.with_context do
+      Dir.chdir @proj_name do
+        FileUtils.cp test_asset_path("example_file.h"), 'src/'
+        FileUtils.cp test_asset_path("example_file.c"), 'src/'
+        FileUtils.cp test_asset_path("test_example_file_crash_assert.c"), 'test/'
+
+        @c.merge_project_yml_for_test({:project => { :use_backtrace => :gdb }})
+
+        output = @c.ceedling_build_exec("test:all")
+        expect(@c.last_exit_status).to eq(1)
+        expect(output).to match(/Test Case Crashed/i)
+        expect(output).to match(/Unit test failures/)
+        expect(output).to match(/SIGABRT/i)
+        expect(output).to match(/Assertion/i)
+        log_path = './build/logs/test/test_example_file_crash_assert/test_add_numbers_triggers_assert.gdb.log'
+        expect(File.exist?(log_path)).to be(true)
+        # Windwos gdb output for an assertion failure can be quite different from Linux.
+        # Windows gdb reports do not seem to cite the signal "SIGABRT" and may be quite brief, 
+        # only citing an assertion failure.
+        expect(File.read(log_path)).to match(/SIGABRT|abort|assert/i)
+        expect(output).to match(/test_add_numbers_triggers_assert\.gdb\.log/)
+        expect(output).to match(/TESTED:\s+2/)
+        expect(output).to match(/FAILED:\s+(?:1|2)/)
+        expect(output).to match(/IGNORED:\s+0/)
+      end
+    end
+  end
+
+  # Validates that :use_backtrace => :simple runs each test case individually,
+  # identifies the crashing one (SIGSEGV from null-pointer dereference), and reports
+  # it as a per-test-case failure rather than a whole-executable crash.
+  def crash_simple_sigsegv_all_test_cases
+    @c.with_context do
+      Dir.chdir @proj_name do
+        FileUtils.cp test_asset_path("example_file.h"), 'src/'
+        FileUtils.cp test_asset_path("example_file.c"), 'src/'
+        FileUtils.cp test_asset_path("test_example_file_crash_sigsegv.c"), 'test/'
+
+        @c.merge_project_yml_for_test({:project => { :use_backtrace => :simple }})
+
+        output = @c.ceedling_build_exec("test:all")
+        expect(@c.last_exit_status).to eq(1)
+        expect(output).to match(/Test Case Crashed/i)
+        expect(output).to match(/Unit test failures/)
+        expect(output).to match(/TESTED:\s+2/)
+        expect(output).to match(/FAILED:\s+(?:1|2)/)
+        expect(output).to match(/IGNORED:\s+0/)
+      end
+    end
+  end
+
+  # Validates that :use_backtrace => :simple captures the glibc assertion message written
+  # to stderr before SIGABRT and includes it in the Ceedling crash report output.
+  # This is the core simple-mode regression test for issue #1038.
+  def crash_simple_sigabrt_assert_failure
+    @c.with_context do
+      Dir.chdir @proj_name do
+        FileUtils.cp test_asset_path("example_file.h"), 'src/'
+        FileUtils.cp test_asset_path("example_file.c"), 'src/'
+        FileUtils.cp test_asset_path("test_example_file_crash_assert.c"), 'test/'
+
+        @c.merge_project_yml_for_test({:project => { :use_backtrace => :simple }})
+
+        output = @c.ceedling_build_exec("test:all")
+        expect(@c.last_exit_status).to eq(1)
+        expect(output).to match(/Test Case Crashed/i)
+        expect(output).to match(/Unit test failures/)
+        # glibc assertion diagnostic written to stderr must appear in Ceedling output
+        expect(output).to match(/Assertion.*failed/i)
+        expect(output).to match(/TESTED:\s+2/)
+        expect(output).to match(/FAILED:\s+(?:1|2)/)
+        expect(output).to match(/IGNORED:\s+0/)
+      end
+    end
+  end
+
+  def project_with_test_file_directly_including_source_file
+    @c.with_context do
+      Dir.chdir @proj_name do
+        FileUtils.cp test_asset_path("example_file_with_statics.c"), 'src/'
+        FileUtils.cp test_asset_path("test_example_file_source_include.c"), 'test/'
+
+        output = @c.ceedling_build_exec
+        expect(@c.last_exit_status).to eq(0)
+        expect(output).to match(/TESTED:\s+\d/)
+        expect(output).to match(/PASSED:\s+\d/)
+        expect(output).to match(/FAILED:\s+\d/)
+        expect(output).to match(/IGNORED:\s+\d/)
       end
     end
   end
 
-  def can_test_projects_with_success_when_space_appears_between_hash_and_include
+  def space_between_hash_and_include_is_valid
     # test case cover issue described in https://github.com/ThrowTheSwitch/Ceedling/issues/588
     @c.with_context do
       Dir.chdir @proj_name do
@@ -982,8 +933,8 @@ module CeedlingTestCases
 
         File.write(File.join('test','test_example_file_success.c'), updated_test_file.join("\n"), mode: 'w')
 
-        output = `bundle exec ruby -S ceedling 2>&1`
-        expect($?.exitstatus).to match(0) # Since a test either pass or are ignored, we return success here
+        output = @c.ceedling_build_exec
+        expect(@c.last_exit_status).to eq(0) # Since a test either pass or are ignored, we return success here
         expect(output).to match(/TESTED:\s+\d/)
         expect(output).to match(/PASSED:\s+\d/)
         expect(output).to match(/FAILED:\s+\d/)