ceedling 1.2.2 → 1.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (390) hide show
  1. checksums.yaml +4 -4
  2. data/GIT_COMMIT_SHA +1 -1
  3. data/README.md +1 -1
  4. data/assets/fixtures/tests_with_partials_coverage/src/private_macro.c +7 -0
  5. data/assets/fixtures/tests_with_partials_coverage/src/private_macro.h +5 -0
  6. data/assets/fixtures/tests_with_partials_coverage/src/tally.c +13 -0
  7. data/assets/fixtures/tests_with_partials_coverage/src/tally.h +4 -0
  8. data/assets/fixtures/tests_with_partials_coverage/test/test_private_macro.c +10 -0
  9. data/assets/fixtures/tests_with_partials_coverage/test/test_tally.c +9 -0
  10. data/docs/BreakingChanges.md +16 -0
  11. data/docs/Changelog.md +71 -0
  12. data/docs/KnownIssues.md +91 -4
  13. data/examples/wondrous_forest/README.md +29 -1
  14. data/examples/wondrous_forest/src/ForestUnits.h +23 -0
  15. data/examples/wondrous_forest/src/RainGauge.c +59 -0
  16. data/examples/wondrous_forest/src/RainGauge.h +39 -0
  17. data/examples/wondrous_forest/src/RainTipIsr.c +17 -0
  18. data/examples/wondrous_forest/src/RainTipIsr.h +14 -0
  19. data/examples/wondrous_forest/test/TestRainGauge.c +126 -0
  20. data/lib/ceedling/c_extractor/README.md +15 -7
  21. data/lib/ceedling/c_extractor/c_extractor.rb +25 -14
  22. data/lib/ceedling/c_extractor/c_extractor_code_text.rb +84 -54
  23. data/lib/ceedling/c_extractor/c_extractor_constants.rb +18 -7
  24. data/lib/ceedling/c_extractor/c_extractor_declarations.rb +319 -283
  25. data/lib/ceedling/c_extractor/c_extractor_declarator.rb +285 -0
  26. data/lib/ceedling/c_extractor/c_extractor_defined_type.rb +111 -0
  27. data/lib/ceedling/c_extractor/c_extractor_definitions.rb +174 -121
  28. data/lib/ceedling/c_extractor/c_extractor_functions.rb +191 -162
  29. data/lib/ceedling/c_extractor/c_extractor_preprocessing.rb +46 -55
  30. data/lib/ceedling/c_extractor/c_extractor_statement.rb +30 -0
  31. data/lib/ceedling/c_extractor/c_extractor_types.rb +63 -41
  32. data/lib/ceedling/c_extractor/c_module_edits.rb +48 -0
  33. data/lib/ceedling/c_identifier.rb +21 -0
  34. data/lib/ceedling/ceedling.h +8 -0
  35. data/lib/ceedling/config/configurator.rb +4 -3
  36. data/lib/ceedling/config/configurator_builder.rb +17 -0
  37. data/lib/ceedling/config/configurator_setup.rb +29 -5
  38. data/lib/ceedling/constants.rb +5 -1
  39. data/lib/ceedling/defaults.rb +31 -1
  40. data/lib/ceedling/dependencies/CACHE_SCHEMA.md +118 -0
  41. data/lib/ceedling/dependencies/README.md +1 -1
  42. data/lib/ceedling/dependencies/dependency_cache_store.rb +30 -25
  43. data/lib/ceedling/dependencies/dependency_tracker.rb +9 -3
  44. data/lib/ceedling/dependencies/dependinator.rb +13 -1
  45. data/lib/ceedling/diagnostics/DOCTOR.md +142 -0
  46. data/lib/ceedling/diagnostics/README.md +5 -0
  47. data/lib/ceedling/diagnostics/build_step_doctor.rb +110 -0
  48. data/lib/ceedling/diagnostics/duplicate_symbol_specialist.rb +108 -0
  49. data/lib/ceedling/diagnostics/guidance_phrases.rb +30 -0
  50. data/lib/ceedling/diagnostics/header_collision_guidance.rb +56 -0
  51. data/lib/ceedling/diagnostics/header_collision_specialist.rb +152 -0
  52. data/lib/ceedling/diagnostics/include_depth_specialist.rb +132 -0
  53. data/lib/ceedling/diagnostics/missing_symbol_specialist.rb +111 -0
  54. data/lib/ceedling/diagnostics/partial_name_specialist.rb +134 -0
  55. data/lib/ceedling/diagnostics/toolchain_output.rb +44 -0
  56. data/lib/ceedling/filesystem/PATH_HANDLING.md +83 -27
  57. data/lib/ceedling/filesystem/README.md +6 -1
  58. data/lib/ceedling/filesystem/build_roots.rb +105 -0
  59. data/lib/ceedling/filesystem/build_subpath.rb +110 -25
  60. data/lib/ceedling/filesystem/file_finder.rb +76 -110
  61. data/lib/ceedling/filesystem/file_finder_helper.rb +33 -11
  62. data/lib/ceedling/filesystem/file_path_utils.rb +113 -91
  63. data/lib/ceedling/filesystem/file_wrapper.rb +105 -28
  64. data/lib/ceedling/filesystem/path_matcher.rb +21 -0
  65. data/lib/ceedling/filesystem/test_build_layout.rb +114 -0
  66. data/lib/ceedling/filesystem/win_long_paths.rb +153 -0
  67. data/lib/ceedling/filesystem/win_path_limit.rb +83 -0
  68. data/lib/ceedling/filesystem/win_path_prober.rb +52 -0
  69. data/lib/ceedling/generators/generator.rb +27 -64
  70. data/lib/ceedling/generators/generator_helper.rb +0 -44
  71. data/lib/ceedling/generators/generator_mocks.rb +5 -0
  72. data/lib/ceedling/generators/generator_partials.rb +305 -243
  73. data/lib/ceedling/generators/generator_test_runner.rb +5 -8
  74. data/lib/ceedling/generators/partial_header_writer.rb +95 -0
  75. data/lib/ceedling/generators/partial_source_writer.rb +137 -0
  76. data/lib/ceedling/includes/header_search.rb +225 -0
  77. data/lib/ceedling/includes/include_factory.rb +9 -12
  78. data/lib/ceedling/includes/include_pathinator.rb +53 -31
  79. data/lib/ceedling/includes/includes.rb +149 -37
  80. data/lib/ceedling/objects.yml +89 -4
  81. data/lib/ceedling/partials/README.md +110 -16
  82. data/lib/ceedling/partials/carry_plan.rb +71 -0
  83. data/lib/ceedling/partials/definition_head.rb +74 -0
  84. data/lib/ceedling/partials/include_groups.rb +37 -0
  85. data/lib/ceedling/partials/interface_extras.rb +25 -0
  86. data/lib/ceedling/partials/partializer.rb +599 -120
  87. data/lib/ceedling/partials/partializer_config.rb +5 -0
  88. data/lib/ceedling/partials/partializer_helper.rb +851 -145
  89. data/lib/ceedling/partials/partializer_reconciler.rb +174 -0
  90. data/lib/ceedling/partials/partializer_utils.rb +89 -109
  91. data/lib/ceedling/partials/partials.rb +153 -10
  92. data/lib/ceedling/partials/type_macros.rb +126 -0
  93. data/lib/ceedling/preprocess/README.md +43 -33
  94. data/lib/ceedling/preprocess/preprocessinator.rb +100 -186
  95. data/lib/ceedling/preprocess/preprocessinator_code_finder.rb +65 -72
  96. data/lib/ceedling/preprocess/preprocessinator_file_assembler.rb +31 -75
  97. data/lib/ceedling/preprocess/preprocessinator_reconstructor.rb +51 -14
  98. data/lib/ceedling/setupinator.rb +16 -3
  99. data/lib/ceedling/test_invoker/HEADER_COLLISIONS.md +21 -7
  100. data/lib/ceedling/test_invoker/PIPELINE.md +57 -16
  101. data/lib/ceedling/test_invoker/README.md +1 -1
  102. data/lib/ceedling/test_invoker/derived_search_path_notices.rb +45 -0
  103. data/lib/ceedling/test_invoker/mock_locator.rb +116 -9
  104. data/lib/ceedling/test_invoker/partial_files_preprocessinator.rb +181 -0
  105. data/lib/ceedling/test_invoker/partials_manager.rb +265 -308
  106. data/lib/ceedling/test_invoker/standin_headerinator.rb +8 -15
  107. data/lib/ceedling/test_invoker/test_bare_includes_extractinator.rb +26 -3
  108. data/lib/ceedling/test_invoker/test_build_executor.rb +338 -198
  109. data/lib/ceedling/test_invoker/test_build_planner.rb +13 -19
  110. data/lib/ceedling/test_invoker/test_build_setup.rb +26 -6
  111. data/lib/ceedling/test_invoker/test_build_validations.rb +23 -20
  112. data/lib/ceedling/test_invoker/test_derived_search_paths.rb +189 -0
  113. data/lib/ceedling/test_invoker/test_file_preprocessinator.rb +1 -2
  114. data/lib/ceedling/test_invoker/test_includes_reconcilinator.rb +1 -1
  115. data/lib/ceedling/test_invoker/test_invoker_types.rb +28 -20
  116. data/lib/ceedling/test_invoker/test_pipeline_helpers.rb +5 -3
  117. data/lib/ceedling/test_invoker/test_pipeline_manager.rb +25 -8
  118. data/lib/ceedling/test_invoker/test_runner_generatinator.rb +31 -3
  119. data/lib/ceedling/test_invoker/test_search_paths.rb +30 -8
  120. data/lib/ceedling/test_invoker/test_substitutions.rb +72 -0
  121. data/lib/ceedling/tools/shell_quoting.rb +45 -0
  122. data/lib/ceedling/tools/tool_quoting.rb +79 -0
  123. data/lib/ceedling/{tool_validator.rb → tools/tool_validator.rb} +18 -7
  124. data/lib/version.rb +1 -1
  125. data/plugins/bullseye/bullseye.rake +1 -3
  126. data/plugins/bullseye/lib/bullseye.rb +15 -2
  127. data/plugins/command_hooks/lib/command_hooks.rb +1 -1
  128. data/plugins/fff/lib/fff.rb +42 -15
  129. data/plugins/fff/lib/fff_mock_generator.rb +12 -9
  130. data/plugins/fff/spec/fff_cmock_wrapper_spec.rb +134 -0
  131. data/plugins/fff/spec/fff_mock_header_generator_spec.rb +9 -0
  132. data/plugins/fff/spec/fff_mock_source_generator_spec.rb +20 -0
  133. data/plugins/gcov/lib/console_reportinator.rb +25 -19
  134. data/plugins/gcov/lib/reportgenerator_reportinator.rb +2 -1
  135. data/site-local/404.html +2 -2
  136. data/site-local/assets/javascripts/{bundle.c21346df.min.js → bundle.a5f9d56c.min.js} +1 -1
  137. data/site-local/assets/javascripts/{bundle.c21346df.min.js.map → bundle.a5f9d56c.min.js.map} +2 -2
  138. data/site-local/configuration/environment-vars.html +2 -2
  139. data/site-local/configuration/global-collections.html +3 -3
  140. data/site-local/configuration/index.html +2 -2
  141. data/site-local/configuration/loading.html +2 -2
  142. data/site-local/configuration/mixins.html +2 -2
  143. data/site-local/configuration/parallel-builds.html +2 -2
  144. data/site-local/configuration/project-file.html +2 -2
  145. data/site-local/configuration/reference/cexception.html +2 -2
  146. data/site-local/configuration/reference/cmock.html +5 -2
  147. data/site-local/configuration/reference/defines.html +2 -2
  148. data/site-local/configuration/reference/environment.html +2 -2
  149. data/site-local/configuration/reference/extension.html +2 -2
  150. data/site-local/configuration/reference/files.html +56 -9
  151. data/site-local/configuration/reference/flags.html +2 -2
  152. data/site-local/configuration/reference/index.html +2 -2
  153. data/site-local/configuration/reference/libraries.html +2 -2
  154. data/site-local/configuration/reference/mixins.html +2 -2
  155. data/site-local/configuration/reference/partials.html +84 -2
  156. data/site-local/configuration/reference/paths.html +7 -2
  157. data/site-local/configuration/reference/plugins.html +2 -2
  158. data/site-local/configuration/reference/project.html +247 -5
  159. data/site-local/configuration/reference/release-build.html +2 -2
  160. data/site-local/configuration/reference/test-build.html +2 -2
  161. data/site-local/configuration/reference/test-runner.html +2 -2
  162. data/site-local/configuration/reference/tools.html +49 -4
  163. data/site-local/configuration/reference/unity.html +2 -2
  164. data/site-local/configuration/which-ceedling.html +2 -2
  165. data/site-local/development/index.html +2 -2
  166. data/site-local/development/plugins/configuration.html +2 -2
  167. data/site-local/development/plugins/index.html +2 -2
  168. data/site-local/development/plugins/plugin-subclass.html +5 -4
  169. data/site-local/development/plugins/rake-tasks.html +2 -2
  170. data/site-local/development/releases.html +2 -2
  171. data/site-local/development/workflow.html +2 -2
  172. data/site-local/getting-started/builds.html +2 -2
  173. data/site-local/getting-started/command-line.html +2 -2
  174. data/site-local/getting-started/example-projects/cipher-quest.html +2 -2
  175. data/site-local/getting-started/example-projects/index.html +2 -2
  176. data/site-local/getting-started/example-projects/temp-sensor.html +2 -2
  177. data/site-local/getting-started/example-projects/wondrous-forest.html +10 -2
  178. data/site-local/getting-started/index.html +2 -2
  179. data/site-local/getting-started/installation.html +2 -2
  180. data/site-local/getting-started/quick-start.html +2 -2
  181. data/site-local/help.html +2 -2
  182. data/site-local/index.html +2 -2
  183. data/site-local/overview/build-system.html +2 -2
  184. data/site-local/overview/index.html +2 -2
  185. data/site-local/overview/test-environments.html +2 -2
  186. data/site-local/overview/tools-and-frameworks.html +2 -2
  187. data/site-local/plugins/beep.html +2 -2
  188. data/site-local/plugins/bullseye/index.html +45 -38
  189. data/site-local/plugins/bullseye/licensing.html +2 -2
  190. data/site-local/plugins/command-hooks.html +4 -4
  191. data/site-local/plugins/compile-commands-json-db.html +2 -2
  192. data/site-local/plugins/cppcheck.html +2 -2
  193. data/site-local/plugins/dependencies.html +2 -2
  194. data/site-local/plugins/fff.html +16 -2
  195. data/site-local/plugins/gcov/examples.html +2 -2
  196. data/site-local/plugins/gcov/gcovr.html +8 -2
  197. data/site-local/plugins/gcov/index.html +2 -2
  198. data/site-local/plugins/gcov/overview.html +2 -2
  199. data/site-local/plugins/gcov/reportgenerator.html +18 -14
  200. data/site-local/plugins/gcov/reporting.html +2 -2
  201. data/site-local/plugins/gcov/setup.html +2 -2
  202. data/site-local/plugins/gcov/tool-versions.html +2 -2
  203. data/site-local/plugins/gcov/troubleshooting.html +2 -2
  204. data/site-local/plugins/index.html +2 -2
  205. data/site-local/plugins/module-generator.html +2 -2
  206. data/site-local/plugins/report-build-warnings-log.html +2 -2
  207. data/site-local/plugins/report-tests-gtestlike-stdout.html +2 -2
  208. data/site-local/plugins/report-tests-ide-stdout.html +2 -2
  209. data/site-local/plugins/report-tests-log-factory.html +2 -2
  210. data/site-local/plugins/report-tests-pretty-stdout.html +2 -2
  211. data/site-local/plugins/report-tests-raw-output-log.html +2 -2
  212. data/site-local/plugins/report-tests-teamcity-stdout.html +2 -2
  213. data/site-local/plugins/sanitize.html +2 -2
  214. data/site-local/plugins/valgrind.html +2 -2
  215. data/site-local/project/index.html +2 -2
  216. data/site-local/project/release-history.html +2 -2
  217. data/site-local/project/sbom.html +2 -2
  218. data/site-local/project/upgrade.html +2 -2
  219. data/site-local/reference/build-directives.html +2 -2
  220. data/site-local/reference/command-line.html +2 -2
  221. data/site-local/reference/environment-vars.html +2 -2
  222. data/site-local/reference/gcov-plugin.html +2 -2
  223. data/site-local/reference/global-collections.html +12 -12
  224. data/site-local/reference/index.html +2 -2
  225. data/site-local/reference/partials-macros.html +47 -2
  226. data/site-local/reference/project-configuration.html +2 -2
  227. data/site-local/sitemap.xml.gz +0 -0
  228. data/site-local/snapshot/examples/cipher_quest/index.html +2 -2
  229. data/site-local/snapshot/examples/temp_sensor/index.html +2 -2
  230. data/site-local/snapshot/examples/wondrous_forest/index.html +72 -15
  231. data/site-local/testing-guide/build-directives.html +2 -2
  232. data/site-local/testing-guide/conventions.html +67 -22
  233. data/site-local/testing-guide/frameworks.html +2 -2
  234. data/site-local/testing-guide/index.html +2 -2
  235. data/site-local/testing-guide/partials/configuration.html +31 -4
  236. data/site-local/testing-guide/partials/conventions.html +509 -8
  237. data/site-local/testing-guide/partials/directives.html +4 -3
  238. data/site-local/testing-guide/partials/example.html +2 -2
  239. data/site-local/testing-guide/partials/index.html +2 -2
  240. data/site-local/testing-guide/partials/overview.html +30 -12
  241. data/site-local/testing-guide/partials/variables.html +169 -4
  242. data/site-local/testing-guide/test-cases.html +2 -2
  243. data/site-local/testing-guide/test-sample.html +2 -2
  244. data/site-local/testing-guide/test-suite-anatomy.html +2 -2
  245. data/spec/integration/build_step_doctor_spec.rb +270 -0
  246. data/spec/integration/c_extractor_composition_spec.rb +254 -4
  247. data/spec/integration/includes_extraction_spec.rb +27 -14
  248. data/spec/integration/nested_test_artifacts_spec.rb +1 -1
  249. data/spec/integration/partial_files_preprocessing_spec.rb +128 -0
  250. data/spec/integration/partials_carry_spec.rb +520 -0
  251. data/spec/integration/partials_declarations_spec.rb +655 -0
  252. data/spec/integration/partials_fallback_preprocessing_spec.rb +65 -0
  253. data/spec/integration/partials_function_pointers_spec.rb +277 -0
  254. data/spec/integration/partials_header_composition_spec.rb +268 -35
  255. data/spec/integration/partials_macro_decorators_spec.rb +267 -0
  256. data/spec/integration/partials_module_resolution_spec.rb +26 -19
  257. data/spec/integration/partials_symbol_linkage_spec.rb +13 -0
  258. data/spec/integration/path_length_reporting_spec.rb +64 -0
  259. data/spec/integration/path_scenarios_spec.rb +80 -3
  260. data/spec/integration/quote_include_isolator_spec.rb +56 -0
  261. data/spec/integration/test_build_parallel_barrier_spec.rb +1 -1
  262. data/spec/integration/test_includes_extractinator_spec.rb +70 -5
  263. data/spec/integration/test_naming_spec.rb +6 -3
  264. data/spec/integration/test_source_file_checks_spec.rb +5 -3
  265. data/spec/integration/tool_executor_spec.rb +1 -1
  266. data/spec/integration/tool_validator_spec.rb +2 -2
  267. data/spec/integration/win_long_paths_probe_spec.rb +46 -0
  268. data/spec/integration/win_path_limit_spec.rb +53 -0
  269. data/spec/integration/windows_registry_query_tool_spec.rb +41 -0
  270. data/spec/support/integration/configurator_integration_helper.rb +8 -3
  271. data/spec/support/integration/partial_files_harness.rb +181 -0
  272. data/spec/support/integration/partials_generation_integration_helper.rb +237 -141
  273. data/spec/support/integration/path_scenario_harness.rb +4 -2
  274. data/spec/support/integration/spec_integration_helper.rb +8 -3
  275. data/spec/support/integration/test_includes_harness.rb +56 -35
  276. data/spec/support/integration/tool_executor_integration_helper.rb +14 -2
  277. data/spec/system/bullseye_deployment_spec.rb +2 -0
  278. data/spec/system/delta_builds_spec.rb +26 -12
  279. data/spec/system/encoding_stress_spec.rb +4 -4
  280. data/spec/system/example_wondrous_forest_spec.rb +2 -2
  281. data/spec/system/gcov_deployment_spec.rb +2 -0
  282. data/spec/system/header_include_path_validation_spec.rb +4 -4
  283. data/spec/system/header_search_paths_spec.rb +1083 -0
  284. data/spec/system/mock_include_folders_spec.rb +121 -0
  285. data/spec/system/mockable_header_reassembly_spec.rb +184 -0
  286. data/spec/system/partials_carry_spec.rb +581 -0
  287. data/spec/system/partials_delta_builds_spec.rb +280 -0
  288. data/spec/system/partials_function_pointers_spec.rb +106 -0
  289. data/spec/system/partials_macro_decorators_spec.rb +127 -0
  290. data/spec/system/partials_module_disambiguation_spec.rb +125 -0
  291. data/spec/system/path_handling_probes_spec.rb +16 -12
  292. data/spec/system/pinned_thread_count_spec.rb +4 -4
  293. data/spec/system/preprocessing_fallback_conditionals_spec.rb +1 -1
  294. data/spec/system/short_build_paths_spec.rb +87 -0
  295. data/spec/system/sibling_header_collision_spec.rb +30 -6
  296. data/spec/system/support/bullseye_common_test_cases.rb +42 -0
  297. data/spec/system/support/common_test_cases.rb +2 -2
  298. data/spec/system/support/gcov_partials_test_cases.rb +48 -0
  299. data/spec/system/test_build_layout_spec.rb +209 -0
  300. data/spec/system/test_source_file_directive_spec.rb +35 -5
  301. data/spec/units/c_extractor/c_extractor_code_text_spec.rb +67 -10
  302. data/spec/units/c_extractor/c_extractor_declarations_spec.rb +501 -4
  303. data/spec/units/c_extractor/c_extractor_declarator_spec.rb +245 -0
  304. data/spec/units/c_extractor/c_extractor_defined_type_spec.rb +45 -0
  305. data/spec/units/c_extractor/c_extractor_definitions_spec.rb +163 -3
  306. data/spec/units/c_extractor/c_extractor_functions_spec.rb +462 -21
  307. data/spec/units/c_extractor/c_extractor_preprocessing_spec.rb +39 -0
  308. data/spec/units/c_extractor/c_extractor_spec.rb +4 -4
  309. data/spec/units/c_extractor/c_extractor_types_spec.rb +163 -0
  310. data/spec/units/c_identifier_spec.rb +35 -0
  311. data/spec/units/config/configurator_builder_spec.rb +24 -0
  312. data/spec/units/config/configurator_setup_spec.rb +72 -4
  313. data/spec/units/config/configurator_spec.rb +27 -1
  314. data/spec/units/dependencies/dependency_cache_store_spec.rb +68 -3
  315. data/spec/units/dependencies/dependency_tracker_spec.rb +25 -0
  316. data/spec/units/dependencies/dependinator_spec.rb +17 -2
  317. data/spec/units/diagnostics/build_step_doctor_spec.rb +170 -0
  318. data/spec/units/diagnostics/duplicate_symbol_specialist_spec.rb +117 -0
  319. data/spec/units/diagnostics/header_collision_specialist_spec.rb +267 -0
  320. data/spec/units/diagnostics/include_depth_specialist_spec.rb +137 -0
  321. data/spec/units/diagnostics/missing_symbol_specialist_spec.rb +154 -0
  322. data/spec/units/diagnostics/partial_name_specialist_spec.rb +129 -0
  323. data/spec/units/diagnostics/toolchain_output_spec.rb +86 -0
  324. data/spec/units/encodinator_spec.rb +3 -4
  325. data/spec/units/filesystem/build_roots_spec.rb +131 -0
  326. data/spec/units/filesystem/build_subpath_spec.rb +113 -0
  327. data/spec/units/filesystem/file_finder_helper_spec.rb +80 -0
  328. data/spec/units/filesystem/file_finder_spec.rb +242 -58
  329. data/spec/units/filesystem/file_path_utils_spec.rb +251 -118
  330. data/spec/units/filesystem/file_wrapper_spec.rb +191 -6
  331. data/spec/units/filesystem/path_matcher_spec.rb +36 -0
  332. data/spec/units/filesystem/test_build_layout_spec.rb +216 -0
  333. data/spec/units/filesystem/win_long_paths_spec.rb +204 -0
  334. data/spec/units/filesystem/win_path_prober_spec.rb +158 -0
  335. data/spec/units/generators/generator_helper_spec.rb +0 -60
  336. data/spec/units/generators/generator_mocks_spec.rb +13 -0
  337. data/spec/units/generators/generator_partials_spec.rb +656 -55
  338. data/spec/units/generators/generator_spec.rb +26 -0
  339. data/spec/units/generators/generator_test_runner_spec.rb +9 -5
  340. data/spec/units/generators/partial_source_writer_spec.rb +129 -0
  341. data/spec/units/includes/header_search_spec.rb +406 -0
  342. data/spec/units/includes/include_factory_spec.rb +22 -5
  343. data/spec/units/includes/include_pathinator_spec.rb +77 -13
  344. data/spec/units/includes/include_spec.rb +14 -0
  345. data/spec/units/includes/includes_spec.rb +176 -19
  346. data/spec/units/loginator_spec.rb +31 -0
  347. data/spec/units/mock_locator_spec.rb +199 -5
  348. data/spec/units/partials/include_groups_spec.rb +42 -0
  349. data/spec/units/partials/partializer_config_spec.rb +25 -0
  350. data/spec/units/partials/partializer_helper_carry_spec.rb +661 -0
  351. data/spec/units/partials/partializer_helper_interface_extras_spec.rb +396 -0
  352. data/spec/units/partials/partializer_helper_spec.rb +529 -277
  353. data/spec/units/partials/partializer_reconciler_spec.rb +661 -0
  354. data/spec/units/partials/partializer_spec.rb +1578 -270
  355. data/spec/units/partials/partializer_utils_spec.rb +269 -232
  356. data/spec/units/partials/partials_rename_spec.rb +160 -0
  357. data/spec/units/partials_manager_spec.rb +554 -261
  358. data/spec/units/plugins/bullseye_spec.rb +34 -0
  359. data/spec/units/plugins/console_reportinator_spec.rb +58 -9
  360. data/spec/units/plugins/report_tests_teamcity_stdout_spec.rb +1 -1
  361. data/spec/units/plugins/reportgenerator_reportinator_spec.rb +51 -3
  362. data/spec/units/preprocess/preprocessinator_code_finder_spec.rb +73 -10
  363. data/spec/units/preprocess/preprocessinator_file_assembler_spec.rb +125 -37
  364. data/spec/units/preprocess/preprocessinator_includes_handler_spec.rb +15 -0
  365. data/spec/units/preprocess/preprocessinator_reconstructor_spec.rb +197 -0
  366. data/spec/units/preprocess/preprocessinator_spec.rb +153 -95
  367. data/spec/units/setupinator_spec.rb +51 -0
  368. data/spec/units/standin_headerinator_spec.rb +27 -11
  369. data/spec/units/test_build_executor_spec.rb +780 -166
  370. data/spec/units/test_build_planner_spec.rb +116 -28
  371. data/spec/units/test_build_setup_spec.rb +83 -18
  372. data/spec/units/test_context_extractor_spec.rb +11 -2
  373. data/spec/units/test_derived_search_paths_spec.rb +259 -0
  374. data/spec/units/test_includes_extractinator_spec.rb +56 -8
  375. data/spec/units/test_invoker/objects_wiring_spec.rb +20 -3
  376. data/spec/units/test_invoker/partial_files_preprocessinator_spec.rb +264 -0
  377. data/spec/units/test_invoker/test_substitutions_spec.rb +122 -0
  378. data/spec/units/test_invoker_types_spec.rb +8 -7
  379. data/spec/units/test_pipeline_manager_spec.rb +54 -13
  380. data/spec/units/test_runner_generatinator_spec.rb +93 -1
  381. data/spec/units/test_search_paths_spec.rb +73 -5
  382. data/spec/units/{default_tools_quoting_spec.rb → tools/default_tools_quoting_spec.rb} +39 -5
  383. data/spec/units/tools/shell_quoting_spec.rb +76 -0
  384. data/spec/units/{tool_executor_helper_spec.rb → tools/tool_executor_helper_spec.rb} +1 -1
  385. data/spec/units/{tool_executor_spec.rb → tools/tool_executor_spec.rb} +1 -1
  386. data/spec/units/{tool_validator_spec.rb → tools/tool_validator_spec.rb} +110 -1
  387. data/spec/units/windows_registry_query_tool_spec.rb +53 -0
  388. metadata +161 -16
  389. /data/lib/ceedling/{tool_executor.rb → tools/tool_executor.rb} +0 -0
  390. /data/lib/ceedling/{tool_executor_helper.rb → tools/tool_executor_helper.rb} +0 -0
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -5015,7 +5015,7 @@ is unknown:</p>
5015
5015
  <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>
5016
5016
 
5017
5017
 
5018
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
5018
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
5019
5019
 
5020
5020
 
5021
5021
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -4344,7 +4344,7 @@ alongside every release.</p>
4344
4344
  <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>
4345
4345
 
4346
4346
 
4347
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4347
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4348
4348
 
4349
4349
 
4350
4350
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -4468,7 +4468,7 @@ release.</p>
4468
4468
  <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>
4469
4469
 
4470
4470
 
4471
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4471
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4472
4472
 
4473
4473
 
4474
4474
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -4705,7 +4705,7 @@ Ruby dependency. Those are the components most likely to matter to a C project.<
4705
4705
  <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>
4706
4706
 
4707
4707
 
4708
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4708
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4709
4709
 
4710
4710
 
4711
4711
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -4560,7 +4560,7 @@ not exist soon.</p>
4560
4560
  <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>
4561
4561
 
4562
4562
 
4563
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4563
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4564
4564
 
4565
4565
 
4566
4566
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -4462,7 +4462,7 @@ entries from your project file.</p>
4462
4462
  <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>
4463
4463
 
4464
4464
 
4465
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4465
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4466
4466
 
4467
4467
 
4468
4468
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -5362,7 +5362,7 @@ command line unless verbosity has been set to an appreciable level.</p>
5362
5362
  <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>
5363
5363
 
5364
5364
 
5365
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
5365
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
5366
5366
 
5367
5367
 
5368
5368
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -4521,7 +4521,7 @@ font (3) set <code>CEEDLING_DECORATORS</code> to <code>true</code>.</p>
4521
4521
  <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>
4522
4522
 
4523
4523
 
4524
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4524
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4525
4525
 
4526
4526
 
4527
4527
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -6407,7 +6407,7 @@ covered by the options above. See the
6407
6407
  <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>
6408
6408
 
6409
6409
 
6410
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
6410
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
6411
6411
 
6412
6412
 
6413
6413
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -4439,7 +4439,7 @@ having the configured source file extension. </p>
4439
4439
  <p><code>COLLECTION_ALL_HEADERS</code>:</p>
4440
4440
  <p>All files with path found in the configured include,
4441
4441
  support, and test paths having the configured header file
4442
- extension. </p>
4442
+ extension, revised by <code>:files</code> ↳ <code>:include</code>.</p>
4443
4443
  </li>
4444
4444
  <li>
4445
4445
  <p><code>COLLECTION_ALL_SUPPORT</code>:</p>
@@ -4472,8 +4472,8 @@ paths having the configured source file extension. </p>
4472
4472
  <li>
4473
4473
  <p><code>COLLECTION_PATHS_SOURCE_INCLUDE_VENDOR</code>:</p>
4474
4474
  <p>All configured source and include paths plus applicable
4475
- vendor paths (Unity's source path plus CMock and
4476
- CException's source paths if mocks and exceptions are
4475
+ vendor paths (Unity’s source path plus CMock and
4476
+ CException’s source paths if mocks and exceptions are
4477
4477
  enabled).</p>
4478
4478
  </li>
4479
4479
  <li>
@@ -4483,8 +4483,8 @@ enabled).</p>
4483
4483
  <li>
4484
4484
  <p><code>COLLECTION_PATHS_TEST_SUPPORT_SOURCE_INCLUDE_VENDOR</code>:</p>
4485
4485
  <p>All test, support, source, include, and applicable
4486
- vendor paths (Unity's source path plus CMock and
4487
- CException's source paths if mocks and exceptions are
4486
+ vendor paths (Unity’s source path plus CMock and
4487
+ CException’s source paths if mocks and exceptions are
4488
4488
  enabled).</p>
4489
4489
  </li>
4490
4490
  <li>
@@ -4497,7 +4497,7 @@ enabled).</p>
4497
4497
  </li>
4498
4498
  <li>
4499
4499
  <p><code>COLLECTION_PATHS_VENDOR</code>:</p>
4500
- <p>Unity's source path plus CMock and CException's source
4500
+ <p>Unity’s source path plus CMock and CException’s source
4501
4501
  paths if mocks and exceptions are enabled.</p>
4502
4502
  </li>
4503
4503
  </ul>
@@ -4522,7 +4522,7 @@ paths if mocks and exceptions are enabled.</p>
4522
4522
  paths having the configured source file extension.</li>
4523
4523
  <li>All files with path found in the configured test
4524
4524
  paths having the configured source file extension.</li>
4525
- <li>Unity's source files.</li>
4525
+ <li>Unity’s source files.</li>
4526
4526
  <li>If exceptions are enabled, the source files for
4527
4527
  CException.</li>
4528
4528
  <li>If mocks are enabled, the C source files for CMock.</li>
@@ -4534,7 +4534,7 @@ paths if mocks and exceptions are enabled.</p>
4534
4534
  Ceedling and its supporting frameworks at build time
4535
4535
  (e.g. test runners and mocks). Further, this collection
4536
4536
  does not include source files added to a test
4537
- executable's build list with the <code>TEST_SOURCE_FILE()</code>
4537
+ executable’s build list with the <code>TEST_SOURCE_FILE()</code>
4538
4538
  build directive macro.</p>
4539
4539
  </li>
4540
4540
  </ul>
@@ -4542,12 +4542,12 @@ build directive macro.</p>
4542
4542
  <ul>
4543
4543
  <li>
4544
4544
  <p><code>COLLECTION_VENDOR_FRAMEWORK_SOURCES</code>:</p>
4545
- <p>Unity plus CMock, and CException's .c filenames (without
4545
+ <p>Unity plus CMock, and CException’s .c filenames (without
4546
4546
  paths) if mocks and exceptions are enabled.</p>
4547
4547
  </li>
4548
4548
  <li>
4549
4549
  <p><code>COLLECTION_RELEASE_ARTIFACT_EXTRA_LINK_OBJECTS</code>:</p>
4550
- <p>If exceptions are enabled, CException's .c filenames
4550
+ <p>If exceptions are enabled, CException’s .c filenames
4551
4551
  (without paths) remapped to configured object file
4552
4552
  extension.</p>
4553
4553
  </li>
@@ -4628,7 +4628,7 @@ remapped to configured object file extension.</p>
4628
4628
  <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>
4629
4629
 
4630
4630
 
4631
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4631
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4632
4632
 
4633
4633
 
4634
4634
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -4369,7 +4369,7 @@ those for advanced reports with GCovr and ReportGenerator.</p>
4369
4369
  <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>
4370
4370
 
4371
4371
 
4372
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4372
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4373
4373
 
4374
4374
 
4375
4375
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -3679,6 +3679,17 @@
3679
3679
  </span>
3680
3680
  </a>
3681
3681
 
3682
+ </li>
3683
+
3684
+ <li class="md-nav__item">
3685
+ <a href="#variable-type-names" class="md-nav__link">
3686
+ <span class="md-ellipsis">
3687
+
3688
+ Variable type names
3689
+
3690
+ </span>
3691
+ </a>
3692
+
3682
3693
  </li>
3683
3694
 
3684
3695
  </ul>
@@ -4358,6 +4369,17 @@
4358
4369
  </span>
4359
4370
  </a>
4360
4371
 
4372
+ </li>
4373
+
4374
+ <li class="md-nav__item">
4375
+ <a href="#variable-type-names" class="md-nav__link">
4376
+ <span class="md-ellipsis">
4377
+
4378
+ Variable type names
4379
+
4380
+ </span>
4381
+ </a>
4382
+
4361
4383
  </li>
4362
4384
 
4363
4385
  </ul>
@@ -4508,6 +4530,29 @@ identifier <code>partial_&lt;function_name&gt;_&lt;variable_name&gt;</code>.</p>
4508
4530
  <li>Can appear anywhere a variable name is legal: expressions, assertions,
4509
4531
  assignments</li>
4510
4532
  </ul>
4533
+ <hr />
4534
+ <h2 id="variable-type-names">Variable type names</h2>
4535
+ <div class="admonition tip">
4536
+ <p class="admonition-title">Tip</p>
4537
+ <p>For how a Partial names the type of a variable declared together with its
4538
+ type, see
4539
+ <a href="../testing-guide/partials/variables.html#a-variable-declared-together-with-its-type">A variable declared together with its type</a>.</p>
4540
+ </div>
4541
+ <p><strong><code>PARTIAL_TYPE(module_name, variable_name)</code></strong></p>
4542
+ <p>Names the type a Partial gives a variable declared together with its type, as
4543
+ in <code>static struct { int count; } s_ctx;</code>. The macro expands to
4544
+ <code>ceedling_partial_&lt;module_name&gt;_&lt;variable_name&gt;_t</code>.</p>
4545
+ <p><strong><code>PARTIAL_LOCAL_TYPE(module_name, function_name, variable_name)</code></strong></p>
4546
+ <p>Names the type of a promoted function-scoped <code>static</code> declared together with
4547
+ its type. The macro expands to
4548
+ <code>ceedling_partial_&lt;module_name&gt;_&lt;function_name&gt;_&lt;variable_name&gt;_t</code>.</p>
4549
+ <ul>
4550
+ <li>Defined in <code>ceedling.h</code>; requires <code>#include "ceedling.h"</code> above its use</li>
4551
+ <li>Every argument must be a literal C identifier — not a string or runtime value</li>
4552
+ <li>The module name is the name alone, without a directory, with <code>_</code> for each
4553
+ character a C identifier can't hold</li>
4554
+ <li>Can appear anywhere a type name is legal: declarations, casts, <code>sizeof</code></li>
4555
+ </ul>
4511
4556
  <p><br/><br/></p>
4512
4557
 
4513
4558
 
@@ -4579,7 +4624,7 @@ identifier <code>partial_&lt;function_name&gt;_&lt;variable_name&gt;</code>.</p>
4579
4624
  <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>
4580
4625
 
4581
4626
 
4582
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4627
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4583
4628
 
4584
4629
 
4585
4630
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -4496,7 +4496,7 @@ left unset.</p>
4496
4496
  <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>
4497
4497
 
4498
4498
 
4499
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4499
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4500
4500
 
4501
4501
 
4502
4502
  </body>
Binary file
@@ -17,7 +17,7 @@
17
17
 
18
18
 
19
19
  <link rel="icon" href="../../../assets/images/favicon.png">
20
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
20
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
21
21
 
22
22
 
23
23
 
@@ -4535,7 +4535,7 @@ characters (colons, brackets, spaces) from shell interpretation:</p>
4535
4535
  <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>
4536
4536
 
4537
4537
 
4538
- <script src="../../../assets/javascripts/bundle.c21346df.min.js"></script>
4538
+ <script src="../../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4539
4539
 
4540
4540
 
4541
4541
  </body>
@@ -17,7 +17,7 @@
17
17
 
18
18
 
19
19
  <link rel="icon" href="../../../assets/images/favicon.png">
20
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
20
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
21
21
 
22
22
 
23
23
 
@@ -4659,7 +4659,7 @@ registers the helper with CMock:</p>
4659
4659
  <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>
4660
4660
 
4661
4661
 
4662
- <script src="../../../assets/javascripts/bundle.c21346df.min.js"></script>
4662
+ <script src="../../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4663
4663
 
4664
4664
 
4665
4665
  </body>
@@ -17,7 +17,7 @@
17
17
 
18
18
 
19
19
  <link rel="icon" href="../../../assets/images/favicon.png">
20
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
20
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
21
21
 
22
22
 
23
23
 
@@ -4200,6 +4200,17 @@
4200
4200
  </span>
4201
4201
  </a>
4202
4202
 
4203
+ </li>
4204
+
4205
+ <li class="md-nav__item">
4206
+ <a href="#what-a-partial-carries" class="md-nav__link">
4207
+ <span class="md-ellipsis">
4208
+
4209
+ What a Partial Carries
4210
+
4211
+ </span>
4212
+ </a>
4213
+
4203
4214
  </li>
4204
4215
 
4205
4216
  <li class="md-nav__item">
@@ -4280,6 +4291,8 @@ Ceedling's Partials feature alongside traditional mock-based testing.</p>
4280
4291
  and <code>static</code> variables that are normally inaccessible to the linker</li>
4281
4292
  <li><strong>Every major Partials pattern</strong> across a range of sensor and system modules</li>
4282
4293
  <li><strong>Partials and mocks used together</strong> in the same test suite</li>
4294
+ <li><strong>Carrying</strong> — a Partial bringing along the helpers, prototypes, and
4295
+ variables its selected functions rely on</li>
4283
4296
  </ul>
4284
4297
  <p>This project is test-suite only (no release build).</p>
4285
4298
  <hr />
@@ -4298,19 +4311,24 @@ Ceedling's Partials feature alongside traditional mock-based testing.</p>
4298
4311
  <a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>│ ├── ForestMonitor.c/.h
4299
4312
  <a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>│ ├── SensorHal.c/.h
4300
4313
  <a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a>│ ├── UartDriver.c/.h
4301
- <a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a>│ ├── sensors/soil/Calibration.c/.h # Same module name as the one below
4302
- <a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>│ ├── sensors/light/Calibration.c/.h # Told apart by directory
4303
- <a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>│ └── Types.h
4304
- <a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a>└── test/ # Test files — Using Partials and traditional assertions/mocks
4305
- <a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a> ├── TestTemperatureSensor.c
4306
- <a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a> ├── TestHumiditySensor.c
4307
- <a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a> ├── TestLightSensor.c
4308
- <a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a> ├── TestSoilMoisture.c
4309
- <a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a> ├── TestAlertManager.c
4310
- <a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a> ├── TestEventQueue.c
4311
- <a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a> ├── TestForestMonitor.c
4312
- <a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a> ├── TestSensorHal.c
4313
- <a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a> └── TestUartDriver.c
4314
+ <a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a>│ ├── RainGauge.c/.h
4315
+ <a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>│ ├── RainTipIsr.c/.h # Defines the tip counter RainGauge.h declares extern
4316
+ <a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>│ ├── ForestUnits.h # C99 inline functions, no source file of its own
4317
+ <a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a>│ ├── sensors/soil/Calibration.c/.h # Same module name as the one below
4318
+ <a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a>│ ├── sensors/light/Calibration.c/.h # Told apart by directory
4319
+ <a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a>│ └── Types.h
4320
+ <a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a>└── test/ # Test files — Using Partials and traditional assertions/mocks
4321
+ <a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a> ├── TestTemperatureSensor.c
4322
+ <a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a> ├── TestHumiditySensor.c
4323
+ <a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a> ├── TestLightSensor.c
4324
+ <a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a> ├── TestSoilMoisture.c
4325
+ <a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a> ├── TestAlertManager.c
4326
+ <a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a> ├── TestEventQueue.c
4327
+ <a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a> ├── TestForestMonitor.c
4328
+ <a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a> ├── TestSensorHal.c
4329
+ <a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a> ├── TestUartDriver.c
4330
+ <a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a> ├── TestRainGauge.c
4331
+ <a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a> └── TestCalibration.c
4314
4332
  </code></pre></div>
4315
4333
  <hr />
4316
4334
  <h2 id="partials-patterns-used">Partials Patterns Used</h2>
@@ -4362,8 +4380,47 @@ Ceedling's Partials feature alongside traditional mock-based testing.</p>
4362
4380
  <td>TestCalibration.c</td>
4363
4381
  <td><code>TEST_PARTIAL_PRIVATE_MODULE_AT</code> — two same-named modules</td>
4364
4382
  </tr>
4383
+ <tr>
4384
+ <td>TestRainGauge.c</td>
4385
+ <td><code>TEST_PARTIAL_PUBLIC_MODULE</code> + a subtracted, stubbed function</td>
4386
+ </tr>
4387
+ </tbody>
4388
+ </table>
4389
+ <hr />
4390
+ <h2 id="what-a-partial-carries">What a Partial Carries</h2>
4391
+ <p>A Partial brings along what its selected functions rely on. <code>TestRainGauge.c</code>
4392
+ selects RainGauge's public functions and subtracts one of them. Those
4393
+ functions rely on code the test does not select, so the Partial carries it.
4394
+ Run the test with <code>--verbosity=debug</code> to see each carried item and why.</p>
4395
+ <table>
4396
+ <thead>
4397
+ <tr>
4398
+ <th>Carried item</th>
4399
+ <th>Why the Partial needs it</th>
4400
+ </tr>
4401
+ </thead>
4402
+ <tbody>
4403
+ <tr>
4404
+ <td><code>RainGauge_TipsToMicrometers()</code></td>
4405
+ <td><code>RainGauge.h</code> defines this <code>static inline</code> helper, and <code>RainGauge_Update()</code> calls it</td>
4406
+ </tr>
4407
+ <tr>
4408
+ <td><code>extern inline</code> prototype of <code>ForestUnits_MicrometersToTenthsMm()</code></td>
4409
+ <td><code>ForestUnits.h</code> defines the function C99 <code>inline</code>. The prototype makes the Partial hold its external definition</td>
4410
+ </tr>
4411
+ <tr>
4412
+ <td>Prototype of <code>RainGauge_ReportStorm()</code></td>
4413
+ <td>The test subtracts this function and defines a stub. <code>RainGauge_Update()</code> calls the stub</td>
4414
+ </tr>
4415
+ <tr>
4416
+ <td>Weak definition of <code>g_rain_tip_count</code></td>
4417
+ <td><code>RainGauge.h</code> declares the counter <code>extern</code>. Its real definition in <code>RainTipIsr.c</code>, which the test links, takes precedence</td>
4418
+ </tr>
4365
4419
  </tbody>
4366
4420
  </table>
4421
+ <p>Each carried item keeps its original spelling. A <code>#line</code> directive ahead of
4422
+ each points back to its original file and line. Coverage of the carried
4423
+ helper therefore counts toward <code>RainGauge.h</code>.</p>
4367
4424
  <hr />
4368
4425
  <h2 id="running-the-tests">Running the Tests</h2>
4369
4426
  <p>Run all tests:</p>
@@ -4449,7 +4506,7 @@ Ceedling's Partials feature alongside traditional mock-based testing.</p>
4449
4506
  <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>
4450
4507
 
4451
4508
 
4452
- <script src="../../../assets/javascripts/bundle.c21346df.min.js"></script>
4509
+ <script src="../../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4453
4510
 
4454
4511
 
4455
4512
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -4800,7 +4800,7 @@ per line within your test file.</p>
4800
4800
  <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>
4801
4801
 
4802
4802
 
4803
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4803
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4804
4804
 
4805
4805
 
4806
4806
  </body>