ceedling 1.1.1 → 1.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56f073ff96051065c1f390744785a8e933cbfa700d81a585495b49d44b318f1c
-  data.tar.gz: 3d9567c9ebb1477eb215fb9cb8cdfd42f76b7b8c5cdfd9cce1010eff89e49ea3
+  metadata.gz: 8aabde4baeef95fad89e87cf3bd6226ffa3f10df9e54708270c82f237f3efe49
+  data.tar.gz: '08693e70f80deab8cb70f11677291f368a159df04b35f7a8d9fec8025522063a'
 SHA512:
-  metadata.gz: 3e108e84bc09d28d53ca336b49cea22e970d6319810b8b68dab3f1dadb9793eb40948589fb771f8f1d6f731ce2319f9ee32b9cc8a12a8f54d32061e4a052c948
-  data.tar.gz: 6e21e05a55622e2836e52feccd2db2c99a2827db4c6b1179f6ed30c702db8a59dc888fd460d23976d07b3c36237e400b0e553ee9493b3f287456bd10099eae29
+  metadata.gz: ab5f32d7896199850b29f6328c9e3fbaea63c0f5bf3dff665434ee0bd488992f971b18afd1bcf194e5c6f2ca66636cd72e38ab26fed3e74904cb374094f9c2b7
+  data.tar.gz: fab7cf5fe911d2dbc24bdb16add93551bfe8d9b7a668b888735ccfe199d04431707d5e01ec2d5ce345ee518db9b8f34376e16b92788ba1780e2ed20b8a32832c

data/GIT_COMMIT_SHA

@@ -1 +1 @@
-e7770cc
+049a9d7

data/README.md

@@ -1,7 +1,7 @@
 Ceedling ![CI](https://github.com/ThrowTheSwitch/Ceedling/workflows/CI/badge.svg)
 ========
 
-**Ceedling 1.1.0** is the latest and greatest.
+**Ceedling 1.1.3** is the latest and greatest.
 
 See [_Release Notes_][release-notes], [_Changelog_](docs/Changelog.md), 
 [_Breaking Changes_][breaking-changes], and [_Known Issues_][known-issues].
@@ -9,7 +9,7 @@ See [_Release Notes_][release-notes], [_Changelog_](docs/Changelog.md),
 See [🚀 Getting Started](#-getting-started) for installation and new 
 project set up.
 
-**New goodies:**
+**New goodies in 1.1.x:**
 * A [Partial][partials-docs] allows a test to mix mocked and real functions 
 from the same source module in a single test file and enables testing of 
 `static` and `inline` functions without modifying source code.
@@ -22,7 +22,7 @@ from the same source module in a single test file and enables testing of
 * New stock plugins for [Valgrind memory checking][valgrind-plugin] and 
 [Cppcheck static analysis][cppcheck-plugin].
 * The [GCov plugin][gcov-plugin]:
-   * _Finally_ supports coverage reports for all sources.
+   * Now supports coverage reports for all sources.
    * Adds support for Modified Condition / Decision Coverage.
 * Mixins improvements including an option for [inline YAML at the command line][mixins-inline-yaml].
 * Ceedling’s test preprocessing is once again compatible with Unity’s 

data/assets/broken_uncovered_file.c

@@ -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
+========================================================================= */
+
+// Untested source with a syntax error -- fails to compile regardless of any
+// :defines/:flags, deliberately triggering the :untested_sources guidance
+// notice when :gcov :untested_sources is set to :compile.
+
+int broken_uncovered_function(int a, int b) {
+  return a + b // Missing semicolon and closing brace: guaranteed compile error.

data/assets/test_example_file_2.c

@@ -0,0 +1,22 @@
+/* =========================================================================
+    Ceedling - Test-Centered Build System for C
+    ThrowTheSwitch.org
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    SPDX-License-Identifier: MIT
+========================================================================= */
+
+// A second test file covering the same source as test_example_file_success.c.
+// Ceedling builds one executable per test file, and both link against
+// example_file.c, producing two sets of .gcda coverage data for the same
+// functions -- used to exercise gcovr's merge-mode-functions behavior.
+
+#include "unity.h"
+#include "example_file.h"
+
+void setUp(void) {}
+void tearDown(void) {}
+
+void test_difference_between_two_numbers(void)
+{
+  TEST_ASSERT_EQUAL_INT(0, difference_between_numbers(1, 1));
+}

data/assets/test_example_file_crash_sigsegv_with_param.c

@@ -0,0 +1,32 @@
+/* =========================================================================
+    Ceedling - Test-Centered Build System for C
+    ThrowTheSwitch.org
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    SPDX-License-Identifier: MIT
+========================================================================= */
+
+#include <signal.h>
+#include "unity.h"
+#include "example_file.h"
+
+
+void setUp(void) {}
+void tearDown(void) {}
+
+void test_add_numbers_will_fail(void) {
+  // Platform-independent way of forcing a crash
+  // NOTE: Avoid `nullptr` as it is a keyword in C23
+  uint32_t* a_null_pointer = (void*)0;
+  uint32_t i = *a_null_pointer;
+  TEST_ASSERT_EQUAL_INT(2, add_numbers(i,2));
+}
+
+// Regression coverage for issue #1185: a parameterized test defined after a
+// crashing test in the same file must still report its own real PASS/FAIL
+// results rather than being swept up as "crashed" alongside the actual crash.
+TEST_CASE(5, 3, 2)
+TEST_CASE(10, 4, 6)
+TEST_CASE(0, 0, 0)
+void test_difference_between_numbers_is_correct(int a, int b, int expected) {
+  TEST_ASSERT_EQUAL_INT(expected, difference_between_numbers(a, b));
+}

data/assets/tests_with_partials_coverage/src/blanks.c

@@ -0,0 +1,10 @@
+#include "blanks.h"
+void helloBlanks(void) {
+
+
+  return;  // Must be the reported hit line -- the whole point of this fixture
+}
+
+// Lines 3-4 above are deliberately blank -- standing in for a stripped
+// multi-line comment. They must never absorb the hit that belongs to
+// `return` on line 5; see gcov_partials_coverage_blank_lines_in_function_body.

data/assets/tests_with_partials_coverage/src/blanks.h

@@ -0,0 +1 @@
+void helloBlanks(void);

data/assets/tests_with_partials_coverage/src/counter.c

@@ -0,0 +1,12 @@
+#include "counter.h"
+int helloCounter(void) {
+  static int count;  // Promoted to module scope and replaced with a no-op by Partials
+
+  count++;  // Must independently report as hit
+
+  return count;  // Must independently report as hit
+}
+
+// Lines 4 and 6 above are deliberately blank; they must never absorb the
+// hits that belong to `count++;` (line 5) and `return count;` (line 7);
+// see gcov_partials_coverage_function_scope_static_promotion.

data/assets/tests_with_partials_coverage/src/counter.h

@@ -0,0 +1 @@
+int helloCounter(void);

data/assets/tests_with_partials_coverage/src/decorators.c

@@ -0,0 +1,11 @@
+#include "decorators.h"
+static  // Own line -- exercises the Partials #line adjustment for stripped decorators
+inline  // Own line -- same as above
+void helloDecorators(void)
+{
+
+  return;  // Must be the reported hit line
+}
+
+// Line 6 above is deliberately blank; it must never absorb the hit that
+// belongs to `return` on line 7; see gcov_partials_coverage_decorators_on_own_lines.

data/assets/tests_with_partials_coverage/src/decorators.h

@@ -0,0 +1,4 @@
+// `helloDecorators` is `static` in decorators.c, so -- like any private
+// helper -- it has no prototype here. Its declaration for the test file
+// comes from the generated Partial's own header via TEST_PARTIAL_ALL_MODULE,
+// not from this file.

data/assets/tests_with_partials_coverage/test/test_blanks.c

@@ -0,0 +1,8 @@
+#include "unity.h"
+#include "ceedling.h"
+#include TEST_PARTIAL_ALL_MODULE(blanks)
+#include "blanks.h"
+
+void test_helloBlanks(void) {
+  helloBlanks();
+}

data/assets/tests_with_partials_coverage/test/test_counter.c

@@ -0,0 +1,9 @@
+#include "unity.h"
+#include "ceedling.h"
+#include TEST_PARTIAL_ALL_MODULE(counter)
+#include "counter.h"
+
+void test_helloCounter(void) {
+  TEST_ASSERT_EQUAL(1, helloCounter());
+  TEST_ASSERT_EQUAL(2, helloCounter());
+}

data/assets/tests_with_partials_coverage/test/test_decorators.c

@@ -0,0 +1,8 @@
+#include "unity.h"
+#include "ceedling.h"
+#include TEST_PARTIAL_ALL_MODULE(decorators)
+#include "decorators.h"
+
+void test_helloDecorators(void) {
+  helloDecorators();
+}

data/bin/actions_wrapper.rb

@@ -13,16 +13,17 @@ class ActionsWrapper
   include Thor::Base
   include Thor::Actions
 
-  JUNK_FILE_EXCLUDE_REGEX = 
+  JUNK_FILE_EXCLUDE_REGEX = /(\.DS_Store)|(thumbs\.db)/
 
   # Most important mixin method is Thor::Actions class method `source_root()` we call externally
 
   def _directory(src, *args)
-    # Insert exclusion of macOS and Windows preview junk files if an exclude pattern is not present
-    # Thor's use of args is an array of call arguments, some of which can be single key/value hash options
-    if !args.any? {|h| h.class != Hash ? false : !h[:exclude_pattern].nil?}
-      args << {:exclude_pattern => /(\.DS_Store)|(thumbs\.db)/}
-    end
+    # Build a single trailing options hash -- Thor's directory() only reads
+    # the last argument as options, so any caller-supplied hash (e.g.
+    # :force) and this default :exclude_pattern must live in the same hash.
+    options = args.last.is_a?(Hash) ? args.pop : {}
+    options[:exclude_pattern] ||= JUNK_FILE_EXCLUDE_REGEX
+    args << options
 
     directory( src, *args )
   end

data/docs/Changelog.md

@@ -10,6 +10,28 @@ This changelog is complemented by three other documents:
 
 ---
 
+# [1.1.3] — 2026-08-06
+
+## 💪 Fixed
+- [#1185](https://github.com/ThrowTheSwitch/Ceedling/issues/1185) Fixed / improved crash handling for parameterized Unity test cases.
+- [#1186](https://github.com/ThrowTheSwitch/Ceedling/issues/1186) Fixed `gcc` version lookup for the Gcov plugin running on Windows.
+- Ensure compilation symbols needed for Partials are injected when `:preprocess` defines are configured.
+- Fixed use of Thor’s Actions#directory to ensure a single options hash.
+
+# [1.1.2] — 2026-07-27
+
+## 💪 Fixed
+
+- Fixed line end handling for certain circumstances in Windows that could accidentally create extra white space lines that affect file line numbering (particularly in coverage reporting).
+
+### Partials
+
+- [#1182](https://github.com/ThrowTheSwitch/Ceedling/issues/1182) Fixed termination newline handling for certain variable declarations. Robustified all similar cases in C feature extraction and added further test coverage.
+- [#1184](https://github.com/ThrowTheSwitch/Ceedling/issues/1184) Fixed escaped character handling in `#define` string literals.
+- [#1183](https://github.com/ThrowTheSwitch/Ceedling/issues/1183) Fixed postprocessed preprocessed files (ha) to preserve blank lines in function definitions where comments were stripped out by preprocessing. Without preserving blank lines, line numbering for coverage reporting purposes becomes corrupted.
+
+---
+
 # [1.1.1] — 2026-07-23
 
 ## 🌟 Added
@@ -18,15 +40,15 @@ This changelog is complemented by three other documents:
 
 ## 💪 Fixed
 
-New since 1.1.0:
+### New since 1.1.0
 
 - [#1180](https://github.com/ThrowTheSwitch/Ceedling/issues/1180) Fixed `gcovr` illegal `--exclude` flag when Gcovr configuration file in use.
 - [#1181](https://github.com/ThrowTheSwitch/Ceedling/issues/1181) Fixed linker error when test files contain no test cases (fix was implemented in Unity and vendored into Ceedling).
 
-Backlog bug fixes predating 1.1.0:
+### Backlog bug fixes predating 1.1.0
 
 - [#1064](https://github.com/ThrowTheSwitch/Ceedling/issues/1064) Fixed include guard handling that in a certain combination of preprocessing and CMock options led to duplicated symbols breaking a test build.
-- [#1098](https://github.com/ThrowTheSwitch/Ceedling/issues/1098) Fixed :test_compiler used instead of :test_assembler for assembly file.
+- [#1098](https://github.com/ThrowTheSwitch/Ceedling/issues/1098) Fixed `:test_compiler` used instead of `:test_assembler` for assembly file.
 - [#1009](https://github.com/ThrowTheSwitch/Ceedling/issues/1009) Fixed tool name handling for `command_hooks` plugin.
 
 ## ⚠️ Changed

data/lib/ceedling/c_extractor/c_extractor_declarations.rb

@@ -167,7 +167,9 @@ class CExtractorDeclarations
           # Verify this looks like a valid declaration
           # Must have at least a type and identifier
           # Can end with: word character, ], ), }, or " (for string initializers)
-          if declaration =~ /\w+.*[\w\]\)\}"']\s*;$/
+          # `/m` flag: declaration may span multiple lines (e.g. a multiline brace
+          # initializer), so '.' must match embedded newlines too
+          if declaration =~ /\w+.*[\w\]\)\}"']\s*;$/m
             return [true, expand_and_parse(declaration)]
           else
             scanner.pos = start_pos

data/lib/ceedling/c_extractor/c_extractor_preprocessing.rb

@@ -142,8 +142,9 @@ class CExtractorPreprocessing
     return [false, nil] unless success
     text << args
 
-    # Consume optional whitespace before ';'
-    text << (scanner.scan(/[ \t]*/) || '')
+    # Consume optional whitespace before ';' (including newlines, for statements formatted
+    # with the terminating ';' on its own line)
+    text << (scanner.scan(/\s*/) || '')
 
     # Consume the required terminating ';'
     return [false, nil] unless scanner.scan(/;/)
@@ -231,20 +232,32 @@ class CExtractorPreprocessing
 
   # Collect and return the full text of a preprocessing directive starting at '#'.
   # Returns nil if not positioned at '#'. Handles backslash-newline continuations.
+  # String/char literals are consumed verbatim via skip_c_string() so an in-string
+  # escape (e.g. "\n", "\"", "\\") is never mistaken for a line continuation.
   # Trailing whitespace and newlines are stripped from the returned text.
   def _collect_directive(scanner)
     return nil unless scanner.check(/#/)
 
     text = scanner.scan(/#/)
 
-    loop do
-      text += scanner.scan(/[^\n\\]*/) || ''
+    until scanner.eos?
+      text << (scanner.scan(/[^"'\\\n]*/) || '')
+
+      if (ch = scanner.peek(1)) == '"' || ch == "'"
+        before = scanner.pos
+        @c_extractor_code_text.skip_c_string(scanner, ch)
+        text << scanner.string[before...scanner.pos]
+
+      elsif scanner.scan(/\\\n/)
+        text << "\\\n"
 
-      if scanner.scan(/\\\n/)
-        text += "\\\n"
       elsif scanner.scan(/\n/)
-        text += "\n"
+        text << "\n"
         break
+
+      elsif scanner.scan(/\\/)
+        text << '\\'
+
       else
         break  # EOS — no trailing newline
       end

data/lib/ceedling/config/configurator.rb

@@ -88,10 +88,16 @@ class Configurator
       @loginator.log( "Reverted :cmock ↳ :treat_inlines to :exclude because this CMock feature is superseded by Partials.", Verbosity::COMPLAIN, LogLabels::NOTICE )
     end
 
-    # If partials enabled, inject partials name prefix symbol to all test compilation.
+    # If partials enabled, inject partials name prefix symbol to all test compilation
+    # and, if a project defines its own preprocess-scoped defines matcher, to
+    # preprocessing as well -- `:preprocess:` defines are looked up independently
+    # of `:test:` defines and only fall back to the latter when `:preprocess:`
+    # is absent entirely, so a project-defined `:preprocess:` matcher needs this
+    # symbol appended directly or Partials' own macro-based #includes break.
     # Handle both the simple list and matcher hash config formats.
     _partials_prefix_symbol = "CEEDLING_PARTIALS_PREFIX=#{PARTIAL_FILENAME_PREFIX}"
     ConfigMatchinator.append_matcher_entries( config[:defines][:test], _partials_prefix_symbol )
+    ConfigMatchinator.append_matcher_entries( config[:defines][:preprocess], _partials_prefix_symbol )
   end
 
 

data/lib/ceedling/defaults.rb

@@ -69,7 +69,10 @@ DEFAULT_TEST_FIXTURE_SIMPLE_BACKTRACE_TOOL = {
   :name => 'default_test_fixture_simple_backtrace'.freeze,
   :optional => false.freeze,
   :arguments => [
-    '-n ${2}'.freeze # Exact test case name matching flag
+    # Test case matching flag and (quoted) value, fully composed by the caller as
+    # either `-n "<exact name>"` or `-f "<base name>"` -- see
+    # GeneratorTestResultsBacktrace#unity_filter_arg.
+    '${2}'.freeze
     ].freeze
   }
 
@@ -202,7 +205,10 @@ DEFAULT_TEST_BACKTRACE_GDB_TOOL = {
     "--command \"${1}\"".freeze, # Debug script file to run
     '--args'.freeze,
     '${2}'.freeze,               # Test executable
-    '-n ${3}'.freeze             # Exact test case name matching flag
+    # Test case matching flag and (quoted) value, fully composed by the caller as
+    # either `-n "<exact name>"` or `-f "<base name>"` -- see
+    # GeneratorTestResultsBacktrace#unity_filter_arg.
+    '${3}'.freeze
     ].freeze
   }
 

data/lib/ceedling/generators/generator_partials.rb

@@ -28,11 +28,15 @@ class GeneratorPartials
     header_filepath = File.join(output_path, header)
     source_filepath = File.join(output_path, source)
 
-    @file_wrapper.open(header_filepath, 'w') do |file|
+    # Binary mode: the function bodies written below may already contain their
+    # own line endings verbatim. Windows text mode rewrites every "\n" on
+    # write, which would alter any line ending already present in that
+    # content instead of passing it through unchanged.
+    @file_wrapper.open(header_filepath, 'wb') do |file|
       generate_header(file, header, header_includes, function_definitions, c_module, true)
     end
 
-    @file_wrapper.open(source_filepath, 'w') do |file|
+    @file_wrapper.open(source_filepath, 'wb') do |file|
       generate_source(file, source_includes, function_definitions, c_module)
     end
 
@@ -43,7 +47,8 @@ class GeneratorPartials
     header = @file_path_utils.form_partial_interface_header_filename(name)
     filepath = File.join(output_path, header)
 
-    @file_wrapper.open(filepath, 'w') do |file|
+    # Binary mode: see generate_implementation above.
+    @file_wrapper.open(filepath, 'wb') do |file|
       generate_header(file, header, includes, function_declarations, c_module, false)
     end
 
@@ -149,6 +154,11 @@ class GeneratorPartials
       # Blank line before a function when preceded by a non-function item
       io << "\n" if anything_emitted && !last_was_func
       if func.line_num and func.source_filepath
+        # #line ties this generated file's code back to its original source
+        # location -- debuggers, error messages, and gcov coverage attribution
+        # all point at the real file/line instead of this generated stand-in.
+        # That mapping only holds if this file's line count matches what
+        # #line promises, which is why it's opened in binary mode above.
         io << "#line #{func.line_num} \"#{func.source_filepath}\"\n"
       end
       io << func.code_block << "\n\n"