ceedling 1.0.0 → 1.1.0

data/plugins/report_tests_log_factory/lib/report_tests_log_factory.rb

@@ -1,18 +1,22 @@
 # =========================================================================
 #   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 'ceedling/plugin'
+require 'ceedling/plugins/plugin'
 
 class ReportTestsLogFactory < Plugin
-  
+
+  DEFAULT_REPORT_NAME = "Ceedling Test Suite"
+
+  TestBuild = Struct.new( :results_filepaths, :start_time_s, :end_time_s )
+
   # `Plugin` setup()
   def setup
-    # Hash: Context => Array of test executable results files
-    @results = {}
+    # Hash: Context symbol => TestBuild struct
+    @build_results = {}
     
     # Get our test suite reports' configuration
     config = @ceedling[:setupinator].config_hash
@@ -33,6 +37,13 @@ class ReportTestsLogFactory < Plugin
     @reportinator = @ceedling[:reportinator]
   end
 
+  def pre_test_build(context, timestamp_s)
+    return if not @enabled
+
+    # Initialize a TestBuild entry for this test context
+    @build_results[context] = TestBuild.new( [], timestamp_s, nil )
+  end
+
   # `Plugin` build step hook -- collect context:results_filepath after test fixture runs
   def post_test_fixture_execute(arg_hash)
     # Do nothing if no reports configured
@@ -42,48 +53,56 @@ class ReportTestsLogFactory < Plugin
     context = arg_hash[:context]
 
     @mutex.synchronize do
-      # Create an empty array if context does not already exist as a key
-      @results[context] = [] if @results[context].nil?
-
-      # Add results filepath to array at context key
-      @results[context] << arg_hash[:result_file]
+      # Create a TestBuild entry if pre_test_build did not fire for this context.
+      # `ceedling summary` will not fire pre_test_build.
+      @build_results[context] ||= TestBuild.new( [], nil, nil )
+      @build_results[context].results_filepaths << arg_hash[:result_file]
     end
   end
 
-  # `Plugin` build step hook -- process results into log files after test build completes
-  def post_build
-    # Do nothing if no reports configured
+  def post_test_build(context, timestamp_s)
     return if not @enabled
 
-    empty = false
-
-    @mutex.synchronize { empty = @results.empty? }
+    @mutex.synchronize do
+      @build_results[context].end_time_s = timestamp_s if @build_results[context]
+    end
+  end
 
-    # Do nothing if no results were generated (e.g. not a test build)
-    return if empty
+  # `Plugin` build step hook -- process results into log files after test build completes
+  def post_build(_timestamp_s)
+    # Do nothing if no reports configured or no results collected (e.g. not a test build)
+    return if not @enabled
+    return if @build_results.empty?
 
     msg = @reportinator.generate_heading( "Running Test Suite Reports" )
     @loginator.log( msg )
 
-    @mutex.synchronize do
-      # For each configured reporter, generate a test suite report per test context
-      @results.each do |context, results_filepaths|
-        # Assemble results from all results filepaths collected
-        _results = @ceedling[:plugin_reportinator].assemble_test_results( results_filepaths )
-
-        # Provide results to each Reporter
-        @reporters.each do |reporter|
-          filepath = File.join( PROJECT_BUILD_ARTIFACTS_ROOT, context.to_s, reporter.filename )
-
-          msg = @reportinator.generate_progress( "Generating artifact #{filepath}" )
-          @loginator.log( msg )
-
-          reporter.write( filepath: filepath, results: _results )
-        end
+    # For each configured reporter, generate a test suite report per test context
+    @build_results.each do |context, test_build|
+      # Assemble results from all results filepaths collected
+      _results = @ceedling[:plugin_reportinator].assemble_test_results( test_build.results_filepaths )
+
+      # Provide results to each Reporter
+      @reporters.each do |reporter|
+        filepath = File.join( PROJECT_BUILD_ARTIFACTS_ROOT, context.to_s, reporter.filename )
+        name = generate_report_name( context )
+
+        msg = @reportinator.generate_progress( "Generating artifact #{filepath}" )
+        @loginator.log( msg )
+
+        start_s    = test_build.start_time_s
+        end_s      = test_build.end_time_s
+        duration_s = (start_s && end_s) ? (end_s - start_s) : nil
+        reporter.write(
+          name: name,
+          filepath: filepath,
+          results: _results,
+          duration_s: duration_s
+        )
       end
     end
 
-  # White space at command line after progress messages
+  # White space at command line after all progress messages
   @loginator.log( '' )
   end
 
@@ -91,6 +110,23 @@ class ReportTestsLogFactory < Plugin
 
   private
 
+  def generate_report_name(context)
+      # Resolve and inject the display name used in report titles/headers.
+
+      # Start with project name from configuration
+      _name = @ceedling[:configurator].project_name.to_s.strip
+
+      # Default to a generic name if project name is empty
+      name = _name.empty? ? DEFAULT_REPORT_NAME : _name
+
+      # Prepend name with context if not the default test context (TEST_SYM)
+      if context != TEST_SYM
+        name = "[#{context.to_s.upcase}] #{name}"
+      end
+
+      return name
+  end
+
   def load_reporters(reports, config)
     reporters = []
 
@@ -117,8 +153,8 @@ class ReportTestsLogFactory < Plugin
       reporter = eval( "#{_reporter}.new(handle: :#{report})" )
 
       # Inject configuration
-      reporter.config = config[report.to_sym] 
-      
+      reporter.config = config[report.to_sym]
+
       # Inject utilty object
       reporter.config_walkinator = @ceedling[:config_walkinator]
 

data/plugins/report_tests_log_factory/lib/tests_reporter.rb

@@ -1,7 +1,7 @@
 # =========================================================================
 #   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
 # =========================================================================
 
@@ -31,23 +31,23 @@ class TestsReporter
   end
 
   # Write report contents to file
-  def write(filepath:, results:)
+  def write(name:, filepath:, results:, duration_s:nil)
     File.open( filepath, 'w' ) do |f|
-      header( results: results, stream: f )
-      body( results: results, stream: f )
-      footer( results: results, stream: f )
+      header( stream: f, name: name, results: results, duration_s: duration_s )
+      body( stream: f, name: name, results: results, duration_s: duration_s )
+      footer( stream: f, name: name, results: results, duration_s: duration_s )
     end
   end
 
-  def header(results:, stream:)
+  def header(stream:, name:, results:, duration_s:)
     # Override in subclass to do something
   end
 
-  def body(results:, stream:)
+  def body(stream:, name:, results:, duration_s:)
     # Override in subclass to do something
   end
 
-  def footer(results:, stream:)
+  def footer(stream:, name:, results:, duration_s:)
     # Override in subclass to do something
   end
 

data/plugins/report_tests_pretty_stdout/assets/template.erb

@@ -1,7 +1,7 @@
 % ignored        = hash[:results][:counts][:ignored]
 % failed         = hash[:results][:counts][:failed]
 % stdout_count   = hash[:results][:counts][:stdout]
-% header_prepend = ((hash[:header].length > 0) ? "#{hash[:header]}: " : '')
+% header_prepend = ((hash[:context] != TEST_SYM) ? "#{hash[:context].to_s.upcase}: " : '')
 % banner_width   = 25 + header_prepend.length # widest message
 
 % if (stdout_count > 0)
@@ -60,4 +60,3 @@ IGNORED: <%=sprintf(format_string, ignored)%>
 
 No tests executed.
 % end
-

data/plugins/report_tests_pretty_stdout/config/report_tests_pretty_stdout.yml

@@ -1,7 +1,7 @@
 # =========================================================================
 #   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
 # =========================================================================
 

data/plugins/report_tests_pretty_stdout/lib/report_tests_pretty_stdout.rb

@@ -1,73 +1,12 @@
 # =========================================================================
 #   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 'ceedling/plugin'
-require 'ceedling/defaults'
-
-class ReportTestsPrettyStdout < Plugin
-
-  # `Plugin` setup()
-  def setup
-    @result_list = []
-    @mutex = Mutex.new
-    
-    # Fetch the test results template for this plugin
-    template = @ceedling[:file_wrapper].read( File.join( @plugin_root_path, 'assets/template.erb' ) )
-
-    # Set the report template
-    @ceedling[:plugin_reportinator].register_test_results_template( template )
-  end
-  
-  # `Plugin` build step hook -- collect result file paths after each test fixture execution
-  def post_test_fixture_execute(arg_hash)
-    # Thread-safe manipulation since test fixtures can be run in child processes
-    # spawned within multiple test execution threads.
-    @mutex.synchronize do
-      @result_list << arg_hash[:result_file]
-    end
-  end
-  
-  # `Plugin` build step hook -- render a report immediately upon build completion (that invoked tests)
-  def post_build()
-    # Ensure a test task was invoked as part of the build
-    return if not (@ceedling[:task_invoker].test_invoked?)
-
-    results = @ceedling[:plugin_reportinator].assemble_test_results( @result_list )
-    hash = {
-      :header => '',
-      :results => results
-    }
-
-    @ceedling[:plugin_reportinator].run_test_results_report(hash) do
-      message = ''
-      message = 'Unit test failures.' if (results[:counts][:failed] > 0)
-      message
-    end
-  end
-
-  # `Plugin` build step hook -- render a test results report on demand using results from a previous build
-  def summary()
-    # Build up the list of passing results from all tests
-    result_list = @ceedling[:file_path_utils].form_pass_results_filelist(
-      PROJECT_TEST_RESULTS_PATH,
-      COLLECTION_ALL_TESTS
-    )
-
-    hash = {
-      :header => '',
-      # Collect all existing test results (success or failing) in the filesystem,
-      # limited to our test collection
-      :results => @ceedling[:plugin_reportinator].assemble_test_results(
-        result_list,
-        {:boom => false}
-      )
-    }
-
-    @ceedling[:plugin_reportinator].run_test_results_report( hash )
-  end
+require 'report_tests_stdout_plugin'
 
+class ReportTestsPrettyStdout < ReportTestsStdoutPlugin
+  # Parent class loads template from plugin assets directory
 end

data/plugins/report_tests_raw_output_log/lib/report_tests_raw_output_log.rb

@@ -1,11 +1,11 @@
 # =========================================================================
 #   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 'ceedling/plugin'
+require 'ceedling/plugins/plugin'
 require 'ceedling/constants'
 
 class ReportTestsRawOutputLog < Plugin
@@ -42,13 +42,13 @@ class ReportTestsRawOutputLog < Plugin
   end
 
   # `Plugin` build step hook
-  def post_build()
+  def post_build(_timestamp_s)
     # Write collected raw output to log(s)
     write_logs( @raw_output )
   end
 
   # `Plugin` build step hook
-  def post_error()
+  def post_error(_timestamp_s)
     # Write collected raw output to log(s)
     write_logs( @raw_output )
   end

data/plugins/report_tests_teamcity_stdout/config/defaults.yml

@@ -1,7 +1,7 @@
 # =========================================================================
 #   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
 # =========================================================================
 

data/plugins/report_tests_teamcity_stdout/config/report_tests_teamcity_stdout.yml

@@ -1,7 +1,7 @@
 # =========================================================================
 #   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
 # =========================================================================
 

data/plugins/report_tests_teamcity_stdout/lib/report_tests_teamcity_stdout.rb

@@ -1,11 +1,11 @@
 # =========================================================================
 #   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 'ceedling/plugin'
+require 'ceedling/plugins/plugin'
 require 'ceedling/defaults'
 
 class ReportTestsTeamcityStdout < Plugin

data/plugins/valgrind/config/defaults.yml

@@ -0,0 +1,19 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+---
+:valgrind:
+  # Register a build failure if valgrind reports memory errors in any test binary
+  :fail_build: TRUE
+
+  # Valgrind flags (do not include --log-file or the ${1} executable token)
+  :arguments:
+    - "--leak-check=full"
+    - "--show-leak-kinds=all"
+    - "--track-origins=yes"
+    - "--errors-for-leak-kinds=all"
+...

data/plugins/valgrind/config/defaults_valgrind.rb

@@ -0,0 +1,20 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+
+DEFAULT_VALGRIND_TOOL = {
+    :executable => FilePathUtils.os_executable_ext('valgrind').freeze,
+    :name => 'default_valgrind'.freeze,
+    :optional => false.freeze,
+    :arguments => [].freeze  # Arguments built dynamically by the plugin from :valgrind: :arguments: config
+    }
+
+def get_default_config
+    return :tools => {
+        :valgrind => DEFAULT_VALGRIND_TOOL
+    }
+end

data/plugins/valgrind/lib/valgrind.rb

@@ -0,0 +1,132 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+require 'ceedling/plugins/plugin'
+require 'fileutils'
+require 'ceedling/constants'
+require 'valgrind_constants'
+
+class Valgrind < Plugin
+
+  def setup
+    @memory_errors   = 0
+    @tests_processed = 0
+    @mutex = Mutex.new()
+
+    @result_list = []
+
+    # Validate the Valgrind tool upfront
+    @ceedling[:tool_validator].validate(
+      tool: TOOLS_VALGRIND,
+      boom: true
+    )
+
+    FileUtils.mkdir_p(VALGRIND_ARTIFACTS_PATH)
+
+    # Aliases
+    @configurator        = @ceedling[:configurator]
+    @loginator           = @ceedling[:loginator]
+    @reportinator        = @ceedling[:reportinator]
+    @rake_invocation_tracker   = @ceedling[:rake_invocation_tracker]
+    @plugin_manager      = @ceedling[:plugin_manager]
+    @plugin_reportinator = @ceedling[:plugin_reportinator]
+  end
+
+  def pre_test_fixture_execute(arg_hash)
+    return unless arg_hash[:context] == VALGRIND_SYM
+
+    @mutex.synchronize do
+      @tests_processed += 1
+    end
+
+    test_name = arg_hash[:test_name]
+    log_path  = File.join( VALGRIND_ARTIFACTS_PATH, "#{test_name}.log" )
+
+    # Replace the test fixture tool with a per-test valgrind wrapper.
+    # Arguments come from :valgrind ↳ :arguments project config.
+    # ${1} (the test executable substitution token) is always appended by the plugin,
+    # not user-visible in config.
+    valgrind_args = Array( @configurator.project_config_hash[:valgrind_arguments] )
+    arg_hash[:tool] = {
+      :executable => TOOLS_VALGRIND[:executable],
+      :name       => TOOLS_VALGRIND[:name],
+      :optional   => TOOLS_VALGRIND[:optional],
+      :arguments  => ["--log-file=\"#{log_path}\""] + valgrind_args + ["${1}"],
+    }
+
+    msg = "Running #{File.basename(arg_hash[:executable])} under Valgrind"
+    arg_hash[:msg] = @reportinator.generate_progress( msg )
+  end
+
+  def post_test_fixture_execute(arg_hash)
+    return unless arg_hash[:context] == VALGRIND_SYM
+
+    result_file = arg_hash[:result_file]
+
+    @mutex.synchronize do
+      if (result_file =~ /#{PROJECT_TEST_RESULTS_PATH}/) && !@result_list.include?(result_file)
+        @result_list << arg_hash[:result_file]
+      end
+    end
+
+    test_name = arg_hash[:test_name]
+    log_path  = File.join( VALGRIND_ARTIFACTS_PATH, "#{test_name}.log" )
+    return unless File.exist?( log_path )
+
+    log_content = File.read( log_path )
+    if (m = log_content.match( /ERROR SUMMARY:\s+(\d+) errors?/ )) && m[1].to_i > 0
+      @mutex.synchronize do
+        @memory_errors += m[1].to_i
+      end
+      msg = "Valgrind detected #{pluralize(m[1].to_i, 'memory error')} in #{test_name} ➡️ see #{log_path}"
+      @loginator.log( msg, Verbosity::ERRORS, LogLabels::ERROR )
+      log_results()
+    end
+  end
+
+  def post_build(_timestamp_s)
+    return unless @rake_invocation_tracker.invoked?( /^#{VALGRIND_ROOT_NAME}(:|$)/ )
+
+    # Only present plugin-based test results if raw test results disabled by a reporting plugin
+    if !@configurator.plugins_display_raw_test_results
+      # Assemble test results
+      results = @plugin_reportinator.assemble_test_results( @result_list )
+
+      hash = {
+        context: VALGRIND_SYM,
+        results: results
+      }
+
+      verbosity = (results[:counts][:failed] > 0) ? Verbosity::ERRORS : Verbosity::NORMAL
+
+      # Print unit test suite results
+      @plugin_reportinator.run_test_results_report( hash, verbosity )
+    end
+
+    log_results()
+    if @configurator.valgrind_fail_build && @memory_errors > 0
+      msg = "Valgrind detected #{pluralize(@memory_errors, 'memory error')} across #{pluralize(@tests_processed, 'test')}"
+      @plugin_manager.register_build_failure( VALGRIND_SYM, msg )
+    end
+  end
+
+  private
+
+  def log_results
+    @mutex.synchronize do
+      if @tests_processed > 0
+        msg = "\nWrote #{pluralize(@tests_processed, 'Valgrind report')} to #{VALGRIND_ARTIFACTS_PATH}/"
+        @loginator.log( msg, Verbosity::NORMAL, LogLabels::NOTICE )
+      end
+    end
+  end
+
+  def pluralize(count, word)
+    "#{count} #{word}#{count == 1 ? '' : 's'}"
+  end
+
+end

data/plugins/valgrind/lib/valgrind_constants.rb

@@ -0,0 +1,13 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+
+VALGRIND_ROOT_NAME              = 'valgrind'.freeze
+VALGRIND_TASK_ROOT              = VALGRIND_ROOT_NAME + ':'
+VALGRIND_SYM                    = VALGRIND_ROOT_NAME.to_sym unless defined?(VALGRIND_SYM)
+
+VALGRIND_ARTIFACTS_PATH         = File.join(PROJECT_BUILD_ARTIFACTS_ROOT, VALGRIND_ROOT_NAME)

data/plugins/valgrind/valgrind.rake

@@ -0,0 +1,87 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+##
+## This Rakefile plugin runs test executables under Valgrind via the test
+## fixture plugin hook. It calls the test invoker directly (same as gcov.rake)
+## to avoid marking test: tasks as invoked.
+##
+
+CLEAN.include(File.join(VALGRIND_ARTIFACTS_PATH, '*'))
+
+task directories: [VALGRIND_ARTIFACTS_PATH]
+
+task :valgrind => [:prepare] do
+  Rake.application['valgrind:all'].invoke
+end
+
+namespace VALGRIND_SYM do
+
+  desc "Run all unit tests under Valgrind (also just 'valgrind' works)."
+  task :all => [:prepare] do
+    @ceedling[:test_invoker].setup_and_invoke(
+      tests: COLLECTION_ALL_TESTS,
+      context: VALGRIND_SYM,
+      options: { :force_run => true, :build_only => false }.merge(TOOL_COLLECTION_TEST_TASKS)
+    )
+  end
+
+  desc "Run single Valgrind test ([*] test or source file name, no path)."
+  task :* do
+    message = "Oops! '#{VALGRIND_ROOT_NAME}:*' isn't a real task. " +
+              "Use a real test or source file name (no path) in place of the wildcard.\n" +
+              "Example: `ceedling #{VALGRIND_ROOT_NAME}:foo.c`"
+    @ceedling[:loginator].log( message, Verbosity::ERRORS )
+  end
+
+  desc "Run Valgrind tests by matching regular expression pattern."
+  task :pattern, [:regex] => [:prepare] do |_t, args|
+    matches = []
+    COLLECTION_ALL_TESTS.each { |test| matches << test if test =~ /#{args.regex}/ }
+    if !matches.empty?
+      @ceedling[:test_invoker].setup_and_invoke(
+        tests: matches,
+        context: VALGRIND_SYM,
+        options: { :force_run => false }.merge(TOOL_COLLECTION_TEST_TASKS)
+      )
+    else
+      @ceedling[:loginator].log( "Found no tests matching pattern /#{args.regex}/", Verbosity::ERRORS )
+    end
+  end
+
+  desc "Run Valgrind tests whose test path contains [dir] or [dir] substring."
+  task :path, [:dir] => [:prepare] do |_t, args|
+    matches = []
+    COLLECTION_ALL_TESTS.each { |test| matches << test if File.dirname(test).include?(args.dir.tr('\\', '/')) }
+    if !matches.empty?
+      @ceedling[:test_invoker].setup_and_invoke(
+        tests: matches,
+        context: VALGRIND_SYM,
+        options: { :force_run => false }.merge(TOOL_COLLECTION_TEST_TASKS)
+      )
+    else
+      @ceedling[:loginator].log( "Found no tests including the given path or path component", Verbosity::ERRORS )
+    end
+  end
+
+end
+
+# Use a rule to handle dynamic per-file tasks: valgrind:foo → build and run foo under Valgrind
+rule(/^#{VALGRIND_TASK_ROOT}\S+$/ => [
+  proc do |task_name|
+    test = task_name.strip().sub(/^#{VALGRIND_TASK_ROOT}/, '').chomp(EXTENSION_SOURCE)
+    test = PROJECT_TEST_FILE_PREFIX + test unless test.start_with?(PROJECT_TEST_FILE_PREFIX)
+    @ceedling[:file_finder].find_test_file_from_name(test)
+  end
+]) do |test|
+  @ceedling[:rake_wrapper][:prepare].invoke
+  @ceedling[:test_invoker].setup_and_invoke(
+    tests: [test.source],
+    context: VALGRIND_SYM,
+    options: { :force_run => true, :build_only => false }.merge(TOOL_COLLECTION_TEST_TASKS)
+  )
+end