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
@@ -56,8 +56,8 @@ ceedling_system_tests do
56
56
  output = @c.ceedling_build_exec("test:all")
57
57
 
58
58
  expect(@c.last_exit_status).to eq(0)
59
- expect(output).to match(/TESTED:\s+71/)
60
- expect(output).to match(/PASSED:\s+71/)
59
+ expect(output).to match(/TESTED:\s+80/)
60
+ expect(output).to match(/PASSED:\s+80/)
61
61
  expect(output).to match(/FAILED:\s+0/)
62
62
  end
63
63
  end
@@ -73,8 +73,8 @@ ceedling_system_tests do
73
73
  output = @c.ceedling_build_exec("test:all")
74
74
 
75
75
  expect(@c.last_exit_status).to eq(0)
76
- expect(output).to match(/TESTED:\s+71/)
77
- expect(output).to match(/PASSED:\s+71/)
76
+ expect(output).to match(/TESTED:\s+80/)
77
+ expect(output).to match(/PASSED:\s+80/)
78
78
  expect(output).to match(/FAILED:\s+0/)
79
79
  end
80
80
  end
@@ -18,7 +18,7 @@ require 'spec_system_helper'
18
18
  ##
19
19
  ## The primary fallback use case is Partials processing: Ceedling reads
20
20
  ## source/header files through collect_file_contents_fallback (called by
21
- ## preprocess_partial_header/source_file_preserve_macros) and the #ifdef
21
+ ## Preprocessinator#preprocess_partial_file) and the #ifdef
22
22
  ## guards in those files determine what code appears in the generated
23
23
  ## partial implementation. The test file mirrors the same define-based
24
24
  ## conditions to include the corresponding mock and select test cases.
@@ -0,0 +1,87 @@
1
+ # =========================================================================
2
+ # Ceedling - Test-Centered Build System for C
3
+ # ThrowTheSwitch.org
4
+ # Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
5
+ # SPDX-License-Identifier: MIT
6
+ # =========================================================================
7
+
8
+ require 'spec_system_helper'
9
+ require 'tmpdir'
10
+ require 'yaml'
11
+
12
+ ##
13
+ ## Shortened Build Roots Through Real Builds (GH #1387)
14
+ ## =====================================================
15
+ ##
16
+ ## A vendor include root far outside the project and a source root nested deep inside it
17
+ ## each add their whole location to every build path below them. A build places those files
18
+ ## below each root's short marker instead, finds every source from its object, rebuilds
19
+ ## nothing when nothing changed, and lists the markers in build/build_roots.yml.
20
+ ##
21
+
22
+ SHORT_ROOTS_TEST_PREAMBLE = "#include \"unity.h\"\nvoid setUp(void) {}\nvoid tearDown(void) {}\n"
23
+
24
+ ceedling_system_tests do
25
+ include_context "a fresh ceedling gem project", "short_roots"
26
+
27
+ def write(path, content)
28
+ FileUtils.mkdir_p( File.dirname( path ) )
29
+ File.write( path, content )
30
+ end
31
+
32
+ # The project, a vendor SDK in `far`, and a configuration naming both long roots
33
+ def short_roots_project(far)
34
+ sdk = File.join( File.realpath( far ), 'deep', 'sdk', 'inc' )
35
+ write( File.join( sdk, 'os', 'vendor_os.h' ), "#define VENDOR_OS_TICKS 3\n" )
36
+
37
+ write( 'lib/vendor/acme/hal/hal.h', "int hal_value(void);\n" )
38
+ write( 'lib/vendor/acme/hal/hal.c', "#include \"hal.h\"\n#include \"os/vendor_os.h\"\nint hal_value(void) { return VENDOR_OS_TICKS; }\n" )
39
+ write( 'src/main.c', "#include \"hal.h\"\nint main(void) { return hal_value() - 3; }\n" )
40
+ write( 'test/test_hal.c', SHORT_ROOTS_TEST_PREAMBLE + "#include \"hal.h\"\nvoid test_value(void) { TEST_ASSERT_EQUAL_INT(3, hal_value()); }\n" )
41
+
42
+ @c.merge_project_yml_for_test( {
43
+ :project => { :release_build => true },
44
+ :paths => { :source => ['src/**', 'lib/vendor/acme/hal/**'], :include => ['lib/vendor/acme/hal/**', sdk] }
45
+ } )
46
+
47
+ return sdk
48
+ end
49
+
50
+ it "places build files below each long root's marker, and rebuilds nothing when nothing changed" do
51
+ Dir.mktmpdir do |far|
52
+ in_project do
53
+ short_roots_project( far )
54
+
55
+ output = @c.ceedling_build_exec( "test:all" )
56
+ expect(@c.last_exit_status).to eq(0), output
57
+ expect(output).to match(/PASSED:\s+1/)
58
+
59
+ roots = YAML.safe_load( File.read( 'build/build_roots.yml' ) )
60
+ expect(roots.values).to include( 'lib/vendor/acme/hal', end_with( 'deep/sdk/inc' ) )
61
+
62
+ hal_marker = roots.key( 'lib/vendor/acme/hal' )
63
+ expect(Dir.glob( "build/test/out/test/test_hal/_t_/#{hal_marker}/hal.o" )).to_not be_empty
64
+
65
+ rebuild = @c.ceedling_build_exec( "test:all" )
66
+ expect(@c.last_exit_status).to eq(0), rebuild
67
+ expect(rebuild).to_not match(/^Compiling /)
68
+ expect(rebuild).to_not match(/^Linking /)
69
+ end
70
+ end
71
+ end
72
+
73
+ it "places a release build's objects below each long root's marker" do
74
+ Dir.mktmpdir do |far|
75
+ in_project do
76
+ short_roots_project( far )
77
+
78
+ output = @c.ceedling_build_exec( "release" )
79
+ expect(@c.last_exit_status).to eq(0), output
80
+
81
+ hal_marker = YAML.safe_load( File.read( 'build/build_roots.yml' ) ).key( 'lib/vendor/acme/hal' )
82
+ expect(File.exist?( "build/release/out/#{hal_marker}/hal.o" )).to be( true )
83
+ expect(File.exist?( 'build/release/out/src/main.o' )).to be( true )
84
+ end
85
+ end
86
+ end
87
+ end
@@ -204,6 +204,31 @@ ceedling_system_tests do
204
204
  expect(output).to match(/Isolated '.*driverlib\.h'.*shares a directory with '.*gpio\.h'/)
205
205
  end
206
206
  end
207
+
208
+ # The isolation directory takes a new name every build and is removed afterward.
209
+ # Dependency tracking weighs the isolated originals, so nothing it names ever changes.
210
+ it "compiles nothing on an unchanged rebuild" do
211
+ in_project do
212
+ @c.ceedling_build_exec("test:all")
213
+ output = @c.ceedling_build_exec("test:all")
214
+
215
+ expect(@c.last_exit_status).to eq(0)
216
+ expect(output).to_not match(/^Compiling /)
217
+ expect(output).to match(/Skipping compilation for \d+ objects/)
218
+ end
219
+ end
220
+
221
+ # moduleA.c reaches driverlib.h through board.h, by way of the isolated copy
222
+ it "recompiles an object that reaches the isolated original when the original changes" do
223
+ in_project do
224
+ @c.ceedling_build_exec("test:all")
225
+ File.write('library/driverlib.h', DRIVERLIB_HEADER_C + "// edited\n")
226
+ output = @c.ceedling_build_exec("test:all")
227
+
228
+ expect(@c.last_exit_status).to eq(0)
229
+ expect(output).to match(/^Compiling .*moduleA\.c/)
230
+ end
231
+ end
207
232
  end
208
233
 
209
234
  # =========================================================================
@@ -401,7 +426,7 @@ ceedling_system_tests do
401
426
  end
402
427
  end
403
428
 
404
- it "still resolves the genuine collision, but only reports -- never isolates -- the unrelated pair" do
429
+ it "still resolves the genuine collision, and neither reports nor isolates the unrelated pair" do
405
430
  in_project do
406
431
  output = @c.ceedling_build_exec("test:all")
407
432
 
@@ -412,9 +437,8 @@ ceedling_system_tests do
412
437
 
413
438
  expect(output).to match(/Isolated '.*driverlib\.h'.*shares a directory with '.*gpio\.h'/)
414
439
 
415
- expect(output).to match(/NOTICE:.*extra_a\.h.*extra_b\.h.*nesting depth/).or(
416
- match(/NOTICE:.*extra_b\.h.*extra_a\.h.*nesting depth/)
417
- )
440
+ # A passing build has no failure to explain
441
+ expect(output).to_not match(/extra_[ab]\.h.*(nesting depth|shares the directory)/)
418
442
  expect(output).to_not match(/Isolated '.*extra_[ab]\.h'/)
419
443
  end
420
444
  end
@@ -513,8 +537,8 @@ ceedling_system_tests do
513
537
  # of") -- either is the real, raw error this guidance explains, not a
514
538
  # bare, unexplained failure.
515
539
  expect(output).to match(/redeclaration of|redefinition of|conflicting types|previous definition/)
516
- expect(output).to match(/mocked or Partialized for this test/)
517
- expect(output).to match(/transitive #include chain/)
540
+ expect(output).to match(/this test's Partial of '.*' may be colliding with its real content/)
541
+ expect(output).to match(/second #include chain that bypasses the Partial/)
518
542
  end
519
543
  end
520
544
  end
@@ -200,6 +200,48 @@ module BullseyeCommonTestCases
200
200
  end
201
201
  end
202
202
 
203
+ # Rake runs the report task before post_build applies its exclusions. On a fresh
204
+ # coverage file, the report task must apply them itself.
205
+ def bullseye_report_task_same_command_line
206
+ @c.with_context do
207
+ Dir.chdir @proj_name do
208
+ prep_project_yml_for_coverage
209
+ copy_branch_coverage_fixture
210
+ add_bullseye_option('report_task', 'TRUE')
211
+ add_bullseye_option('xml_report', ':cobertura')
212
+
213
+ @c.ceedling_build_exec('clobber')
214
+ output = @c.ceedling_build_exec('bullseye:all report:bullseye')
215
+
216
+ expect(@c.last_exit_status).to eq(0)
217
+ expect(output).to match(/XML coverage report/)
218
+
219
+ contents = read_spec_file(File.join('build', 'artifacts', 'bullseye', 'coverage.xml'))
220
+ expect(contents).to match(/branchy\.c/)
221
+ expect(contents).not_to match(/unity\.c/)
222
+ expect(contents).not_to match(/_runner\.c/)
223
+ expect(contents).not_to match(/test_branchy\.c/)
224
+ end
225
+ end
226
+ end
227
+
228
+ def bullseye_report_task_without_coverage
229
+ @c.with_context do
230
+ Dir.chdir @proj_name do
231
+ prep_project_yml_for_coverage
232
+ add_bullseye_option('report_task', 'TRUE')
233
+
234
+ @c.ceedling_build_exec('clobber')
235
+ output = @c.ceedling_build_exec('report:bullseye')
236
+
237
+ expect(@c.last_exit_status).to eq(0)
238
+ expect(output).to match(/No coverage file\./)
239
+ expect(output).not_to match(/coverage report:/)
240
+ expect(File.exist?('test.cov')).to eq false
241
+ end
242
+ end
243
+ end
244
+
203
245
  ##
204
246
  ## Coverage thresholds
205
247
  ##
@@ -188,8 +188,8 @@ module CommonSystemTestCases
188
188
 
189
189
  # Windows' Installer Detection reads a manifest beside each test executable
190
190
  if windows
191
- manifests = Dir.glob('build/test/out/test/test_example_file_success/*.manifest')
192
- expect(manifests).to eq(['build/test/out/test/test_example_file_success/test_example_file_success.exe.manifest'])
191
+ manifests = Dir.glob('build/test/out/test/test_example_file_success/_t_/*.manifest')
192
+ expect(manifests).to eq(['build/test/out/test/test_example_file_success/_t_/test_example_file_success.exe.manifest'])
193
193
  end
194
194
  end
195
195
  end
@@ -86,6 +86,32 @@ module GcovPartialsTestCases
86
86
  end
87
87
  end
88
88
 
89
+ def gcov_partials_coverage_macro_hidden_static
90
+ @c.with_context do
91
+ Dir.chdir @proj_name do
92
+ prep_project_yml_for_coverage
93
+
94
+ # `static` comes from PRIVATE, a macro the module header defines, and the head spans
95
+ # two lines. The Partial writes that head from its expanded signature, so the selected
96
+ # function links from the test, and every body line keeps its original line.
97
+ asset_base = test_asset_path("tests_with_partials_coverage")
98
+ FileUtils.cp "#{asset_base}/src/private_macro.h", 'src/'
99
+ FileUtils.cp "#{asset_base}/src/private_macro.c", 'src/'
100
+ FileUtils.cp "#{asset_base}/test/test_private_macro.c", 'test/'
101
+
102
+ hits = partials_cobertura_hits_by_line('src/private_macro.c')
103
+
104
+ # The function's line is its name's line (3), not the line `PRIVATE int` starts (2).
105
+ expect(hits[3]).to be > 0
106
+ expect(hits[2]).to be_nil
107
+ # `return` is on source line 6 -- it must show as hit.
108
+ expect(hits[6]).to be > 0
109
+ # The blank line (5) must not appear as an executable/hit line.
110
+ expect(hits[5]).to be_nil
111
+ end
112
+ end
113
+ end
114
+
89
115
  def gcov_partials_coverage_function_scope_static_promotion
90
116
  @c.with_context do
91
117
  Dir.chdir @proj_name do
@@ -114,6 +140,28 @@ module GcovPartialsTestCases
114
140
  end
115
141
  end
116
142
 
143
+ # A promoted static that defines its type spans three lines, which its no-ops keep, so the
144
+ # lines after it stay aligned with their original line numbers
145
+ def gcov_partials_coverage_promoted_type
146
+ @c.with_context do
147
+ Dir.chdir @proj_name do
148
+ prep_project_yml_for_coverage
149
+
150
+ asset_base = test_asset_path("tests_with_partials_coverage")
151
+ FileUtils.cp "#{asset_base}/src/tally.h", 'src/'
152
+ FileUtils.cp "#{asset_base}/src/tally.c", 'src/'
153
+ FileUtils.cp "#{asset_base}/test/test_tally.c", 'test/'
154
+
155
+ hits = partials_cobertura_hits_by_line('src/tally.c')
156
+
157
+ expect(hits[7]).to be > 0
158
+ expect(hits[9]).to be > 0
159
+ expect(hits[6]).to be_nil
160
+ expect(hits[8]).to be_nil
161
+ end
162
+ end
163
+ end
164
+
117
165
  # Coverage reporting has to tell two same-basename modules apart. A Partial replaces one
118
166
  # module, so the other keeps reporting its own coverage. Matching on basename alone drops
119
167
  # both, and the module nobody Partialized disappears from the report.
@@ -0,0 +1,209 @@
1
+ # =========================================================================
2
+ # Ceedling - Test-Centered Build System for C
3
+ # ThrowTheSwitch.org
4
+ # Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
5
+ # SPDX-License-Identifier: MIT
6
+ # =========================================================================
7
+
8
+ require 'spec_system_helper'
9
+ require 'json'
10
+
11
+ ##
12
+ ## Each Test's Own Build Directories (GH #1439)
13
+ ## ============================================
14
+ ##
15
+ ## A test is named by its path, so one test's name can continue another's, as
16
+ ## test/test_c/test_x continues test/test_c. A test's mock or Partial may also lie in a
17
+ ## folder named like the nested test. Each per-test directory closes the test's name with
18
+ ## `_t_`, so the two never share one.
19
+ ##
20
+
21
+ LAYOUT_TEST_PREAMBLE = "#include \"unity.h\"\nvoid setUp(void) {}\nvoid tearDown(void) {}\n"
22
+
23
+ # The directories below which each test's own files lie, one directory per test
24
+ LAYOUT_PER_TEST_BASES = %w[
25
+ build/test/mocks build/test/partials build/test/preprocess/includes build/test/preprocess/files
26
+ build/test/preprocess/build_directives build/test/out build/test/dependencies
27
+ ].freeze
28
+
29
+ ceedling_system_tests do
30
+ include_context "a fresh ceedling gem project", "test_layout"
31
+
32
+ def write(path, content)
33
+ FileUtils.mkdir_p( File.dirname( path ) )
34
+ File.write( path, content )
35
+ end
36
+
37
+ def build(task)
38
+ output = @c.ceedling_build_exec( task )
39
+
40
+ expect(@c.last_exit_status).to eq(0), output
41
+ return output
42
+ end
43
+
44
+ def header(path, guard, declaration)
45
+ write( path, "#ifndef #{guard}\n#define #{guard}\n#{declaration}\n#endif\n" )
46
+ end
47
+
48
+ # The test whose name continues test/test_c, beside test_c's own folder test_x
49
+ def write_nested_test(body = "void test_b(void) {}\n")
50
+ write( 'test/test_c/test_x.c', LAYOUT_TEST_PREAMBLE + body )
51
+ end
52
+
53
+ # test/test_c mocks a header in folder test_x
54
+ def write_test_mocking_in_folder
55
+ header( 'src/test_x/qux.h', 'QUX_H', 'int qux_read(void);' )
56
+ write( 'test/test_c.c', LAYOUT_TEST_PREAMBLE + "#include \"test_x/mock_qux.h\"\n" \
57
+ "void test_a(void) { qux_read_ExpectAndReturn( 5 ); TEST_ASSERT_EQUAL_INT( 5, qux_read() ); }\n" )
58
+ end
59
+
60
+ it "builds a test's mock in a folder named like a nested test once that test exists" do
61
+ in_project do
62
+ write_test_mocking_in_folder
63
+ build( 'test:test_c' )
64
+
65
+ write_nested_test
66
+ expect(build( 'test:test_c' )).to match(/PASSED:\s+1/)
67
+ expect(build( 'test:test_x' )).to match(/PASSED:\s+1/)
68
+ expect(build( 'test:all' )).to match(/PASSED:\s+2/)
69
+ end
70
+ end
71
+
72
+ it "builds a test's Partial of a module in a folder named like a nested test once that test exists" do
73
+ in_project do
74
+ @c.merge_project_yml_for_test( { :project => { :use_partials => true } } )
75
+ header( 'src/test_x/qux.h', 'QUX_H', 'int qux_read(void);' )
76
+ write( 'src/test_x/qux.c', "#include \"qux.h\"\nstatic int helper(void) { return 7; }\nint qux_read(void) { return helper(); }\n" )
77
+ write( 'test/test_c.c', LAYOUT_TEST_PREAMBLE + "#include \"ceedling.h\"\n#include TEST_PARTIAL_PRIVATE_MODULE_AT(test_x, qux)\n" \
78
+ "void test_a(void) { TEST_ASSERT_EQUAL_INT( 7, helper() ); }\n" )
79
+ build( 'test:test_c' )
80
+
81
+ write_nested_test
82
+ expect(build( 'test:test_c' )).to match(/PASSED:\s+1/)
83
+ expect(build( 'test:all' )).to match(/PASSED:\s+2/)
84
+ end
85
+ end
86
+
87
+ # Two same-named headers: test_c mocks one by folder test_x, and the nested test the other bare
88
+ it "keeps a nested test's mock apart from a same-named mock its parent places in a folder of that test's name" do
89
+ in_project do
90
+ @c.remove_project_yml_option_for_test( :paths, :include )
91
+ @c.merge_project_yml_for_test( { :paths => { :include => ['src/'] } } )
92
+ write_test_mocking_in_folder
93
+ header( 'src/qux.h', 'ROOT_QUX_H', 'int qux_other(void);' )
94
+ write_nested_test( "#include \"mock_qux.h\"\n" \
95
+ "void test_b(void) { qux_other_ExpectAndReturn( 6 ); TEST_ASSERT_EQUAL_INT( 6, qux_other() ); }\n" )
96
+
97
+ 2.times { expect(build( 'test:all' )).to match(/PASSED:\s+2/) }
98
+
99
+ expect(File.read( 'build/test/mocks/test/test_c/_t_/test_x/mock_qux.h' )).to include( 'qux_read_ExpectAndReturn' )
100
+ expect(File.read( 'build/test/mocks/test/test_c/test_x/_t_/mock_qux.h' )).to include( 'qux_other_ExpectAndReturn' )
101
+ end
102
+ end
103
+
104
+ it "builds coverage of a test whose mock lies in a folder named like a nested test" do
105
+ in_project do
106
+ # Coverage reports would need a report utility this example doesn't exercise
107
+ @c.merge_project_yml_for_test( { :plugins => { :enabled => ['gcov'] }, :gcov => { :report_task => true } } )
108
+ write_test_mocking_in_folder
109
+ write_nested_test
110
+
111
+ expect(build( 'gcov:all' )).to match(/PASSED:\s+2/)
112
+ end
113
+ end
114
+
115
+ # An earlier release placed each test's files at its name alone, and its cache holds that
116
+ # layout's paths. Setting that cache aside rebuilds every test.
117
+ it "rebuilds a build directory of the earlier layout without a clobber" do
118
+ in_project do
119
+ write_test_mocking_in_folder
120
+ write_nested_test
121
+ build( 'test:all' )
122
+
123
+ write( 'build/test/mocks/test/test_c/test_x/mock_qux.h', "#error a mock of the earlier layout\n" )
124
+ write( 'build/test/mocks/test/test_c/mock_qux.h', "#error a mock of the earlier layout\n" )
125
+ Dir.glob( 'build/cache/.*.dep_cache.json' ).each do |path|
126
+ File.write( path, JSON.generate( JSON.parse( File.read( path ) ).merge( 'schema_version' => 3 ) ) )
127
+ end
128
+
129
+ output = build( 'test:all' )
130
+
131
+ expect(output).to match(/PASSED:\s+2/)
132
+ expect(output).to match(/comes from an earlier Ceedling build layout -- rebuilding everything once/)
133
+ end
134
+ end
135
+
136
+ # Gives each cache in build/cache a schema version an earlier release wrote
137
+ def set_cache_schema(version, pattern = '.*.dep_cache.json')
138
+ Dir.glob( File.join( 'build/cache', pattern ) ).each do |path|
139
+ File.write( path, JSON.generate( JSON.parse( File.read( path ) ).merge( 'schema_version' => version ) ) )
140
+ end
141
+ end
142
+
143
+ # A release build has no per-test directories, so the test layout leaves it as it was
144
+ describe "a release build" do
145
+ before do
146
+ in_project do
147
+ @c.merge_project_yml_for_test( { :project => { :release_build => true } } )
148
+ header( 'src/_t_/foo.h', 'FOO_H', 'int foo(void);' )
149
+ write( 'src/_t_/foo.c', "#include \"foo.h\"\nint foo(void) { return 0; }\n" )
150
+ write( 'src/main.c', "#include \"foo.h\"\nint main(void) { return foo(); }\n" )
151
+ end
152
+ end
153
+
154
+ it "places a source in a directory named `_t_` at its own path" do
155
+ in_project do
156
+ build( 'release' )
157
+
158
+ expect(File.exist?( 'build/release/out/src/_t_/foo.o' )).to be( true )
159
+ expect(File.exist?( 'build/release/dependencies/src/_t_/foo.d' )).to be( true )
160
+ end
161
+ end
162
+
163
+ it "keeps its cache from an earlier release, compiling nothing" do
164
+ in_project do
165
+ build( 'release' )
166
+ set_cache_schema( 3, '.release.dep_cache.json' )
167
+
168
+ output = build( 'release' )
169
+
170
+ expect(output).to_not match(/earlier Ceedling build layout/)
171
+ expect(output).to_not match(/^Compiling /)
172
+ end
173
+ end
174
+ end
175
+
176
+ it "places every file below a per-test directory under its own test's `_t_` root" do
177
+ in_project do
178
+ @c.merge_project_yml_for_test( { :project => { :use_partials => true, :use_test_preprocessor => :all } } )
179
+ header( 'src/test_x/qux.h', 'QUX_H', 'int qux_read(void);' )
180
+ write( 'src/test_x/qux.c', "#include \"qux.h\"\nstatic int helper(void) { return 7; }\nint qux_read(void) { return helper(); }\n" )
181
+ header( 'src/test_x/bar.h', 'BAR_H', 'int bar_read(void);' )
182
+ header( 'src/baz.h', 'BAZ_H', 'int baz_read(void);' )
183
+ write( 'test/test_c.c', LAYOUT_TEST_PREAMBLE + "#include \"ceedling.h\"\n#include \"test_x/mock_bar.h\"\n" \
184
+ "#include TEST_PARTIAL_PRIVATE_MODULE_AT(test_x, qux)\n" \
185
+ "void test_a(void) { bar_read_ExpectAndReturn( 3 ); TEST_ASSERT_EQUAL_INT( 10, helper() + bar_read() ); }\n" )
186
+ write_nested_test( "#include \"mock_baz.h\"\n" \
187
+ "void test_b(void) { baz_read_ExpectAndReturn( 4 ); TEST_ASSERT_EQUAL_INT( 4, baz_read() ); }\n" )
188
+
189
+ expect(build( 'test:all' )).to match(/PASSED:\s+2/)
190
+
191
+ names = ['test/test_c', 'test/test_c/test_x']
192
+ LAYOUT_PER_TEST_BASES.each do |base|
193
+ files = Dir.glob( "#{base}/**/*", File::FNM_DOTMATCH ).select { |path| File.file?( path ) }
194
+ expect(files).to_not be_empty, "#{base} holds no file"
195
+
196
+ files.each do |file|
197
+ name = file.delete_prefix( "#{base}/" ).split( '/_t_/', 2 ).first
198
+ expect(names).to include( name ), "#{file} lies below no test's own root"
199
+ end
200
+ end
201
+
202
+ # The nested test's own mock and objects, beside test_c's folder of the same name
203
+ expect(File.exist?( 'build/test/mocks/test/test_c/test_x/_t_/mock_baz.c' )).to be( true )
204
+ expect(File.exist?( 'build/test/mocks/test/test_c/_t_/test_x/mock_bar.c' )).to be( true )
205
+ expect(File.exist?( 'build/test/out/test/test_c/test_x/_t_/test_x.out' )).to be( true )
206
+ expect(File.exist?( 'build/test/out/test/test_c/_t_/test_c.out' )).to be( true )
207
+ end
208
+ end
209
+ end
@@ -194,8 +194,8 @@ ceedling_system_tests do
194
194
  # is untouched by the override), so its own NOTICE still fires -- but the
195
195
  # correctly-linked pass above already proves only beta/dup.c was ever compiled,
196
196
  # not both. A duplicate-symbol link error would have failed the build otherwise.
197
- expect(File.exist?('build/test/out/test/test_dup_override/src/beta/dup.o')).to be true
198
- expect(File.exist?('build/test/out/test/test_dup_override/src/alpha/dup.o')).to be false
197
+ expect(File.exist?('build/test/out/test/test_dup_override/_t_/src/beta/dup.o')).to be true
198
+ expect(File.exist?('build/test/out/test/test_dup_override/_t_/src/alpha/dup.o')).to be false
199
199
 
200
200
  # A second, distinct NOTICE -- from extract_sources's own override, not the
201
201
  # header-ambiguity NOTICE above -- names the winning TEST_SOURCE_FILE() entry
@@ -224,8 +224,8 @@ ceedling_system_tests do
224
224
  expect(output).to match(/TESTED:\s+1/)
225
225
  expect(output).to match(/PASSED:\s+1/)
226
226
 
227
- expect(File.exist?('build/test/out/test/test_dup_subtractive/src/alpha/dup.o')).to be false
228
- expect(File.exist?('build/test/out/test/test_dup_subtractive/src/gamma/dup_gamma.o')).to be true
227
+ expect(File.exist?('build/test/out/test/test_dup_subtractive/_t_/src/alpha/dup.o')).to be false
228
+ expect(File.exist?('build/test/out/test/test_dup_subtractive/_t_/src/gamma/dup_gamma.o')).to be true
229
229
 
230
230
  expect(output).to match(/TEST_SOURCE_FILE\(.*-:alpha[\/\\]dup\.c.*\)/)
231
231
  expect(output).to match(/removed/)
@@ -251,7 +251,7 @@ ceedling_system_tests do
251
251
  expect(output).to match(/TESTED:\s+1/)
252
252
  expect(output).to match(/PASSED:\s+1/)
253
253
 
254
- expect(File.exist?('build/test/out/test/test_dup_subtractive_noop/src/alpha/dup.o')).to be true
254
+ expect(File.exist?('build/test/out/test/test_dup_subtractive_noop/_t_/src/alpha/dup.o')).to be true
255
255
 
256
256
  expect(output).to_not match(/TEST_SOURCE_FILE\(.*removed/)
257
257
  end
@@ -259,6 +259,36 @@ ceedling_system_tests do
259
259
 
260
260
  end
261
261
 
262
+ # =========================================================================
263
+ describe "A hand-written source named with the mock prefix, beside a test that mocks its header" do
264
+ # =========================================================================
265
+
266
+ # test_a mocks spi.h, and test_b links a hand-written fake of the mock's name instead. A
267
+ # :support source would be linked into every test, test_a's too, so the fake is a source.
268
+ before do
269
+ in_project do
270
+ preamble = "#include \"unity.h\"\nvoid setUp(void) {}\nvoid tearDown(void) {}\n"
271
+ FileUtils.mkdir_p( 'src/fakes' )
272
+ File.write( 'src/spi.h', "#ifndef SPI_H\n#define SPI_H\nint spi_read(void);\n#endif\n" )
273
+ File.write( 'src/fakes/mock_spi.c', "int spi_read(void) { return 42; }\n" )
274
+ File.write( 'test/test_a.c', preamble + "#include \"mock_spi.h\"\n" \
275
+ "void test_a(void) { spi_read_ExpectAndReturn( 5 ); TEST_ASSERT_EQUAL_INT( 5, spi_read() ); }\n" )
276
+ File.write( 'test/test_b.c', preamble + "#include \"spi.h\"\nTEST_SOURCE_FILE(\"mock_spi.c\")\n" \
277
+ "void test_b(void) { TEST_ASSERT_EQUAL_INT( 42, spi_read() ); }\n" )
278
+ end
279
+ end
280
+
281
+ it "builds the hand-written source into the test that names it" do
282
+ in_project do
283
+ output = @c.ceedling_build_exec("test:all")
284
+ expect(@c.last_exit_status).to eq(0), output
285
+ expect(output).to match(/TESTED:\s+2/)
286
+ expect(output).to match(/PASSED:\s+2/)
287
+ end
288
+ end
289
+
290
+ end
291
+
262
292
  end
263
293
 
264
294
  end