ceedling 1.1.0 → 1.1.1

data/site-local/testing-guide/partials/directives.html

@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4673,7 +4673,7 @@ error.</p>
       <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
+      <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
       
     
   </body>

data/site-local/testing-guide/partials/example.html

@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4441,7 +4441,7 @@ usage scenarios.</p>
       <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
+      <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
       
     
   </body>

data/site-local/testing-guide/partials/index.html

@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4028,24 +4028,26 @@
 <p>A <em>Partial</em> is your C code sliced and diced to expose elements for testing 
 that you could not otherwise access without rewriting your source code. 
 Think of Partials as a unit testing scalpel.</p>
-<p>Partials are useful when a module under test contains:</p>
+<p>Partials are useful when you need to test:</p>
 <ul>
-<li><strong><code>static</code> or <code>inline</code> functions</strong> — These become accessible within 
-  your test code.</li>
+<li><strong><code>static</code> or <code>inline</code> functions</strong> — These become accessible to 
+  your test code without modifying your source.</li>
 <li><strong>File-scoped <code>static</code> variables</strong> — The <code>static</code> keyword is stripped, 
-  and the variable is automatically made <code>extern</code> for easy access within 
-  your test code.</li>
+  and the variable is automatically made <code>extern</code> for your test code 
+  with no changes to the source under test.</li>
 <li><strong>Function-scoped <code>static</code> variables</strong> — These are promoted from
   function scope to module scope so they can be accessed in your
-  test code. Apart from necessary renaming, this works identically to
-  file-scoped <code>static</code> variables.</li>
+  test code just like file-scoped <code>static</code> variables.</li>
+<li><strong>Same-module mocked functions</strong> — You can mix and match tested and 
+  mocked functions from the same source module. Partials allow mocking 
+  functions inside a module that are called by other functions inside 
+  the same module.</li>
 </ul>
-<div class="admonition warning">
-<p class="admonition-title">Limitations of Partials</p>
-<p>Partials are new to Ceedling with 1.1.0. Carving up C code is tricky
-business. Complex code <em>may</em> break Ceedling’s lexing or its assumptions 
-on symbol ordering. Some issues may be <a href="../../help.html">bugs to be reported</a> 
-while others may be complexities that Partials are simply unable to resolve.</p>
+<div class="admonition tip">
+<p class="admonition-title">Tip</p>
+<p>See the <a href="../../getting-started/example-projects/wondrous-forest.html"><code>wondrous_forest</code></a> 
+example available within Ceedling for a working example project 
+demonstrating Partials in action.</p>
 </div>
 <hr />
 <div class="grid cards">
@@ -4089,6 +4091,13 @@ via Partials.</p>
 </li>
 </ul>
 </div>
+<div class="admonition warning">
+<p class="admonition-title">Limitations of Partials</p>
+<p>Partials are new to Ceedling with 1.1.0. Carving up C code is tricky
+business. Complex code <em>may</em> break Ceedling’s lexing or certain assumptions.
+Some issues may be <a href="../../help.html">bugs to be reported</a> while others may 
+be complexities that Partials are simply unable to resolve.</p>
+</div>
 <p><br/><br/></p>
 
 
@@ -4160,7 +4169,7 @@ via Partials.</p>
       <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
+      <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
       
     
   </body>

data/site-local/testing-guide/partials/overview.html

@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4315,7 +4315,7 @@ incorporate them into your tests except with the accompanying macros.</p>
       <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
+      <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
       
     
   </body>

data/site-local/testing-guide/partials/variables.html

@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4541,7 +4541,7 @@ in the source file).</p>
       <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
+      <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
       
     
   </body>

data/site-local/testing-guide/test-cases.html

@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.484c7ddc.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4429,7 +4429,7 @@ and details on how everything fits together.</p>
       <script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.79ae519e.min.js"></script>
+      <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
       
     
   </body>

data/site-local/testing-guide/test-sample.html

@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.484c7ddc.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4258,7 +4258,7 @@ to be reported to the developer at the command line.</p>
       <script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.79ae519e.min.js"></script>
+      <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
       
     
   </body>

data/site-local/testing-guide/test-suite-anatomy.html

@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.484c7ddc.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4242,7 +4242,7 @@ executables and tallying all the test results.</p>
       <script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.79ae519e.min.js"></script>
+      <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
       
     
   </body>

data/spec/support/system/system_context.rb

@@ -48,7 +48,9 @@ class SystemContext
       begin
         %w{BUNDLE_GEMFILE BUNDLE_BIN_PATH RUBYOPT}.each { |k| ENV.delete(k) }
         deploy_output  = `bundle config set --local path '#{shared_gem.install_dir}' 2>&1`
-        deploy_output += `bundle install 2>&1`
+        # --prefer-local: Without it, Bundler resolves gems (e.g. `erb`) fresh from
+        # rubygems repository even when Ruby's default-gem copy satisfies the Gemfile constraint.
+        deploy_output += `bundle install --prefer-local 2>&1`
         raise VerificationFailed, "bundle install failed:\n#{deploy_output}" unless $?.success?
 
         verify = `bundle exec ruby -S ceedling version 2>&1`

data/spec/system/support/gcov_common_test_cases.rb

@@ -246,11 +246,14 @@ module GcovCommonTestCases
           }
         })
 
-        output = `bundle exec ruby -S ceedling gcov:all 2>&1`
+        output = `bundle exec ruby -S ceedling gcov:all --verbosity=obnoxious 2>&1`
         if @gcov_reports.include? :gcovr
           # Config file honored (fix applied): strict mode exits non-zero on duplicate functions.
           # Config file overridden by Ceedling CLI (bug): merge-use-line-max exits 0.
           expect($?.exitstatus).not_to eq(0)
+
+          # No `--exclude` should appear on the gcovr command line when a config file is in use.
+          expect(output).not_to match(/--exclude/)
         end
       end
     end

data/spec/units/preprocess/preprocessinator_file_assembler_spec.rb

@@ -260,4 +260,159 @@ RSpec.describe PreprocessinatorFileAssembler do
 
   end
 
+
+  # ===========================================================================
+  describe '#collect_mockable_header_file_contents' do
+  # ===========================================================================
+
+    let(:test) { 'test_module' }
+    let(:filepath) { '/src/module.h' }
+    let(:directives_only_filepath) { '/build/directives/module.h' }
+    let(:preprocessed_filepath) { '/build/full_expansion/module.h' }
+    let(:flags) { [] }
+    let(:defines) { [] }
+    let(:include_paths) { [] }
+
+    before :each do
+      allow(@file_path_utils).to receive(:form_preprocessed_file_full_expansion_filepath)
+        .with(filepath, test).and_return(preprocessed_filepath)
+      allow(@configurator).to receive(:tools_test_file_full_preprocessor).and_return(:full_preprocessor)
+      allow(@tool_executor).to receive(:build_command_line).and_return('gcc -E ...')
+      allow(@tool_executor).to receive(:exec)
+      stub_file_open(preprocessed_filepath, "# 1 \"#{filepath}\"\nint x;\n", 'r')
+    end
+
+    def call_collect_mockable(fallback:, extras:)
+      subject.collect_mockable_header_file_contents(
+        test: test,
+        filepath: filepath,
+        directives_only_filepath: directives_only_filepath,
+        fallback: fallback,
+        flags: flags,
+        defines: defines,
+        include_paths: include_paths,
+        extras: extras
+      )
+    end
+
+    context 'when extras are not requested' do
+
+      it 'returns an empty extras list and a nil include guard' do
+        _contents, extras, include_guard = call_collect_mockable(fallback: true, extras: false)
+        expect(extras).to eq([])
+        expect(include_guard).to be_nil
+      end
+
+      it 'does not read the original file to look for an include guard' do
+        expect(@file_wrapper).not_to receive(:read)
+        call_collect_mockable(fallback: true, extras: false)
+      end
+
+    end
+
+    context 'when extras are requested' do
+
+      let(:header_with_guard) do
+        <<~C
+          #ifndef FOO_H
+          #define FOO_H
+
+          void foo(void);
+
+          #endif
+        C
+      end
+
+      it 'extracts the include guard from the original file in fallback mode' do
+        allow(@file_wrapper).to receive(:read).with(filepath, 2048).and_return(header_with_guard)
+        stub_file_open(filepath, header_with_guard, 'rb')
+
+        _contents, _extras, include_guard = call_collect_mockable(fallback: true, extras: true)
+        expect(include_guard).to eq('FOO_H')
+      end
+
+      it 'extracts the include guard from the original file in directives-only mode' do
+        allow(@file_wrapper).to receive(:read).with(filepath, 2048).and_return(header_with_guard)
+        stub_file_open(directives_only_filepath, header_with_guard, 'r')
+
+        _contents, _extras, include_guard = call_collect_mockable(fallback: false, extras: true)
+        expect(include_guard).to eq('FOO_H')
+      end
+
+      it 'returns a nil include guard when the original file has no #ifndef/#define guard pair' do
+        header_without_guard = "#pragma once\n\nvoid foo(void);\n"
+        allow(@file_wrapper).to receive(:read).with(filepath, 2048).and_return(header_without_guard)
+        stub_file_open(filepath, header_without_guard, 'rb')
+
+        _contents, _extras, include_guard = call_collect_mockable(fallback: true, extras: true)
+        expect(include_guard).to be_nil
+      end
+
+    end
+
+  end
+
+
+  # ===========================================================================
+  describe '#assemble_preprocessed_header_file' do
+  # ===========================================================================
+
+    let(:preprocessed_filepath) { '/build/mocks/test_module/module.h' }
+
+    def stub_file_write(filepath)
+      output = StringIO.new
+      allow(@file_wrapper).to receive(:open).with(filepath, 'w').and_yield(output)
+      output
+    end
+
+    it 'writes the given include guard name as the #ifndef/#define/#endif guard' do
+      output = stub_file_write(preprocessed_filepath)
+
+      subject.assemble_preprocessed_header_file(
+        filename:              'module.h',
+        preprocessed_filepath: preprocessed_filepath,
+        contents:              ['void foo(void);'],
+        extras:                [],
+        includes:              [],
+        include_guard:         'FOO_H'
+      )
+
+      expect(output.string).to include("#ifndef FOO_H\n")
+      expect(output.string).to include("#define FOO_H\n")
+      expect(output.string).to include('#endif // FOO_H')
+    end
+
+    it 'derives a synthetic include guard from the filename when none is given' do
+      output = stub_file_write(preprocessed_filepath)
+
+      subject.assemble_preprocessed_header_file(
+        filename:              'module.h',
+        preprocessed_filepath: preprocessed_filepath,
+        contents:              ['void foo(void);'],
+        extras:                [],
+        includes:              []
+      )
+
+      expect(output.string).to include("#ifndef __CEEDLING_GENERATED_MODULE_H__\n")
+      expect(output.string).to include("#define __CEEDLING_GENERATED_MODULE_H__\n")
+    end
+
+    it 'writes provided includes and contents between the guard lines' do
+      output = stub_file_write(preprocessed_filepath)
+
+      subject.assemble_preprocessed_header_file(
+        filename:              'module.h',
+        preprocessed_filepath: preprocessed_filepath,
+        contents:              ['void foo(void);'],
+        extras:                [],
+        includes:              ['#include "bar.h"'],
+        include_guard:         'FOO_H'
+      )
+
+      expect(output.string).to include('#include "bar.h"')
+      expect(output.string).to include('void foo(void);')
+    end
+
+  end
+
 end

data/spec/units/test_build_executor_spec.rb

@@ -0,0 +1,114 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+require 'spec_helper'
+require 'ceedling/test_invoker/test_build_executor'
+require 'ceedling/test_invoker/test_invoker_types'
+
+PROJECT_BUILD_VENDOR_UNITY_PATH = 'build/vendor/unity' unless defined?(PROJECT_BUILD_VENDOR_UNITY_PATH)
+UNITY_C_FILE = 'unity.c' unless defined?(UNITY_C_FILE)
+
+describe TestBuildExecutor do
+  before(:each) do
+    @configurator            = double( "Configurator" )
+    @loginator                = double( "Loginator" )
+    @reportinator               = double( "Reportinator" )
+    @batchinator                  = double( "Batchinator" )
+    @preprocessinator                = double( "Preprocessinator" )
+    @partializer                       = double( "Partializer" )
+    @generator                           = double( "Generator" )
+    @test_context_extractor                 = double( "TestContextExtractor" )
+    @plugin_manager                            = double( "PluginManager" )
+    @file_path_utils                              = double( "FilePathUtils" )
+    @file_finder                                     = double( "FileFinder" )
+    @file_wrapper                                       = double( "FileWrapper" )
+
+    @tools_test_compiler  = { name: 'fake compiler' }
+    @tools_test_assembler = { name: 'fake assembler' }
+
+    allow(@configurator).to receive(:extension_assembly).and_return( '.asm' )
+    allow(@configurator).to receive(:tools_test_compiler).and_return( @tools_test_compiler )
+    allow(@configurator).to receive(:tools_test_assembler).and_return( @tools_test_assembler )
+    allow(@configurator).to receive(:project_use_mocks).and_return( false )
+    allow(@configurator).to receive(:project_use_exceptions).and_return( false )
+    allow(@configurator).to receive(:collection_all_support).and_return( [] )
+
+    allow(@file_path_utils).to receive(:form_test_build_list_filepath).and_return( 'build/list' )
+    allow(@file_path_utils).to receive(:form_test_dependencies_filepath).and_return( 'build/deps' )
+
+    @executor = described_class.new(
+      {
+        :configurator            => @configurator,
+        :loginator               => @loginator,
+        :reportinator            => @reportinator,
+        :batchinator             => @batchinator,
+        :preprocessinator        => @preprocessinator,
+        :partializer             => @partializer,
+        :generator               => @generator,
+        :test_context_extractor  => @test_context_extractor,
+        :plugin_manager          => @plugin_manager,
+        :file_path_utils         => @file_path_utils,
+        :file_finder             => @file_finder,
+        :file_wrapper            => @file_wrapper
+      }
+    )
+
+    testable = TestInvokerTypes::Testable.new(
+      :compile_defines  => [],
+      :search_paths     => [],
+      :compile_flags    => [],
+      :assembler_flags  => []
+    )
+
+    @state = TestInvokerTypes::PipelineState.new( :testables => { :a_test => testable } )
+  end
+
+  context "#compile_test_component" do
+    it "compiles a C source file with the configured test compiler tool" do
+      allow(@file_wrapper).to receive(:extname).with( 'src/foo.c' ).and_return( '.c' )
+      allow(@configurator).to receive(:test_build_use_assembly).and_return( false )
+
+      expect(@generator).to receive(:generate_object_file_c) do |**args|
+        expect( args[:tool] ).to eq( @tools_test_compiler )
+      end
+      expect(@generator).to_not receive(:generate_object_file_asm)
+
+      @executor.send(
+        :compile_test_component,
+        :context => :test, :test => :a_test, :source => 'src/foo.c', :object => 'build/foo.o', :state => @state
+      )
+    end
+
+    it "assembles an assembly source file with the configured test assembler tool when assembly support is enabled" do
+      allow(@file_wrapper).to receive(:extname).with( 'src/foo.asm' ).and_return( '.asm' )
+      allow(@configurator).to receive(:test_build_use_assembly).and_return( true )
+
+      expect(@generator).to receive(:generate_object_file_asm) do |**args|
+        expect( args[:tool] ).to eq( @tools_test_assembler )
+      end
+      expect(@generator).to_not receive(:generate_object_file_c)
+
+      @executor.send(
+        :compile_test_component,
+        :context => :test, :test => :a_test, :source => 'src/foo.asm', :object => 'build/foo.o', :state => @state
+      )
+    end
+
+    it "does not compile an assembly source file when assembly support is disabled" do
+      allow(@file_wrapper).to receive(:extname).with( 'src/foo.asm' ).and_return( '.asm' )
+      allow(@configurator).to receive(:test_build_use_assembly).and_return( false )
+
+      expect(@generator).to_not receive(:generate_object_file_c)
+      expect(@generator).to_not receive(:generate_object_file_asm)
+
+      @executor.send(
+        :compile_test_component,
+        :context => :test, :test => :a_test, :source => 'src/foo.asm', :object => 'build/foo.o', :state => @state
+      )
+    end
+  end
+end