ceedling 1.2.0 → 1.2.1

data/lib/ceedling/test_invoker/test_build_executor.rb

@@ -350,6 +350,11 @@ class TestBuildExecutor
   # (not reusing it) so a tool-only change reruns the fixture without also
   # marking the executable itself stale and forcing an unnecessary relink.
   #
+  # The command line test case filters (--test-case, --exclude_test_case) are a fourth.
+  # When :test_runner ↳ :cmdline_args is on, as any :use_backtrace other than :none makes
+  # it, a filtered and an unfiltered executable are identical, and only the filter tells
+  # one run's results from another's. See fixture_meta.
+  #
   # The target itself is a dedicated marker file, not either outcome-dependent
   # results file (.pass/.fail) -- which of those two actually gets written
   # depends on whether the test passes, so neither is guaranteed to exist after
@@ -404,7 +409,7 @@ class TestBuildExecutor
 
         @dependinator.register(
           fixture_target, files: [testable.executable],
-          meta: { tools: [fixture_tool], use_backtrace: use_backtrace, backtrace_tools: backtrace_tools }
+          meta: fixture_meta( fixture_tool: fixture_tool, use_backtrace: use_backtrace, backtrace_tools: backtrace_tools )
         )
 
         run_now = testable.executable_rebuilt || force_rerun || @dependinator.stale?( fixture_target )
@@ -466,6 +471,18 @@ class TestBuildExecutor
   # Helper methods
   # -----------------------------------------------------------------------
 
+  # What a test fixture's run depends on besides its executable. An unset filter, nil or
+  # empty, is one value, so an unfiltered run keeps a stable key.
+  def fixture_meta(fixture_tool:, use_backtrace:, backtrace_tools:)
+    return {
+      tools:             [fixture_tool],
+      use_backtrace:     use_backtrace,
+      backtrace_tools:   backtrace_tools,
+      include_test_case: @configurator.include_test_case.to_s,
+      exclude_test_case: @configurator.exclude_test_case.to_s
+    }
+  end
+
   def generate_executable(context:, build_path:, executable:, objects:, flags:, lib_args:, lib_paths:, tool:)
     begin
       @generator.generate_executable_file(

data/lib/version.rb

@@ -21,7 +21,7 @@ module Ceedling
     # Target version for the current release cycle. Maintained by hand, one edit
     # per minor or major cycle. Never edited to match a release tag. The release
     # pipeline rewrites this line from the tag that triggered it.
-    BASE = '1.2.0'
+    BASE = '1.2.1'
 
     # Marker for a build the release pipeline did not produce. That pipeline
     # empties this line, so a published gem reports a bare version while a local

data/plugins/bullseye/bullseye.rake

@@ -38,11 +38,12 @@ namespace BULLSEYE_SYM do
     @ceedling[:bullseye].process_untested_sources( sources:COLLECTION_ALL_SOURCE )
   end
 
-  desc 'Run single test w/ coverage ([*] test or source file name, no path).'
+  desc 'Run single test w/ coverage ([*] test or source file name, with optional path).'
   task :* do
     message = "Oops! '#{BULLSEYE_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 #{BULLSEYE_ROOT_NAME}:foo.c`"
+              "Use a real test or source file name in place of the wildcard, " \
+              "adding as much of its path as needed to identify one file among any same-named tests.\n" \
+              "Example: `ceedling #{BULLSEYE_ROOT_NAME}:foo.c` or `ceedling #{BULLSEYE_ROOT_NAME}:unit/foo.c`"
 
     @ceedling[:loginator].log( message, Verbosity::ERRORS )
   end
@@ -83,12 +84,8 @@ namespace BULLSEYE_SYM do
   # Use a rule to increase efficiency for large projects
   rule(/^#{BULLSEYE_TASK_ROOT}\S+$/ => [ # bullseye test tasks by regex
      proc do |task_name|
-        # Yield clean test name => Strip the task string, remove Rake test task prefix, and remove any code file extension
-        test = task_name.strip().sub(/^#{BULLSEYE_TASK_ROOT}/, '')
-        EXTENSION_SOURCE.each { |ext| test = test.chomp( ext ) }
-
-        # Ensure the test name begins with a test name prefix
-        test = PROJECT_TEST_FILE_PREFIX + test if not (test.start_with?( PROJECT_TEST_FILE_PREFIX ))
+        # Any directory typed ahead of the name is kept. See TestTaskName.
+        test = TestTaskName.test_name( task_name, root: BULLSEYE_TASK_ROOT )
 
         # Provide the filepath for the target test task back to the Rake task
         @ceedling[:file_finder].find_test_file_from_name( test )

data/plugins/gcov/gcov.rake

@@ -38,11 +38,12 @@ namespace GCOV_SYM do
     @ceedling[:gcov].process_untested_sources( sources:COLLECTION_ALL_SOURCE )
   end
 
-  desc 'Run single test w/ coverage ([*] test or source file name, no path).'
+  desc 'Run single test w/ coverage ([*] test or source file name, with optional path).'
   task :* do
     message = "Oops! '#{GCOV_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 #{GCOV_ROOT_NAME}:foo.c`"
+              "Use a real test or source file name in place of the wildcard, " \
+              "adding as much of its path as needed to identify one file among any same-named tests.\n" \
+              "Example: `ceedling #{GCOV_ROOT_NAME}:foo.c` or `ceedling #{GCOV_ROOT_NAME}:unit/foo.c`"
 
     @ceedling[:loginator].log( message, Verbosity::ERRORS )
   end
@@ -83,12 +84,8 @@ namespace GCOV_SYM do
   # Use a rule to increase efficiency for large projects
   rule(/^#{GCOV_TASK_ROOT}\S+$/ => [ # gcov test tasks by regex
      proc do |task_name|
-        # Yield clean test name => Strip the task string, remove Rake test task prefix, and remove any code file extension
-        test = task_name.strip().sub(/^#{GCOV_TASK_ROOT}/, '')
-        EXTENSION_SOURCE.each { |ext| test = test.chomp( ext ) }
-
-        # Ensure the test name begins with a test name prefix
-        test = PROJECT_TEST_FILE_PREFIX + test if not (test.start_with?( PROJECT_TEST_FILE_PREFIX ))
+        # Any directory typed ahead of the name is kept. See TestTaskName.
+        test = TestTaskName.test_name( task_name, root: GCOV_TASK_ROOT )
 
         # Provide the filepath for the target test task back to the Rake task
         @ceedling[:file_finder].find_test_file_from_name( test )

data/plugins/sanitize/sanitize.rake

@@ -47,11 +47,12 @@ namespace SANITIZE_SYM do
     )
   end
 
-  desc "Run single sanitized test ([*] test or source file name, no path)."
+  desc "Run single sanitized test ([*] test or source file name, with optional path)."
   task :* do
     message = "Oops! '#{SANITIZE_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 #{SANITIZE_ROOT_NAME}:foo.c`"
+              "Use a real test or source file name in place of the wildcard, " +
+              "adding as much of its path as needed to identify one file among any same-named tests.\n" +
+              "Example: `ceedling #{SANITIZE_ROOT_NAME}:foo.c` or `ceedling #{SANITIZE_ROOT_NAME}:unit/foo.c`"
     @ceedling[:loginator].log( message, Verbosity::ERRORS )
   end
 
@@ -92,9 +93,8 @@ end
 # Use a rule to handle dynamic per-file tasks: sanitize:foo → build and run foo with sanitizers
 rule(/^#{SANITIZE_TASK_ROOT}\S+$/ => [
   proc do |task_name|
-    test = task_name.strip().sub(/^#{SANITIZE_TASK_ROOT}/, '')
-    EXTENSION_SOURCE.each { |ext| test = test.chomp(ext) }
-    test = PROJECT_TEST_FILE_PREFIX + test unless test.start_with?(PROJECT_TEST_FILE_PREFIX)
+    # Any directory typed ahead of the name is kept. See TestTaskName.
+    test = TestTaskName.test_name( task_name, root: SANITIZE_TASK_ROOT )
     @ceedling[:file_finder].find_test_file_from_name(test)
   end
 ]) do |test|

data/plugins/valgrind/valgrind.rake

@@ -48,11 +48,12 @@ namespace VALGRIND_SYM do
     )
   end
 
-  desc "Run single Valgrind test ([*] test or source file name, no path)."
+  desc "Run single Valgrind test ([*] test or source file name, with optional 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`"
+              "Use a real test or source file name in place of the wildcard, " +
+              "adding as much of its path as needed to identify one file among any same-named tests.\n" +
+              "Example: `ceedling #{VALGRIND_ROOT_NAME}:foo.c` or `ceedling #{VALGRIND_ROOT_NAME}:unit/foo.c`"
     @ceedling[:loginator].log( message, Verbosity::ERRORS )
   end
 
@@ -93,9 +94,8 @@ 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}/, '')
-    EXTENSION_SOURCE.each { |ext| test = test.chomp(ext) }
-    test = PROJECT_TEST_FILE_PREFIX + test unless test.start_with?(PROJECT_TEST_FILE_PREFIX)
+    # Any directory typed ahead of the name is kept. See TestTaskName.
+    test = TestTaskName.test_name( task_name, root: VALGRIND_TASK_ROOT )
     @ceedling[:file_finder].find_test_file_from_name(test)
   end
 ]) do |test|

data/site-local/404.html

@@ -17,7 +17,7 @@
       
       
       <link rel="icon" href="/assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
     
     
       
@@ -25,10 +25,10 @@
       
     
     
-      <link rel="stylesheet" href="/assets/stylesheets/main.ec1eaa64.min.css">
+      <link rel="stylesheet" href="/assets/stylesheets/main.57a0d79d.min.css">
       
         
-        <link rel="stylesheet" href="/assets/stylesheets/palette.ab4e12ef.min.css">
+        <link rel="stylesheet" href="/assets/stylesheets/palette.fb2fffe2.min.css">
       
       
 
@@ -80,30 +80,16 @@
     </div>
     <div data-md-component="announce">
       
-        <aside class="md-banner">
-          <div class="md-banner__inner md-grid md-typeset">
-            
-            
-  
-
-          </div>
-          
-        </aside>
-      
     </div>
     
       <div data-md-color-scheme="default" data-md-component="outdated" hidden>
         
           <aside class="md-banner md-banner--warning">
             <div class="md-banner__inner md-grid md-typeset">
-              
-  
-    You are not viewing the latest version.
+              You are not viewing the latest version.
     <a href="..//">
       <strong>Click here to go to latest.</strong>
     </a>
-  
-
             </div>
             <script>var el=document.querySelector("[data-md-component=outdated]"),base=new URL("/"),outdated=__md_get("__outdated",sessionStorage,base);!0===outdated&&el&&(el.hidden=!1)</script>
           </aside>
@@ -4256,10 +4242,10 @@
     
       
       
-      <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 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.a7633da7.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.d7400e89.min.js"></script>
+      <script src="/assets/javascripts/bundle.c21346df.min.js"></script>
       
     
   </body>