ceedling 1.2.1 → 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 (545) hide show
  1. checksums.yaml +4 -4
  2. data/GIT_COMMIT_SHA +1 -1
  3. data/README.md +11 -9
  4. data/Rakefile +2 -1
  5. data/assets/features/ceedling +1 -1
  6. data/assets/fixtures/test_source_file_duplicate_basenames/test_calc_typo.c +14 -0
  7. data/assets/fixtures/tests_with_duplicate_test_names/test_foo.c +21 -0
  8. data/assets/fixtures/tests_with_partials_coverage/src/private_macro.c +7 -0
  9. data/assets/fixtures/tests_with_partials_coverage/src/private_macro.h +5 -0
  10. data/assets/fixtures/tests_with_partials_coverage/src/tally.c +13 -0
  11. data/assets/fixtures/tests_with_partials_coverage/src/tally.h +4 -0
  12. data/assets/fixtures/tests_with_partials_coverage/test/test_private_macro.c +10 -0
  13. data/assets/fixtures/tests_with_partials_coverage/test/test_tally.c +9 -0
  14. data/bin/actionator.rb +6 -12
  15. data/bin/app_cfg.rb +14 -1
  16. data/bin/ceedling +13 -3
  17. data/bin/cli.rb +25 -6
  18. data/bin/cli_handler.rb +113 -73
  19. data/bin/cli_helper.rb +51 -78
  20. data/bin/installation_selector.rb +81 -0
  21. data/bin/launchinator.rb +69 -0
  22. data/bin/mixin_resolvinator.rb +26 -36
  23. data/bin/objects.yml +13 -0
  24. data/bin/path_validator.rb +25 -29
  25. data/bin/versionator.rb +47 -48
  26. data/ceedling.gemspec +19 -15
  27. data/docs/BreakingChanges.md +86 -1
  28. data/docs/Changelog.md +145 -3
  29. data/docs/KnownIssues.md +179 -6
  30. data/docs/ReleaseNotes.md +13 -0
  31. data/examples/wondrous_forest/README.md +29 -1
  32. data/examples/wondrous_forest/src/ForestUnits.h +23 -0
  33. data/examples/wondrous_forest/src/RainGauge.c +59 -0
  34. data/examples/wondrous_forest/src/RainGauge.h +39 -0
  35. data/examples/wondrous_forest/src/RainTipIsr.c +17 -0
  36. data/examples/wondrous_forest/src/RainTipIsr.h +14 -0
  37. data/examples/wondrous_forest/test/TestRainGauge.c +126 -0
  38. data/lib/ceedling/build_log_writer.rb +33 -0
  39. data/lib/ceedling/c_extractor/README.md +15 -7
  40. data/lib/ceedling/c_extractor/c_extractor.rb +25 -14
  41. data/lib/ceedling/c_extractor/c_extractor_code_text.rb +84 -54
  42. data/lib/ceedling/c_extractor/c_extractor_constants.rb +18 -7
  43. data/lib/ceedling/c_extractor/c_extractor_declarations.rb +319 -283
  44. data/lib/ceedling/c_extractor/c_extractor_declarator.rb +285 -0
  45. data/lib/ceedling/c_extractor/c_extractor_defined_type.rb +111 -0
  46. data/lib/ceedling/c_extractor/c_extractor_definitions.rb +174 -121
  47. data/lib/ceedling/c_extractor/c_extractor_functions.rb +191 -162
  48. data/lib/ceedling/c_extractor/c_extractor_preprocessing.rb +46 -55
  49. data/lib/ceedling/c_extractor/c_extractor_statement.rb +30 -0
  50. data/lib/ceedling/c_extractor/c_extractor_types.rb +63 -41
  51. data/lib/ceedling/c_extractor/c_module_edits.rb +48 -0
  52. data/lib/ceedling/c_identifier.rb +21 -0
  53. data/lib/ceedling/ceedling.h +8 -0
  54. data/lib/ceedling/config/build_root_policy.rb +70 -0
  55. data/lib/ceedling/config/configurator.rb +18 -19
  56. data/lib/ceedling/config/configurator_builder.rb +75 -28
  57. data/lib/ceedling/config/configurator_paths_validator.rb +179 -0
  58. data/lib/ceedling/config/configurator_plugins.rb +1 -1
  59. data/lib/ceedling/config/configurator_setup.rb +44 -33
  60. data/lib/ceedling/config/configurator_validator.rb +1 -110
  61. data/lib/ceedling/constants.rb +5 -1
  62. data/lib/ceedling/defaults.rb +35 -5
  63. data/lib/ceedling/dependencies/CACHE_SCHEMA.md +118 -0
  64. data/lib/ceedling/dependencies/README.md +18 -16
  65. data/lib/ceedling/dependencies/dependency_cache_store.rb +43 -21
  66. data/lib/ceedling/dependencies/dependency_hasher.rb +35 -1
  67. data/lib/ceedling/dependencies/dependency_tracker.rb +9 -3
  68. data/lib/ceedling/dependencies/dependinator.rb +13 -1
  69. data/lib/ceedling/diagnostics/DOCTOR.md +142 -0
  70. data/lib/ceedling/diagnostics/README.md +5 -0
  71. data/lib/ceedling/diagnostics/build_step_doctor.rb +110 -0
  72. data/lib/ceedling/diagnostics/duplicate_symbol_specialist.rb +108 -0
  73. data/lib/ceedling/diagnostics/guidance_phrases.rb +30 -0
  74. data/lib/ceedling/diagnostics/header_collision_guidance.rb +56 -0
  75. data/lib/ceedling/diagnostics/header_collision_specialist.rb +152 -0
  76. data/lib/ceedling/diagnostics/include_depth_specialist.rb +132 -0
  77. data/lib/ceedling/diagnostics/missing_symbol_specialist.rb +111 -0
  78. data/lib/ceedling/diagnostics/partial_name_specialist.rb +134 -0
  79. data/lib/ceedling/diagnostics/toolchain_output.rb +44 -0
  80. data/lib/ceedling/filename_extension.rb +7 -1
  81. data/lib/ceedling/filesystem/FILE_TREE.md +253 -0
  82. data/lib/ceedling/filesystem/PATH_HANDLING.md +360 -0
  83. data/lib/ceedling/filesystem/README.md +46 -0
  84. data/lib/ceedling/filesystem/build_roots.rb +105 -0
  85. data/lib/ceedling/filesystem/build_subpath.rb +187 -0
  86. data/lib/ceedling/filesystem/destination_collision.rb +25 -0
  87. data/lib/ceedling/{file_finder.rb → filesystem/file_finder.rb} +177 -156
  88. data/lib/ceedling/filesystem/file_finder_helper.rb +154 -0
  89. data/lib/ceedling/filesystem/file_path_collection_utils.rb +183 -0
  90. data/lib/ceedling/{file_path_utils.rb → filesystem/file_path_utils.rb} +200 -167
  91. data/lib/ceedling/{file_system_wrapper.rb → filesystem/file_system_wrapper.rb} +6 -5
  92. data/lib/ceedling/filesystem/file_tree.rb +241 -0
  93. data/lib/ceedling/{file_wrapper.rb → filesystem/file_wrapper.rb} +149 -65
  94. data/lib/ceedling/filesystem/path_exclusions.rb +30 -0
  95. data/lib/ceedling/{path_matcher.rb → filesystem/path_matcher.rb} +48 -23
  96. data/lib/ceedling/{path_mirror.rb → filesystem/path_mirror.rb} +19 -18
  97. data/lib/ceedling/filesystem/path_spellings.rb +55 -0
  98. data/lib/ceedling/filesystem/project_paths.rb +184 -0
  99. data/lib/ceedling/filesystem/test_build_layout.rb +114 -0
  100. data/lib/ceedling/filesystem/win_long_paths.rb +153 -0
  101. data/lib/ceedling/filesystem/win_path_limit.rb +83 -0
  102. data/lib/ceedling/filesystem/win_path_prober.rb +52 -0
  103. data/lib/ceedling/filesystem/working_dir.rb +40 -0
  104. data/lib/ceedling/generators/generator.rb +32 -70
  105. data/lib/ceedling/generators/generator_helper.rb +0 -44
  106. data/lib/ceedling/generators/generator_mocks.rb +5 -0
  107. data/lib/ceedling/generators/generator_partials.rb +306 -244
  108. data/lib/ceedling/generators/generator_test_results_backtrace.rb +7 -7
  109. data/lib/ceedling/generators/generator_test_runner.rb +5 -8
  110. data/lib/ceedling/generators/partial_header_writer.rb +95 -0
  111. data/lib/ceedling/generators/partial_source_writer.rb +137 -0
  112. data/lib/ceedling/handoff.rb +121 -0
  113. data/lib/ceedling/includes/header_search.rb +225 -0
  114. data/lib/ceedling/includes/include_factory.rb +9 -12
  115. data/lib/ceedling/includes/include_pathinator.rb +112 -33
  116. data/lib/ceedling/includes/includes.rb +150 -38
  117. data/lib/ceedling/installation.rb +92 -0
  118. data/lib/ceedling/library_resolver.rb +99 -0
  119. data/lib/ceedling/objects.yml +112 -6
  120. data/lib/ceedling/partials/README.md +110 -16
  121. data/lib/ceedling/partials/carry_plan.rb +71 -0
  122. data/lib/ceedling/partials/definition_head.rb +74 -0
  123. data/lib/ceedling/partials/include_groups.rb +37 -0
  124. data/lib/ceedling/partials/interface_extras.rb +25 -0
  125. data/lib/ceedling/partials/partializer.rb +603 -124
  126. data/lib/ceedling/partials/partializer_config.rb +8 -1
  127. data/lib/ceedling/partials/partializer_helper.rb +851 -145
  128. data/lib/ceedling/partials/partializer_reconciler.rb +174 -0
  129. data/lib/ceedling/partials/partializer_utils.rb +89 -109
  130. data/lib/ceedling/partials/partials.rb +153 -10
  131. data/lib/ceedling/partials/type_macros.rb +126 -0
  132. data/lib/ceedling/plugins/report_log_writer_plugin.rb +3 -5
  133. data/lib/ceedling/preprocess/README.md +43 -33
  134. data/lib/ceedling/preprocess/preprocessinator.rb +100 -186
  135. data/lib/ceedling/preprocess/preprocessinator_code_finder.rb +65 -72
  136. data/lib/ceedling/preprocess/preprocessinator_file_assembler.rb +32 -76
  137. data/lib/ceedling/preprocess/preprocessinator_includes_handler.rb +1 -1
  138. data/lib/ceedling/preprocess/preprocessinator_line_marker_includes_extractor.rb +1 -1
  139. data/lib/ceedling/preprocess/preprocessinator_reconstructor.rb +51 -14
  140. data/lib/ceedling/rake_app/rakefile_component_resolver.rb +10 -17
  141. data/lib/ceedling/rakefile.rb +15 -1
  142. data/lib/ceedling/rakefiles/base/tasks_base.rake +1 -1
  143. data/lib/ceedling/rakefiles/release/rules_release.rake +4 -7
  144. data/lib/ceedling/release_invoker/release_build_executor.rb +33 -44
  145. data/lib/ceedling/release_invoker/release_build_planner.rb +14 -6
  146. data/lib/ceedling/reportinator.rb +3 -4
  147. data/lib/ceedling/setupinator.rb +104 -87
  148. data/lib/ceedling/test_context_extractor.rb +5 -1
  149. data/lib/ceedling/test_invoker/HEADER_COLLISIONS.md +21 -7
  150. data/lib/ceedling/test_invoker/PIPELINE.md +62 -19
  151. data/lib/ceedling/test_invoker/README.md +1 -1
  152. data/lib/ceedling/test_invoker/derived_search_path_notices.rb +45 -0
  153. data/lib/ceedling/test_invoker/mock_locator.rb +175 -10
  154. data/lib/ceedling/test_invoker/partial_files_preprocessinator.rb +181 -0
  155. data/lib/ceedling/test_invoker/partials_manager.rb +271 -302
  156. data/lib/ceedling/test_invoker/standin_headerinator.rb +19 -17
  157. data/lib/ceedling/test_invoker/test_bare_includes_extractinator.rb +26 -3
  158. data/lib/ceedling/test_invoker/test_build_executor.rb +358 -234
  159. data/lib/ceedling/test_invoker/test_build_planner.rb +46 -33
  160. data/lib/ceedling/test_invoker/test_build_setup.rb +43 -18
  161. data/lib/ceedling/test_invoker/test_build_validations.rb +35 -47
  162. data/lib/ceedling/test_invoker/test_derived_search_paths.rb +189 -0
  163. data/lib/ceedling/test_invoker/test_file_preprocessinator.rb +2 -3
  164. data/lib/ceedling/test_invoker/test_includes_reconcilinator.rb +1 -1
  165. data/lib/ceedling/test_invoker/test_invoker.rb +6 -1
  166. data/lib/ceedling/test_invoker/test_invoker_types.rb +28 -20
  167. data/lib/ceedling/test_invoker/test_pipeline_helpers.rb +6 -4
  168. data/lib/ceedling/test_invoker/test_pipeline_manager.rb +25 -8
  169. data/lib/ceedling/test_invoker/test_runner_generatinator.rb +31 -3
  170. data/lib/ceedling/test_invoker/test_search_paths.rb +30 -8
  171. data/lib/ceedling/test_invoker/test_source_file_directive_resolver.rb +40 -20
  172. data/lib/ceedling/test_invoker/test_substitutions.rb +72 -0
  173. data/lib/ceedling/tools/shell_quoting.rb +45 -0
  174. data/lib/ceedling/{tool_executor.rb → tools/tool_executor.rb} +9 -3
  175. data/lib/ceedling/tools/tool_quoting.rb +79 -0
  176. data/lib/ceedling/{tool_validator.rb → tools/tool_validator.rb} +18 -7
  177. data/lib/ceedling/yaml_wrapper.rb +3 -2
  178. data/lib/version.rb +1 -1
  179. data/plugins/bullseye/bullseye.rake +1 -3
  180. data/plugins/bullseye/config/defaults_bullseye.rb +1 -1
  181. data/plugins/bullseye/lib/bullseye.rb +24 -9
  182. data/plugins/command_hooks/lib/command_hooks.rb +1 -1
  183. data/plugins/cppcheck/config/defaults_cppcheck.rb +1 -1
  184. data/plugins/dependencies/config/defaults.yml +6 -6
  185. data/plugins/dependencies/dependencies.rake +4 -1
  186. data/plugins/dependencies/lib/dependencies.rb +18 -8
  187. data/plugins/dependencies/lib/dependency_spec.rb +17 -5
  188. data/plugins/fff/lib/fff.rb +79 -46
  189. data/plugins/fff/lib/fff_mock_generator.rb +12 -9
  190. data/plugins/fff/spec/fff_cmock_wrapper_spec.rb +262 -0
  191. data/plugins/fff/spec/fff_mock_header_generator_spec.rb +9 -0
  192. data/plugins/fff/spec/fff_mock_source_generator_spec.rb +20 -0
  193. data/plugins/gcov/config/defaults_gcov.rb +1 -1
  194. data/plugins/gcov/lib/console_reportinator.rb +28 -36
  195. data/plugins/gcov/lib/gcov.rb +9 -2
  196. data/plugins/gcov/lib/gcovr_reportinator.rb +8 -40
  197. data/plugins/gcov/lib/gcovr_thresholds.rb +74 -0
  198. data/plugins/gcov/lib/reportgenerator_reportinator.rb +3 -2
  199. data/plugins/module_generator/lib/module_generator.rb +3 -3
  200. data/plugins/report_tests_teamcity_stdout/lib/report_tests_teamcity_stdout.rb +53 -80
  201. data/plugins/sanitize/lib/sanitize_records.rb +3 -6
  202. data/plugins/valgrind/lib/valgrind.rb +14 -7
  203. data/site-local/404.html +2 -2
  204. data/site-local/assets/javascripts/{bundle.c21346df.min.js → bundle.a5f9d56c.min.js} +1 -1
  205. data/site-local/assets/javascripts/{bundle.c21346df.min.js.map → bundle.a5f9d56c.min.js.map} +2 -2
  206. data/site-local/configuration/environment-vars.html +2 -2
  207. data/site-local/configuration/global-collections.html +3 -3
  208. data/site-local/configuration/index.html +2 -2
  209. data/site-local/configuration/loading.html +2 -2
  210. data/site-local/configuration/mixins.html +2 -2
  211. data/site-local/configuration/parallel-builds.html +2 -2
  212. data/site-local/configuration/project-file.html +2 -2
  213. data/site-local/configuration/reference/cexception.html +2 -2
  214. data/site-local/configuration/reference/cmock.html +7 -3
  215. data/site-local/configuration/reference/defines.html +2 -2
  216. data/site-local/configuration/reference/environment.html +2 -2
  217. data/site-local/configuration/reference/extension.html +2 -2
  218. data/site-local/configuration/reference/files.html +65 -12
  219. data/site-local/configuration/reference/flags.html +2 -2
  220. data/site-local/configuration/reference/index.html +2 -2
  221. data/site-local/configuration/reference/libraries.html +23 -5
  222. data/site-local/configuration/reference/mixins.html +2 -2
  223. data/site-local/configuration/reference/partials.html +84 -2
  224. data/site-local/configuration/reference/paths.html +36 -8
  225. data/site-local/configuration/reference/plugins.html +2 -2
  226. data/site-local/configuration/reference/project.html +264 -12
  227. data/site-local/configuration/reference/release-build.html +4 -2
  228. data/site-local/configuration/reference/test-build.html +2 -2
  229. data/site-local/configuration/reference/test-runner.html +2 -2
  230. data/site-local/configuration/reference/tools.html +58 -4
  231. data/site-local/configuration/reference/unity.html +2 -2
  232. data/site-local/configuration/which-ceedling.html +379 -19
  233. data/site-local/development/index.html +2 -2
  234. data/site-local/development/plugins/configuration.html +2 -2
  235. data/site-local/development/plugins/index.html +2 -2
  236. data/site-local/development/plugins/plugin-subclass.html +5 -4
  237. data/site-local/development/plugins/rake-tasks.html +2 -2
  238. data/site-local/development/releases.html +7 -3
  239. data/site-local/development/workflow.html +50 -45
  240. data/site-local/getting-started/builds.html +4 -2
  241. data/site-local/getting-started/command-line.html +58 -6
  242. data/site-local/getting-started/example-projects/cipher-quest.html +2 -2
  243. data/site-local/getting-started/example-projects/index.html +2 -2
  244. data/site-local/getting-started/example-projects/temp-sensor.html +2 -2
  245. data/site-local/getting-started/example-projects/wondrous-forest.html +10 -2
  246. data/site-local/getting-started/index.html +2 -2
  247. data/site-local/getting-started/installation.html +2 -2
  248. data/site-local/getting-started/quick-start.html +2 -2
  249. data/site-local/help.html +2 -2
  250. data/site-local/index.html +2 -2
  251. data/site-local/overview/build-system.html +2 -2
  252. data/site-local/overview/index.html +2 -2
  253. data/site-local/overview/test-environments.html +2 -2
  254. data/site-local/overview/tools-and-frameworks.html +2 -2
  255. data/site-local/plugins/beep.html +2 -2
  256. data/site-local/plugins/bullseye/index.html +45 -38
  257. data/site-local/plugins/bullseye/licensing.html +2 -2
  258. data/site-local/plugins/command-hooks.html +4 -4
  259. data/site-local/plugins/compile-commands-json-db.html +2 -2
  260. data/site-local/plugins/cppcheck.html +2 -2
  261. data/site-local/plugins/dependencies.html +8 -5
  262. data/site-local/plugins/fff.html +58 -13
  263. data/site-local/plugins/gcov/examples.html +2 -2
  264. data/site-local/plugins/gcov/gcovr.html +23 -14
  265. data/site-local/plugins/gcov/index.html +2 -2
  266. data/site-local/plugins/gcov/overview.html +2 -2
  267. data/site-local/plugins/gcov/reportgenerator.html +18 -14
  268. data/site-local/plugins/gcov/reporting.html +2 -2
  269. data/site-local/plugins/gcov/setup.html +4 -3
  270. data/site-local/plugins/gcov/tool-versions.html +2 -2
  271. data/site-local/plugins/gcov/troubleshooting.html +2 -2
  272. data/site-local/plugins/index.html +2 -2
  273. data/site-local/plugins/module-generator.html +2 -2
  274. data/site-local/plugins/report-build-warnings-log.html +2 -2
  275. data/site-local/plugins/report-tests-gtestlike-stdout.html +2 -2
  276. data/site-local/plugins/report-tests-ide-stdout.html +2 -2
  277. data/site-local/plugins/report-tests-log-factory.html +2 -2
  278. data/site-local/plugins/report-tests-pretty-stdout.html +2 -2
  279. data/site-local/plugins/report-tests-raw-output-log.html +5 -3
  280. data/site-local/plugins/report-tests-teamcity-stdout.html +8 -5
  281. data/site-local/plugins/sanitize.html +9 -8
  282. data/site-local/plugins/valgrind.html +10 -9
  283. data/site-local/project/index.html +2 -2
  284. data/site-local/project/release-history.html +2 -2
  285. data/site-local/project/sbom.html +2 -2
  286. data/site-local/project/upgrade.html +5 -2
  287. data/site-local/reference/build-directives.html +2 -2
  288. data/site-local/reference/command-line.html +11 -4
  289. data/site-local/reference/environment-vars.html +2 -2
  290. data/site-local/reference/gcov-plugin.html +2 -2
  291. data/site-local/reference/global-collections.html +12 -12
  292. data/site-local/reference/index.html +2 -2
  293. data/site-local/reference/partials-macros.html +47 -2
  294. data/site-local/reference/project-configuration.html +2 -2
  295. data/site-local/sitemap.xml.gz +0 -0
  296. data/site-local/snapshot/examples/cipher_quest/index.html +2 -2
  297. data/site-local/snapshot/examples/temp_sensor/index.html +2 -2
  298. data/site-local/snapshot/examples/wondrous_forest/index.html +72 -15
  299. data/site-local/snapshot/plugins/bullseye/config/defaults_bullseye.rb +1 -1
  300. data/site-local/snapshot/plugins/gcov/config/defaults_gcov.rb +1 -1
  301. data/site-local/testing-guide/build-directives.html +2 -2
  302. data/site-local/testing-guide/conventions.html +113 -15
  303. data/site-local/testing-guide/frameworks.html +2 -2
  304. data/site-local/testing-guide/index.html +2 -2
  305. data/site-local/testing-guide/partials/configuration.html +31 -4
  306. data/site-local/testing-guide/partials/conventions.html +509 -8
  307. data/site-local/testing-guide/partials/directives.html +4 -3
  308. data/site-local/testing-guide/partials/example.html +2 -2
  309. data/site-local/testing-guide/partials/index.html +2 -2
  310. data/site-local/testing-guide/partials/overview.html +30 -12
  311. data/site-local/testing-guide/partials/variables.html +169 -4
  312. data/site-local/testing-guide/test-cases.html +2 -2
  313. data/site-local/testing-guide/test-sample.html +2 -2
  314. data/site-local/testing-guide/test-suite-anatomy.html +2 -2
  315. data/spec/integration/actionator_file_operations_spec.rb +91 -1
  316. data/spec/integration/build_step_doctor_spec.rb +270 -0
  317. data/spec/integration/c_extractor_composition_spec.rb +254 -4
  318. data/spec/integration/compile_commands_json_db_spec.rb +1 -1
  319. data/spec/integration/configurator_validation_spec.rb +1 -1
  320. data/spec/integration/dependencies/dependency_tracker_cache_hardening_spec.rb +26 -0
  321. data/spec/integration/dependencies/dependency_tracker_core_spec.rb +22 -0
  322. data/spec/integration/includes_extraction_spec.rb +27 -14
  323. data/spec/integration/launcher_handoff_spec.rb +297 -0
  324. data/spec/integration/mixin_loading_spec.rb +1 -1
  325. data/spec/integration/module_generator_spec.rb +3 -3
  326. data/spec/integration/nested_test_artifacts_spec.rb +99 -0
  327. data/spec/integration/partial_files_preprocessing_spec.rb +128 -0
  328. data/spec/integration/partials_carry_spec.rb +520 -0
  329. data/spec/integration/partials_declarations_spec.rb +655 -0
  330. data/spec/integration/partials_fallback_preprocessing_spec.rb +65 -0
  331. data/spec/integration/partials_function_pointers_spec.rb +277 -0
  332. data/spec/integration/partials_header_composition_spec.rb +268 -35
  333. data/spec/integration/partials_macro_decorators_spec.rb +267 -0
  334. data/spec/integration/partials_module_resolution_spec.rb +33 -23
  335. data/spec/integration/partials_symbol_linkage_spec.rb +13 -0
  336. data/spec/integration/path_intake_scenarios_spec.rb +101 -0
  337. data/spec/integration/path_length_reporting_spec.rb +64 -0
  338. data/spec/integration/path_scenarios_spec.rb +399 -0
  339. data/spec/integration/quote_include_isolator_spec.rb +57 -1
  340. data/spec/integration/report_build_warnings_log_spec.rb +1 -1
  341. data/spec/integration/report_tests_log_factory_spec.rb +1 -1
  342. data/spec/integration/test_build_parallel_barrier_spec.rb +1 -1
  343. data/spec/integration/test_executable_manifest_spec.rb +1 -1
  344. data/spec/integration/test_includes_extractinator_spec.rb +69 -3
  345. data/spec/integration/test_naming_spec.rb +201 -0
  346. data/spec/integration/test_source_file_checks_spec.rb +168 -0
  347. data/spec/integration/tool_executor_spec.rb +1 -1
  348. data/spec/integration/tool_validator_spec.rb +3 -3
  349. data/spec/integration/upgrade_docs_spec.rb +84 -0
  350. data/spec/integration/vendor_copy_transient_io_retry_spec.rb +74 -5
  351. data/spec/integration/win_long_paths_probe_spec.rb +46 -0
  352. data/spec/integration/win_path_limit_spec.rb +53 -0
  353. data/spec/integration/windows_registry_query_tool_spec.rb +41 -0
  354. data/spec/support/file_tree_helper.rb +88 -0
  355. data/spec/support/integration/configurator_integration_helper.rb +14 -9
  356. data/spec/support/integration/dependency_tracker_integration_helper.rb +1 -1
  357. data/spec/support/integration/partial_files_harness.rb +181 -0
  358. data/spec/support/integration/partials_generation_integration_helper.rb +239 -143
  359. data/spec/support/integration/path_scenario_harness.rb +175 -0
  360. data/spec/support/integration/spec_integration_helper.rb +9 -4
  361. data/spec/support/integration/test_includes_harness.rb +69 -37
  362. data/spec/support/integration/tool_executor_integration_helper.rb +14 -2
  363. data/spec/support/spec_helper.rb +2 -0
  364. data/spec/support/system/spec_system_helper.rb +7 -6
  365. data/spec/support/system/system_context.rb +21 -3
  366. data/spec/support/working_dir_tracking.rb +49 -0
  367. data/spec/system/build_output_mirroring_spec.rb +2 -2
  368. data/spec/system/bullseye_deployment_spec.rb +2 -0
  369. data/spec/system/conditional_mock_includes_spec.rb +1 -1
  370. data/spec/system/delta_builds_spec.rb +163 -23
  371. data/spec/system/encoding_stress_spec.rb +4 -4
  372. data/spec/system/example_wondrous_forest_spec.rb +2 -2
  373. data/spec/system/gcov_deployment_spec.rb +3 -0
  374. data/spec/system/header_include_path_validation_spec.rb +4 -4
  375. data/spec/system/header_search_paths_spec.rb +1083 -0
  376. data/spec/system/launcher_handoff_spec.rb +82 -0
  377. data/spec/system/mock_include_folders_spec.rb +212 -0
  378. data/spec/system/mockable_header_reassembly_spec.rb +184 -0
  379. data/spec/system/parent_directory_reference_spec.rb +5 -3
  380. data/spec/system/partials_carry_spec.rb +581 -0
  381. data/spec/system/partials_delta_builds_spec.rb +280 -0
  382. data/spec/system/partials_function_pointers_spec.rb +106 -0
  383. data/spec/system/partials_macro_decorators_spec.rb +127 -0
  384. data/spec/system/partials_module_disambiguation_spec.rb +125 -0
  385. data/spec/system/path_handling_probes_spec.rb +196 -0
  386. data/spec/system/pinned_thread_count_spec.rb +4 -4
  387. data/spec/system/preprocessing_fallback_conditionals_spec.rb +1 -1
  388. data/spec/system/preprocessing_parameterized_tests_spec.rb +1 -1
  389. data/spec/system/rake_release_task_path_disambiguation_spec.rb +6 -6
  390. data/spec/system/rake_test_task_path_disambiguation_spec.rb +85 -0
  391. data/spec/system/short_build_paths_spec.rb +87 -0
  392. data/spec/system/sibling_header_collision_spec.rb +30 -6
  393. data/spec/system/special_path_characters_spec.rb +86 -0
  394. data/spec/system/support/bullseye_common_test_cases.rb +42 -0
  395. data/spec/system/support/common_test_cases.rb +23 -21
  396. data/spec/system/support/gcov_common_test_cases.rb +37 -9
  397. data/spec/system/support/gcov_partials_test_cases.rb +48 -0
  398. data/spec/system/support/sanitize_common_test_cases.rb +2 -2
  399. data/spec/system/support/valgrind_common_test_cases.rb +12 -12
  400. data/spec/system/test_build_layout_spec.rb +209 -0
  401. data/spec/system/test_pipeline_stop_points_spec.rb +4 -4
  402. data/spec/system/test_runner_system_include_spec.rb +1 -1
  403. data/spec/system/test_source_file_directive_spec.rb +64 -5
  404. data/spec/units/bin/actionator_spec.rb +14 -17
  405. data/spec/units/bin/app_cfg_spec.rb +37 -0
  406. data/spec/units/bin/cli_handler_spec.rb +282 -6
  407. data/spec/units/bin/cli_helper_spec.rb +116 -45
  408. data/spec/units/bin/installation_selector_spec.rb +114 -0
  409. data/spec/units/bin/launchinator_spec.rb +171 -0
  410. data/spec/units/bin/path_validator_spec.rb +10 -0
  411. data/spec/units/bin/versionator_spec.rb +38 -6
  412. data/spec/units/build_log_writer_spec.rb +57 -0
  413. data/spec/units/c_extractor/c_extractor_code_text_spec.rb +67 -10
  414. data/spec/units/c_extractor/c_extractor_declarations_spec.rb +501 -4
  415. data/spec/units/c_extractor/c_extractor_declarator_spec.rb +245 -0
  416. data/spec/units/c_extractor/c_extractor_defined_type_spec.rb +45 -0
  417. data/spec/units/c_extractor/c_extractor_definitions_spec.rb +163 -3
  418. data/spec/units/c_extractor/c_extractor_functions_spec.rb +462 -21
  419. data/spec/units/c_extractor/c_extractor_preprocessing_spec.rb +39 -0
  420. data/spec/units/c_extractor/c_extractor_spec.rb +4 -4
  421. data/spec/units/c_extractor/c_extractor_types_spec.rb +163 -0
  422. data/spec/units/c_identifier_spec.rb +35 -0
  423. data/spec/units/config/build_root_policy_spec.rb +61 -0
  424. data/spec/units/config/configurator_builder_spec.rb +61 -6
  425. data/spec/units/config/configurator_paths_validator_spec.rb +292 -0
  426. data/spec/units/config/configurator_setup_spec.rb +80 -68
  427. data/spec/units/config/configurator_spec.rb +54 -6
  428. data/spec/units/config/configurator_validator_spec.rb +1 -172
  429. data/spec/units/dependencies/dependency_cache_store_spec.rb +98 -2
  430. data/spec/units/dependencies/dependency_debug_tree_spec.rb +1 -1
  431. data/spec/units/dependencies/dependency_hasher_spec.rb +42 -1
  432. data/spec/units/dependencies/dependency_path_normalizer_spec.rb +1 -1
  433. data/spec/units/dependencies/dependency_tracker_spec.rb +28 -1
  434. data/spec/units/dependencies/dependinator_spec.rb +17 -2
  435. data/spec/units/diagnostics/build_step_doctor_spec.rb +170 -0
  436. data/spec/units/diagnostics/duplicate_symbol_specialist_spec.rb +117 -0
  437. data/spec/units/diagnostics/header_collision_specialist_spec.rb +267 -0
  438. data/spec/units/diagnostics/include_depth_specialist_spec.rb +137 -0
  439. data/spec/units/diagnostics/missing_symbol_specialist_spec.rb +154 -0
  440. data/spec/units/diagnostics/partial_name_specialist_spec.rb +129 -0
  441. data/spec/units/diagnostics/toolchain_output_spec.rb +86 -0
  442. data/spec/units/encodinator_spec.rb +3 -4
  443. data/spec/units/filename_extension_spec.rb +11 -0
  444. data/spec/units/filesystem/build_roots_spec.rb +131 -0
  445. data/spec/units/filesystem/build_subpath_spec.rb +235 -0
  446. data/spec/units/filesystem/destination_collision_spec.rb +30 -0
  447. data/spec/units/{file_finder_helper_spec.rb → filesystem/file_finder_helper_spec.rb} +126 -1
  448. data/spec/units/filesystem/file_finder_spec.rb +845 -0
  449. data/spec/units/{file_path_collection_utils_spec.rb → filesystem/file_path_collection_utils_spec.rb} +181 -1
  450. data/spec/units/{file_path_utils_spec.rb → filesystem/file_path_utils_spec.rb} +435 -185
  451. data/spec/units/filesystem/file_system_wrapper_spec.rb +33 -0
  452. data/spec/units/filesystem/file_tree_spec.rb +511 -0
  453. data/spec/units/filesystem/file_tree_windows_spec.rb +78 -0
  454. data/spec/units/{file_wrapper_spec.rb → filesystem/file_wrapper_spec.rb} +286 -18
  455. data/spec/units/{path_matcher_spec.rb → filesystem/path_matcher_spec.rb} +48 -1
  456. data/spec/units/{path_mirror_spec.rb → filesystem/path_mirror_spec.rb} +32 -4
  457. data/spec/units/filesystem/project_paths_spec.rb +147 -0
  458. data/spec/units/filesystem/test_build_layout_spec.rb +216 -0
  459. data/spec/units/filesystem/win_long_paths_spec.rb +204 -0
  460. data/spec/units/filesystem/win_path_prober_spec.rb +158 -0
  461. data/spec/units/filesystem/working_dir_spec.rb +71 -0
  462. data/spec/units/generators/generator_helper_spec.rb +0 -60
  463. data/spec/units/generators/generator_mocks_spec.rb +13 -0
  464. data/spec/units/generators/generator_partials_spec.rb +656 -55
  465. data/spec/units/generators/generator_spec.rb +38 -6
  466. data/spec/units/generators/generator_test_results_backtrace_spec.rb +50 -46
  467. data/spec/units/generators/generator_test_results_spec.rb +1 -1
  468. data/spec/units/generators/generator_test_runner_spec.rb +9 -5
  469. data/spec/units/generators/partial_source_writer_spec.rb +129 -0
  470. data/spec/units/handoff_spec.rb +205 -0
  471. data/spec/units/includes/header_search_spec.rb +406 -0
  472. data/spec/units/includes/include_factory_spec.rb +23 -6
  473. data/spec/units/includes/include_pathinator_spec.rb +118 -8
  474. data/spec/units/includes/include_spec.rb +14 -0
  475. data/spec/units/includes/includes_spec.rb +176 -19
  476. data/spec/units/installation_spec.rb +228 -0
  477. data/spec/units/library_resolver_spec.rb +157 -0
  478. data/spec/units/loginator_spec.rb +31 -0
  479. data/spec/units/mock_locator_spec.rb +275 -6
  480. data/spec/units/partials/include_groups_spec.rb +42 -0
  481. data/spec/units/partials/partializer_config_spec.rb +32 -0
  482. data/spec/units/partials/partializer_helper_carry_spec.rb +661 -0
  483. data/spec/units/partials/partializer_helper_interface_extras_spec.rb +396 -0
  484. data/spec/units/partials/partializer_helper_spec.rb +529 -277
  485. data/spec/units/partials/partializer_reconciler_spec.rb +661 -0
  486. data/spec/units/partials/partializer_spec.rb +1579 -270
  487. data/spec/units/partials/partializer_utils_spec.rb +269 -232
  488. data/spec/units/partials/partials_rename_spec.rb +160 -0
  489. data/spec/units/partials_manager_spec.rb +561 -251
  490. data/spec/units/plugins/bullseye_spec.rb +49 -2
  491. data/spec/units/plugins/console_reportinator_spec.rb +73 -26
  492. data/spec/units/plugins/dependencies_spec.rb +33 -7
  493. data/spec/units/plugins/dependency_spec_spec.rb +17 -0
  494. data/spec/units/plugins/gcov_spec.rb +28 -3
  495. data/spec/units/plugins/gcovr_reportinator_spec.rb +19 -47
  496. data/spec/units/plugins/gcovr_thresholds_spec.rb +95 -0
  497. data/spec/units/plugins/module_generator_spec.rb +5 -5
  498. data/spec/units/plugins/report_build_warnings_log_spec.rb +3 -3
  499. data/spec/units/plugins/report_log_writer_plugin_spec.rb +10 -1
  500. data/spec/units/plugins/report_tests_raw_output_log_spec.rb +13 -2
  501. data/spec/units/plugins/report_tests_teamcity_stdout_spec.rb +77 -3
  502. data/spec/units/plugins/reportgenerator_reportinator_spec.rb +52 -4
  503. data/spec/units/plugins/sanitize_records_spec.rb +3 -1
  504. data/spec/units/plugins/sanitize_spec.rb +1 -1
  505. data/spec/units/plugins/valgrind_spec.rb +23 -8
  506. data/spec/units/preprocess/preprocessinator_code_finder_spec.rb +73 -10
  507. data/spec/units/preprocess/preprocessinator_comment_stripper_spec.rb +1 -1
  508. data/spec/units/preprocess/preprocessinator_file_assembler_spec.rb +125 -37
  509. data/spec/units/preprocess/preprocessinator_includes_handler_spec.rb +15 -0
  510. data/spec/units/preprocess/preprocessinator_reconstructor_spec.rb +197 -0
  511. data/spec/units/preprocess/preprocessinator_spec.rb +153 -95
  512. data/spec/units/rake_app/rakefile_component_resolver_spec.rb +21 -0
  513. data/spec/units/release_build_executor_spec.rb +53 -14
  514. data/spec/units/release_build_planner_spec.rb +15 -3
  515. data/spec/units/reportinator_spec.rb +5 -5
  516. data/spec/units/setupinator_spec.rb +51 -0
  517. data/spec/units/standin_headerinator_spec.rb +55 -9
  518. data/spec/units/test_build_executor_spec.rb +842 -166
  519. data/spec/units/test_build_planner_spec.rb +205 -15
  520. data/spec/units/test_build_setup_spec.rb +179 -30
  521. data/spec/units/test_context_extractor_spec.rb +36 -2
  522. data/spec/units/test_derived_search_paths_spec.rb +259 -0
  523. data/spec/units/test_file_preprocessinator_spec.rb +17 -1
  524. data/spec/units/test_includes_extractinator_spec.rb +61 -9
  525. data/spec/units/test_invoker/objects_wiring_spec.rb +24 -4
  526. data/spec/units/test_invoker/partial_files_preprocessinator_spec.rb +264 -0
  527. data/spec/units/test_invoker/test_substitutions_spec.rb +122 -0
  528. data/spec/units/test_invoker_spec.rb +14 -1
  529. data/spec/units/test_invoker_types_spec.rb +8 -7
  530. data/spec/units/test_pipeline_manager_spec.rb +54 -13
  531. data/spec/units/test_runner_generatinator_spec.rb +93 -1
  532. data/spec/units/test_search_paths_spec.rb +73 -5
  533. data/spec/units/test_source_file_directive_resolver_spec.rb +38 -7
  534. data/spec/units/tools/default_tools_quoting_spec.rb +117 -0
  535. data/spec/units/tools/shell_quoting_spec.rb +76 -0
  536. data/spec/units/{tool_executor_helper_spec.rb → tools/tool_executor_helper_spec.rb} +1 -1
  537. data/spec/units/{tool_executor_spec.rb → tools/tool_executor_spec.rb} +27 -1
  538. data/spec/units/{tool_validator_spec.rb → tools/tool_validator_spec.rb} +110 -1
  539. data/spec/units/windows_registry_query_tool_spec.rb +53 -0
  540. data/spec/units/yaml_wrapper_spec.rb +11 -0
  541. metadata +265 -36
  542. data/lib/ceedling/file_finder_helper.rb +0 -127
  543. data/lib/ceedling/file_path_collection_utils.rb +0 -164
  544. data/spec/units/file_finder_spec.rb +0 -495
  545. /data/lib/ceedling/{tool_executor_helper.rb → tools/tool_executor_helper.rb} +0 -0
@@ -0,0 +1,196 @@
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
+
11
+ ##
12
+ ## Path Handling Through Real Builds (GH #1370 and the audit around it)
13
+ ## ======================================================================
14
+ ##
15
+ ## Each example builds a project whose configuration names paths in a way the path
16
+ ## handling audit found unsafe, and names the gap it probes. The project sits at `app/`
17
+ ## within its own directory, so a `..` root reaches only that directory, never a
18
+ ## neighboring project.
19
+ ##
20
+
21
+ PROBE_TEST_PREAMBLE = "#include \"unity.h\"\nvoid setUp(void) {}\nvoid tearDown(void) {}\n"
22
+
23
+ ceedling_system_tests do
24
+ include_context "a fresh ceedling gem project", "path_probe"
25
+
26
+ # Moves the fresh project into `app/` and runs the block from there
27
+ def in_app
28
+ in_project do
29
+ FileUtils.mkdir_p( 'app' )
30
+ FileUtils.mv( Dir.children( '.' ) - ['app'], 'app' )
31
+ Dir.chdir( 'app' ) { yield File.expand_path( '..' ) }
32
+ end
33
+ end
34
+
35
+ def write(path, content)
36
+ FileUtils.mkdir_p( File.dirname( path ) )
37
+ File.write( path, content )
38
+ end
39
+
40
+ # The report's setup: a vendor SDK far above the project, beside a `..` root
41
+ it "G1 (#1370): mocks a header far outside the project beside a `..` root" do
42
+ Dir.mktmpdir do |far|
43
+ sdk = File.join( File.realpath( far ), 'deep', 'sdk', 'inc' )
44
+ write( File.join( sdk, 'sdk.h' ), "int sdk_read(void);\n" )
45
+
46
+ in_app do |parent|
47
+ write( 'test/test_m.c', PROBE_TEST_PREAMBLE + "#include \"mock_sdk.h\"\nvoid test_reads(void) { sdk_read_ExpectAndReturn(3); TEST_ASSERT_EQUAL_INT(3, sdk_read()); }\n" )
48
+ @c.merge_project_yml_for_test( { :paths => { :include => ['../**', sdk] } } )
49
+
50
+ output = @c.ceedling_build_exec( "test:all" )
51
+
52
+ expect(@c.last_exit_status).to eq(0), output
53
+ expect(output).to match(/PASSED:\s+1/)
54
+ expect(Dir.children( parent ) - ['app']).to be_empty
55
+ end
56
+ end
57
+ end
58
+
59
+ it "G4: links the source beside a header below a `./` include root" do
60
+ in_app do
61
+ write( 'include/drv/x.h', "int x_value(void);\n" )
62
+ write( 'src/drv/x.c', "#include \"x.h\"\nint x_value(void) { return 7; }\n" )
63
+ write( 'test/test_x.c', PROBE_TEST_PREAMBLE + "#include \"x.h\"\nvoid test_value(void) { TEST_ASSERT_EQUAL_INT(7, x_value()); }\n" )
64
+ @c.merge_project_yml_for_test( { :project => { :use_test_preprocessor => :all }, :paths => { :include => ['./include/**'] } } )
65
+
66
+ output = @c.ceedling_build_exec( "test:all" )
67
+
68
+ expect(@c.last_exit_status).to eq(0), output
69
+ expect(output).to match(/PASSED:\s+1/)
70
+ end
71
+ end
72
+
73
+ it "G5: compiles both of two same-named sources below two roots into a release" do
74
+ in_app do
75
+ write( 'src/foo.c', "int foo_a(void) { return 1; }\n" )
76
+ write( 'lib/foo.c', "int foo_b(void) { return 2; }\n" )
77
+ write( 'src/main.c', "int foo_a(void);\nint foo_b(void);\nint main(void) { return foo_a() + foo_b() - 3; }\n" )
78
+ @c.merge_project_yml_for_test( { :project => { :release_build => true }, :paths => { :source => ['src/**', 'lib/**'] } } )
79
+
80
+ output = @c.ceedling_build_exec( "release" )
81
+
82
+ expect(@c.last_exit_status).to eq(0), output
83
+ end
84
+ end
85
+
86
+ # The mock search path for the header's mirrored directory reaches the #include as written.
87
+ # Test preprocessing finds and places the mock by the #include anchored to the test file's
88
+ # directory, as the text scan does.
89
+ [:none, :tests, :all].each do |preprocessor|
90
+ it "G14: builds a mock #include that climbs with `..`, keeping the mock below its test's mocks directory, under :use_test_preprocessor #{preprocessor}" do
91
+ in_app do
92
+ write( 'inc/x/foo.h', "int foo_read(void);\n" )
93
+ write( 'test/test_c.c', PROBE_TEST_PREAMBLE + "#include \"../x/mock_foo.h\"\nvoid test_reads(void) { foo_read_ExpectAndReturn(5); TEST_ASSERT_EQUAL_INT(5, foo_read()); }\n" )
94
+ @c.merge_project_yml_for_test( { :project => { :use_test_preprocessor => preprocessor }, :paths => { :include => ['inc/**'] } } )
95
+
96
+ output = @c.ceedling_build_exec( "test:all" )
97
+
98
+ expect(@c.last_exit_status).to eq(0), output
99
+ expect(output).to match(/PASSED:\s+1/)
100
+ expect(Dir.glob( 'build/test/mocks/test/test_c/**/mock_foo.h' )).to_not be_empty
101
+ expect(Dir.children( 'build/test/mocks' )).to eq( ['test'] )
102
+ expect(Dir.children( 'build/test/mocks/test' )).to eq( ['test_c'] )
103
+ end
104
+ end
105
+ end
106
+
107
+ # A test reaches a module's static functions by #including its source, which must not be
108
+ # linked a second time from its own object
109
+ it "links a test that #includes both a module's header and its source" do
110
+ in_app do
111
+ write( 'src/foo.h', "int foo(void);\n" )
112
+ write( 'src/foo.c', "#include \"foo.h\"\nstatic int helper(void) { return 2; }\nint foo(void) { return helper() + 1; }\n" )
113
+ write( 'test/test_foo.c', PROBE_TEST_PREAMBLE + "#include \"foo.h\"\n#include \"foo.c\"\nvoid test_helper(void) { TEST_ASSERT_EQUAL_INT(2, helper()); TEST_ASSERT_EQUAL_INT(3, foo()); }\n" )
114
+
115
+ output = @c.ceedling_build_exec( "test:all" )
116
+
117
+ expect(@c.last_exit_status).to eq(0), output
118
+ expect(output).to match(/PASSED:\s+1/)
119
+ end
120
+ end
121
+
122
+ # One file collected by one spelling and configured by another is one source
123
+ it "builds with a `./` build root and Unity helper, which name files the collections spell otherwise" do
124
+ in_app do
125
+ write( 'src/calc.h', "int calc(int a);\n" )
126
+ write( 'src/calc.c', "#include \"calc.h\"\n#include \"CException.h\"\nint calc(int a) { if (a < 0) { Throw(1); } return a + 1; }\n" )
127
+ write( 'test/support/unity_helper.h', "#define UNITY_HELPER_VALUE 1\n" )
128
+ write( 'test/support/unity_helper.c', "int unity_helper_value(void) { return 1; }\n" )
129
+ write( 'test/test_calc.c', PROBE_TEST_PREAMBLE + "#include \"CException.h\"\n#include \"calc.h\"\nvoid test_calc(void) { TEST_ASSERT_EQUAL_INT(2, calc(1)); }\n" )
130
+ @c.merge_project_yml_for_test( {
131
+ :project => { :build_root => './build', :use_exceptions => true },
132
+ :paths => { :support => ['test/support'] },
133
+ :cmock => { :unity_helper_path => ['./test/support/unity_helper.h'] }
134
+ } )
135
+
136
+ output = @c.ceedling_build_exec( "test:all" )
137
+
138
+ expect(@c.last_exit_status).to eq(0), output
139
+ expect(output).to match(/PASSED:\s+1/)
140
+ end
141
+ end
142
+
143
+ # A project file's relative paths resolve against the working directory, not the project
144
+ # file's own directory
145
+ it "G22: builds a project named by --project from another directory, with paths relative to that directory" do
146
+ in_app do |parent|
147
+ write( 'src/calc.c', "#include \"calc.h\"\nint calc(int a) { return a + 1; }\n" )
148
+ write( 'src/calc.h', "int calc(int a);\n" )
149
+ write( 'test/test_calc.c', PROBE_TEST_PREAMBLE + "#include \"calc.h\"\nvoid test_calc(void) { TEST_ASSERT_EQUAL_INT(2, calc(1)); }\n" )
150
+
151
+ project = YAML.load_file( 'project.yml' )
152
+ project[:project][:build_root] = 'app/build'
153
+ project[:paths] = { :test => ['app/test/**'], :source => ['app/src/**'], :include => ['app/src/**'], :support => [] }
154
+ File.write( 'project.yml', project.to_yaml )
155
+
156
+ Dir.chdir( parent ) do
157
+ output = @c.ceedling_build_exec( "--project app/project.yml test:all" )
158
+
159
+ expect(@c.last_exit_status).to eq(0), output
160
+ expect(output).to match(/PASSED:\s+1/)
161
+ expect(Dir.exist?( 'app/build/test' )).to be true
162
+ end
163
+ end
164
+ end
165
+
166
+ # Ceedling refuses a build root holding the project's own directories
167
+ it "G16: never lets clobber empty the project's own test directory" do
168
+ in_app do
169
+ write( 'test/test_keep.c', PROBE_TEST_PREAMBLE + "void test_it(void) {}\n" )
170
+ @c.merge_project_yml_for_test( { :project => { :build_root => '.' } } )
171
+
172
+ output = @c.ceedling_build_exec( "clobber" )
173
+
174
+ expect(@c.last_exit_status).to_not eq(0)
175
+ expect(output).to match( /:build_root => '\.' is the project directory or holds it/ )
176
+ expect(File.exist?( 'test/test_keep.c' )).to be( true )
177
+ end
178
+ end
179
+
180
+ it "reports coverage of a source in a sibling directory outside the project" do
181
+ in_app do |parent|
182
+ write( File.join( parent, 'shared', 'src', 'calc.c' ), "#include \"calc.h\"\nint calc(int a) { return a + 1; }\n" )
183
+ write( File.join( parent, 'shared', 'src', 'calc.h' ), "int calc(int a);\n" )
184
+ write( 'test/test_calc.c', PROBE_TEST_PREAMBLE + "#include \"calc.h\"\nvoid test_calc(void) { TEST_ASSERT_EQUAL_INT(2, calc(1)); }\n" )
185
+ @c.merge_project_yml_for_test( {
186
+ :plugins => { :enabled => ['gcov'] },
187
+ :paths => { :source => ['../shared/src/**'], :include => ['../shared/src/**'] }
188
+ } )
189
+
190
+ output = @c.ceedling_build_exec( "gcov:all" )
191
+
192
+ expect(@c.last_exit_status).to eq(0), output
193
+ expect(output).to match(/calc\.c/)
194
+ end
195
+ end
196
+ end
@@ -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.
@@ -164,7 +164,7 @@ ceedling_system_tests do
164
164
  @c.ceedling_build_exec
165
165
  expect(@c.last_exit_status).to eq(0)
166
166
 
167
- runner_path = 'build/test/runners/test_ptc_runner.c'
167
+ runner_path = 'build/test/runners/test/test_ptc_runner.c'
168
168
  expect(File.exist?(runner_path)).to eq(true)
169
169
  runner_contents = read_spec_file(runner_path)
170
170
 
@@ -61,8 +61,8 @@ ceedling_system_tests do
61
61
  expect(output).to match(/baz[\/\\]bar\.c/)
62
62
  expect(output).to match(/^Compiling bar\.c/)
63
63
 
64
- expect(File.exist?('build/release/out/baz/bar.o')).to be true
65
- expect(File.exist?('build/release/out/foo/bar.o')).to be false
64
+ expect(File.exist?('build/release/out/src/baz/bar.o')).to be true
65
+ expect(File.exist?('build/release/out/src/foo/bar.o')).to be false
66
66
  end
67
67
  end
68
68
 
@@ -73,8 +73,8 @@ ceedling_system_tests do
73
73
  expect(output).to match(/^Compiling bar\.c/)
74
74
  expect(output).to_not match(/^Linking /)
75
75
 
76
- expect(File.exist?('build/release/out/foo/bar.o')).to be true
77
- expect(File.exist?('build/release/out/baz/bar.o')).to be false
76
+ expect(File.exist?('build/release/out/src/foo/bar.o')).to be true
77
+ expect(File.exist?('build/release/out/src/baz/bar.o')).to be false
78
78
  end
79
79
  end
80
80
 
@@ -85,8 +85,8 @@ ceedling_system_tests do
85
85
  expect(output).to match(/^Compiling bar\.c/)
86
86
  expect(output).to_not match(/^Linking /)
87
87
 
88
- expect(File.exist?('build/release/out/baz/bar.o')).to be true
89
- expect(File.exist?('build/release/out/foo/bar.o')).to be false
88
+ expect(File.exist?('build/release/out/src/baz/bar.o')).to be true
89
+ expect(File.exist?('build/release/out/src/foo/bar.o')).to be false
90
90
  end
91
91
  end
92
92
 
@@ -113,6 +113,91 @@ ceedling_system_tests do
113
113
 
114
114
  end
115
115
 
116
+ # =========================================================================
117
+ describe "A test at its root beside same-named tests below it" do
118
+ # =========================================================================
119
+
120
+ # GH #1364: a test at its root builds beside same-named tests below it
121
+ before do
122
+ in_project do
123
+ copy_fixture("tests_with_duplicate_test_names/test_foo.c", 'test')
124
+ copy_fixture("tests_with_duplicate_test_names/unit/test_foo.c", 'test/unit')
125
+ copy_fixture("tests_with_duplicate_test_names/integration/test_foo.c", 'test/integration')
126
+ end
127
+ end
128
+
129
+ it "runs all three under test:all, and summarizes all three" do
130
+ in_project do
131
+ output = @c.ceedling_build_exec("test:all")
132
+ expect(@c.last_exit_status).to eq(0)
133
+ expect(output).to_not match(/Ambiguous/)
134
+ expect(output).to match(/TESTED:\s+3/)
135
+ expect(output).to match(/PASSED:\s+3/)
136
+ expect(output).to match(/test_this_is_the_root_directory_test_foo/)
137
+
138
+ summary = @c.ceedling_build_exec("summary")
139
+ expect(summary).to match(/TESTED:\s+3/)
140
+ end
141
+ end
142
+
143
+ it "runs exactly the test at the root when named by its full path" do
144
+ in_project do
145
+ output = @c.ceedling_build_exec("test:test/test_foo.c")
146
+ expect(@c.last_exit_status).to eq(0)
147
+ expect(output).to match(/TESTED:\s+1/)
148
+ expect(output).to match(/test_this_is_the_root_directory_test_foo/)
149
+ end
150
+ end
151
+
152
+ it "runs all three under gcov:all" do
153
+ in_project do
154
+ @c.merge_project_yml_for_test({ :plugins => { :enabled => ['gcov'] } })
155
+
156
+ output = @c.ceedling_build_exec("gcov:all")
157
+ expect(@c.last_exit_status).to eq(0)
158
+ expect(output).to_not match(/Ambiguous/)
159
+ expect(output).to match(/TESTED:\s+3/)
160
+ expect(output).to match(/PASSED:\s+3/)
161
+ end
162
+ end
163
+
164
+ end
165
+
166
+ # =========================================================================
167
+ describe "Same-named tests under more than one test root" do
168
+ # =========================================================================
169
+
170
+ # GH #1364: tests with one path below different roots keep apart
171
+ it "runs both tests when one root lies inside the other" do
172
+ in_project do
173
+ copy_fixture("tests_with_duplicate_test_names/unit/test_foo.c", 'test')
174
+ copy_fixture("tests_with_duplicate_test_names/integration/test_foo.c", 'test/unit')
175
+ @c.merge_project_yml_for_test({ :paths => { :test => ['+:test/unit/**'] } })
176
+
177
+ output = @c.ceedling_build_exec("test:all")
178
+ expect(@c.last_exit_status).to eq(0)
179
+ expect(output).to match(/TESTED:\s+2/)
180
+ expect(output).to match(/test_this_is_the_unit_directory_test_foo/)
181
+ expect(output).to match(/test_this_is_the_integration_directory_test_foo/)
182
+ end
183
+ end
184
+
185
+ it "runs both tests when two roots hold the same layout" do
186
+ in_project do
187
+ copy_fixture("tests_with_duplicate_test_names/unit/test_foo.c", 'test/foo')
188
+ copy_fixture("tests_with_duplicate_test_names/integration/test_foo.c", 'extra/foo')
189
+ @c.merge_project_yml_for_test({ :paths => { :test => ['+:extra/**'] } })
190
+
191
+ output = @c.ceedling_build_exec("test:all")
192
+ expect(@c.last_exit_status).to eq(0)
193
+ expect(output).to match(/TESTED:\s+2/)
194
+ expect(output).to match(/test_this_is_the_unit_directory_test_foo/)
195
+ expect(output).to match(/test_this_is_the_integration_directory_test_foo/)
196
+ end
197
+ end
198
+
199
+ end
200
+
116
201
  end
117
202
 
118
203
  end
@@ -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
@@ -0,0 +1,86 @@
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
+
10
+ ##
11
+ ## Tests Under Paths Holding Shell Characters Run (issue #1373)
12
+ ## ==============================================================
13
+ ##
14
+ ## A test's executable sits beneath its path from the project root, and tools run through
15
+ ## the system shell. The default tools that run a test executable named it unquoted, so a
16
+ ## test under `test/o'neil/` reported every case as a crash, and one under `test/my dir/`
17
+ ## stopped the build. Each runs here, with a pass, a failure, and a crash that the simple
18
+ ## backtrace reruns pin to its own case.
19
+ ##
20
+
21
+ SPECIAL_PATH_TEST_C = <<~C
22
+ #include "unity.h"
23
+
24
+ void setUp(void) {}
25
+ void tearDown(void) {}
26
+
27
+ void test_passes(void) { TEST_ASSERT_TRUE(1); }
28
+ void test_fails(void) { TEST_ASSERT_EQUAL_INT(1, 2); }
29
+ C
30
+
31
+ SPECIAL_PATH_CRASH_C = <<~C
32
+
33
+ void test_crashes(void) { volatile int *p = 0; *p = 1; }
34
+ C
35
+
36
+ ceedling_system_tests do
37
+ include_context "a fresh ceedling gem project", "special_path"
38
+
39
+ ["o'neil", "my dir"].each do |directory|
40
+ describe "A test under `test/#{directory}/`" do
41
+ before do
42
+ in_project do
43
+ FileUtils.mkdir_p( "test/#{directory}" )
44
+ File.write( "test/#{directory}/test_special.c", SPECIAL_PATH_TEST_C )
45
+ end
46
+ end
47
+
48
+ it "runs a test under `test/#{directory}/`, reporting each case's own result" do
49
+ in_project do
50
+ output = @c.ceedling_build_exec( "test:all" )
51
+
52
+ expect(@c.last_exit_status).to eq(1), output
53
+ expect(output).to_not match(/crashed/i)
54
+ expect(output).to match(/TESTED:\s+2/)
55
+ expect(output).to match(/PASSED:\s+1/)
56
+ expect(output).to match(/FAILED:\s+1/)
57
+ end
58
+ end
59
+
60
+ it "pins a crash under `test/#{directory}/` to its own case through simple backtrace reruns" do
61
+ in_project do
62
+ File.write( "test/#{directory}/test_special.c", SPECIAL_PATH_TEST_C + SPECIAL_PATH_CRASH_C )
63
+
64
+ output = @c.ceedling_build_exec( "test:all" )
65
+
66
+ expect(output).to match(/Test: test_crashes/)
67
+ expect(output).to match(/TESTED:\s+3/)
68
+ expect(output).to match(/PASSED:\s+1/)
69
+ expect(output).to match(/FAILED:\s+2/)
70
+ end
71
+ end
72
+
73
+ it "runs a test under `test/#{directory}/` with gcov" do
74
+ in_project do
75
+ @c.merge_project_yml_for_test( {:plugins => {:enabled => ['gcov']}} )
76
+
77
+ output = @c.ceedling_build_exec( "gcov:all" )
78
+
79
+ expect(output).to_not match(/crashed/i)
80
+ expect(output).to match(/PASSED:\s+1/)
81
+ expect(output).to match(/FAILED:\s+1/)
82
+ end
83
+ end
84
+ end
85
+ end
86
+ 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
  ##