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,399 @@
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
+ # Path handling across project layouts and the spellings a project file may use for one
9
+ # place: through configuration, collection, build-path mapping, and the lookups that invert
10
+ # it. Every build file must land inside the build root, distinct inputs must stay distinct,
11
+ # and every spelling of one layout must place files alike.
12
+ #
13
+ # Each example names the gap it probes (GH #1370 and the path handling audit around it).
14
+
15
+ require 'spec_helper'
16
+ require 'path_scenario_harness'
17
+ require 'yaml'
18
+ require 'ceedling/filesystem/build_subpath'
19
+
20
+ describe 'Path scenarios (integration)' do
21
+ include PathScenarioHarness
22
+
23
+ TEST_C = "#include \"unity.h\"\nvoid setUp(void) {}\nvoid tearDown(void) {}\nvoid test_it(void) {}\n"
24
+
25
+ def c(name)
26
+ "int #{name}(void) { return 0; }\n"
27
+ end
28
+
29
+ def h(name)
30
+ "int #{name}(void);\n"
31
+ end
32
+
33
+ # --- Baseline -------------------------------------------------------------------------
34
+
35
+ it 'baseline: mirrors same-named files below one plain root, inside the build root' do
36
+ files = {
37
+ 'app/src/a/util.c' => c( 'a' ), 'app/src/b/util.c' => c( 'b' ),
38
+ 'app/src/a/util.h' => h( 'a' ), 'app/src/b/util.h' => h( 'b' ),
39
+ 'app/test/test_u.c' => TEST_C
40
+ }
41
+ in_workspace( files ) do |ws, app|
42
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['src/**'], include: ['src/**'] } ) )
43
+ placed = placements( scene )
44
+
45
+ placed.each_value { |paths| expect_inside_build( paths ) }
46
+ expect_distinct( placed[:test_objects], 'test objects' )
47
+ expect_distinct( placed[:release_objects], 'release objects' )
48
+ expect_distinct( placed[:preprocessed], 'preprocessed headers' )
49
+ end
50
+ end
51
+
52
+ # --- G1 (#1370): a `..` root beside a header outside the project ------------------------
53
+
54
+ # The report's vendor SDK sat at its drive's root, far above the project, so its headers'
55
+ # paths climb past the `..` root. A sibling one level up is truly below `..` and mirrors.
56
+ context 'G1 (#1370): a `..` root beside an include path far outside the project' do
57
+ def files
58
+ {
59
+ 'app/src/main.c' => c( 'main' ), 'app/src/main.h' => h( 'main' ),
60
+ 'app/test/test_m.c' => TEST_C,
61
+ 'vendor/inc/cmsis.h' => h( 'cmsis' )
62
+ }
63
+ end
64
+
65
+ [
66
+ ['an absolute vendor path far outside', '%{far}/inc'],
67
+ ['a sibling vendor path', '../vendor/inc']
68
+ ].each do |label, vendor|
69
+ it "places a mock of the vendor header inside the build root, with #{label}" do
70
+ in_workspace( files, far: { 'inc/sdk.h' => h( 'sdk' ) } ) do |ws, app|
71
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['src/**'], include: ['../**', vendor] } ) )
72
+ placed = placements( scene )
73
+
74
+ expect_inside_build( placed[:mocks] )
75
+ expect_inside_build( placed[:preprocessed] )
76
+ expect_inside_build( placed[:test_objects] )
77
+ end
78
+ end
79
+ end
80
+ end
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
+
157
+ # --- G2: equivalent spellings of one root ------------------------------------------------
158
+
159
+ context 'G2: one layout under each spelling of its roots' do
160
+ def files
161
+ {
162
+ 'app/src/a/util.c' => c( 'a' ), 'app/src/b/util.c' => c( 'b' ),
163
+ 'app/src/a/util.h' => h( 'a' ), 'app/src/b/util.h' => h( 'b' ),
164
+ 'app/test/test_u.c' => TEST_C
165
+ }
166
+ end
167
+
168
+ def placed_with(spelling, ws, app)
169
+ spell = PathScenarioHarness::ROOT_SPELLINGS[spelling]
170
+ roots = ->(root) { [spell.call( root, ws: ws, app: app )] }
171
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: roots.( 'test/**' ), source: roots.( 'src/**' ), include: roots.( 'src/**' ) } ) )
172
+ return [scene, relative_placements( scene )]
173
+ end
174
+
175
+ (PathScenarioHarness::ROOT_SPELLINGS.keys - [:plain]).each do |spelling|
176
+ it "places every build file as the plain spelling does, with #{spelling} roots" do
177
+ in_workspace( files, symlink: spelling == :symlink ) do |ws, app|
178
+ _, plain = placed_with( :plain, ws, app )
179
+ scene, spelled = placed_with( spelling, ws, app )
180
+
181
+ expect_one_spelling_each( scene[:configurator] )
182
+ expect(spelled).to eq( plain )
183
+ end
184
+ end
185
+ end
186
+ end
187
+
188
+ # --- G3 and G13: exclusions ---------------------------------------------------------------
189
+
190
+ context 'G3 and G13: a `-:` exclusion' do
191
+ def files
192
+ {
193
+ 'app/src/sub/x.c' => c( 'x1' ), 'app/src/exp/sub/x.c' => c( 'x2' ), 'app/src/exp/deep/y.c' => c( 'y' ),
194
+ 'app/src/main.h' => h( 'main' ), 'app/test/test_m.c' => TEST_C
195
+ }
196
+ end
197
+
198
+ it 'G13: excludes the whole subtree it names' do
199
+ in_workspace( files ) do |ws, app|
200
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['+:src/**', '-:src/exp'], include: ['src/**'] } ) )
201
+
202
+ expect(scene[:configurator].collection_all_source).to match_array( %w[src/sub/x.c] )
203
+ end
204
+ end
205
+
206
+ # A file the exclusion fails to drop (G13) must not mirror below the exclusion itself
207
+ it 'G3: is never a root that kept files mirror below' do
208
+ in_workspace( files ) do |ws, app|
209
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['+:src/**', '-:src/exp'], include: ['src/**'] } ) )
210
+ placed = placements( scene )
211
+
212
+ expect_distinct( placed[:release_objects], 'release objects' )
213
+ end
214
+ end
215
+ end
216
+
217
+ # --- G4: header-to-source correlation ---------------------------------------------------
218
+
219
+ context 'G4: a header found beside its source by convention' do
220
+ def files
221
+ {
222
+ 'app/include/drv/x.h' => h( 'x' ), 'app/src/drv/x.c' => c( 'x' ),
223
+ 'app/components/foo/include/foo.h' => h( 'foo' ), 'app/components/foo/src/foo.c' => c( 'foo' ),
224
+ 'app/test/test_x.c' => TEST_C
225
+ }
226
+ end
227
+
228
+ {
229
+ 'a plain include root' => ['include/**'],
230
+ 'a `./` include root' => ['./include/**'],
231
+ 'an absolute include root' => ['%{app}/include/**']
232
+ }.each do |label, include|
233
+ it "finds the source of a header below #{label}" do
234
+ in_workspace( files ) do |ws, app|
235
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['src/**'], include: include } ) )
236
+
237
+ expect(scene[:finder].find_build_input_file( filepath: 'include/drv/x.h', complain: :ignore, context: :test )).to eq( 'src/drv/x.c' )
238
+ end
239
+ end
240
+ end
241
+
242
+ it 'finds the source of a header below a glob-middle include root' do
243
+ in_workspace( files ) do |ws, app|
244
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['components/*/src'], include: ['components/*/include'] } ) )
245
+
246
+ expect(scene[:finder].find_build_input_file( filepath: 'components/foo/include/foo.h', complain: :ignore, context: :test )).to eq( 'components/foo/src/foo.c' )
247
+ end
248
+ end
249
+ end
250
+
251
+ # --- G5 and G6: collisions --------------------------------------------------------------
252
+
253
+ context 'G5: the same relative path below two roots' do
254
+ it 'gives each source its own release object' do
255
+ files = { 'app/src/foo.c' => c( 'a' ), 'app/lib/foo.c' => c( 'b' ), 'app/src/foo.h' => h( 'a' ), 'app/test/test_f.c' => TEST_C }
256
+ in_workspace( files ) do |ws, app|
257
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['src/**', 'lib/**'], include: ['src/**'] } ) )
258
+
259
+ expect_distinct( placements( scene )[:release_objects], 'release objects' )
260
+ end
261
+ end
262
+ end
263
+
264
+ context 'G6: nested roots' do
265
+ it 'gives a file in the inner root and one in the outer root their own objects' do
266
+ files = { 'app/src/util.c' => c( 'a' ), 'app/src/legacy/util.c' => c( 'b' ), 'app/src/util.h' => h( 'a' ), 'app/test/test_u.c' => TEST_C }
267
+ in_workspace( files ) do |ws, app|
268
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['src/**', 'src/legacy/**'], include: ['src/**'] } ) )
269
+ placed = placements( scene )
270
+
271
+ expect_distinct( placed[:test_objects], 'test objects' )
272
+ expect_distinct( placed[:release_objects], 'release objects' )
273
+ end
274
+ end
275
+ end
276
+
277
+ # --- G8: outside every root -------------------------------------------------------------
278
+
279
+ context 'G8: sources reached only through :files' do
280
+ it 'gives same-named files outside every root their own objects' do
281
+ files = { 'app/src/main.c' => c( 'main' ), 'app/src/main.h' => h( 'main' ), 'app/a/util.c' => c( 'a' ), 'app/b/util.c' => c( 'b' ), 'app/test/test_m.c' => TEST_C }
282
+ in_workspace( files ) do |ws, app|
283
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['src/**'], include: ['src/**'] }, files: { source: ['a/util.c', 'b/util.c'] } ) )
284
+
285
+ expect_distinct( placements( scene )[:release_objects], 'release objects' )
286
+ end
287
+ end
288
+ end
289
+
290
+ # --- Sources outside the project --------------------------------------------------------
291
+
292
+ context 'sources and headers in a sibling directory' do
293
+ it 'places their build files inside the build root, each its own' do
294
+ files = {
295
+ 'shared/src/a/util.c' => c( 'a' ), 'shared/src/b/util.c' => c( 'b' ),
296
+ 'shared/src/a/util.h' => h( 'a' ), 'shared/src/b/util.h' => h( 'b' ),
297
+ 'app/test/test_u.c' => TEST_C
298
+ }
299
+ in_workspace( files ) do |ws, app|
300
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['../shared/src/**'], include: ['../shared/src/**'] } ) )
301
+ placed = placements( scene )
302
+
303
+ placed.each_value { |paths| expect_inside_build( paths ) }
304
+ expect_distinct( placed[:release_objects], 'release objects' )
305
+ end
306
+ end
307
+ end
308
+
309
+ # --- G15: a root above the build root --------------------------------------------------
310
+
311
+ context 'G15: a root that holds the build root' do
312
+ it 'collects nothing from an existing build directory' do
313
+ files = {
314
+ 'app/src/main.c' => c( 'main' ), 'app/src/main.h' => h( 'main' ), 'app/test/test_m.c' => TEST_C,
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' )
316
+ }
317
+ in_workspace( files ) do |ws, app|
318
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['src/**'], include: ['../**'] } ) )
319
+
320
+ expect_collections_outside_build( scene[:configurator] )
321
+ end
322
+ end
323
+
324
+ # A release compiles every collected source, so generated mocks and runners broke it
325
+ it 'collects nothing from an existing build directory through a `:files` glob' do
326
+ files = {
327
+ 'app/src/main.c' => c( 'main' ), 'app/src/main.h' => h( 'main' ), 'app/test/test_m.c' => TEST_C,
328
+ 'app/build/test/mocks/test/test_m/_t_/mock_main.c' => c( 'mock' ), 'app/build/vendor/unity/src/unity.c' => c( 'unity' )
329
+ }
330
+ in_workspace( files ) do |ws, app|
331
+ yaml = scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['src/**'], include: ['src/**'] }, files: { source: ['+:**/*.c'] } )
332
+ scene = scenario( yaml )
333
+
334
+ expect_collections_outside_build( scene[:configurator] )
335
+ expect(scene[:configurator].collection_release_build_input.to_a.grep( %r{\Abuild/} )).to be_empty
336
+ expect(scene[:configurator].collection_existing_test_build_input.to_a.grep( %r{\Abuild/test/} )).to be_empty
337
+ end
338
+ end
339
+
340
+ # Generated code may sit in the build root, beside the directories Ceedling creates there
341
+ it 'collects generated code an entry names in the build root, but nothing Ceedling created there' do
342
+ files = {
343
+ 'app/src/main.c' => c( 'main' ), 'app/src/main.h' => h( 'main' ), 'app/test/test_m.c' => TEST_C,
344
+ 'app/build/gen/table.c' => c( 'table' ), 'app/build/gen/table.h' => h( 'table' ),
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' )
346
+ }
347
+ in_workspace( files ) do |ws, app|
348
+ paths = { test: ['test/**'], source: ['src/**', 'build/**'], include: ['src/**', 'build/gen'] }
349
+ yaml = scenario_yaml( ws: ws, app: app, paths: paths, files: { source: ['+:build/**/*.c'] } )
350
+ scene = scenario( yaml )
351
+
352
+ expect(scene[:configurator].collection_all_source.to_a).to contain_exactly( 'src/main.c', 'build/gen/table.c' )
353
+ expect(scene[:configurator].collection_all_headers.to_a).to include( 'build/gen/table.h' )
354
+ expect(scene[:configurator].collection_all_headers.to_a.grep( %r{\Abuild/test/} )).to be_empty
355
+ end
356
+ end
357
+ end
358
+
359
+ # --- Test files kept out of the sources and the release --------------------------------
360
+
361
+ context 'test files among the sources' do
362
+ # A release compiles every source it collects, and a test file holds a second main()
363
+ it 'collects no test file into the sources or the release through a `:files` glob' do
364
+ files = { 'app/src/main.c' => c( 'main' ), 'app/src/main.h' => h( 'main' ), 'app/test/test_m.c' => TEST_C }
365
+ in_workspace( files ) do |ws, app|
366
+ yaml = scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['src/**'], include: ['src/**'] }, files: { source: ['+:**/*.c'] } )
367
+ scene = scenario( yaml )
368
+
369
+ expect(scene[:configurator].collection_all_tests.to_a).to eq( ['test/test_m.c'] )
370
+ expect(scene[:configurator].collection_all_source.to_a).to eq( ['src/main.c'] )
371
+ expect(scene[:configurator].collection_release_build_input.to_a).to eq( ['src/main.c'] )
372
+ end
373
+ end
374
+
375
+ # A test root beside the sources reaches the release through :paths as well
376
+ it 'collects no test file into the release from a source root that holds the tests' do
377
+ files = { 'app/src/main.c' => c( 'main' ), 'app/src/main.h' => h( 'main' ), 'app/src/test/test_m.c' => TEST_C }
378
+ in_workspace( files ) do |ws, app|
379
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['src/test/**'], source: ['src/**'], include: ['src/**'] } ) )
380
+
381
+ expect(scene[:configurator].collection_release_build_input.to_a).to eq( ['src/main.c'] )
382
+ end
383
+ end
384
+
385
+ end
386
+
387
+ # --- G12: the working directory reached through a symlink -------------------------------
388
+
389
+ context 'G12: absolute roots spelled through a symlink to the project' do
390
+ it 'collects each file once' do
391
+ files = { 'app/src/main.c' => c( 'main' ), 'app/src/main.h' => h( 'main' ), 'app/test/test_m.c' => TEST_C }
392
+ in_workspace( files, symlink: true ) do |ws, app|
393
+ scene = scenario( scenario_yaml( ws: ws, app: app, paths: { test: ['test/**'], source: ['src/**', '%{ws}/link/src/**'], include: ['src/**'] } ) )
394
+
395
+ expect_one_spelling_each( scene[:configurator] )
396
+ end
397
+ end
398
+ end
399
+ end
@@ -24,7 +24,7 @@ require 'spec_integration_helper'
24
24
  require 'fileutils'
25
25
  require 'tmpdir'
26
26
  require 'open3'
27
- require 'ceedling/file_wrapper'
27
+ require 'ceedling/filesystem/file_wrapper'
28
28
  require 'ceedling/quote_include_isolator'
29
29
  require 'ceedling/constants'
30
30
 
@@ -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
@@ -16,7 +16,7 @@ require 'open3'
16
16
  require 'json'
17
17
  require 'ceedling/constants'
18
18
  require 'ceedling/plugins/plugin'
19
- require 'ceedling/file_wrapper'
19
+ require 'ceedling/filesystem/file_wrapper'
20
20
 
21
21
  $LOAD_PATH.unshift( File.expand_path( '../../plugins/report_build_warnings_log/lib', __dir__ ) )
22
22
 
@@ -16,7 +16,7 @@ require 'spec_helper'
16
16
  require 'json'
17
17
  require 'tmpdir'
18
18
  require 'rexml/document'
19
- require 'ceedling/file_wrapper'
19
+ require 'ceedling/filesystem/file_wrapper'
20
20
  require 'ceedling/config/config_walkinator'
21
21
 
22
22
  $: << File.expand_path('../../../plugins/report_tests_log_factory/lib', __FILE__)
@@ -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
@@ -14,7 +14,7 @@ require 'spec_integration_helper'
14
14
  require 'open3'
15
15
  require 'tmpdir'
16
16
  require 'ceedling/constants'
17
- require 'ceedling/file_wrapper'
17
+ require 'ceedling/filesystem/file_wrapper'
18
18
  require 'ceedling/generators/generator'
19
19
  require 'ceedling/system_wrapper'
20
20
  require 'fileutils'
@@ -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,11 +143,38 @@ 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'] )
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
143
148
  expect(testable.mock_search_paths).to eq( ['build/mocks/test_reader/drivers'] )
144
149
  end
145
150
  end
146
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' )
175
+ end
176
+ end
177
+
147
178
  describe 'a mock chosen by a macro from a header' do
148
179
  it 'is kept when the macro arrives through another mock' do
149
180
  extract_in_mode( CASE_2_TREE, 'test_Case_02.c' ) do |harness, _testable|
@@ -184,6 +215,41 @@ describe 'Test file #include extraction (integration)' do
184
215
  end
185
216
  end
186
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
+
187
253
  # The candidates include scanned mocks the preprocessor then discards; their
188
254
  # directories serve the second pass and are dropped once it has decided
189
255
  it 'narrows mock search paths to the mocks the build uses' do