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
@@ -0,0 +1,396 @@
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
+ # What a mock-only Partial keeps of its real header beyond the functions the test mocks.
9
+ #
10
+ # A mocked Partial's interface header takes the real header's place wherever generated code
11
+ # includes it, so what the real header supplied besides the mocked functions has to come along
12
+ # in the extras header the interface includes. These examples state which of a module's items
13
+ # PartializerHelper#plan_interface_extras keeps, and which it withholds.
14
+
15
+ require 'spec_helper'
16
+ require 'ceedling/partials/partializer_helper'
17
+ require 'ceedling/partials/partials'
18
+ require 'ceedling/c_extractor/c_extractor_types'
19
+
20
+ EXTRAS_KEYWORDS = %w[static inline extern const __inline __inline__].freeze
21
+
22
+ describe PartializerHelper do
23
+ before(:each) do
24
+ @helper = described_class.new(
25
+ {
26
+ :partializer_utils => double( 'PartializerUtils' ),
27
+ :c_extractor_declarations => double( 'CExtractorDeclarations' ),
28
+ :parsing_parcels => double( 'ParsingParcels' ),
29
+ :loginator => double( 'Loginator' ).as_null_object
30
+ }
31
+ )
32
+ end
33
+
34
+ # ---- builders --------------------------------------------------------------
35
+
36
+ def decl(signature, origin: :header)
37
+ name = signature[/(\w+)\s*\(/, 1]
38
+ CExtractorTypes::CFunctionDeclaration.new(
39
+ name: name, signature: signature, decorators: signature.split( /\s+/ ).take_while { |t| EXTRAS_KEYWORDS.include?( t ) },
40
+ signature_stripped: signature.sub( /\A(?:(?:static|inline|extern)\s+)+/, '' ), origin: origin
41
+ )
42
+ end
43
+
44
+ def defn(code_block, origin: :header, expanded_body: nil)
45
+ signature = code_block[/\A[^{]*/].strip
46
+ CExtractorTypes::CFunctionDefinition.new(
47
+ name: signature[/(\w+)\s*\(/, 1], signature: signature, code_block: code_block, body: code_block[/\{.*\}/m],
48
+ decorators: signature.split( /\s+/ ).take_while { |t| EXTRAS_KEYWORDS.include?( t ) }, origin: origin, expanded_body: expanded_body
49
+ )
50
+ end
51
+
52
+ def var(text, decorators: [], origin: :header, promoted_from: nil, name: nil, expanded_text: nil)
53
+ CExtractorTypes::CVariableDeclaration.new(
54
+ name: name || text[/(\w+)\s*(?:=|;|\[)/, 1], text: text, decorators: decorators, origin: origin, promoted_from: promoted_from,
55
+ expanded_text: expanded_text
56
+ )
57
+ end
58
+
59
+ def macro(text)
60
+ CExtractorTypes::CStatement.new( text: text, kind: :macro, origin: :header )
61
+ end
62
+
63
+ def c_module(*items)
64
+ CExtractorTypes::CModule.new(
65
+ function_definitions: items.grep( CExtractorTypes::CFunctionDefinition ),
66
+ function_declarations: items.grep( CExtractorTypes::CFunctionDeclaration ),
67
+ variable_declarations: items.grep( CExtractorTypes::CVariableDeclaration ),
68
+ macro_definitions: items.grep( CExtractorTypes::CStatement ),
69
+ element_sequence: items
70
+ )
71
+ end
72
+
73
+ def mocked(*names)
74
+ names.map { |n| Partials.manufacture_function_declaration( name: n, signature: "int #{n}(void)" ) }
75
+ end
76
+
77
+ def plan(mod, interface: [], fallback: false, header_guarded: true)
78
+ @helper.plan_interface_extras( c_module: mod, interface: interface, fallback: fallback, header_guarded: header_guarded )
79
+ end
80
+
81
+ # ---- functions --------------------------------------------------------------
82
+
83
+ context 'functions' do
84
+ it 'keeps a header helper the mock leaves out, and leaves out the one it mocks' do
85
+ twice = defn( 'static inline int twice(int x) { return 2 * x; }' )
86
+ read = defn( 'static inline int read(void) { return -1; }' )
87
+
88
+ extras = plan( c_module( twice, read ), interface: mocked( 'read' ) )
89
+
90
+ expect( extras.items ).to eq( [twice] )
91
+ end
92
+
93
+ it "keeps a kept helper's prototype ahead of it" do
94
+ proto = decl( 'static inline int twice(int x);' )
95
+ twice = defn( 'static inline int twice(int x) { return 2 * x; }' )
96
+
97
+ expect( plan( c_module( proto, twice ) ).items ).to eq( [proto, twice] )
98
+ end
99
+
100
+ # A caller may need a function the mock doesn't select, defined somewhere else
101
+ it 'keeps a plain prototype the mock leaves out' do
102
+ init = decl( 'int init(void);' )
103
+
104
+ expect( plan( c_module( init, decl( 'int read(void);' ) ), interface: mocked( 'read' ) ).items ).to eq( [init] )
105
+ end
106
+
107
+ # A static prototype with no body here promises a definition no file of the test holds
108
+ it 'leaves out a static prototype of a function with no body' do
109
+ expect( plan( c_module( decl( 'static int port(void);' ) ) ).items ).to eq( [] )
110
+ end
111
+
112
+ it "leaves out the source's functions" do
113
+ helper = defn( 'static int adjust(int v) { return v + 1; }', origin: :source )
114
+
115
+ expect( plan( c_module( helper ) ).items ).to eq( [] )
116
+ end
117
+
118
+ it 'keeps one copy of a helper fallback preprocessing found twice alike' do
119
+ first = defn( 'static inline int twice(int x) { return 2 * x; }' )
120
+ second = defn( 'static inline int twice(int x) { return 2 * x; }' )
121
+
122
+ expect( plan( c_module( first, second ), fallback: true ).items ).to eq( [first] )
123
+ end
124
+
125
+ it 'leaves out a helper fallback preprocessing found with two different bodies' do
126
+ first = defn( 'static inline int twice(int x) { return 2 * x; }' )
127
+ second = defn( 'static inline int twice(int x) { return x + x + 1; }' )
128
+
129
+ expect( plan( c_module( first, second ), fallback: true ).items ).to eq( [] )
130
+ end
131
+ end
132
+
133
+ # ---- variables --------------------------------------------------------------
134
+
135
+ context 'variables' do
136
+ it 'keeps a header static variable and an extern declaration' do
137
+ table = var( 'int table[] = { 1, 2 };', decorators: ['static', 'const'] )
138
+ count = var( 'int count;', decorators: ['extern'] )
139
+
140
+ expect( plan( c_module( table, count ) ).items ).to eq( [table, count] )
141
+ end
142
+
143
+ # Every file including the extras header would define it again
144
+ it 'leaves out a header definition without static' do
145
+ expect( plan( c_module( var( 'int total = 1;' ) ) ).items ).to eq( [] )
146
+ end
147
+
148
+ it "leaves out the source's variables" do
149
+ expect( plan( c_module( var( 'int level;', decorators: ['static'], origin: :source ) ) ).items ).to eq( [] )
150
+ end
151
+
152
+ it 'keeps the promoted statics of a helper it keeps, and not those of a helper the mock selects' do
153
+ kept_static = var( 'int partial_twice_calls;', decorators: ['static'], promoted_from: 'twice' )
154
+ twice = defn( 'static inline int twice(int x) { return 2 * x; }' )
155
+ mock_static = var( 'int partial_read_calls;', decorators: ['static'], promoted_from: 'read' )
156
+ read = defn( 'static inline int read(void) { return -1; }' )
157
+
158
+ extras = plan( c_module( kept_static, twice, mock_static, read ), interface: mocked( 'read' ) )
159
+
160
+ expect( extras.items ).to eq( [kept_static, twice] )
161
+ end
162
+ end
163
+
164
+ # ---- fallback preprocessing ------------------------------------------------------
165
+
166
+ # Fallback keeps both sides of a conditional, so a name can arrive twice
167
+ context 'fallback preprocessing' do
168
+ # A tentative definition and the definition that initializes it are both C
169
+ it 'keeps every declaration of a static variable outside fallback' do
170
+ tentative = var( 'int port_x;', decorators: ['static'] )
171
+ defined = var( 'int port_x = 5;', decorators: ['static'] )
172
+
173
+ expect( plan( c_module( tentative, defined ) ).items ).to eq( [tentative, defined] )
174
+ end
175
+
176
+ # A tentative definition is C beside the definition that initializes it
177
+ it 'keeps a tentative definition beside the initialized one' do
178
+ tentative = var( 'int port_x;', decorators: ['static'] )
179
+ defined = var( 'int port_x = 5;', decorators: ['static'] )
180
+
181
+ expect( plan( c_module( tentative, defined ), fallback: true ).items ).to eq( [tentative, defined] )
182
+ end
183
+
184
+ it 'leaves out tentative definitions declared differently' do
185
+ long = var( 'unsigned long port_acc;', decorators: ['static'] )
186
+ short = var( 'unsigned short port_acc;', decorators: ['static'] )
187
+
188
+ expect( plan( c_module( long, short ), fallback: true ).items ).to eq( [] )
189
+ end
190
+
191
+ it 'leaves out a tentative definition declared unlike the initialized one' do
192
+ tentative = var( 'int port_x;', decorators: ['static'] )
193
+ defined = var( 'int port_x = 5;', decorators: ['static', 'const'] )
194
+
195
+ expect( plan( c_module( tentative, defined ), fallback: true ).items ).to eq( [] )
196
+ end
197
+
198
+ it 'keeps one copy of a static variable found twice alike' do
199
+ first = var( 'int gain = 1;', decorators: ['static', 'const'] )
200
+ second = var( 'int gain = 1;', decorators: ['static', 'const'] )
201
+
202
+ expect( plan( c_module( first, second ), fallback: true ).items ).to eq( [first] )
203
+ end
204
+
205
+ it 'leaves out a static variable found twice with different definitions' do
206
+ first = var( 'int gain = 1;', decorators: ['static', 'const'] )
207
+ second = var( 'int gain = 2;', decorators: ['static', 'const'] )
208
+
209
+ expect( plan( c_module( first, second ), fallback: true ).items ).to eq( [] )
210
+ end
211
+
212
+ it 'leaves out a plain prototype found twice with different signatures' do
213
+ expect( plan( c_module( decl( 'int init(void);' ), decl( 'long init(void);' ) ), fallback: true ).items ).to eq( [] )
214
+ end
215
+
216
+ # A helper calling a function whose prototype stays behind wouldn't compile
217
+ it 'leaves out a helper calling a function whose prototypes conflict' do
218
+ twice = defn( 'static inline int port_twice(void) { return 2 * (int)port_mode(); }' )
219
+
220
+ extras = plan( c_module( decl( 'unsigned long port_mode(void);' ), decl( 'unsigned short port_mode(void);' ), twice ), fallback: true )
221
+
222
+ expect( extras.items ).to eq( [] )
223
+ end
224
+ end
225
+
226
+ # ---- names a macro rewrites ------------------------------------------------------
227
+
228
+ # The interface writes every macro ahead of the extras, so a function-like macro of the
229
+ # same name would rewrite the prototype. Calls go through the macro anyway.
230
+ # An object-like macro of a function's name renames the prototype into one callers still reach
231
+ it 'keeps a prototype an object-like macro of its name renames' do
232
+ reg = decl( 'int read_reg(void);' )
233
+
234
+ expect( plan( c_module( reg, macro( '#define read_reg read_reg_v2' ) ) ).items ).to eq( [reg] )
235
+ end
236
+
237
+ it 'leaves out a prototype a function-like macro of the same name rewrites' do
238
+ alloc = decl( 'void *port_alloc(unsigned n);' )
239
+ dbg = decl( 'void *port_alloc_dbg(unsigned n, int line);' )
240
+
241
+ extras = plan( c_module( alloc, macro( '#define port_alloc(n) port_alloc_dbg((n), __LINE__)' ), dbg ) )
242
+
243
+ expect( extras.items ).to eq( [dbg] )
244
+ end
245
+
246
+ # ---- what a test leaves undefined --------------------------------------------------
247
+
248
+ # GCC emits an unused static variable or non-inline static function at -O0, so one naming a
249
+ # function no file of the test defines fails the link. It stays behind, as it would have
250
+ # without the extras.
251
+ context 'a function the mock leaves undefined' do
252
+ def port_module(*items)
253
+ c_module( decl( 'int port_a(void);' ), decl( 'int port_read(void);' ), *items )
254
+ end
255
+
256
+ it 'leaves out a static variable naming it' do
257
+ handlers = var( 'port_fn_t port_handlers[] = { port_a };', decorators: ['static', 'const'] )
258
+
259
+ expect( plan( port_module( handlers ), interface: mocked( 'port_read' ) ).items.map( &:name ) ).to eq( ['port_a'] )
260
+ end
261
+
262
+ it 'leaves out a non-inline static helper calling it, and keeps an inline one' do
263
+ sum = defn( 'static int port_sum(void) { return port_a() + 1; }' )
264
+ twice = defn( 'static inline int port_twice(void) { return 2 * port_a(); }' )
265
+
266
+ extras = plan( port_module( sum, twice ), interface: mocked( 'port_read' ) )
267
+
268
+ expect( extras.items.map( &:name ) ).to eq( ['port_a', 'port_twice'] )
269
+ end
270
+
271
+ # A body naming an item the extras leave out wouldn't compile, used or not
272
+ it 'leaves out what names an item it left out' do
273
+ sum = defn( 'static int port_sum(void) { return port_a() + 1; }' )
274
+ twice = defn( 'static inline int port_twice(void) { return 2 * port_sum(); }' )
275
+ table = var( 'port_fn_t port_table[] = { port_twice };', decorators: ['static', 'const'] )
276
+
277
+ expect( plan( port_module( sum, twice, table ), interface: mocked( 'port_read' ) ).items.map( &:name ) ).to eq( ['port_a'] )
278
+ end
279
+
280
+ # A promoted static is data at file scope, which GCC emits even where the helper is unused
281
+ it 'leaves out an inline helper whose promoted static names it' do
282
+ promoted = var( 'int (*partial_port_h_cb)(void) = port_a;', decorators: ['static'], promoted_from: 'port_h', name: 'partial_port_h_cb' )
283
+ helper = defn( 'static inline int port_h(void) { return partial_port_h_cb(); }' )
284
+
285
+ expect( plan( port_module( promoted, helper ), interface: mocked( 'port_read' ) ).items.map( &:name ) ).to eq( ['port_a'] )
286
+ end
287
+
288
+ it 'leaves out what names a helper its promoted static took along' do
289
+ promoted = var( 'int (*partial_port_h_cb)(void) = port_a;', decorators: ['static'], promoted_from: 'port_h', name: 'partial_port_h_cb' )
290
+ helper = defn( 'static inline int port_h(void) { return 1; }' )
291
+ caller = defn( 'static inline int port_g(void) { return port_h(); }' )
292
+
293
+ expect( plan( port_module( promoted, helper, caller ), interface: mocked( 'port_read' ) ).items.map( &:name ) ).to eq( ['port_a'] )
294
+ end
295
+
296
+ # A macro from another header, token pasting and stringizing show only after expansion
297
+ it "reads an initializer's names as the expansion spells them" do
298
+ pasted = var( 'port_fn_t port_pasted[] = { E(a) };', decorators: ['static', 'const'], expanded_text: 'port_fn_t port_pasted[] = { port_a };' )
299
+ strings = var( 'const char *port_names[] = { NAME(port_a) };', decorators: ['static'], expanded_text: 'const char *port_names[] = { "port_a" };' )
300
+
301
+ extras = plan( port_module( pasted, strings ), interface: mocked( 'port_read' ) )
302
+
303
+ expect( extras.items.map( &:name ) ).to eq( ['port_a', 'port_names'] )
304
+ end
305
+
306
+ # Fallback may pair a variable with the other side of a conditional, or not at all, so the
307
+ # written text counts too. A doubtful item stays behind, as without the extras.
308
+ it 'reads names from both the written and the expanded text' do
309
+ table = var( 'port_fn_t port_table[] = { port_a };', decorators: ['static', 'const'], expanded_text: 'port_fn_t port_table[] = { port_read };' )
310
+
311
+ expect( plan( port_module( table ), interface: mocked( 'port_read' ), fallback: true ).items.map( &:name ) ).to eq( ['port_a'] )
312
+ end
313
+
314
+ it "reads a helper's names from its expanded body" do
315
+ helper = defn( 'static int port_h(void) { return HANDLER(); }', expanded_body: '{ return port_a(); }' )
316
+
317
+ expect( plan( port_module( helper ), interface: mocked( 'port_read' ) ).items.map( &:name ) ).to eq( ['port_a'] )
318
+ end
319
+
320
+ it 'reads a name a macro hides through another macro' do
321
+ handlers = var( 'port_fn_t port_handlers[] = { PORT_FIRST };', decorators: ['static', 'const'] )
322
+
323
+ extras = plan( port_module( macro( '#define PORT_FIRST PORT_A' ), macro( '#define PORT_A port_a' ), handlers ), interface: mocked( 'port_read' ) )
324
+
325
+ expect( extras.items.map( &:name ) ).to eq( ['port_a'] )
326
+ end
327
+
328
+ # A wrong guess at a local could hide an item left behind, which no file could then compile
329
+ it 'reads a name a helper body uses even where it reads like a declaration' do
330
+ table = var( 'port_fn_t port_table[] = { port_a };', decorators: ['static', 'const'] )
331
+ first = defn( 'static inline int port_first(int i) { return port_mix(i * port_table[0](), i); }' )
332
+
333
+ expect( plan( port_module( table, first ), interface: mocked( 'port_read' ) ).items.map( &:name ) ).to eq( ['port_a'] )
334
+ end
335
+
336
+ it 'reads a name a macro hides' do
337
+ handlers = var( 'port_fn_t port_handlers[] = { PORT_HANDLER };', decorators: ['static', 'const'] )
338
+
339
+ extras = plan( port_module( macro( '#define PORT_HANDLER port_a' ), handlers ), interface: mocked( 'port_read' ) )
340
+
341
+ expect( extras.items.map( &:name ) ).to eq( ['port_a'] )
342
+ end
343
+
344
+ # A string, a comment or a member access only reads like a use
345
+ it 'keeps an item whose string, comment or member access spells the name' do
346
+ names = var( 'const char *port_names[] = { "port_a" };', decorators: ['static'] )
347
+ helper = defn( 'static int port_h(struct port *p) { /* not port_a */ return p->port_a; }' )
348
+
349
+ extras = plan( port_module( names, helper ), interface: mocked( 'port_read' ) )
350
+
351
+ expect( extras.items.map( &:name ) ).to eq( ['port_a', 'port_names', 'port_h'] )
352
+ end
353
+
354
+ it 'keeps an item naming a function that only starts with the name' do
355
+ table = var( 'port_fn_t port_table[] = { port_ab };', decorators: ['static', 'const'] )
356
+
357
+ extras = plan( port_module( decl( 'int port_ab(void);' ), table ), interface: mocked( 'port_read', 'port_ab' ) )
358
+
359
+ expect( extras.items.map( &:name ) ).to eq( ['port_a', 'port_table'] )
360
+ end
361
+
362
+ it 'keeps a static variable naming a mocked function or a kept helper' do
363
+ twice = defn( 'static inline int port_twice(int x) { return 2 * x; }' )
364
+ table = var( 'port_fn_t port_table[] = { port_read, port_twice };', decorators: ['static', 'const'] )
365
+
366
+ extras = plan( port_module( twice, table ), interface: mocked( 'port_read' ) )
367
+
368
+ expect( extras.items.map( &:name ) ).to eq( ['port_a', 'port_twice', 'port_table'] )
369
+ end
370
+ end
371
+
372
+ # ---- a header without an include guard ---------------------------------------
373
+
374
+ # The real header may still arrive through another include, where a second copy collides
375
+ context 'a header without an include guard' do
376
+ it 'withholds its helpers and static variables, and keeps its declarations' do
377
+ twice = defn( 'static inline int twice(int x) { return 2 * x; }' )
378
+ table = var( 'int table[] = { 1, 2 };', decorators: ['static', 'const'] )
379
+ count = var( 'int count;', decorators: ['extern'] )
380
+ init = decl( 'int init(void);' )
381
+
382
+ extras = plan( c_module( twice, table, count, init ), header_guarded: false )
383
+
384
+ expect( extras.items ).to eq( [count, init] )
385
+ expect( extras.withheld ).to eq( [twice, table] )
386
+ end
387
+ end
388
+
389
+ it 'reads names in code, not in strings or comments' do
390
+ expect( @helper.names_in( 'x = "port_a"; /* port_b */ port_c();' ) ).to eq( Set['x', 'port_c'] )
391
+ end
392
+
393
+ it 'is empty for a header holding only what the mock selects' do
394
+ expect( plan( c_module( decl( 'int read(void);' ) ), interface: mocked( 'read' ) ) ).to be_empty
395
+ end
396
+ end