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
@@ -8,6 +8,9 @@
8
8
  require 'spec_helper'
9
9
  require 'tmpdir'
10
10
  require 'ceedling/filesystem/file_wrapper'
11
+ require 'ceedling/filesystem/project_paths'
12
+ require 'ceedling/filesystem/win_long_paths'
13
+ require 'ceedling/constants'
11
14
  require 'ceedling/system_wrapper'
12
15
  require 'ceedling/exceptions'
13
16
 
@@ -32,15 +35,15 @@ describe FileWrapper do
32
35
  allow(SystemWrapper).to receive(:macos?).and_return(false)
33
36
  end
34
37
 
35
- # Absolute paths throughout: check_path_length measures File.expand_path(path).length,
38
+ # Absolute paths throughout: check_path_length measures the path's absolute spelling,
36
39
  # so a relative path would pick up the test-runner's own CWD and throw off the
37
40
  # precise threshold arithmetic these examples depend on. The padding is sized off
38
- # File.expand_path('/')'s own actual length rather than assumed to be 1, since Windows
39
- # expands a bare '/' by prepending a drive letter (e.g. "C:/") -- without probing that
40
- # overhead first, expanded lengths on Windows would run a couple characters longer than
41
- # intended and throw off the precise threshold boundaries these examples depend on.
41
+ # the absolute spelling of '/' rather than assumed to be 1, since Windows spells a bare
42
+ # '/' with a drive letter (e.g. "C:/") -- without probing that overhead first, lengths
43
+ # on Windows would run a couple characters longer than intended and throw off the
44
+ # precise threshold boundaries these examples depend on.
42
45
  def path_of_length(n)
43
- overhead = File.expand_path('/').length - 1
46
+ overhead = ProjectPaths.absolute('/').length - 1
44
47
  '/' + ('a' * (n - 1 - overhead))
45
48
  end
46
49
 
@@ -125,6 +128,188 @@ describe FileWrapper do
125
128
  expect(@loginator).to have_received(:log).with(any_args, Verbosity::ERRORS)
126
129
  end
127
130
  end
131
+
132
+ # A build file is created, opened, and written through separate FileWrapper calls, and
133
+ # each checks its path. One report per path keeps a real failure from being buried.
134
+ context 'one report per path' do
135
+ it 'reports a long path once, whichever operation checks it' do
136
+ path = path_of_length(5000)
137
+ ['FileWrapper#mkdir', 'FileWrapper#open', 'FileWrapper#write'].each do |origin|
138
+ @file_wrapper.check_path_length(path, origin: origin)
139
+ end
140
+
141
+ expect(@loginator).to have_received(:log).once
142
+ end
143
+
144
+ it 'reports a relative and an absolute spelling of one path once' do
145
+ relative = 'b' * 5000
146
+ @file_wrapper.check_path_length(relative, origin: 'Test')
147
+ @file_wrapper.check_path_length(File.join(ProjectPaths.working_dir, relative), origin: 'Test')
148
+
149
+ expect(@loginator).to have_received(:log).once
150
+ end
151
+
152
+ it 'reports each of two long paths' do
153
+ @file_wrapper.check_path_length(path_of_length(5000), origin: 'Test')
154
+ @file_wrapper.check_path_length(path_of_length(5001), origin: 'Test')
155
+
156
+ expect(@loginator).to have_received(:log).twice
157
+ end
158
+
159
+ it 'remembers nothing, and takes no lock, for a path below the warning band' do
160
+ expect(@file_wrapper.instance_variable_get(:@path_lock)).not_to receive(:synchronize)
161
+ expect(ProjectPaths).not_to receive(:absolute)
162
+
163
+ @file_wrapper.check_path_length('src/short/path.c', origin: 'Test')
164
+
165
+ expect(@file_wrapper.instance_variable_get(:@path_reports)).to be_empty
166
+ end
167
+
168
+ it 'measures a relative path against the remembered working directory, not the process\'s' do
169
+ expect(File).to receive(:expand_path).with('src/file.c', ProjectPaths.working_dir).and_call_original
170
+
171
+ @file_wrapper.check_path_length('src/file.c', origin: 'Test')
172
+ end
173
+ end
174
+
175
+ # :project ↳ :win_path_limit. The prober is a double; what it decides and logs is
176
+ # specified in win_path_prober_spec.rb.
177
+ context 'Windows path limit' do
178
+ before(:each) do
179
+ allow(SystemWrapper).to receive(:windows?).and_return(true)
180
+ @logged = []
181
+ allow(@loginator).to receive(:log) { |message, verbosity = nil, label = nil| @logged << [message, verbosity, label] }
182
+ @prober = double('win_path_prober')
183
+ end
184
+
185
+ def configure(mode, long_paths: nil)
186
+ allow(@prober).to receive(:long_paths?).and_return(long_paths) unless long_paths.nil?
187
+ @file_wrapper.configure_win_path_limit(mode: mode, prober: @prober)
188
+ end
189
+
190
+ def check(length, directory: false)
191
+ @file_wrapper.check_path_length(path_of_length(length), origin: 'Test', directory: directory)
192
+ end
193
+
194
+ def verbosities
195
+ return @logged.map { |_message, verbosity, _label| verbosity }
196
+ end
197
+
198
+ context ':classic' do
199
+ before(:each) { configure(:classic) }
200
+
201
+ it 'never asks the prober' do
202
+ expect(@prober).not_to receive(:long_paths?)
203
+ check(300)
204
+ end
205
+
206
+ it 'reports a path at 260 against Windows\' limit, pointing to the setting' do
207
+ check(300)
208
+
209
+ expect(@logged.length).to eq( 1 )
210
+ message, verbosity = @logged.first
211
+ expect(verbosity).to eq( Verbosity::ERRORS )
212
+ expect(message).to match( /Path length \(300\) reaches or exceeds Windows' 260-character limit/ )
213
+ expect(message).to include( ':project ↳ :win_path_limit' )
214
+ end
215
+
216
+ it 'warns of a file path in the band below 260' do
217
+ check(240)
218
+ expect(verbosities).to eq( [Verbosity::COMPLAIN] )
219
+ expect(@logged.first.first).to match( /is approaching Windows' 260-character limit/ )
220
+ end
221
+
222
+ it 'reports a directory past 248 as an error, though a file of that length only warns' do
223
+ check(252, directory: true)
224
+ check(253)
225
+
226
+ expect(verbosities).to eq( [Verbosity::ERRORS, Verbosity::COMPLAIN] )
227
+ expect(@logged.first.first).to match( /Directory path length \(252\) reaches or exceeds Windows' 248-character limit for directories/ )
228
+ end
229
+ end
230
+
231
+ [:long_paths, :auto].each do |mode|
232
+ context mode.inspect do
233
+ it 'asks the prober with this mode once a path nears the classic limit' do
234
+ configure(mode, long_paths: true)
235
+ check(300)
236
+
237
+ expect(@prober).to have_received(:long_paths?).with( mode )
238
+ end
239
+
240
+ it 'never asks the prober for a path below the warning band' do
241
+ configure(mode, long_paths: true)
242
+ check(200)
243
+
244
+ expect(@prober).not_to have_received(:long_paths?)
245
+ end
246
+
247
+ it 'asks once, then keeps the answer' do
248
+ configure(mode, long_paths: false)
249
+ check(300)
250
+ check(301)
251
+
252
+ expect(@prober).to have_received(:long_paths?).once
253
+ end
254
+
255
+ it 'reports nothing below the long limit once long paths are in effect' do
256
+ configure(mode, long_paths: true)
257
+ check(300)
258
+ check(252, directory: true)
259
+
260
+ expect(@logged).to be_empty
261
+ end
262
+
263
+ # Windows' own path functions can't expand a path past 32,767 characters, so the
264
+ # measured length is given rather than taken from File.expand_path on every OS
265
+ it 'reports a path past the long limit against it' do
266
+ configure(mode, long_paths: true)
267
+ path = path_of_length(300)
268
+ allow(File).to receive(:expand_path).and_call_original
269
+ allow(File).to receive(:expand_path).with(path, ProjectPaths.working_dir).and_return('/' + ('a' * 32_799))
270
+
271
+ @file_wrapper.check_path_length(path, origin: 'Test')
272
+
273
+ expect(@logged.first.first).to match( /reaches or exceeds Windows' 32,767-character long path limit/ )
274
+ end
275
+
276
+ it 'reports against 260, without the pointer, when long paths are not in effect' do
277
+ configure(mode, long_paths: false)
278
+ check(300)
279
+
280
+ expect(verbosities).to eq( [Verbosity::ERRORS] )
281
+ expect(@logged.first.first).to match( /260-character limit/ )
282
+ expect(@logged.first.first).not_to include( ':project ↳ :win_path_limit' )
283
+ end
284
+ end
285
+ end
286
+
287
+ it 'ignores the setting and never asks the prober on macOS and Linux' do
288
+ allow(SystemWrapper).to receive(:windows?).and_return(false)
289
+ expect(@prober).not_to receive(:long_paths?)
290
+ @file_wrapper.configure_win_path_limit(mode: :auto, prober: @prober)
291
+
292
+ check(5000)
293
+
294
+ expect(@logged.first.first).to match( /this platform's practical limit \(4096\)/ )
295
+ end
296
+ end
297
+ end
298
+
299
+ describe '#mkdir and #mkdir_tmp' do
300
+ it 'checks a directory it makes as a directory' do
301
+ allow(FileUtils).to receive(:mkdir_p)
302
+ expect(@file_wrapper).to receive(:check_path_length).with('build/dir', origin: 'FileWrapper#mkdir', directory: true)
303
+
304
+ @file_wrapper.mkdir('build/dir')
305
+ end
306
+
307
+ it 'checks a temporary directory it makes as a directory' do
308
+ allow(Dir).to receive(:mktmpdir).and_return('build/tmp123')
309
+ expect(@file_wrapper).to receive(:check_path_length).with('build/tmp123', origin: 'FileWrapper#mkdir_tmp', directory: true)
310
+
311
+ @file_wrapper.mkdir_tmp('tmp', 'build')
312
+ end
128
313
  end
129
314
 
130
315
  # #104 -- plain FileList.new(files)/#include treats every entry as a glob pattern to
@@ -192,6 +192,42 @@ describe PathMatcher do
192
192
 
193
193
 
194
194
  # A `.` segment names nothing (the path handling audit around GH #1370)
195
+ # The directory a search path must be for `tail` joined with it to name `path`
196
+ describe '.strip_tail' do
197
+ it 'gives what lies above the tail' do
198
+ expect(described_class.strip_tail( 'src/path/to/sensor.h', 'sensor.h' )).to eq( 'src/path/to' )
199
+ expect(described_class.strip_tail( 'src/path/to/sensor.h', 'path/to/sensor.h' )).to eq( 'src' )
200
+ end
201
+
202
+ it 'gives `.` when the tail is the whole path' do
203
+ expect(described_class.strip_tail( 'src/sensor.h', 'src/sensor.h' )).to eq( '.' )
204
+ end
205
+
206
+ it 'keeps an absolute path absolute' do
207
+ expect(described_class.strip_tail( '/usr/include/x86_64-linux-gnu/sys/socket.h', 'sys/socket.h' )).to eq( '/usr/include/x86_64-linux-gnu' )
208
+ expect(described_class.strip_tail( '/sys/socket.h', 'sys/socket.h' )).to eq( '/' )
209
+ end
210
+
211
+ it 'keeps a drive letter, with forward slashes' do
212
+ expect(described_class.strip_tail( 'C:\\sdk\\inc\\sys\\socket.h', 'sys/socket.h' )).to eq( 'C:/sdk/inc' )
213
+ expect(described_class.strip_tail( 'C:/sys/socket.h', 'sys/socket.h' )).to eq( 'C:/' )
214
+ end
215
+
216
+ it 'keeps a share' do
217
+ expect(described_class.strip_tail( '//server/sdk/sys/socket.h', 'sys/socket.h' )).to eq( '//server/sdk' )
218
+ end
219
+
220
+ it 'ignores `./` and doubled separators' do
221
+ expect(described_class.strip_tail( './src//path/sensor.h', './path/sensor.h' )).to eq( 'src' )
222
+ end
223
+
224
+ it 'gives nil when the path ends otherwise' do
225
+ expect(described_class.strip_tail( 'src/path/to/sensor.h', 'other/sensor.h' )).to be_nil
226
+ expect(described_class.strip_tail( 'src/path/to/sensor.h', 'Sensor.h' )).to be_nil
227
+ expect(described_class.strip_tail( 'sensor.h', 'to/sensor.h' )).to be_nil
228
+ end
229
+ end
230
+
195
231
  describe 'G9: `.` segments' do
196
232
  it 'matches a query with a leading `./`' do
197
233
  expect(PathMatcher.candidates( './foo.h', ['inc/foo.h'] )).to eq( ['inc/foo.h'] )
@@ -0,0 +1,216 @@
1
+ # =========================================================================
2
+ # Ceedling - Test-Centered Build System for C
3
+ # ThrowTheSwitch.org
4
+ # Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
5
+ # SPDX-License-Identifier: MIT
6
+ # =========================================================================
7
+
8
+ require 'spec_helper'
9
+ require 'ceedling/filesystem/test_build_layout'
10
+ require 'ceedling/filesystem/build_subpath'
11
+
12
+ describe TestBuildLayout do
13
+
14
+ LAYOUT_BASES = {
15
+ mocks: 'build/test/mocks',
16
+ partials: 'build/test/partials',
17
+ preprocess_includes: 'build/test/preprocess/includes',
18
+ preprocess_files: 'build/test/preprocess/files',
19
+ build_directives: 'build/test/preprocess/build_directives',
20
+ out: 'build/test/out',
21
+ dependencies: 'build/test/dependencies'
22
+ }.freeze
23
+
24
+ before(:each) do
25
+ @configurator = double( 'configurator' )
26
+ @file_wrapper = double( 'file_wrapper' )
27
+ allow(@file_wrapper).to receive(:check_path_length)
28
+
29
+ allow(@configurator).to receive(:project_build_root).and_return( 'build' )
30
+ allow(@configurator).to receive(:project_use_mocks).and_return( true )
31
+ allow(@configurator).to receive(:project_use_partials).and_return( true )
32
+ allow(@configurator).to receive(:cmock_mock_path).and_return( LAYOUT_BASES[:mocks] )
33
+ allow(@configurator).to receive(:project_test_partials_path).and_return( LAYOUT_BASES[:partials] )
34
+ allow(@configurator).to receive(:project_test_preprocess_includes_path).and_return( LAYOUT_BASES[:preprocess_includes] )
35
+ allow(@configurator).to receive(:project_test_preprocess_files_path).and_return( LAYOUT_BASES[:preprocess_files] )
36
+ allow(@configurator).to receive(:project_test_preprocess_build_directives_path).and_return( LAYOUT_BASES[:build_directives] )
37
+
38
+ @layout = described_class.new( { :configurator => @configurator, :file_wrapper => @file_wrapper } )
39
+ end
40
+
41
+ it 'reserves the segment `_t_`' do
42
+ expect( BuildSubpath::OWN_SEGMENT ).to eq( '_t_' )
43
+ end
44
+
45
+ describe '#base' do
46
+ LAYOUT_BASES.each do |kind, base|
47
+ it "gives the shared #{kind} directory" do
48
+ expect( @layout.base( kind, context: :test ) ).to eq( base )
49
+ end
50
+ end
51
+
52
+ it 'places the output and dependencies bases below their build context' do
53
+ expect( @layout.base( :out, context: :gcov ) ).to eq( 'build/gcov/out' )
54
+ expect( @layout.base( :dependencies, context: :gcov ) ).to eq( 'build/gcov/dependencies' )
55
+ expect( @layout.base( :out ) ).to eq( 'build/out' )
56
+ end
57
+
58
+ it 'gives no base for a disabled feature' do
59
+ allow(@configurator).to receive(:project_use_mocks).and_return( false )
60
+ allow(@configurator).to receive(:project_use_partials).and_return( false )
61
+
62
+ expect( @layout.base( :mocks ) ).to be_nil
63
+ expect( @layout.base( :partials ) ).to be_nil
64
+ end
65
+ end
66
+
67
+ describe '#root' do
68
+ LAYOUT_BASES.each do |kind, base|
69
+ it "closes a test's #{kind} directory with `_t_`" do
70
+ expect( @layout.root( kind, 'test/unit/test_foo', context: :test ) ).to eq( "#{base}/test/unit/test_foo/_t_" )
71
+ end
72
+ end
73
+
74
+ it 'gives no root for a nil or empty name' do
75
+ expect( @layout.root( :mocks, nil ) ).to be_nil
76
+ expect( @layout.root( :mocks, '' ) ).to be_nil
77
+ expect( @layout.root( :out, nil, context: :test ) ).to be_nil
78
+ end
79
+
80
+ it 'gives no root for a disabled feature' do
81
+ allow(@configurator).to receive(:project_use_mocks).and_return( false )
82
+ allow(@configurator).to receive(:project_use_partials).and_return( false )
83
+
84
+ expect( @layout.root( :mocks, 'test/test_c' ) ).to be_nil
85
+ expect( @layout.root( :partials, 'test/test_c' ) ).to be_nil
86
+ end
87
+
88
+ it "places a nested test's root beside its parent's subdirectory of the same name" do
89
+ expect( @layout.root( :mocks, 'test/test_c/test_x' ) ).to eq( 'build/test/mocks/test/test_c/test_x/_t_' )
90
+ expect( @layout.file( :mocks, 'test/test_c', 'test_x/mock_qux.c' ) ).to eq( 'build/test/mocks/test/test_c/_t_/test_x/mock_qux.c' )
91
+ end
92
+
93
+ it "checks the root's length once" do
94
+ @layout.root( :out, 'test/test_c', context: :test )
95
+
96
+ expect(@file_wrapper).to have_received(:check_path_length).once
97
+ end
98
+
99
+ # Windows limits a directory's path more tightly than a file's
100
+ it "checks the root's length as a directory's" do
101
+ @layout.root( :mocks, 'test/test_c' )
102
+
103
+ expect(@file_wrapper).to have_received(:check_path_length).with( 'build/test/mocks/test/test_c/_t_', origin: 'TestBuildLayout#root', directory: true )
104
+ end
105
+ end
106
+
107
+ describe '#file' do
108
+ LAYOUT_BASES.each do |kind, base|
109
+ it "places a file below a test's #{kind} root" do
110
+ expect( @layout.file( kind, 'test/test_c', 'drv/x.h', context: :test ) ).to eq( "#{base}/test/test_c/_t_/drv/x.h" )
111
+ end
112
+ end
113
+
114
+ it 'gives the root itself for no subpath' do
115
+ expect( @layout.file( :mocks, 'test/test_c', '' ) ).to eq( 'build/test/mocks/test/test_c/_t_' )
116
+ expect( @layout.file( :mocks, 'test/test_c', nil ) ).to eq( 'build/test/mocks/test/test_c/_t_' )
117
+ end
118
+
119
+ it 'gives nothing where the test has no root' do
120
+ allow(@configurator).to receive(:project_use_partials).and_return( false )
121
+
122
+ expect( @layout.file( :mocks, nil, 'mock_x.h' ) ).to be_nil
123
+ expect( @layout.file( :partials, 'test/test_c', 'x.h' ) ).to be_nil
124
+ end
125
+ end
126
+
127
+ describe '#generated_roots' do
128
+ it "gives a test's Partials root and mock root" do
129
+ expect( @layout.generated_roots( 'test/test_c' ) ).to eq( ['build/test/partials/test/test_c/_t_', 'build/test/mocks/test/test_c/_t_'] )
130
+ end
131
+
132
+ it 'leaves out a disabled feature' do
133
+ allow(@configurator).to receive(:project_use_partials).and_return( false )
134
+
135
+ expect( @layout.generated_roots( 'test/test_c' ) ).to eq( ['build/test/mocks/test/test_c/_t_'] )
136
+ end
137
+
138
+ it 'gives none for no test' do
139
+ expect( @layout.generated_roots( nil ) ).to eq( [] )
140
+ end
141
+ end
142
+
143
+ describe '#locate' do
144
+ LAYOUT_BASES.each do |kind, base|
145
+ it "names the test of a file below its #{kind} root" do
146
+ expect( @layout.locate( "#{base}/test/test_c/_t_/test_x/mock_qux.c", context: :test ) ).to eq( 'test/test_c' )
147
+ end
148
+ end
149
+
150
+ it "tells a nested test's file from its parent's file in a folder of the nested test's name" do
151
+ expect( @layout.locate( 'build/test/mocks/test/test_c/test_x/_t_/mock_qux.c' ) ).to eq( 'test/test_c/test_x' )
152
+ expect( @layout.locate( 'build/test/mocks/test/test_c/_t_/test_x/mock_qux.c' ) ).to eq( 'test/test_c' )
153
+ end
154
+
155
+ # The first `_t_` ends the name, since no name holds one
156
+ it 'ends the name at the first `_t_`' do
157
+ expect( @layout.locate( 'build/test/mocks/test/test_c/_t_/_t_/mock_qux.c' ) ).to eq( 'test/test_c' )
158
+ end
159
+
160
+ it "names a test whose own directory is named like `_t_` by its escaped name" do
161
+ name = BuildSubpath.encode( 'test/_t_/test_c' )
162
+
163
+ expect( @layout.locate( @layout.file( :out, name, 'x.o', context: :test ), context: :test ) ).to eq( 'test/__t_/test_c' )
164
+ end
165
+
166
+ it 'names the test of its root itself' do
167
+ expect( @layout.locate( 'build/test/out/test/test_c/_t_', context: :test ) ).to eq( 'test/test_c' )
168
+ end
169
+
170
+ it "locates a file below the context's own output root" do
171
+ expect( @layout.locate( 'build/gcov/out/test/test_c/_t_/src/x.o', context: :gcov ) ).to eq( 'test/test_c' )
172
+ expect( @layout.locate( 'build/gcov/out/test/test_c/_t_/src/x.o', context: :test ) ).to be_nil
173
+ end
174
+
175
+ it 'locates nothing below no test root' do
176
+ expect( @layout.locate( 'build/test/out/test/test_c/test_c.o', context: :test ) ).to be_nil
177
+ expect( @layout.locate( 'build/test/mocks/_t_/mock_x.c' ) ).to be_nil
178
+ expect( @layout.locate( 'src/test_x/qux.c', context: :test ) ).to be_nil
179
+ expect( @layout.locate( 'build/test/runners/test/test_c_runner.c', context: :test ) ).to be_nil
180
+ end
181
+
182
+ it 'locates nothing below a disabled feature' do
183
+ allow(@configurator).to receive(:project_use_mocks).and_return( false )
184
+
185
+ expect( @layout.locate( 'build/test/mocks/test/test_c/_t_/mock_x.c' ) ).to be_nil
186
+ end
187
+
188
+ # Below the output base, the mock's test would be `mocks/test/test_c`
189
+ it 'counts the most specific base holding a path' do
190
+ allow(@configurator).to receive(:cmock_mock_path).and_return( 'build/test/out/mocks' )
191
+
192
+ expect( @layout.locate( 'build/test/out/mocks/test/test_c/_t_/mock_x.c', context: :test ) ).to eq( 'test/test_c' )
193
+ end
194
+ end
195
+
196
+ describe '#subpath' do
197
+ LAYOUT_BASES.reject { |kind, _| TestBuildLayout::CONTEXTUAL.key?( kind ) }.each do |kind, base|
198
+ it "gives a path below a test's #{kind} root" do
199
+ expect( @layout.subpath( "#{base}/test/test_c/_t_/drv/x.h", kind: kind, name: 'test/test_c' ) ).to eq( 'drv/x.h' )
200
+ end
201
+ end
202
+
203
+ it "gives nothing for a path outside the test's root" do
204
+ expect( @layout.subpath( 'build/test/mocks/test/test_c/test_x/_t_/mock_qux.h', kind: :mocks, name: 'test/test_c' ) ).to be_nil
205
+ expect( @layout.subpath( 'test_x/mock_qux.h', kind: :mocks, name: 'test/test_c' ) ).to be_nil
206
+ end
207
+
208
+ it 'gives nothing for no name or a disabled feature' do
209
+ allow(@configurator).to receive(:project_use_mocks).and_return( false )
210
+
211
+ expect( @layout.subpath( 'build/test/partials/test/test_c/_t_/x.h', kind: :partials, name: nil ) ).to be_nil
212
+ expect( @layout.subpath( 'build/test/mocks/test/test_c/_t_/x.h', kind: :mocks, name: 'test/test_c' ) ).to be_nil
213
+ end
214
+ end
215
+
216
+ end