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
@@ -1,495 +0,0 @@
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/file_finder'
10
- require 'ceedling/file_finder_helper'
11
- require 'ceedling/filename_extension'
12
- require 'ceedling/exceptions'
13
- require 'ceedling/constants'
14
-
15
- describe FileFinder do
16
- before(:each) do
17
- @configurator = double( "Configurator" )
18
- @file_path_utils = double( "FilePathUtils" )
19
- @file_wrapper = double( "FileWrapper" )
20
- @yaml_wrapper = double( "YamlWrapper" )
21
- @loginator = double( "Loginator" )
22
- allow(@loginator).to receive(:log)
23
-
24
- # A real FileFinderHelper (already unit-tested on its own) so these specs exercise the
25
- # whole query -> FileFinder -> FileFinderHelper -> PathMatcher chain, not a mocked stub of it.
26
- @file_finder_helper = FileFinderHelper.new( { loginator: @loginator } )
27
-
28
- @file_finder = described_class.new({
29
- configurator: @configurator,
30
- file_finder_helper: @file_finder_helper,
31
- file_path_utils: @file_path_utils,
32
- file_wrapper: @file_wrapper,
33
- yaml_wrapper: @yaml_wrapper
34
- })
35
- end
36
-
37
- describe '#find_header_file' do
38
- before(:each) do
39
- allow(@configurator).to receive(:extension_header).and_return( FilenameExtension.new('.h') )
40
- allow(@configurator).to receive(:collection_all_headers).and_return(
41
- ['unit/bar.h', 'integration/bar.h', 'baz.h']
42
- )
43
- end
44
-
45
- it 'resolves a bare basename when it is unique' do
46
- expect(@file_finder.find_header_file('baz.h')).to eq('baz.h')
47
- expect(@file_finder.find_header_file('baz')).to eq('baz.h')
48
- end
49
-
50
- it 'never raises on a bare, ambiguous basename -- resolves to the first candidate in collection order' do
51
- expect(@file_finder.find_header_file('bar.h')).to eq('unit/bar.h')
52
- end
53
-
54
- it 'logs an ℹ️ NOTICE naming the passed-over candidate when a bare basename is ambiguous' do
55
- expect(@loginator).to receive(:log) do |msg, verbosity, label|
56
- expect(msg).to include('unit/bar.h')
57
- expect(msg).to include('integration/bar.h')
58
- expect(verbosity).to eq(Verbosity::COMPLAIN)
59
- expect(label).to eq(LogLabels::NOTICE)
60
- end
61
-
62
- @file_finder.find_header_file('bar.h')
63
- end
64
-
65
- it 'resolves an ambiguous basename when the query supplies enough path to disambiguate' do
66
- expect(@file_finder.find_header_file('unit/bar.h')).to eq('unit/bar.h')
67
- expect(@file_finder.find_header_file('integration/bar.h')).to eq('integration/bar.h')
68
- end
69
-
70
- it 'searches a caller-supplied collection instead of collection_all_headers when one is given' do
71
- expect(@file_finder.find_header_file('baz.h', :error, collection: ['other/baz.h'])).to eq('other/baz.h')
72
- end
73
- end
74
-
75
- describe '#find_header_input_for_mock' do
76
- before(:each) do
77
- allow(@configurator).to receive(:cmock_mock_prefix).and_return( 'Mock' )
78
- allow(@configurator).to receive(:collection_all_headers).and_return(
79
- ['unit/bar.h', 'integration/bar.h', 'baz.h']
80
- )
81
- end
82
-
83
- it 'resolves a bare mock name when its header is unique' do
84
- expect(@file_finder.find_header_input_for_mock('Mockbaz.h')).to eq('baz.h')
85
- end
86
-
87
- it 'never raises on a bare, ambiguous mock name -- resolves to the first candidate in collection order' do
88
- expect(@file_finder.find_header_input_for_mock('Mockbar.h')).to eq('unit/bar.h')
89
- end
90
-
91
- it 'logs an ℹ️ NOTICE naming the passed-over candidate when a bare mock name is ambiguous' do
92
- expect(@loginator).to receive(:log) do |msg, verbosity, label|
93
- expect(msg).to include('unit/bar.h')
94
- expect(msg).to include('integration/bar.h')
95
- expect(verbosity).to eq(Verbosity::COMPLAIN)
96
- expect(label).to eq(LogLabels::NOTICE)
97
- end
98
-
99
- @file_finder.find_header_input_for_mock('Mockbar.h')
100
- end
101
-
102
- it 'resolves an ambiguous mock name when the query supplies enough path to disambiguate' do
103
- expect(@file_finder.find_header_input_for_mock('unit/Mockbar.h')).to eq('unit/bar.h')
104
- expect(@file_finder.find_header_input_for_mock('integration/Mockbar.h')).to eq('integration/bar.h')
105
- end
106
-
107
- it 'still raises rather than silently matching just the basename when the given path is bogus (not-found, not ambiguity)' do
108
- expect {
109
- @file_finder.find_header_input_for_mock('nonexistent/dir/Mockbaz.h')
110
- }.to raise_error(CeedlingException)
111
- end
112
-
113
- it 'searches a caller-supplied collection instead of collection_all_headers when one is given' do
114
- expect(@file_finder.find_header_input_for_mock('Mockbaz.h', collection: ['other/baz.h'])).to eq('other/baz.h')
115
- end
116
- end
117
-
118
- describe '#resolve_mock' do
119
- before(:each) do
120
- allow(@configurator).to receive(:cmock_mock_prefix).and_return( 'Mock' )
121
- allow(@configurator).to receive(:collection_all_headers).and_return(
122
- ['src/drivers/foo.h', 'src/baz.h']
123
- )
124
- allow(@configurator).to receive(:paths_test).and_return( [] )
125
- allow(@configurator).to receive(:paths_support).and_return( [] )
126
- allow(@configurator).to receive(:paths_include).and_return( ['src'] )
127
- end
128
-
129
- it 'resolves a mock header and its own mirrored subdirectory below the configured root that contains it' do
130
- source, subdir = @file_finder.resolve_mock('Mockfoo.h')
131
- expect(source).to eq('src/drivers/foo.h')
132
- expect(subdir).to eq('drivers')
133
- end
134
-
135
- it 'returns an empty subdirectory for a mock header directly in a configured root' do
136
- source, subdir = @file_finder.resolve_mock('Mockbaz.h')
137
- expect(source).to eq('src/baz.h')
138
- expect(subdir).to eq('')
139
- end
140
-
141
- it 'resolves identically regardless of how much disambiguating path the query itself carries' do
142
- bare, bare_subdir = @file_finder.resolve_mock('Mockfoo.h')
143
- pathed, pathed_subdir = @file_finder.resolve_mock('drivers/Mockfoo.h')
144
- expect(bare).to eq(pathed)
145
- expect(bare_subdir).to eq(pathed_subdir)
146
- end
147
-
148
- it 'still raises on a bogus (not-found) mock reference, exactly as find_header_input_for_mock does' do
149
- expect { @file_finder.resolve_mock('nonexistent/dir/Mockfoo.h') }.to raise_error(CeedlingException)
150
- end
151
-
152
- it 'finds nothing for a mock without a header, rather than raising, when told to ignore a missing header' do
153
- expect(@file_finder.resolve_mock('Mocknope.h', complain: :ignore)).to eq( [nil, nil] )
154
- end
155
-
156
- it 'finds nothing for a mock whose header differs only in letter case when told to be silent' do
157
- expect(@file_finder.resolve_mock('MockFOO.h', complain: :silent)).to eq( [nil, nil] )
158
- end
159
-
160
- it 'never raises on an ambiguous mock reference -- resolves to the first candidate in collection order' do
161
- allow(@configurator).to receive(:collection_all_headers).and_return(
162
- ['src/drivers/dup.h', 'src/other/dup.h']
163
- )
164
- source, subdir = @file_finder.resolve_mock('Mockdup.h')
165
- expect(source).to eq('src/drivers/dup.h')
166
- expect(subdir).to eq('drivers')
167
- end
168
-
169
- it 'searches a caller-supplied collection instead of collection_all_headers when one is given' do
170
- source, subdir = @file_finder.resolve_mock('Mockfoo.h', collection: ['src/other/foo.h'])
171
- expect(source).to eq('src/other/foo.h')
172
- expect(subdir).to eq('other')
173
- end
174
- end
175
-
176
- describe '#find_source_file' do
177
- before(:each) do
178
- allow(@configurator).to receive(:extension_source).and_return( FilenameExtension.new('.c') )
179
- allow(@configurator).to receive(:collection_all_source).and_return(
180
- ['drivers/foo/bar.c', 'drivers/baz/bar.c']
181
- )
182
- end
183
-
184
- it 'resolves a path-qualified query among same-named files' do
185
- expect(@file_finder.find_source_file('drivers/foo/bar.c')).to eq('drivers/foo/bar.c')
186
- expect(@file_finder.find_source_file('foo/bar.c')).to eq('drivers/foo/bar.c')
187
- end
188
-
189
- it 'never raises on a bare, ambiguous query -- resolves to the first candidate in collection order' do
190
- expect(@file_finder.find_source_file('bar.c')).to eq('drivers/foo/bar.c')
191
- end
192
-
193
- it 'logs an ℹ️ NOTICE naming the passed-over candidate when a bare query is ambiguous' do
194
- expect(@loginator).to receive(:log) do |msg, verbosity, label|
195
- expect(msg).to include('drivers/foo/bar.c')
196
- expect(msg).to include('drivers/baz/bar.c')
197
- expect(verbosity).to eq(Verbosity::COMPLAIN)
198
- expect(label).to eq(LogLabels::NOTICE)
199
- end
200
-
201
- @file_finder.find_source_file('bar.c')
202
- end
203
- end
204
-
205
- describe '#find_assembly_file' do
206
- it 'tries every configured extension in turn, still resolving a unique match' do
207
- allow(@configurator).to receive(:extension_assembly).and_return( FilenameExtension.new(['.s', '.S']) )
208
- allow(@configurator).to receive(:collection_all_assembly).and_return( ['src/foo.S'] )
209
-
210
- expect(@file_finder.find_assembly_file('foo')).to eq('src/foo.S')
211
- end
212
-
213
- it 'never raises on an ambiguous match -- resolves to the first candidate in collection order' do
214
- allow(@configurator).to receive(:extension_assembly).and_return( FilenameExtension.new('.s') )
215
- allow(@configurator).to receive(:collection_all_assembly).and_return( ['drivers/foo/bar.s', 'drivers/baz/bar.s'] )
216
-
217
- expect(@file_finder.find_assembly_file('bar')).to eq('drivers/foo/bar.s')
218
- end
219
- end
220
-
221
- describe '#find_test_file_from_name' do
222
- before(:each) do
223
- allow(@configurator).to receive(:extension_source).and_return( FilenameExtension.new('.c') )
224
- allow(@configurator).to receive(:collection_all_tests).and_return(
225
- ['unit/test_foo.c', 'integration/test_foo.c']
226
- )
227
- end
228
-
229
- it 'raises a CeedlingException when a bare test name is ambiguous' do
230
- expect { @file_finder.find_test_file_from_name('test_foo') }.to raise_error(CeedlingException)
231
- end
232
-
233
- it 'resolves when the name carries enough path to disambiguate' do
234
- expect(@file_finder.find_test_file_from_name('unit/test_foo')).to eq('unit/test_foo.c')
235
- end
236
-
237
- it 'raises a clear CeedlingException naming .. as unsupported in a CLI task name, rather than a generic not-found' do
238
- # A CLI task name has no file of its own to anchor a .. against -- unlike an
239
- # #include or TEST_SOURCE_FILE() entry, which are always scoped to the test file
240
- # that wrote them. Today's generic "Found no file" message happens to also
241
- # contain the query text, so asserting on the query alone would pass for the
242
- # wrong reason -- the message must specifically call out .. as the problem.
243
- expect { @file_finder.find_test_file_from_name('../unit/test_foo') }.to raise_error(CeedlingException) do |error|
244
- expect(error.message).to include('../unit/test_foo')
245
- expect(error.message).not_to match(/Found no file/)
246
- expect(error.message).to match(/\.\./)
247
- expect(error.message).to match(/context/i)
248
- end
249
- end
250
- end
251
-
252
- describe '#find_file_from_list' do
253
- it 'delegates to the underlying collection, raising on ambiguity the same as any other lookup' do
254
- list = ['a/dup.c', 'b/dup.c']
255
- expect { @file_finder.find_file_from_list('dup.c', list, :ignore) }.to raise_error(CeedlingException)
256
- expect(@file_finder.find_file_from_list('a/dup.c', list, :ignore)).to eq('a/dup.c')
257
- end
258
- end
259
-
260
- describe '#find_build_input_file' do
261
- before(:each) do
262
- allow(@configurator).to receive(:project_test_file_prefix).and_return('test_')
263
- allow(@configurator).to receive(:test_runner_file_suffix).and_return('_runner')
264
- allow(@configurator).to receive(:cmock_mock_prefix).and_return('Mock')
265
- allow(@configurator).to receive(:collection_vendor_framework_sources).and_return([])
266
- allow(@configurator).to receive(:release_build_use_assembly).and_return(false)
267
- allow(@configurator).to receive(:test_build_use_assembly).and_return(false)
268
- allow(@configurator).to receive(:extension_source).and_return( FilenameExtension.new('.c') )
269
- allow(@configurator).to receive(:extension_assembly).and_return( FilenameExtension.new('.s') )
270
- allow(@configurator).to receive(:project_test_build_output_path).and_return('build/test/out')
271
- allow(@configurator).to receive(:project_release_build_output_path).and_return('build/release/out')
272
- allow(@configurator).to receive(:project_build_root).and_return('build')
273
- # No configured include root contains these queries, so each keeps its own path.
274
- allow(@configurator).to receive(:paths_include).and_return( ['include'] )
275
- end
276
-
277
- it 'never raises, rather than silently missing a build, when two release sources share a basename -- resolves to the first by project path order' do
278
- allow(@configurator).to receive(:collection_release_build_input).and_return(
279
- ['drivers/foo/bar.c', 'drivers/baz/bar.c']
280
- )
281
-
282
- found = @file_finder.find_build_input_file( filepath: 'build/release/out/bar.o', complain: :error, context: RELEASE_SYM )
283
- expect(found).to eq('drivers/foo/bar.c')
284
- end
285
-
286
- it 'logs an ℹ️ NOTICE naming the passed-over release source when ambiguous' do
287
- allow(@configurator).to receive(:collection_release_build_input).and_return(
288
- ['drivers/foo/bar.c', 'drivers/baz/bar.c']
289
- )
290
-
291
- expect(@loginator).to receive(:log) do |msg, verbosity, label|
292
- expect(msg).to include('drivers/foo/bar.c')
293
- expect(msg).to include('drivers/baz/bar.c')
294
- expect(verbosity).to eq(Verbosity::COMPLAIN)
295
- expect(label).to eq(LogLabels::NOTICE)
296
- end
297
-
298
- @file_finder.find_build_input_file( filepath: 'build/release/out/bar.o', complain: :error, context: RELEASE_SYM )
299
- end
300
-
301
- it 'still resolves a genuinely unique release source by basename' do
302
- allow(@configurator).to receive(:collection_release_build_input).and_return( ['drivers/foo/bar.c'] )
303
-
304
- found = @file_finder.find_build_input_file( filepath: 'build/release/out/bar.o', complain: :error, context: RELEASE_SYM )
305
- expect(found).to eq('drivers/foo/bar.c')
306
- end
307
-
308
- it 'resolves a test\'s own source file via its build directory identity, even when another same-named test exists elsewhere' do
309
- allow(@configurator).to receive(:collection_all_tests).and_return(
310
- ['test/unit/test_foo.c', 'test/integration/test_foo.c']
311
- )
312
-
313
- found = @file_finder.find_build_input_file(
314
- filepath: 'build/test/out/unit/test_foo/test_foo.o', complain: :error, context: TEST_SYM
315
- )
316
- expect(found).to eq('test/unit/test_foo.c')
317
-
318
- found = @file_finder.find_build_input_file(
319
- filepath: 'build/test/out/integration/test_foo/test_foo.o', complain: :error, context: TEST_SYM
320
- )
321
- expect(found).to eq('test/integration/test_foo.c')
322
- end
323
-
324
- it 'resolves a test\'s own runner by its own runner subdirectory, without treating another same-named test\'s runner as ambiguous' do
325
- allow(@configurator).to receive(:project_test_runners_path).and_return('build/test/runners')
326
-
327
- all_runners = {
328
- 'build/test/runners/unit' => ['build/test/runners/unit/test_foo_runner.c'],
329
- 'build/test/runners/integration' => ['build/test/runners/integration/test_foo_runner.c']
330
- }
331
- allow(@file_wrapper).to receive(:directory_listing) do |glob|
332
- dir = all_runners.keys.find { |d| glob.start_with?(d) }
333
- dir.nil? ? [] : all_runners[dir]
334
- end
335
-
336
- found = @file_finder.find_build_input_file(
337
- filepath: 'build/test/out/unit/test_foo/test_foo_runner.o', complain: :error, context: TEST_SYM
338
- )
339
- expect(found).to eq('build/test/runners/unit/test_foo_runner.c')
340
-
341
- found = @file_finder.find_build_input_file(
342
- filepath: 'build/test/out/integration/test_foo/test_foo_runner.o', complain: :error, context: TEST_SYM
343
- )
344
- expect(found).to eq('build/test/runners/integration/test_foo_runner.c')
345
- end
346
-
347
- it 'resolves a mock generated once per test, by the current test\'s own build directory, without treating that expected repetition as ambiguous' do
348
- allow(@configurator).to receive(:cmock_mock_path).and_return('build/test/mocks')
349
-
350
- all_mocks = {
351
- 'build/test/mocks/TestAdcModel' => ['build/test/mocks/TestAdcModel/MockTemperatureFilter.c'],
352
- 'build/test/mocks/TestModel' => ['build/test/mocks/TestModel/MockTemperatureFilter.c']
353
- }
354
- # The real FileWrapper only lists files under the specific glob it's given; a test's own
355
- # mock subtree is queried in isolation, which is exactly what keeps two tests' identically-
356
- # named mocks from ever appearing in the same collection at once.
357
- allow(@file_wrapper).to receive(:directory_listing) do |glob|
358
- test_dir = all_mocks.keys.find { |dir| glob.start_with?(dir) }
359
- test_dir.nil? ? [] : all_mocks[test_dir]
360
- end
361
-
362
- found = @file_finder.find_build_input_file(
363
- filepath: 'build/test/out/TestAdcModel/MockTemperatureFilter.o', complain: :error, context: TEST_SYM
364
- )
365
- expect(found).to eq('build/test/mocks/TestAdcModel/MockTemperatureFilter.c')
366
-
367
- found = @file_finder.find_build_input_file(
368
- filepath: 'build/test/out/TestModel/MockTemperatureFilter.o', complain: :error, context: TEST_SYM
369
- )
370
- expect(found).to eq('build/test/mocks/TestModel/MockTemperatureFilter.c')
371
- end
372
-
373
- it 'still raises when the very same test mocks two different same-named headers from different directories' do
374
- allow(@configurator).to receive(:cmock_mock_path).and_return('build/test/mocks')
375
- allow(@file_wrapper).to receive(:directory_listing).and_return(
376
- ['build/test/mocks/TestAdcModel/foo/MockBar.c', 'build/test/mocks/TestAdcModel/baz/MockBar.c']
377
- )
378
-
379
- expect {
380
- @file_finder.find_build_input_file(
381
- filepath: 'build/test/out/TestAdcModel/MockBar.o', complain: :error, context: TEST_SYM
382
- )
383
- }.to raise_error(CeedlingException)
384
- end
385
-
386
- it 'resolves a mock scoped to its own test via an explicitly-given test identity, even when the object path itself is flat (e.g. a GCOV or Bullseye build with no per-test mirroring of its own)' do
387
- allow(@configurator).to receive(:cmock_mock_path).and_return('build/test/mocks')
388
- # This build mirrors nothing per test, so the object sits below neither the mock
389
- # root nor a per-test out path and the mock resolves by name alone.
390
- allow(@file_path_utils).to receive(:form_test_build_path).and_return('build/gcov/out')
391
-
392
- all_mocks = {
393
- 'build/test/mocks/TestAdcModel' => ['build/test/mocks/TestAdcModel/MockTemperatureFilter.c'],
394
- 'build/test/mocks/TestModel' => ['build/test/mocks/TestModel/MockTemperatureFilter.c']
395
- }
396
- allow(@file_wrapper).to receive(:directory_listing) do |glob|
397
- test_dir = all_mocks.keys.find { |dir| glob.start_with?(dir) }
398
- test_dir.nil? ? [] : all_mocks[test_dir]
399
- end
400
-
401
- # A flat, project-wide object path (no per-test subdirectory of its own, as GCOV/Bullseye
402
- # form their own objects) carries no test identity for test_context_of to recover -- only
403
- # the explicitly-given `test:` lets this resolve to the right one of two same-named mocks.
404
- found = @file_finder.find_build_input_file(
405
- filepath: 'build/gcov/out/MockTemperatureFilter.o', complain: :error, context: :gcov, test: 'TestAdcModel'
406
- )
407
- expect(found).to eq('build/test/mocks/TestAdcModel/MockTemperatureFilter.c')
408
-
409
- found = @file_finder.find_build_input_file(
410
- filepath: 'build/gcov/out/MockTemperatureFilter.o', complain: :error, context: :gcov, test: 'TestModel'
411
- )
412
- expect(found).to eq('build/test/mocks/TestModel/MockTemperatureFilter.c')
413
- end
414
-
415
- it 'resolves a release object via its own mirrored subdirectory, even when another same-named source exists elsewhere' do
416
- allow(@configurator).to receive(:collection_release_build_input).and_return(
417
- ['drivers/foo/bar.c', 'drivers/baz/bar.c']
418
- )
419
-
420
- found = @file_finder.find_build_input_file(
421
- filepath: 'build/release/out/foo/bar.o', complain: :error, context: RELEASE_SYM
422
- )
423
- expect(found).to eq('drivers/foo/bar.c')
424
-
425
- found = @file_finder.find_build_input_file(
426
- filepath: 'build/release/out/baz/bar.o', complain: :error, context: RELEASE_SYM
427
- )
428
- expect(found).to eq('drivers/baz/bar.c')
429
- end
430
-
431
- it 'resolves a module-under-test object via its own mirrored subdirectory, even when another same-named module exists elsewhere' do
432
- allow(@file_path_utils).to receive(:form_test_build_path).with('TestFoo', context: TEST_SYM).and_return('build/test/out/TestFoo')
433
- allow(@configurator).to receive(:collection_existing_test_build_input).and_return(
434
- ['drivers/foo/bar.c', 'drivers/baz/bar.c']
435
- )
436
-
437
- found = @file_finder.find_build_input_file(
438
- filepath: 'build/test/out/TestFoo/foo/bar.o', complain: :error, context: TEST_SYM, test: 'TestFoo'
439
- )
440
- expect(found).to eq('drivers/foo/bar.c')
441
-
442
- found = @file_finder.find_build_input_file(
443
- filepath: 'build/test/out/TestFoo/baz/bar.o', complain: :error, context: TEST_SYM, test: 'TestFoo'
444
- )
445
- expect(found).to eq('drivers/baz/bar.c')
446
- end
447
-
448
- it 'still resolves a flat module-under-test object by basename when no test identity is given' do
449
- allow(@configurator).to receive(:collection_existing_test_build_input).and_return( ['drivers/bar.c'] )
450
-
451
- found = @file_finder.find_build_input_file(
452
- filepath: 'build/test/out/TestFoo/bar.o', complain: :error, context: TEST_SYM
453
- )
454
- expect(found).to eq('drivers/bar.c')
455
- end
456
-
457
- it 'never raises on a bare, ambiguous TEST_SOURCE_FILE()-style query -- resolves to the first candidate by project path order' do
458
- allow(@configurator).to receive(:collection_existing_test_build_input).and_return(
459
- ['drivers/foo/bar.c', 'drivers/baz/bar.c']
460
- )
461
-
462
- found = @file_finder.find_build_input_file( filepath: 'bar.c', complain: :ignore, context: TEST_SYM )
463
- expect(found).to eq('drivers/foo/bar.c')
464
- end
465
-
466
- it 'preserves a source-tree-relative query\'s own path, rather than collapsing it to a bare basename' do
467
- allow(@configurator).to receive(:collection_existing_test_build_input).and_return(
468
- ['drivers/foo/bar.c', 'drivers/baz/bar.c']
469
- )
470
-
471
- found = @file_finder.find_build_input_file(
472
- filepath: 'drivers/foo/bar.c', complain: :error, context: TEST_SYM
473
- )
474
- expect(found).to eq('drivers/foo/bar.c')
475
- end
476
-
477
- it 'still resolves a plugin\'s own build-context object by basename, an unrecognized build root having no mirroring rule of its own' do
478
- allow(@configurator).to receive(:collection_existing_test_build_input).and_return( ['drivers/bar.c'] )
479
-
480
- found = @file_finder.find_build_input_file(
481
- filepath: 'build/valgrind/out/TestFoo/bar.o', complain: :error, context: :valgrind
482
- )
483
- expect(found).to eq('drivers/bar.c')
484
- end
485
-
486
- it 'does not mistake an unrelated resolved path\'s own directory name for a test identity, when that directory happens to share the file\'s own basename' do
487
- allow(@configurator).to receive(:collection_existing_test_build_input).and_return( ['build/vendor/ceedling/ceedling.c'] )
488
-
489
- found = @file_finder.find_build_input_file(
490
- filepath: 'build/vendor/ceedling/ceedling.h', complain: :ignore, context: TEST_SYM
491
- )
492
- expect(found).to eq('build/vendor/ceedling/ceedling.c')
493
- end
494
- end
495
- end