ceedling 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0610e698b34fe7dc61a65a1c455e28438cbe132bea10d85634b19fc791f5a293
-  data.tar.gz: 4f9b3d43150358c366de44a33697aa58460601fe372311524a303351b43eaba4
+  metadata.gz: 1eb94c2d7bae641fd66962f23ab8ee145a73c635f0fd7a5ae5fb2d9602f2713a
+  data.tar.gz: 2a20e6e6da82880a3ba78464a872c92ccb1be79174385a806477133e116d2682
 SHA512:
-  metadata.gz: acac7be5ef1b0b19eac71e189d178a39834405372ca4349cb529720bb3bc4a3fadfdbecf5e5fc462f5c72617052b3eddd0f334bf99a23a71fb576e7f247175fb
-  data.tar.gz: 9da4d2e23f1a6c45392177449d633332389093ca75804e22af4bb29d5feed971c5783296513cc4e6bf49492f337f45a154efa991829b3753aecb448959886084
+  metadata.gz: 0a5e8b807216ea64535a94e5b7b1a4b005f84ece39c5c4dad3bebf5cb0febe7236a8c8db30716baa2ffc3db7b48df8dfb2b3e7e3cced0bd851c88528f5b6773b
+  data.tar.gz: 1e46b99eba0c0fa4a8e365719688d0d643a8338ce7d01e30c5a77c918e5f0ca151c37da0959006ff13d2b8ae904da95f9be19ffb9d1ebb17c6ccbafe55760e11

data/GIT_COMMIT_SHA

@@ -1 +1 @@
-13a540f
+47d2c5e

data/README.md

@@ -1,25 +1,58 @@
-Ceedling [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/15117/badge)](https://www.bestpractices.dev/projects/15117) [![Docs](https://img.shields.io/badge/Docs-white?logo=materialformkdocs&link=https%3A%2F%2Fdocs.throwtheswitch.org%2FCeedling%2F)](https://docs.throwtheswitch.org/Ceedling/) [![Discourse](https://img.shields.io/badge/Discourse-purple?logo=discourse&link=https%3A%2F%2Fthrowtheswitch.discourse.group)](https://throwtheswitch.discourse.group) ![CI](https://github.com/ThrowTheSwitch/Ceedling/workflows/CI/badge.svg)
+[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/15117/badge)](https://www.bestpractices.dev/projects/15117) [![Docs](https://img.shields.io/badge/Docs-white?logo=materialformkdocs&link=https%3A%2F%2Fdocs.throwtheswitch.org%2FCeedling%2F)](https://docs.throwtheswitch.org/Ceedling/) [![Discourse](https://img.shields.io/badge/Discourse-purple?logo=discourse&link=https%3A%2F%2Fthrowtheswitch.discourse.group)](https://throwtheswitch.discourse.group) ![CI](https://github.com/ThrowTheSwitch/Ceedling/workflows/CI/badge.svg)
 ========
 
-**Ceedling 1.2.0** is the latest and greatest.
+# 🌱 Ceedling is a handy-dandy build system for C projects
+
+## Developer-friendly release _and_ test builds
 
-See [_Changelog_](docs/Changelog.md). [_Release Notes_][release-notes], 
-[_Breaking Changes_][breaking-changes], and [_Known Issues_][known-issues] are
-not yet updated.
+Ceedling can build your release artifact but is especially adept at building
+unit test suites for your C projects — even in tricky embedded systems.
 
-See [🚀 Getting Started](#-getting-started) for installation and new 
-project set up.
+⭐️ **Eager to just get going? Jump to 
+[📚 Documentation & Learning](#-documentation--learning) and
+[🚀 Getting Started](#-getting-started).**
+
+For a test suite project using the default toolchain `gcc`, Ceedling’s
+configuration file could be as simple as this:
+
+```yaml
+:project:
+  :build_root: project/build/
+
+:paths:
+  :test:
+    - tests/**
+  :source:
+    - source/**
+  :include:
+    - inc/**
+```
+
+To execute all your unit tests, you would run `ceedling test:all`. That‘s it!
+
+Ceedling works the way developers want to work. It is flexible and entirely
+command-line driven. It drives code generation and command line tools for you.
+All generated and framework code is easy to see and understand.
+
+Ceedling’s features support all types of C development from low-level embedded
+to enterprise systems. No tool is perfect, but Ceedling can do a whole lot to 
+help you and your team produce quality software.
+
+## Ceedling 1.2.1 is the latest and greatest
+
+See [_Changelog_](docs/Changelog.md), [_Release Notes_][release-notes], [_Breaking Changes_][breaking-changes], and [_Known Issues_][known-issues].
 
 **New goodies in 1.2.0:**
 * **[Delta builds][delta-builds]** have been restored after a temporary hiatus following a major refactoring for 1.0.0. A [delta build][delta-build-overview] is simply a build run that only performs regeneration, compilation, or linking as needed because of changed files. [Delta builds][delta-builds] are automatic with no configuration and complement [parallel builds][parallel-builds] introduced in 1.0.0 for build time speedups.
 * **`#include` relative paths & duplicate filename disambiguation**. Ceedling now fully supports [relative paths in `#include` directives][same-named-files] and [`TEST_SOURCE_FILE()` build directive macros][test-source-file]. Ceedling is now also able to distinguish files of the same name using paths in the preceding and [at the command line][test-path-task] to distinguish test files of the same name (e.g. `ceedling test:foo/file` vs. `ceedling test:bar/file`).
 * **Multiple file extensions per file type.** You may now provide a list of file types via [`:extensions`][extension-config] to gather files into your project’s build. For instance, the extensions `.c` and `.cc` can now both be used together to collect all source file in your project.
 * **Shuffled test order.** Ceedling now supports [Unity’s][unity-framework] randomized test case ordering (via a [`:unity` configuration setting][shuffle-tests]). [Delta builds][delta-builds] automatically adjust to always rerun test executables so test case ordering is shuffled.
-* The [`TEST_SOURCE_FILE()` build directive macro][test-source-file-subtractive] can now be used to remove source files from a test executable build. This can be handy in overriding [Ceedling’s conventions][header-source-convention] for associating source files with a test executable if your project structure does not match up with [Ceedling’s conventions][header-source-convention].
-* The [build warnings], [JUnit report], [IDE integration], [GoogleTest report], [module generator], and [dependencies] plugins all received numerous bug fixes and feature expansions.
-* [Bullseye code coverage plugin][bullseye-plugin] re-enabled and modernized (disabled since 1.0.0).
+* The **[`TEST_SOURCE_FILE()` build directive macro][test-source-file-subtractive]** can now be used to remove source files from a test executable build. This can be handy in overriding [Ceedling’s conventions][header-source-convention] for associating source files with a test executable if your project structure does not match up with Ceedling’s conventions.
+* The **new [Sanitize plugin][sanitize-plugin]** builds and runs tests with ASan, UBSan, and LeakSanitizer, naming each finding where a test fails and writing text, JSON, and SARIF reports.
+* The **[build warnings]**, **[JUnit report]**, **[IDE integration]**, **[GoogleTest report]**, **[module generator]**, and **[dependencies]** plugins all received numerous bug fixes and feature expansions.
+* **[Bullseye code coverage plugin][bullseye-plugin]** re-enabled and modernized (disabled since 1.0.0).
 * **Dedicated mocks and test runner generation build tasks.** It is now possible to run the test build pipeline only up through generating mocks or test runners without running the rest of a build using `ceedling gen:mocks:<test>` and `ceedling gen:test_runner:<test>` mirroring the convention of `test:` tasks.
-* Ceedling prerelease and release builds now automatically [generate Software Bills of Material][sbom-docs] (SBOMs) and attach them to GitHub pre/releases along with the final Ruby gem.
+* Ceedling prerelease and release builds now automatically **[generate Software Bills of Material][sbom-docs]** (SBOMs) and attach them to GitHub pre/releases along with the final Ruby gem.
 
 **Goodness introduced in 1.1.0:**
 * A [Partial][partials-docs] allows a test to mix mocked and real functions 
@@ -48,47 +81,11 @@ from the same source module in a single test file and enables testing of
 [GoogleTest report]: https://docs.throwtheswitch.org/Ceedling/1.2.0/plugins/report-tests-gtestlike-stdout/
 [module generator]: https://docs.throwtheswitch.org/Ceedling/1.2.0/plugins/module-generator/
 [dependencies]: https://docs.throwtheswitch.org/Ceedling/1.2.0/plugins/dependencies/
+[sanitize-plugin]: https://docs.throwtheswitch.org/Ceedling/1.2.0/plugins/sanitize/
 [bullseye-plugin]: https://docs.throwtheswitch.org/Ceedling/1.2.0/plugins/bullseye/
 [sbom-docs]: https://docs.throwtheswitch.org/Ceedling/latest/project/sbom/
-[partials-docs]: https://throwtheswitch.github.io/Ceedling/1.1.0/testing-guide/partials/
-[ceedling-docs-site]: https://throwtheswitch.github.io/Ceedling/
-
-# 🌱 Ceedling is a handy-dandy build system for C projects
-
-## Developer-friendly release _and_ test builds
-
-Ceedling can build your release artifact but is especially adept at building
-unit test suites for your C projects — even in tricky embedded systems.
-
-⭐️ **Eager to just get going? Jump to 
-[📚 Documentation & Learning](#-documentation--learning) and
-[🚀 Getting Started](#-getting-started).**
-
-For a test suite project using the default toolchain `gcc`, Ceedling’s
-configuration file could be as simple as this:
-
-```yaml
-:project:
-  :build_root: project/build/
-
-:paths:
-  :test:
-    - tests/**
-  :source:
-    - source/**
-  :include:
-    - inc/**
-```
-
-To execute all your unit tests, you would run `ceedling test:all`. That‘s it!
-
-Ceedling works the way developers want to work. It is flexible and entirely
-command-line driven. It drives code generation and command line tools for you.
-All generated and framework code is easy to see and understand.
-
-Ceedling’s features support all types of C development from low-level embedded
-to enterprise systems. No tool is perfect, but Ceedling can do a whole lot to 
-help you and your team produce quality software.
+[partials-docs]: https://docs.throwtheswitch.org/Ceedling/1.1.0/testing-guide/partials/
+[ceedling-docs-site]: https://docs.throwtheswitch.org/Ceedling/
 
 ## Supporting this work
 

data/Rakefile

@@ -948,10 +948,11 @@ namespace :docs do
     end
 
     namespace :release do
-      desc "Deploy release docs to Github Pages without and set it as 'latest'"
+      desc "Deploy release docs to Github Pages and set it as 'latest'"
       task :latest, [:version] => [:snapshot] do |t, args|
         version = args[:version] || raise("Version required: rake docs:deploy:release:latest[#.#.#]")
-        venv_sh "mike deploy --push #{version} latest"
+        # --update-aliases moves 'latest' off whichever version currently holds it
+        venv_sh "mike deploy --push --update-aliases #{version} latest"
       end
     end
   end

data/bin/app_cfg.rb

@@ -61,6 +61,11 @@ class CeedlingAppConfig
       # Default to task categry other than build/plugin tasks
       :build_tasks? => false,
 
+      # Whether the tasks build tests (test:, gcov:, ...) or a release, which decides what
+      # build/vendor needs
+      :test_build_tasks? => false,
+      :release_build_tasks? => false,
+
       # Default to `exit(1)` upon failing test cases
       :tests_graceful_fail? => false,
 
@@ -106,6 +111,14 @@ class CeedlingAppConfig
     @app_cfg[:build_tasks?] = enable
   end
 
+  def set_test_build_tasks(enable)
+    @app_cfg[:test_build_tasks?] = enable
+  end
+
+  def set_release_build_tasks(enable)
+    @app_cfg[:release_build_tasks?] = enable
+  end
+
   def set_tests_graceful_fail(enable)
     @app_cfg[:tests_graceful_fail?] = enable
   end
@@ -129,6 +142,14 @@ class CeedlingAppConfig
     return @app_cfg[:build_tasks?]
   end
 
+  def test_build_tasks?()
+    return @app_cfg[:test_build_tasks?]
+  end
+
+  def release_build_tasks?()
+    return @app_cfg[:release_build_tasks?]
+  end
+
   def tests_graceful_fail?()
     return @app_cfg[:tests_graceful_fail?]
   end

data/bin/cli_handler.rb

@@ -234,11 +234,17 @@ class CliHandler
     )
 
     # Look up if any tasks we will execute are build tasks
-    build_tasks = @helper.build_task?( tasks: (tasks.empty? ? default_tasks : tasks ) )
+    requested = (tasks.empty? ? default_tasks : tasks)
+    build_tasks = @helper.build_task?( tasks: requested )
 
     # Enable setup / operations duration logging in Rake context if build tasks are being invoked
     app_cfg.set_build_tasks( build_tasks )
 
+    # Only a build populates build/vendor, so a command that only reads the project leaves a
+    # concurrent build's vendored files alone
+    app_cfg.set_test_build_tasks( @helper.test_task?( tasks: requested ) )
+    app_cfg.set_release_build_tasks( @helper.release_task?( tasks: requested ) )
+
     _, path = @helper.which_ceedling?( env:env, config:config, app_cfg:app_cfg )
 
     # Log Ceedling Application version information

data/bin/cli_helper.rb

@@ -329,6 +329,11 @@ class CliHelper
   end
 
 
+  def release_task?(tasks:)
+    return tasks.any? { |task| @registry.task_is?( task, RakeTaskRegistry::TAG_RELEASE ) }
+  end
+
+
   def print_rake_tasks()
     # This all required digging into Rake internals a bit.
 

data/docs/Changelog.md

@@ -10,6 +10,16 @@ This changelog is complemented by three other documents:
 
 ---
 
+# [1.2.1] — 2026-10-24
+
+## 💪 Fixed
+
+- [#1360](https://github.com/ThrowTheSwitch/Ceedling/issues/1360) Fixed a delta build reporting another run’s cached test results when the [`--test-case` or `--exclude_test_case`](https://docs.throwtheswitch.org/Ceedling/1.2.0/getting-started/command-line/#ceedling-test-test-casetest_case_name) filter changed between runs. It affected every project whose [`:use_backtrace`](https://docs.throwtheswitch.org/Ceedling/1.2.0/configuration/reference/project/#use_backtrace) is not `:none`, including the `:simple` default. A changed filter now reruns the test executable without recompiling or relinking it. An unchanged filter still reuses the cached results.
+- [#1361](https://github.com/ThrowTheSwitch/Ceedling/issues/1361) Fixed every command that loads a project, `files:test` and `dumpconfig` included, rewriting the vendored Unity, CMock, and CException sources in `build/vendor/` in place. A second command run while a build compiled could leave the compiler reading a half-written header. Only a test build or release build now brings `build/vendor/` up to date. A vendored file that already matches its source is no longer written, and one that differs (e.g. after an accidental edit) is replaced whole.
+- [#1362](https://github.com/ThrowTheSwitch/Ceedling/issues/1362) Fixed [`gcov:`](https://docs.throwtheswitch.org/Ceedling/1.2.0/plugins/gcov/), [`valgrind:`](https://docs.throwtheswitch.org/Ceedling/1.2.0/plugins/valgrind/), [`sanitize:`](https://docs.throwtheswitch.org/Ceedling/1.2.0/plugins/sanitize/), and [`bullseye:`](https://docs.throwtheswitch.org/Ceedling/1.2.0/plugins/bullseye/) single-file tasks rejecting a project-relative path, such as `gcov:test/test_calculator.c`. They now accept a path to tell same-named test files apart, as [`test:` tasks](https://docs.throwtheswitch.org/Ceedling/1.2.0/getting-started/command-line/#ceedling-test) do.
+
+---
+
 # [1.2.0] — 2026-10-21
 
 ## 🌟 Added

data/docs/overrides/main.html

@@ -4,11 +4,14 @@
   Material's own `outdated`/`announce` blocks (base.html) ship empty by
   default -- both are opt-in via a project template override like this one.
 
+  Material only renders a block's wrapping banner markup when the block
+  produces non-empty output, and whitespace alone counts as output. The
+  `{%- -%}` whitespace control below is load-bearing: without it the
+  indentation around each `if` leaks out, rendering an empty banner (a blank
+  dark bar for `announce`) even when the condition is false.
+
   `outdated`: the standard "you're not viewing the latest version" warning
-  banner. Material only renders its wrapping markup when this block actually
-  produces non-empty output, so suppressing it here for prerelease pages
-  (rather than just leaving the block's *content* blank) is what keeps the
-  banner from appearing at all on those pages.
+  banner, suppressed entirely on prerelease pages.
 
   `announce`: a separate announcement bar, used here to carry the prerelease
   notice instead. `extra.prerelease` is set to `true` only in
@@ -17,16 +20,16 @@
 #}
 
 {% block outdated %}
-  {% if not config.extra.prerelease %}
+  {%- if not config.extra.prerelease -%}
     You are not viewing the latest version.
     <a href="{{ '../' ~ base_url }}">
       <strong>Click here to go to latest.</strong>
     </a>
-  {% endif %}
+  {%- endif -%}
 {% endblock %}
 
 {% block announce %}
-  {% if config.extra.prerelease %}
+  {%- if config.extra.prerelease -%}
     This is prerelease documentation for an upcoming Ceedling release.
-  {% endif %}
+  {%- endif -%}
 {% endblock %}

data/lib/ceedling/config/configurator.rb

@@ -16,7 +16,8 @@ require 'deep_merge'
 class Configurator
 
   attr_reader :project_config_hash, :programmatic_plugins, :rake_plugins
-  attr_accessor :project_logging, :sanity_checks, :include_test_case, :exclude_test_case, :force_test_rerun
+  attr_accessor :project_logging, :sanity_checks, :include_test_case, :exclude_test_case, :force_test_rerun,
+                :test_build_tasks, :release_build_tasks
 
   constructor :configurator_setup, :configurator_builder, :configurator_plugins, :config_walkinator, :yaml_wrapper, :system_wrapper, :loginator, :reportinator, :ruby_expandinator
 
@@ -431,7 +432,9 @@ class Configurator
     @configurator_setup.build_directory_structure( flattened_config )
 
     # Copy Unity, CMock, CException into vendor directory within build directory
-    @configurator_setup.vendor_frameworks_and_support_files( ceedling_lib_path, flattened_config )
+    @configurator_setup.vendor_frameworks_and_support_files(
+      ceedling_lib_path, flattened_config, test_build: @test_build_tasks == true, release_build: @release_build_tasks == true
+    )
     @configurator_setup.build_project_collections( flattened_config )
 
     @project_config_hash = flattened_config.clone

data/lib/ceedling/config/configurator_setup.rb

@@ -83,23 +83,19 @@ class ConfiguratorSetup
     @file_wrapper.rm_rf( path )
   end
 
-  # Copies the frameworks a build uses into build/vendor, and the support files its
-  # features need. Copies always, every run. An errant edit beneath build/vendor/, by hand,
-  # an IDE, or an automated agent, is overwritten from the canonical source by the next build.
-  def vendor_frameworks_and_support_files(ceedling_lib_path, flattened_config)
-    vendored_frameworks( flattened_config ).each do |source, destination, marker_file|
+  # Brings build/vendor up to date with the frameworks and support files a build needs. Only
+  # a build does this, so a command that only reads the project leaves a concurrent build's
+  # files alone. A file that already matches its source is not written, and one that differs,
+  # such as an errant edit by hand, an IDE, or an automated agent, is replaced whole.
+  #
+  # A release build needs only CException, and that only when exceptions are enabled.
+  def vendor_frameworks_and_support_files(ceedling_lib_path, flattened_config, test_build:, release_build:)
+    frameworks_for_build( flattened_config, test_build: test_build, release_build: release_build ).each do |source, destination, marker_file|
       heal_vendor_path( destination, marker_file )
-      # '/.' to cause cp_r to copy directory contents
-      @file_wrapper.cp_r_with_retry( File.join( source, '/.' ), destination )
+      @file_wrapper.sync_tree( source, destination )
     end
 
-    copy_backtrace_script( ceedling_lib_path, flattened_config ) if flattened_config[:project_use_backtrace] == :gdb
-
-    # Copy supporting partials code into build/vendor directory structure
-    @file_wrapper.cp_r(
-      File.join( ceedling_lib_path, CEEDLING_HEADER_FILEPATH ),
-      flattened_config[:project_build_vendor_ceedling_path]
-    ) if flattened_config[:project_use_partials]
+    vendor_test_support_files( ceedling_lib_path, flattened_config ) if test_build
   end
 
   # Tests are collected after path collections, both to merge and to filter out of sources
@@ -334,11 +330,26 @@ class ConfiguratorSetup
     return frameworks
   end
 
+  def frameworks_for_build(config, test_build:, release_build:)
+    return vendored_frameworks( config ) if test_build
+    return vendored_frameworks( config ).select { |_, _, marker_file| marker_file == CEXCEPTION_C_FILE } if release_build
+
+    return []
+  end
+
+  def vendor_test_support_files(ceedling_lib_path, config)
+    copy_backtrace_script( ceedling_lib_path, config ) if config[:project_use_backtrace] == :gdb
+
+    return unless config[:project_use_partials]
+
+    @file_wrapper.sync_file( File.join( ceedling_lib_path, CEEDLING_HEADER_FILEPATH ), config[:project_build_vendor_ceedling_path] )
+  end
+
   # The destination may not exist yet on a fresh build, since Rake creates directories
   # after configuration
   def copy_backtrace_script(ceedling_lib_path, flattened_config)
     @file_wrapper.mkdir( flattened_config[:project_build_tests_root] )
-    @file_wrapper.cp_r( File.join( ceedling_lib_path, BACKTRACE_GDB_SCRIPT_FILE ), flattened_config[:project_build_tests_root] )
+    @file_wrapper.sync_file( File.join( ceedling_lib_path, BACKTRACE_GDB_SCRIPT_FILE ), flattened_config[:project_build_tests_root] )
   end
 
   def validate_simple_paths(paths, *keys)

data/lib/ceedling/file_wrapper.rb

@@ -238,36 +238,39 @@ class FileWrapper
     false
   end
 
-  # As #cp_r, but retries the whole copy on a transient OS-level error instead of
-  # surfacing it on the first attempt -- the same transient-visibility race
-  # #open_with_retry guards against, here hitting FileUtils.cp_r's own internal
-  # stat-then-open sequence on either the source or destination tree. A source/dest
-  # entry briefly reporting the wrong type (a directory where a file was just stat'd,
-  # or vice versa) mid-copy raises Errno::ENOTDIR/EISDIR from deep inside cp_r; a
-  # retry a moment later re-walks the tree fresh rather than trusting stale type info
-  # from the failed attempt. A failure that never clears still surfaces as a
-  # CeedlingException naming the destination and how many attempts were made, not a
-  # bare, unhelpful Errno.
-  def cp_r_with_retry(source, destination, options={})
-    attempts_remaining = TRANSIENT_IO_RETRY_DELAYS.dup
-    begin
-      cp_r(source, destination, options)
-    rescue SystemCallError => e
-      if attempts_remaining.empty?
-        msg = "Failed to copy into '#{destination}' after #{TRANSIENT_IO_RETRY_DELAYS.size} retries ⏩️ #{e.message}\n" \
-              "This path may be corrupted (a file exists where Ceedling expects a directory, or vice versa). " \
-              "Try deleting this project's build/ directory and rebuilding -- or, if the error names a path " \
-              "under your Ruby gem install, reinstall the ceedling gem."
-        @loginator.log(msg, Verbosity::ERRORS)
-        raise CeedlingException, msg
+  # Brings every file beneath source_dir up to date beneath destination_dir. A file that
+  # already matches its source is not written, so a reader elsewhere never sees it change. One
+  # that differs or is missing is replaced whole (see #replace_file). Files the destination
+  # has beyond the source are left alone.
+  #
+  # A transient OS-level error retries the whole pass: a path briefly reporting the wrong type
+  # mid-copy, or on Windows a file another process holds open. A failure that never clears
+  # surfaces as a CeedlingException naming the destination, not a bare Errno.
+  def sync_tree(source_dir, destination_dir)
+    with_copy_retry( destination_dir ) do
+      Dir.glob( '**/*', File::FNM_DOTMATCH, base: source_dir ).each do |relative|
+        source = File.join( source_dir, relative )
+        sync_one( source, File.join( destination_dir, relative ) ) if File.file?( source )
       end
-      delay = attempts_remaining.shift
-      @loginator.log("Retrying copy into '#{destination}' after a transient error: #{e.message}", Verbosity::DEBUG)
-      sleep(delay)
-      retry
     end
   end
 
+  # As #sync_tree, for a single file copied into destination_dir
+  def sync_file(source, destination_dir)
+    with_copy_retry( destination_dir ) { sync_one( source, File.join( destination_dir, File.basename( source ) ) ) }
+  end
+
+  # Copies source to a temporary name beside destination, then renames it over destination.
+  # A concurrent reader sees the old file or the new one, never a partial one.
+  def replace_file(source, destination)
+    temp = File.join( File.dirname( destination ), ".#{File.basename( destination )}.#{Process.pid}.#{Thread.current.object_id}.tmp" )
+    check_path_length( temp, origin: 'FileWrapper#replace_file' )
+    FileUtils.cp( source, temp )
+    File.rename( temp, destination )
+  ensure
+    FileUtils.rm_f( temp ) if temp
+  end
+
   def read(filepath, length=nil)
     return File.read(filepath, length)
   end
@@ -371,6 +374,33 @@ class FileWrapper
 
   private
 
+  def sync_one(source, destination)
+    return if File.file?( destination ) && File.size( source ) == File.size( destination ) && FileUtils.compare_file( source, destination )
+
+    FileUtils.mkdir_p( File.dirname( destination ) )
+    replace_file( source, destination )
+  end
+
+  def with_copy_retry(destination)
+    attempts_remaining = TRANSIENT_IO_RETRY_DELAYS.dup
+    begin
+      yield
+    rescue SystemCallError => e
+      if attempts_remaining.empty?
+        msg = "Failed to copy into '#{destination}' after #{TRANSIENT_IO_RETRY_DELAYS.size} retries ⏩️ #{e.message}\n" \
+              "This path may be corrupted (a file exists where Ceedling expects a directory, or vice versa). " \
+              "Try deleting this project's build/ directory and rebuilding -- or, if the error names a path " \
+              "under your Ruby gem install, reinstall the ceedling gem."
+        @loginator.log(msg, Verbosity::ERRORS)
+        raise CeedlingException, msg
+      end
+      delay = attempts_remaining.shift
+      @loginator.log("Retrying copy into '#{destination}' after a transient error: #{e.message}", Verbosity::DEBUG)
+      sleep(delay)
+      retry
+    end
+  end
+
   def path_length_limit
     return PATH_LENGTH_LIMITS[:windows] if SystemWrapper.windows?
     return PATH_LENGTH_LIMITS[:macos] if SystemWrapper.macos?

data/lib/ceedling/rake_app/test_task_name.rb

@@ -0,0 +1,29 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+# Turns a per-file test task's name (test:, gen:mocks:, gcov:, valgrind:, and the rest) into
+# the test name file lookup needs. A directory typed ahead of the name tells same-named tests
+# apart, so it is kept, and only the file name gets the test file prefix.
+module TestTaskName
+
+  def self.test_name(task_name, root:, extensions: EXTENSION_SOURCE, prefix: PROJECT_TEST_FILE_PREFIX)
+    test = task_name.strip.delete_prefix( root )
+
+    # At most one configured extension ends the name, so trying each in turn is safe
+    extensions.each { |ext| test = test.chomp( ext ) }
+
+    # A Windows-style name under a POSIX Ruby (WSL, Cygwin) has backslashes File won't split on
+    test = test.tr( '\\', '/' )
+
+    dir  = File.dirname( test )
+    base = File.basename( test )
+    base = prefix + base unless base.start_with?( prefix )
+
+    return (dir == '.') ? base : File.join( dir, base )
+  end
+
+end

data/lib/ceedling/rakefile.rb

@@ -23,6 +23,7 @@ Rake::TaskManager.record_task_metadata = true
 
 require 'ceedling/system_wrapper'
 require 'ceedling/reportinator'
+require 'ceedling/rake_app/test_task_name'
 
 # Operation duration logging
 def log_runtime(run, start_time_s, end_time_s, enabled)

data/lib/ceedling/rakefiles/tests/rules_tests.rake

@@ -9,26 +9,9 @@ namespace TEST_SYM do
   # Use rules to increase efficiency for large projects (instead of iterating through all sources and creating defined tasks)
   rule(/^#{TEST_TASK_ROOT}\S+$/ => [ # Test task names 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.
-        # Only one configured source extension can actually be present at the end of a given
-        # task name, so trying each in turn is safe -- chomp is a no-op for the ones that don't match.
-        # Whatever directory the invoker typed ahead of the name (e.g. `test:unit/test_foo.c`)
-        # is left exactly as given -- it's not decoration, it's what disambiguates one test
-        # from another same-named test elsewhere in the project.
-        test = task_name.strip().sub(/^#{TEST_TASK_ROOT}/, '')
-        EXTENSION_SOURCE.each { |ext| test = test.chomp( ext ) }
-
-        # Normalized to forward slashes so a directory the invoker typed with backslashes
-        # (a Windows-style task name run under a POSIX Ruby, e.g. WSL or Cygwin, where
-        # File.dirname/basename below don't treat '\' as a separator) still splits correctly.
-        test = test.tr( '\\', '/' )
-
-        # Ensure the test name's own basename begins with the test file prefix, without
-        # disturbing any directory the invoker supplied ahead of it.
-        dir  = File.dirname( test )
-        base = File.basename( test )
-        base = PROJECT_TEST_FILE_PREFIX + base if not (base.start_with?( PROJECT_TEST_FILE_PREFIX ))
-        test = (dir == '.') ? base : File.join( dir, base )
+        # Any directory typed ahead of the name (e.g. `test:unit/test_foo.c`) is kept, since it
+        # tells one test from a same-named test elsewhere. See TestTaskName.
+        test = TestTaskName.test_name( task_name, root: TEST_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/lib/ceedling/rakefiles/tests/rules_tests_generate.rake

@@ -21,26 +21,9 @@ namespace GEN_SYM do
   # Use a rule to increase efficiency for large projects (instead of iterating through all sources and creating defined tasks)
   rule(/^#{GENERATE_MOCKS_TASK_ROOT}\S+$/ => [ # Task names by regex
       proc do |task_name|
-        # Yield clean test name => Strip the task string, remove Rake task prefix, and remove any code file extension.
-        # Only one configured source extension can actually be present at the end of a given
-        # task name, so trying each in turn is safe -- chomp is a no-op for the ones that don't match.
-        # Whatever directory the invoker typed ahead of the name (e.g. `gen:mocks:unit/foo.c`)
-        # is left exactly as given -- it's not decoration, it's what disambiguates one test
-        # from another same-named test elsewhere in the project.
-        test = task_name.strip().sub(/^#{GENERATE_MOCKS_TASK_ROOT}/, '')
-        EXTENSION_SOURCE.each { |ext| test = test.chomp( ext ) }
-
-        # Normalized to forward slashes so a directory the invoker typed with backslashes
-        # (a Windows-style task name run under a POSIX Ruby, e.g. WSL or Cygwin, where
-        # File.dirname/basename below don't treat '\' as a separator) still splits correctly.
-        test = test.tr( '\\', '/' )
-
-        # Ensure the test name's own basename begins with the test file prefix, without
-        # disturbing any directory the invoker supplied ahead of it.
-        dir  = File.dirname( test )
-        base = File.basename( test )
-        base = PROJECT_TEST_FILE_PREFIX + base if not (base.start_with?( PROJECT_TEST_FILE_PREFIX ))
-        test = (dir == '.') ? base : File.join( dir, base )
+        # Any directory typed ahead of the name (e.g. `gen:mocks:unit/foo.c`) is kept, since it
+        # tells one test from a same-named test elsewhere. See TestTaskName.
+        test = TestTaskName.test_name( task_name, root: GENERATE_MOCKS_TASK_ROOT )
 
         # Provide the filepath for the target test task back to the Rake task
         @ceedling[:file_finder].find_test_file_from_name( test )
@@ -56,16 +39,7 @@ namespace GEN_SYM do
   # Use a rule to increase efficiency for large projects (instead of iterating through all sources and creating defined tasks)
   rule(/^#{GENERATE_TEST_RUNNER_TASK_ROOT}\S+$/ => [ # Task names by regex
       proc do |task_name|
-        # See gen:mocks's identical rule above for a full explanation of this resolution.
-        test = task_name.strip().sub(/^#{GENERATE_TEST_RUNNER_TASK_ROOT}/, '')
-        EXTENSION_SOURCE.each { |ext| test = test.chomp( ext ) }
-
-        test = test.tr( '\\', '/' )
-
-        dir  = File.dirname( test )
-        base = File.basename( test )
-        base = PROJECT_TEST_FILE_PREFIX + base if not (base.start_with?( PROJECT_TEST_FILE_PREFIX ))
-        test = (dir == '.') ? base : File.join( dir, base )
+        test = TestTaskName.test_name( task_name, root: GENERATE_TEST_RUNNER_TASK_ROOT )
 
         @ceedling[:file_finder].find_test_file_from_name( test )
       end

data/lib/ceedling/setupinator.rb

@@ -50,6 +50,10 @@ class Setupinator
     @configurator.include_test_case = app_cfg[:include_test_case]
     @configurator.exclude_test_case = app_cfg[:exclude_test_case]
 
+    # Whether the requested tasks build tests or a release, which decides what build/vendor needs
+    @configurator.test_build_tasks = app_cfg[:test_build_tasks?]
+    @configurator.release_build_tasks = app_cfg[:release_build_tasks?]
+
     # Set special purpose forced test re-execution (from command line)
     @configurator.force_test_rerun = app_cfg[:force_test_rerun]