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
@@ -25,6 +25,7 @@ require 'ceedling/filesystem/file_finder_helper'
25
25
  require 'ceedling/filename_extension'
26
26
  require 'ceedling/filesystem/path_matcher'
27
27
  require 'ceedling/filesystem/file_path_utils'
28
+ require 'ceedling/filesystem/test_build_layout'
28
29
  require 'ceedling/constants'
29
30
 
30
31
  describe 'Partial module resolution (integration)' do
@@ -52,15 +53,30 @@ describe 'Partial module resolution (integration)' do
52
53
  allow(@configurator).to receive(:collection_all_source).and_return( RESOLUTION_SOURCES )
53
54
  allow(@configurator).to receive(:collection_all_tests).and_return( [] )
54
55
 
56
+ # Each test's generated files sit where TestBuildLayout puts them
57
+ allow(@configurator).to receive(:project_build_root).and_return('build')
58
+ allow(@configurator).to receive(:project_use_mocks).and_return( true )
59
+ allow(@configurator).to receive(:project_use_partials).and_return( true )
60
+ allow(@configurator).to receive(:cmock_mock_path).and_return('build/test/mocks')
61
+ allow(@configurator).to receive(:project_test_partials_path).and_return('build/test/partials')
62
+ allow(@configurator).to receive(:project_test_preprocess_includes_path).and_return('build/test/preprocess/includes')
63
+ allow(@configurator).to receive(:project_test_preprocess_files_path).and_return('build/test/preprocess/files')
64
+ allow(@configurator).to receive(:project_test_preprocess_build_directives_path).and_return('build/test/preprocess/build_directives')
65
+
66
+ file_wrapper = double('file_wrapper', check_path_length: nil)
67
+ layout = TestBuildLayout.new({ :configurator => @configurator, :file_wrapper => file_wrapper })
68
+
55
69
  @finder = FileFinder.new({
56
70
  :configurator => @configurator,
57
71
  :file_finder_helper => FileFinderHelper.new({ :loginator => loginator }),
58
72
  :file_path_utils => FilePathUtils.new({
59
- :configurator => @configurator,
60
- :file_wrapper => double('file_wrapper')
73
+ :configurator => @configurator,
74
+ :file_wrapper => file_wrapper,
75
+ :test_build_layout => layout
61
76
  }),
62
- :file_wrapper => double('file_wrapper'),
63
- :yaml_wrapper => double('yaml_wrapper')
77
+ :file_wrapper => file_wrapper,
78
+ :yaml_wrapper => double('yaml_wrapper'),
79
+ :test_build_layout => layout
64
80
  })
65
81
  end
66
82
 
@@ -171,7 +187,7 @@ describe 'Partial module resolution (integration)' do
171
187
  # A mock's own generated source is found the same way, and two modules mocked as
172
188
  # Partials by directory put two same-named mocks in one test.
173
189
  context 'resolving build input for a generated mock' do
174
- MOCKS_BUILD_PATH = 'build/test/mocks/test_both_configs'.freeze
190
+ MOCKS_BUILD_PATH = 'build/test/mocks/test_both_configs/_t_'.freeze
175
191
 
176
192
  GENERATED_MOCK_SOURCES = [
177
193
  "#{MOCKS_BUILD_PATH}/drivers/spi/mock_ceedling_partial_config_interface.c",
@@ -182,10 +198,6 @@ describe 'Partial module resolution (integration)' do
182
198
  allow(@configurator).to receive(:project_test_file_prefix).and_return('test_')
183
199
  allow(@configurator).to receive(:test_runner_file_suffix).and_return('_runner')
184
200
  allow(@configurator).to receive(:cmock_mock_prefix).and_return('mock_')
185
- allow(@configurator).to receive(:cmock_mock_path).and_return('build/test/mocks')
186
- allow(@configurator).to receive(:project_build_root).and_return('build')
187
- allow(@finder.instance_variable_get(:@file_path_utils))
188
- .to receive(:form_test_build_path).and_return('build/test/out/test_both_configs')
189
201
  allow(@finder.instance_variable_get(:@file_wrapper))
190
202
  .to receive(:directory_listing).and_return( GENERATED_MOCK_SOURCES )
191
203
  end
@@ -206,7 +218,7 @@ describe 'Partial module resolution (integration)' do
206
218
  expect(
207
219
  find_mock_input(
208
220
  'drivers/spi/mock_ceedling_partial_config_interface.o',
209
- root: 'build/test/out/test_both_configs'
221
+ root: 'build/test/out/test_both_configs/_t_'
210
222
  )
211
223
  ).to eq(GENERATED_MOCK_SOURCES.first)
212
224
  end
@@ -226,7 +238,7 @@ describe 'Partial module resolution (integration)' do
226
238
  # generated filenames rather than anything the test author wrote. A message here
227
239
  # must translate back to the module name before it can mean anything.
228
240
  context 'resolving build input for a generated Partial' do
229
- PARTIALS_BUILD_PATH = 'build/test/partials/test_both_configs'.freeze
241
+ PARTIALS_BUILD_PATH = 'build/test/partials/test_both_configs/_t_'.freeze
230
242
 
231
243
  GENERATED_PARTIAL_SOURCES = [
232
244
  "#{PARTIALS_BUILD_PATH}/drivers/spi/ceedling_partial_config_impl.c",
@@ -237,14 +249,9 @@ describe 'Partial module resolution (integration)' do
237
249
  allow(@configurator).to receive(:project_test_file_prefix).and_return('test_')
238
250
  allow(@configurator).to receive(:test_runner_file_suffix).and_return('_runner')
239
251
  allow(@configurator).to receive(:cmock_mock_prefix).and_return('Mock')
240
- allow(@configurator).to receive(:project_test_partials_path).and_return('build/test/partials')
241
- allow(@configurator).to receive(:project_build_root).and_return('build')
242
-
243
- # The test's own out root. Objects for generated Partials mirror below it, so the
244
- # lookup measures against it as well as the Partials root.
245
- allow(@finder.instance_variable_get(:@file_path_utils))
246
- .to receive(:form_test_build_path).and_return('build/test/out/test_both_configs')
247
252
 
253
+ # Objects for generated Partials mirror below the test's own out root, so the lookup
254
+ # measures against it as well as the Partials root.
248
255
  @listing = GENERATED_PARTIAL_SOURCES
249
256
  allow(@finder.instance_variable_get(:@file_wrapper))
250
257
  .to receive(:directory_listing) { @listing }
@@ -287,7 +294,7 @@ describe 'Partial module resolution (integration)' do
287
294
  expect(
288
295
  find_partial_input(
289
296
  'drivers/uart/ceedling_partial_config_impl.o',
290
- root: 'build/test/out/test_both_configs'
297
+ root: 'build/test/out/test_both_configs/_t_'
291
298
  )
292
299
  ).to eq(GENERATED_PARTIAL_SOURCES.last)
293
300
  end
@@ -53,6 +53,19 @@ describe 'Partial symbol linkage' do
53
53
  expect( link.ok ).to be(true), "expected a clean link, got: #{link.first_diagnostic}"
54
54
  end
55
55
 
56
+ # A coverage tool, a debugger and a compiler message all follow the #line back to the module
57
+ it 'writes an exposed function behind a #line naming its own file and line' do
58
+ result = generate_partial(
59
+ module_name: 'engine',
60
+ header: "#ifndef ENGINE_H\n#define ENGINE_H\n#endif\n",
61
+ source: "#include \"engine.h\"\n\nstatic int engine_step(int v)\n{\n return v + 1;\n}\n",
62
+ source_includes: ['engine.h']
63
+ )
64
+ @dir = result.dir
65
+
66
+ expect( result.impl_c ).to match( /^#line 3 "[^"]*engine\.c"\nint engine_step\(int v\)/ )
67
+ end
68
+
56
69
  # An inline function carries no external definition of its own in C99, so exposing one
57
70
  # has to produce a definition the linker can find rather than only a declaration.
58
71
  it 'links an inline function the Partial exposes' do
@@ -0,0 +1,64 @@
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
+ # A build file is created, opened, written, and replaced through separate FileWrapper
9
+ # calls, each of which checks its path's length. A path near the platform's limit is
10
+ # reported once, however many of them touch it.
11
+ #
12
+ # The path is sized to sit just inside this platform's warning band, below its limit, so
13
+ # every operation succeeds on the real disk.
14
+
15
+ require 'spec_helper'
16
+ require 'tmpdir'
17
+ require 'ceedling/filesystem/file_wrapper'
18
+ require 'ceedling/system_wrapper'
19
+
20
+ describe 'Path length reporting (integration)' do
21
+ around(:each) do |example|
22
+ Dir.mktmpdir { |dir| @root = File.realpath( dir ); example.run }
23
+ end
24
+
25
+ before(:each) do
26
+ @loginator = double( 'loginator' )
27
+ @verbosinator = double( 'verbosinator', should_output?: false )
28
+ @messages = []
29
+ allow(@loginator).to receive(:log) { |message, *| @messages << message }
30
+
31
+ @file_wrapper = FileWrapper.new( { loginator: @loginator, verbosinator: @verbosinator } )
32
+ end
33
+
34
+ def limit
35
+ return FileWrapper::PATH_LENGTH_LIMITS[:windows] if SystemWrapper.windows?
36
+ return FileWrapper::PATH_LENGTH_LIMITS[:macos] if SystemWrapper.macos?
37
+
38
+ return FileWrapper::PATH_LENGTH_LIMITS[:linux]
39
+ end
40
+
41
+ # A directory below the warning band, and a file in it inside the band
42
+ def paths
43
+ directory = @root
44
+ directory = File.join( directory, 'd' * [limit - 40 - directory.length - 1, 100].min ) while directory.length < limit - 40
45
+
46
+ file = File.join( directory, 'f' * (limit - 10 - directory.length - 1) )
47
+ return [directory, file]
48
+ end
49
+
50
+ it 'reports a path in the warning band once across mkdir, open, write, and cp' do
51
+ directory, file = paths
52
+ source = File.join( @root, 'source.c' )
53
+ File.write( source, 'int x;' )
54
+
55
+ @file_wrapper.mkdir( directory )
56
+ @file_wrapper.open( file, 'w' ) { |f| f.write( 'int x;' ) }
57
+ @file_wrapper.write( file, 'int y;' )
58
+ @file_wrapper.cp( source, file )
59
+
60
+ expect(File.read( file )).to eq( 'int x;' )
61
+ expect(@messages.length).to eq( 1 )
62
+ expect(@messages.first).to include( file )
63
+ end
64
+ end
@@ -14,6 +14,8 @@
14
14
 
15
15
  require 'spec_helper'
16
16
  require 'path_scenario_harness'
17
+ require 'yaml'
18
+ require 'ceedling/filesystem/build_subpath'
17
19
 
18
20
  describe 'Path scenarios (integration)' do
19
21
  include PathScenarioHarness
@@ -77,6 +79,81 @@ describe 'Path scenarios (integration)' do
77
79
  end
78
80
  end
79
81
 
82
+ # --- #1387: long roots shorten to a marker in build paths -------------------------------
83
+
84
+ # A vendor's include root far outside the project, and a source root nested deep inside
85
+ # it, add their whole locations to every build path below them. Each gives way to a short
86
+ # marker, and everything below the root keeps its path.
87
+ context '#1387: a long root outside the project and one deep inside it' do
88
+ def files
89
+ {
90
+ 'app/src/main.c' => c( 'main' ), 'app/src/main.h' => h( 'main' ),
91
+ 'app/lib/vendor/acme/hal/hal.c' => c( 'hal' ), 'app/lib/vendor/acme/hal/hal.h' => h( 'hal' ),
92
+ 'app/test/test_m.c' => TEST_C
93
+ }
94
+ end
95
+
96
+ def paths
97
+ {
98
+ test: ['test/**'],
99
+ source: ['src/**', 'lib/vendor/acme/hal/**'],
100
+ include: ['src/**', 'lib/vendor/acme/hal/**', '%{far}/inc/**']
101
+ }
102
+ end
103
+
104
+ def roots_of(scene)
105
+ table = scene[:paths].build_roots
106
+ far = table.entries.map( &:first ).find { |root| root.end_with?( 'inc' ) }
107
+ return [table, far, 'lib/vendor/acme/hal']
108
+ end
109
+
110
+ it 'places build files below each root\'s marker, and finds each source from them exactly' do
111
+ in_workspace( files, far: { 'inc/os/cmsis_os2.h' => h( 'os' ) } ) do |ws, app|
112
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: paths ) )
113
+ table, far, hal = roots_of( scene )
114
+ placed = placements( scene )
115
+
116
+ expect(table.entries.map( &:first )).to contain_exactly( far, hal )
117
+ expect(placed[:release_objects]).to include( "build/release/out/#{table.marker_for( hal )}/hal.o", 'build/release/out/src/main.o' )
118
+ expect(placed[:preprocessed]).to include( end_with( "/#{table.marker_for( far )}/os/cmsis_os2.h" ) )
119
+ placed.each_value { |kind| expect_inside_build( kind ) }
120
+ expect_collections_outside_build( scene[:configurator] )
121
+
122
+ object = "build/release/out/#{table.marker_for( hal )}/hal.o"
123
+ expect(scene[:finder].find_build_input_file( filepath: object, complain: :error, context: RELEASE_SYM )).to eq( "#{hal}/hal.c" )
124
+ end
125
+ end
126
+
127
+ it 'shortens a vendor header\'s build path by exactly its root\'s climb and location' do
128
+ in_workspace( files, far: { 'inc/os/cmsis_os2.h' => h( 'os' ) } ) do |ws, app|
129
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: paths ) )
130
+ table, far, _hal = roots_of( scene )
131
+ header = scene[:configurator].collection_all_headers.find { |path| path.end_with?( 'cmsis_os2.h' ) }
132
+ testable = scene[:state].testables.values.first
133
+
134
+ shortened = scene[:paths].form_preprocessed_file_filepath( header, testable.name )
135
+ former = File.join( scene[:configurator].project_test_preprocess_files_path, testable.name, BuildSubpath::OWN_SEGMENT, BuildSubpath.encode( File.dirname( header ) ), 'cmsis_os2.h' )
136
+
137
+ expect(shortened).to eq( former.sub( BuildSubpath.encode( far ), table.marker_for( far ) ) )
138
+ expect(former.length - shortened.length).to eq( BuildSubpath.encode( far ).length - table.marker_for( far ).length )
139
+ end
140
+ end
141
+
142
+ it 'writes the roots it shortened to the build root, and removes the map once none is' do
143
+ in_workspace( files, far: { 'inc/os/cmsis_os2.h' => h( 'os' ) } ) do |ws, app|
144
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: paths ) )
145
+ table, = roots_of( scene )
146
+
147
+ scene[:paths].publish_build_roots
148
+ expect(YAML.safe_load( File.read( 'build/build_roots.yml' ) )).to eq( table.entries.to_h { |root, marker| [marker, root] } )
149
+
150
+ shallow = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['src/**'], include: ['src/**'] } ) )
151
+ shallow[:paths].publish_build_roots
152
+ expect(File.exist?( 'build/build_roots.yml' )).to be( false )
153
+ end
154
+ end
155
+ end
156
+
80
157
  # --- G2: equivalent spellings of one root ------------------------------------------------
81
158
 
82
159
  context 'G2: one layout under each spelling of its roots' do
@@ -235,7 +312,7 @@ describe 'Path scenarios (integration)' do
235
312
  it 'collects nothing from an existing build directory' do
236
313
  files = {
237
314
  'app/src/main.c' => c( 'main' ), 'app/src/main.h' => h( 'main' ), 'app/test/test_m.c' => TEST_C,
238
- 'app/build/test/mocks/test/test_m/mock_main.h' => h( 'mock' ), 'app/build/test/runners/test/test_m/test_m_runner.c' => c( 'r' )
315
+ 'app/build/test/mocks/test/test_m/_t_/mock_main.h' => h( 'mock' ), 'app/build/test/runners/test/test_m/test_m_runner.c' => c( 'r' )
239
316
  }
240
317
  in_workspace( files ) do |ws, app|
241
318
  scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['src/**'], include: ['../**'] } ) )
@@ -248,7 +325,7 @@ describe 'Path scenarios (integration)' do
248
325
  it 'collects nothing from an existing build directory through a `:files` glob' do
249
326
  files = {
250
327
  'app/src/main.c' => c( 'main' ), 'app/src/main.h' => h( 'main' ), 'app/test/test_m.c' => TEST_C,
251
- 'app/build/test/mocks/test/test_m/mock_main.c' => c( 'mock' ), 'app/build/vendor/unity/src/unity.c' => c( 'unity' )
328
+ 'app/build/test/mocks/test/test_m/_t_/mock_main.c' => c( 'mock' ), 'app/build/vendor/unity/src/unity.c' => c( 'unity' )
252
329
  }
253
330
  in_workspace( files ) do |ws, app|
254
331
  yaml = scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['src/**'], include: ['src/**'] }, files: { source: ['+:**/*.c'] } )
@@ -265,7 +342,7 @@ describe 'Path scenarios (integration)' do
265
342
  files = {
266
343
  'app/src/main.c' => c( 'main' ), 'app/src/main.h' => h( 'main' ), 'app/test/test_m.c' => TEST_C,
267
344
  'app/build/gen/table.c' => c( 'table' ), 'app/build/gen/table.h' => h( 'table' ),
268
- 'app/build/test/mocks/test/test_m/mock_main.c' => c( 'mock' ), 'app/build/test/mocks/test/test_m/mock_main.h' => h( 'mock' )
345
+ 'app/build/test/mocks/test/test_m/_t_/mock_main.c' => c( 'mock' ), 'app/build/test/mocks/test/test_m/_t_/mock_main.h' => h( 'mock' )
269
346
  }
270
347
  in_workspace( files ) do |ws, app|
271
348
  paths = { test: ['test/**'], source: ['src/**', 'build/**'], include: ['src/**', 'build/gen'] }
@@ -164,4 +164,60 @@ describe 'QuoteIncludeIsolator (integration)' do
164
164
  end
165
165
  end
166
166
  end
167
+
168
+ # Sibling-header isolation stages a header, not the file a compiler is handed. A test
169
+ # file elsewhere reaches the copy through the search path that lists it first.
170
+ context 'including a location-preserving header copy with a real gcc' do
171
+ include_context 'requires gcc'
172
+
173
+ def compile(tree)
174
+ with_source_tree(tree) do |dir|
175
+ header = File.join( dir, 'src', 'driverlib.h' )
176
+ deps = File.join( dir, 'main.d' )
177
+ program = File.join( dir, 'main' )
178
+ isolation = @isolator.isolate( parent: dir, files: [header], preserve_location: true )
179
+
180
+ search = ['-I', isolation.dir, '-I', File.join( dir, 'shadow' ), '-I', File.join( dir, 'src' )]
181
+ _, status = Open3.capture2e( 'gcc', *search, '-MMD', '-MF', deps, File.join( dir, 'test', 'main.c' ), '-o', program )
182
+ raise 'compile failed' unless status.success?
183
+
184
+ @isolator.restore_dependencies( isolation, deps )
185
+ run, = Open3.capture2e( program )
186
+
187
+ @isolator.release( isolation.dir )
188
+ yield header, run, File.read( deps ), isolation.dir
189
+ end
190
+ end
191
+
192
+ let(:tree) do
193
+ {
194
+ 'test/main.c' => %(#include <stdio.h>\n#include "driverlib.h"\n) +
195
+ %(int main(void) { printf("%s %d\\n", driverlib_file, BOARD); return 0; }\n),
196
+ 'src/driverlib.h' => %(#include "board.h"\nstatic const char *driverlib_file = __FILE__;\n),
197
+ 'src/board.h' => %(#define BOARD 1\n),
198
+ 'shadow/board.h' => %(#define BOARD 2\n)
199
+ }
200
+ end
201
+
202
+ # The #line directive names the original's directory, but a quoted #include still
203
+ # starts from the directory the copy really sits in
204
+ it "resolves the copy's quoted #include through the search path, not the original's directory" do
205
+ compile( tree ) do |_, run|
206
+ expect( run.split[1] ).to eq( '2' )
207
+ end
208
+ end
209
+
210
+ it 'reports the original header as __FILE__' do
211
+ compile( tree ) do |header, run|
212
+ expect( run.split[0] ).to eq( header )
213
+ end
214
+ end
215
+
216
+ it 'leaves the restored dependency file naming the original header, never the copy' do
217
+ compile( tree ) do |header, _, deps, staged_dir|
218
+ expect( deps ).to include( header )
219
+ expect( deps ).to_not include( staged_dir )
220
+ end
221
+ end
222
+ end
167
223
  end
@@ -7,7 +7,7 @@
7
7
 
8
8
  # Integration coverage for Fix 5 (Stage 2 of the concurrency/file-presence work,
9
9
  # Finding 4): TestBuildExecutor#apply_sibling_isolation's unguarded writes to
10
- # testable.search_paths/isolated_headers_path are safe only because
10
+ # testable.search_paths/header_isolation are safe only because
11
11
  # stage_build_objects's two-pass split is a real barrier -- every test's own file
12
12
  # compiles in one Batchinator batch, fully drained, before any other object in
13
13
  # that same test's build starts in a second batch. This is a canary, not a
@@ -30,10 +30,14 @@ describe 'Test file #include extraction (integration)' do
30
30
 
31
31
  # Runs stages 2 through 4 for test/<test> in a project laid out from `tree`, and yields
32
32
  # the harness and the Testable. `directives_only: false` forces whole-run fallback.
33
- def extract(tree, test, directives_only:, defines: [], flags: [], bare_tool: DEFAULT_TEST_BARE_INCLUDES_PREPROCESSOR_TOOL)
33
+ # `include_paths` replaces every directory below src/ as the search paths, and
34
+ # `all_headers` every header below src/ as the header collection.
35
+ def extract(tree, test, directives_only:, defines: [], flags: [], bare_tool: DEFAULT_TEST_BARE_INCLUDES_PREPROCESSOR_TOOL, include_paths: nil, all_headers: nil)
34
36
  with_source_tree( tree ) do |dir|
35
37
  Dir.chdir( dir ) do
36
- harness = IntegrationSpecHelpers::TestIncludesHarness.new( directives_only: directives_only, bare_tool: bare_tool )
38
+ harness = IntegrationSpecHelpers::TestIncludesHarness.new(
39
+ directives_only: directives_only, bare_tool: bare_tool, include_paths: include_paths, all_headers: all_headers
40
+ )
37
41
  testable = harness.run( "test/#{test}", defines: defines, flags: flags )
38
42
  yield harness, testable
39
43
  end
@@ -139,9 +143,35 @@ describe 'Test file #include extraction (integration)' do
139
143
  }
140
144
 
141
145
  extract_in_mode( tree, 'test_reader.c' ) do |harness, testable|
142
- expect(harness.mocks( 'test/test_reader.c' )).to eq( ['mock_widget.h'] )
143
- # The macro's #include resolves as `drivers/mock_widget.h`, reached from the mock root
144
- expect(testable.mock_search_paths).to eq( ['build/mocks/test_reader/drivers', 'build/mocks/test_reader'] )
146
+ expect(harness.mock_filepaths( 'test/test_reader.c' )).to eq( ['mock_widget.h'] )
147
+ # The macro's #include names the mock without a folder, reached in its mirrored directory
148
+ expect(testable.mock_search_paths).to eq( ['build/mocks/test_reader/drivers'] )
149
+ end
150
+ end
151
+
152
+ # The preprocessor finds a mock at its place below its mirror root, which can carry
153
+ # folders the test's #include never wrote. CMock and the runner name the mock by its #include.
154
+ it 'names a mock by the #include the test wrote, not its header\'s mirrored folder' do
155
+ tree = {
156
+ 'src/include/task.h' => "int task_run(int x);\n",
157
+ 'test/test_task.c' => "#include \"mock_task.h\"\n"
158
+ }
159
+
160
+ extract_in_mode( tree, 'test_task.c' ) do |harness, testable|
161
+ expect(harness.mock_filepaths( 'test/test_task.c' )).to eq( ['mock_task.h'] )
162
+ expect(testable.mock_search_paths).to eq( ['build/mocks/test_task/include'] )
163
+ end
164
+ end
165
+
166
+ it 'keeps same-named mocks apart by the folders the test wrote' do
167
+ tree = {
168
+ 'src/x/a/foo.h' => "int a_read(void);\n",
169
+ 'src/y/b/foo.h' => "int b_read(void);\n",
170
+ 'test/test_ab.c' => "#include \"a/mock_foo.h\"\n#include \"b/mock_foo.h\"\n"
171
+ }
172
+
173
+ extract_in_mode( tree, 'test_ab.c' ) do |harness, _testable|
174
+ expect(harness.mock_filepaths( 'test/test_ab.c' )).to contain_exactly( 'a/mock_foo.h', 'b/mock_foo.h' )
145
175
  end
146
176
  end
147
177
 
@@ -185,6 +215,41 @@ describe 'Test file #include extraction (integration)' do
185
215
  end
186
216
  end
187
217
 
218
+ # A search path reaches a header in a directory below it, as the compiler's -I does,
219
+ # whether the #include is the test's own or the path GCC resolved it to
220
+ it 'reaches a header named by its directory below a search path that lists only its parent' do
221
+ tree = {
222
+ 'src/drivers/foo.h' => "int foo_read(void);\n",
223
+ 'test/test_drivers.c' => "#include \"drivers/foo.h\"\n#include \"drivers/mock_foo.h\"\n"
224
+ }
225
+
226
+ extract_in_mode( tree, 'test_drivers.c', include_paths: ['src'] ) do |harness, testable|
227
+ expect(harness.mocks( 'test/test_drivers.c' )).to eq( ['mock_foo.h'] )
228
+ expect(testable.mock_search_paths).to eq( ['build/mocks/test_drivers/drivers', 'build/mocks/test_drivers'] )
229
+
230
+ search = harness.header_search( testable )
231
+ headers = harness.context_extractor.lookup_nonmock_header_includes_list( 'test/test_drivers.c' ).map do |include|
232
+ search.header_candidates( include.filepath ).first
233
+ end
234
+ expect(headers).to eq( ['src/drivers/foo.h'] )
235
+ end
236
+ end
237
+
238
+ # A header only :files supplies sits in no search path's directory, so the test gets
239
+ # the directory its #include implies, and its stand-in reaches the header through it
240
+ it 'reaches a header no search path lists through the directory its #include implies' do
241
+ tree = {
242
+ 'src/path/to/sensor.h' => "int sensor_read(void);\n",
243
+ 'test/test_sensor.c' => "#include \"mock_sensor.h\"\n"
244
+ }
245
+
246
+ extract_in_mode( tree, 'test_sensor.c', include_paths: ['.'], all_headers: ['src/path/to/sensor.h'] ) do |harness, testable|
247
+ expect(testable.derived_search_paths).to eq( ['src/path/to'] )
248
+ expect(testable.search_paths.last).to eq( 'src/path/to' )
249
+ expect(harness.mocks( 'test/test_sensor.c' )).to eq( ['mock_sensor.h'] )
250
+ end
251
+ end
252
+
188
253
  # The candidates include scanned mocks the preprocessor then discards; their
189
254
  # directories serve the second pass and are dropped once it has decided
190
255
  it 'narrows mock search paths to the mocks the build uses' do
@@ -13,6 +13,7 @@
13
13
  require 'spec_helper'
14
14
  require 'configurator_integration_helper'
15
15
  require 'ceedling/filesystem/file_path_utils'
16
+ require 'ceedling/filesystem/test_build_layout'
16
17
  require 'ceedling/filesystem/file_finder'
17
18
  require 'ceedling/filesystem/file_finder_helper'
18
19
  require 'ceedling/test_invoker/test_build_setup'
@@ -59,7 +60,8 @@ describe 'Test naming (integration)' do
59
60
  # Stage 1 of a build of `tests`, with real naming and real directories
60
61
  def prepare(configurator, tests)
61
62
  file_wrapper = FileWrapper.new( loginator: double( 'loginator', log: nil ), verbosinator: double( 'verbosinator', should_output?: false ) )
62
- file_path_utils = FilePathUtils.new( configurator: configurator, file_wrapper: file_wrapper )
63
+ layout = TestBuildLayout.new( configurator: configurator, file_wrapper: file_wrapper )
64
+ file_path_utils = FilePathUtils.new( configurator: configurator, file_wrapper: file_wrapper, test_build_layout: layout )
63
65
 
64
66
  collaborators = TestBuildSetup.constructor_keys.to_h { |key| [key, double( key.to_s )] }
65
67
  setup = TestBuildSetup.new( collaborators.merge(
@@ -72,10 +74,11 @@ describe 'Test naming (integration)' do
72
74
  end
73
75
 
74
76
  def finder(configurator, file_path_utils)
75
- loginator = double( 'loginator', log: nil )
77
+ loginator = double( 'loginator', log: nil )
78
+ file_wrapper = FileWrapper.new( loginator: loginator, verbosinator: double( 'verbosinator', should_output?: false ) )
76
79
  return FileFinder.new(
77
80
  configurator: configurator, file_finder_helper: FileFinderHelper.new( loginator: loginator ), file_path_utils: file_path_utils,
78
- file_wrapper: FileWrapper.new( loginator: loginator, verbosinator: double( 'verbosinator', should_output?: false ) ), yaml_wrapper: nil
81
+ file_wrapper: file_wrapper, yaml_wrapper: nil, test_build_layout: TestBuildLayout.new( configurator: configurator, file_wrapper: file_wrapper )
79
82
  )
80
83
  end
81
84
 
@@ -19,6 +19,7 @@ require 'ceedling/includes/include_factory'
19
19
  require 'ceedling/filesystem/file_finder'
20
20
  require 'ceedling/filesystem/file_finder_helper'
21
21
  require 'ceedling/filesystem/file_path_utils'
22
+ require 'ceedling/filesystem/test_build_layout'
22
23
  require 'ceedling/test_context_extractor'
23
24
  require 'ceedling/test_invoker/test_source_file_directive_resolver'
24
25
  require 'ceedling/test_invoker/test_build_setup'
@@ -70,13 +71,14 @@ describe 'TEST_SOURCE_FILE() checks (integration)' do
70
71
  loginator = graph[:loginator]
71
72
  file_wrapper = graph[:file_wrapper]
72
73
 
73
- file_path_utils = FilePathUtils.new( configurator: configurator, file_wrapper: file_wrapper )
74
+ layout = TestBuildLayout.new( configurator: configurator, file_wrapper: file_wrapper )
75
+ file_path_utils = FilePathUtils.new( configurator: configurator, file_wrapper: file_wrapper, test_build_layout: layout )
74
76
  file_finder = FileFinder.new(
75
77
  configurator: configurator, file_finder_helper: FileFinderHelper.new( loginator: loginator ),
76
- file_path_utils: file_path_utils, file_wrapper: file_wrapper, yaml_wrapper: graph[:yaml_wrapper]
78
+ file_path_utils: file_path_utils, file_wrapper: file_wrapper, yaml_wrapper: graph[:yaml_wrapper], test_build_layout: layout
77
79
  )
78
80
  extractor = TestContextExtractor.new(
79
- configurator: configurator, parsing_parcels: ParsingParcels.new, include_factory: IncludeFactory.new( configurator: configurator ),
81
+ configurator: configurator, parsing_parcels: ParsingParcels.new, include_factory: IncludeFactory.new( configurator: configurator, test_build_layout: layout ),
80
82
  partializer_config: double( 'partializer_config' ).as_null_object, file_path_utils: file_path_utils, file_wrapper: file_wrapper,
81
83
  yaml_wrapper: graph[:yaml_wrapper], loginator: loginator
82
84
  )
@@ -5,7 +5,7 @@
5
5
  # SPDX-License-Identifier: MIT
6
6
  # =========================================================================
7
7
 
8
- # Unlike spec/units/tool_executor_spec.rb, this spec wires the REAL ToolExecutor +
8
+ # Unlike spec/units/tools/tool_executor_spec.rb, this spec wires the REAL ToolExecutor +
9
9
  # ToolExecutorHelper + SystemWrapper + SystemUtils + Loginator + Verbosinator +
10
10
  # RubyExpandinator graph (see tool_executor_integration_helper.rb) and genuinely shells
11
11
  # out through SystemWrapper#shell_capture3 (Open3.capture3). The one external dependency
@@ -10,13 +10,13 @@
10
10
  # Whether a candidate file exists, how a quoted path with spaces resolves, and what PATH
11
11
  # a process actually searches are facts a doubled file layer cannot prove. A real
12
12
  # FileWrapper and SystemWrapper run here against real temp directories, with PATH set
13
- # per example. The unit spec at spec/units/tool_validator_spec.rb owns every decision
13
+ # per example. The unit spec at spec/units/tools/tool_validator_spec.rb owns every decision
14
14
  # observable through doubles alone.
15
15
 
16
16
  require 'spec_helper'
17
17
  require 'spec_integration_helper'
18
18
  require 'fileutils'
19
- require 'ceedling/tool_validator'
19
+ require 'ceedling/tools/tool_validator'
20
20
  require 'ceedling/filesystem/file_wrapper'
21
21
  require 'ceedling/system_wrapper'
22
22
  require 'ceedling/ruby_expandinator'
@@ -0,0 +1,46 @@
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
+ # The Windows long path probe against the real disk, reading the registry through the
9
+ # default Windows registry query tool and the real ToolExecutor.
10
+ #
11
+ # Hosted Windows runners ship with long paths enabled, and every RubyInstaller Ruby is
12
+ # long-path-aware. Ruby 3.x there writes and reads files past 260 characters, but can't
13
+ # list directories that deep; Ruby 4.0 can. macOS and Linux have no 260-character limit.
14
+
15
+ require 'spec_helper'
16
+ require 'tmpdir'
17
+ require 'tool_executor_integration_helper'
18
+ require 'ceedling/filesystem/win_long_paths'
19
+ require 'ceedling/system_wrapper'
20
+
21
+ describe 'Windows long path probe (integration)' do
22
+ around(:each) do |example|
23
+ Dir.mktmpdir { |dir| @root = dir; example.run }
24
+ end
25
+
26
+ def probe
27
+ prober = real_win_path_prober( build_root: @root, loginator: double( 'loginator' ).as_null_object )
28
+ return WinLongPaths.probe( @root, query: prober.method( :registry_query ) )
29
+ end
30
+
31
+ def expected_support
32
+ return :full unless SystemWrapper.windows?
33
+
34
+ return Gem::Version.new( RUBY_VERSION ) >= Gem::Version.new( '4.0' ) ? :full : :files_only
35
+ end
36
+
37
+ it 'reports what this host and Ruby support past 260 characters' do
38
+ expect(probe[:support]).to eq( expected_support )
39
+ end
40
+
41
+ it 'leaves nothing behind' do
42
+ probe
43
+
44
+ expect(Dir.children( @root )).to be_empty
45
+ end
46
+ end