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,285 @@
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 'strscan'
9
+ require 'ceedling/c_extractor/c_extractor_constants'
10
+
11
+ # Reads the parenthesized declarator a C declaration may have, as in `int (*hook)(int)`.
12
+ #
13
+ # The declared name sits inside that group, past pointer stars and qualifiers. What follows the
14
+ # name decides what the declaration declares. A parameter list makes it a function, even one
15
+ # returning a function pointer. Anything else makes it an object, such as a pointer to a function
16
+ # or to an array. A plain declaration has no such group, and each caller reads it its own way.
17
+ # Every scan here is a single forward pass, so a declaration's cost stays linear.
18
+ module CExtractorDeclarator
19
+
20
+ # A declaration's parenthesized declarator. `follows` is the '(' or '[' right after the name,
21
+ # or nil. `base_type` is the text ahead of the group, and `declarator` the group onward.
22
+ Parenthesized = Struct.new( :name, :follows, :base_type, :declarator, keyword_init: true ) unless const_defined?(:Parenthesized, false)
23
+
24
+ # A calling convention, which may come ahead of a group's star
25
+ CALLING_CONVENTION = /(?:#{CExtractorConstants::MSVC_CALLING_CONVENTIONS.join( '|' )})\b/ unless const_defined?(:CALLING_CONVENTION, false)
26
+
27
+ # A '(' opening a declarator, perhaps through redundant parentheses and a calling convention
28
+ POINTER_GROUP = /\([\s(]*(?:#{CALLING_CONVENTION}\s*)*\*/ unless const_defined?(:POINTER_GROUP, false)
29
+
30
+ # A type specifier ending the text ahead of a group, whose argument the group holds
31
+ SPECIFIER_AHEAD = /(?<![\w$])(?:#{CExtractorConstants::SPECIFIERS_WITH_ARGUMENTS.join( '|' )})\s*\z/ unless const_defined?(:SPECIFIER_AHEAD, false)
32
+
33
+ # A nested pointer group. After a word, a '(' that opens one is no parameter list.
34
+ NESTED_GROUP = /\(\s*(?:#{CALLING_CONVENTION}\s*)*\*/ unless const_defined?(:NESTED_GROUP, false)
35
+
36
+ # Words that qualify a pointer ahead of the name, including ones a compiler adds. A '(' after
37
+ # one of these still opens a redundant group, as in `(* const (name))`.
38
+ QUALIFIERS = (CExtractorConstants::TYPE_QUALIFIER_KEYWORDS + CExtractorConstants::MSVC_CALLING_CONVENTIONS +
39
+ %w[__restrict __restrict__ _Nullable _Nonnull _Null_unspecified __far __near __huge __ptr32 __ptr64 __unaligned]).freeze unless const_defined?(:QUALIFIERS, false)
40
+
41
+ # An identifier, which GCC and Clang let hold '$'
42
+ WORD = CExtractorConstants::IDENTIFIER unless const_defined?(:WORD, false)
43
+
44
+ # Space between a group's tokens. Fallback preprocessing leaves comments in place.
45
+ GAP = %r{(?:\s|/\*.*?\*/|//[^\n]*)*}m unless const_defined?(:GAP, false)
46
+
47
+ # A string or character literal, or a comment. What looks like code inside one isn't. A literal
48
+ # may run past a line's end here, as CExtractorCodeText#skip_c_string reads one, so blanking
49
+ # comments and passing literals agree on where each ends.
50
+ LITERAL_OR_COMMENT = %r{"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|/\*.*?\*/|//[^\n]*}m unless const_defined?(:LITERAL_OR_COMMENT, false)
51
+
52
+ # A bracket, or a literal or comment whose brackets don't count toward a group's balance
53
+ BALANCE_TOKEN = Regexp.union( /[()\[\]{}]/, LITERAL_OR_COMMENT ) unless const_defined?(:BALANCE_TOKEN, false)
54
+
55
+ # A balance token, or the '=' that may start an initializer
56
+ INITIALIZER_TOKEN = Regexp.union( /=/, BALANCE_TOKEN ) unless const_defined?(:INITIALIZER_TOKEN, false)
57
+
58
+ # Where a walk through a declarator group stands. That is the name read so far, and how many
59
+ # '(' have passed since the last star. Those only group the name, and close right after it.
60
+ GroupWalk = Struct.new( :name, :opens ) unless const_defined?(:GroupWalk, false)
61
+
62
+ # What may follow a declarator's name. That is the group's own ')', a parameter list or an
63
+ # array size.
64
+ NAME_ENDS = [')', '(', '['].freeze unless const_defined?(:NAME_ENDS, false)
65
+
66
+ # How each delimiter changes the nesting depth
67
+ DEPTH_CHANGE = { '(' => 1, '[' => 1, '{' => 1, ')' => -1, ']' => -1, '}' => -1 }.freeze unless const_defined?(:DEPTH_CHANGE, false)
68
+
69
+ # The declaration's parenthesized declarator, or nil when it has none. The text has no
70
+ # initializer (see without_initializer). Words and attributes ahead of the group are passed
71
+ # over like the type, and end up in the base type. A group whose name ends any other way,
72
+ # such as at the ',' of a macro's arguments, is no declarator.
73
+ def self.parenthesized(text)
74
+ text = text.sub( /\s*;\s*\z/, '' )
75
+ start = _group_start( text )
76
+ return nil if start.nil?
77
+
78
+ name, ending = _name_in( text, start )
79
+ return nil unless NAME_ENDS.include?( ending )
80
+
81
+ return Parenthesized.new( name: name, follows: (ending == ')' ? nil : ending),
82
+ base_type: text.byteslice( 0, start ).strip, declarator: Extent.text( text, start ) )
83
+ end
84
+
85
+ # The declaration up to any initializer, less its semicolon. Only an '=' outside brackets,
86
+ # parentheses and braces starts one, and a bracket in a comment or literal doesn't count.
87
+ def self.without_initializer(text)
88
+ scanner = StringScanner.new( text )
89
+ depth = 0
90
+ while scanner.skip_until( INITIALIZER_TOKEN )
91
+ depth += DEPTH_CHANGE.fetch( scanner.matched, 0 )
92
+ return text.byteslice( 0, scanner.pos - 1 ).rstrip if scanner.matched == '=' and depth.zero?
93
+ end
94
+
95
+ return text.sub( /\s*;\s*\z/, '' )
96
+ end
97
+
98
+ # Where the declarator group opens. That is the first top-level '(' whose next token is a '*',
99
+ # perhaps after a calling convention. Any other group is a parameter list or a macro's
100
+ # arguments, a bracket holds an array size, and a brace holds a struct's members, so each is
101
+ # passed over whole. So is a type specifier's argument, as in `typeof(*p)`.
102
+ def self._group_start(text)
103
+ scanner = StringScanner.new( text )
104
+ while scanner.skip_until( /[(\[{]/ )
105
+ open = scanner.pos - 1
106
+ scanner.pos = open
107
+ return open if scanner.match?( POINTER_GROUP ) and !_specifier_argument?( text, open )
108
+ return nil unless _skip_balanced( scanner )
109
+ end
110
+
111
+ return nil
112
+ end
113
+
114
+ # Whether the group at `open` follows a specifier. Only the few bytes ahead of it are read,
115
+ # which the longest specifier and its space fit in. Every caller collapses whitespace and
116
+ # blanks or removes comments first, so nothing longer sits between the two.
117
+ def self._specifier_argument?(text, open)
118
+ from = [open - 24, 0].max
119
+ return text.byteslice( from, open - from ).scrub( '' ).match?( SPECIFIER_AHEAD )
120
+ end
121
+
122
+ # Moves the scanner past the group, bracket or brace it sits at. A bracket in a string, a
123
+ # character literal or a comment doesn't count. False when the text ends first.
124
+ def self._skip_balanced(scanner)
125
+ depth = 0
126
+ while scanner.skip_until( BALANCE_TOKEN )
127
+ depth += DEPTH_CHANGE.fetch( scanner.matched, 0 )
128
+ return true if depth.zero?
129
+ end
130
+
131
+ return false
132
+ end
133
+
134
+ # The name inside the group at `start`, with the character that ends it. The name is the last
135
+ # word ahead of that end that isn't a qualifier. A star or '(' ahead of the name clears any word
136
+ # read so far, since a qualifier the list lacks may come before the name. Parentheses around the
137
+ # name close before its end is read. After the name, a '(' opens a parameter list unless a
138
+ # nested pointer group starts there.
139
+ def self._name_in(text, start)
140
+ scanner = StringScanner.new( text )
141
+ scanner.pos = start + 1
142
+ walk = GroupWalk.new( nil, 0 )
143
+
144
+ while (step = _next_in_group( scanner, walk.name ))
145
+ _take_step( walk, step )
146
+ end
147
+
148
+ return [walk.name, _name_end( scanner, walk.opens )]
149
+ end
150
+
151
+ # Moves the scanner past the next token in a group and says what it was. That is :star, :group
152
+ # for a '(' passed through, or the word read. It is nil at anything else, which ends the name.
153
+ def self._next_in_group(scanner, name)
154
+ scanner.skip( GAP )
155
+ return :star if scanner.skip( /\*/ )
156
+ return scanner.scan( WORD ) unless scanner.check( /\(/ ) and (name.nil? or scanner.match?( NESTED_GROUP ))
157
+
158
+ scanner.pos += 1
159
+ return :group
160
+ end
161
+
162
+ # Records one step of the walk. A qualifier changes nothing. A star clears the name and the '('
163
+ # counted, and a '(' clears the name and counts one more.
164
+ def self._take_step(walk, step)
165
+ return if QUALIFIERS.include?( step )
166
+
167
+ walk.opens = (step == :star) ? 0 : walk.opens + 1 unless step.is_a?( String )
168
+ walk.name = step.is_a?( String ) ? step : nil
169
+ end
170
+
171
+ # What ends the name. A ')' closing a parenthesis that only groups the name is passed, and the
172
+ # first character past those decides, as in `(*(get)(void))` and `(*(get(void)))` alike.
173
+ def self._name_end(scanner, opens)
174
+ loop do
175
+ scanner.skip( GAP )
176
+ return scanner.peek( 1 ) unless scanner.check( /\)/ ) and opens.positive?
177
+
178
+ scanner.pos += 1
179
+ opens -= 1
180
+ end
181
+ end
182
+
183
+ # Where a declarator's text ends. An extern repeats the text, from the group's '(' through its
184
+ # last suffix. What follows the last suffix is left out. An extern needs no attribute or macro
185
+ # there, and some draw a warning. An asm label there is read apart (see AsmLabel).
186
+ module Extent
187
+
188
+ # Words, such as a macro, that may sit ahead of an array size among a declarator's suffixes
189
+ SUFFIX_WORDS = /(?:#{WORD}#{GAP})+/ unless const_defined?(:SUFFIX_WORDS, false)
190
+
191
+ # The declarator's text from its group's '(' at `start`
192
+ def self.text(text, start)
193
+ scanner = StringScanner.new( text )
194
+ scanner.pos = start
195
+ return text.byteslice( start, text.bytesize - start ).strip unless CExtractorDeclarator._skip_balanced( scanner )
196
+
197
+ finish = _suffixes_end( scanner )
198
+ return text.byteslice( start, finish - start ).strip
199
+ end
200
+
201
+ # Where the last of a declarator's parameter lists and array sizes ends, read from the scanner
202
+ # just past the group. A word may sit ahead of an array size, but a word ahead of a '(' makes
203
+ # a macro call, an attribute or an asm label, which ends the suffixes.
204
+ def self._suffixes_end(scanner)
205
+ finish = scanner.pos
206
+ loop do
207
+ scanner.skip( GAP )
208
+ opening = scanner.skip( SUFFIX_WORDS ) ? /\[/ : /[(\[]/
209
+ break unless scanner.check( opening ) and CExtractorDeclarator._skip_balanced( scanner )
210
+
211
+ finish = scanner.pos
212
+ end
213
+
214
+ return finish
215
+ end
216
+
217
+ end
218
+
219
+ # An asm label, as in `int g __asm__("sym") = 1;`, which names the symbol a declaration's
220
+ # object or function takes. A compiler applies it to the declarations it sees, so a test's own
221
+ # declaration must carry it too. A record keeps the label apart from the name and type it
222
+ # reads. Only a label outside brackets and ahead of any initializer counts.
223
+ module AsmLabel
224
+
225
+ # A run of word characters read whole, among which a label's keyword may be, or an
226
+ # initializer token. A number is read whole too, so no keyword is found inside one.
227
+ TOKEN = Regexp.union( INITIALIZER_TOKEN, /[\w$]+/ ) unless const_defined?(:TOKEN, false)
228
+
229
+ # The keywords that open a label
230
+ KEYWORDS = %w[asm __asm __asm__].freeze unless const_defined?(:KEYWORDS, false)
231
+
232
+ # What follows a label's keyword, up to the '(' of its string
233
+ OPEN = /#{GAP}\(/ unless const_defined?(:OPEN, false)
234
+
235
+ # The first label as written, such as `__asm__("sym")`, or nil
236
+ def self.of(text)
237
+ range = _ranges( text ).first
238
+ return range && text.byteslice( range.begin, range.size )
239
+ end
240
+
241
+ # The declaration without its labels ahead of any initializer. A compound declaration may hold
242
+ # one per declarator. The space around a label collapses to one, or to none ahead of a
243
+ # semicolon or comma.
244
+ def self.without(text)
245
+ ranges = _ranges( text )
246
+ return text if ranges.empty?
247
+
248
+ cuts = [0, *ranges.flat_map { |range| [range.begin, range.end] }, text.bytesize]
249
+ return cuts.each_slice( 2 ).map { |from, to| text.byteslice( from, to - from ) }.reduce { |kept, piece| _joined( kept, piece ) }
250
+ end
251
+
252
+ # Two pieces of text a label sat between, with the space between them collapsed
253
+ def self._joined(before, after)
254
+ before = before.rstrip
255
+ after = after.lstrip
256
+ return (after.empty? or after.start_with?( ';', ',' )) ? "#{before}#{after}" : "#{before} #{after}"
257
+ end
258
+
259
+ # Where each label sits, from its keyword through its ')'. The walk stops at an initializer.
260
+ def self._ranges(text)
261
+ scanner = StringScanner.new( text )
262
+ depth = 0
263
+ ranges = []
264
+ while scanner.skip_until( TOKEN ) and !(scanner.matched == '=' and depth.zero?)
265
+ token = scanner.matched
266
+ depth += DEPTH_CHANGE.fetch( token, 0 )
267
+ from = scanner.pos - token.bytesize
268
+ ranges << (from...scanner.pos) if _opens?( scanner, token, depth )
269
+ end
270
+
271
+ return ranges
272
+ end
273
+
274
+ # Whether the token just read opens a label outside brackets. On true, the scanner has passed
275
+ # the label's ')'.
276
+ def self._opens?(scanner, token, depth)
277
+ return false unless depth.zero? and KEYWORDS.include?( token ) and scanner.match?( OPEN )
278
+
279
+ scanner.skip( GAP )
280
+ return CExtractorDeclarator._skip_balanced( scanner )
281
+ end
282
+
283
+ end
284
+
285
+ end
@@ -0,0 +1,111 @@
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 'strscan'
9
+ require 'ceedling/c_extractor/c_extractor_constants'
10
+ require 'ceedling/c_extractor/c_extractor_declarator'
11
+
12
+ # Reads a struct, union or enum that a declaration defines ahead of its declarators, as in
13
+ # `static struct pair { int a; } g_p1, g_p2;`. Such a statement holds two things. The type is
14
+ # defined once, and each variable names it. Separating them lets every variable be read like
15
+ # any other, and lets a type be written once wherever a module's types go.
16
+ #
17
+ # Every scan here is a single forward pass over text whose comments are already blanked.
18
+ module CExtractorDefinedType
19
+
20
+ # A declaration split at the type it defines. `type` runs from the keyword through the body's
21
+ # '}' and any extensions after it, which belong to the type. `tag` is the type's tag, or nil.
22
+ # `declarators` is the declaration with the type taken out.
23
+ Split = Struct.new( :type, :tag, :declarators, keyword_init: true ) unless const_defined?(:Split, false)
24
+
25
+ KEYWORD = /(?:struct|union|enum)(?![\w$])/ unless const_defined?(:KEYWORD, false)
26
+
27
+ # A token in a type's head. A group or a bracket is passed whole. A '{' opens the body, and any
28
+ # other token here means the declaration names a type without defining one.
29
+ HEAD_TOKEN = Regexp.union( /[{(\[;=*,]/, CExtractorDeclarator::LITERAL_OR_COMMENT ) unless const_defined?(:HEAD_TOKEN, false)
30
+
31
+ # A head's words once its groups are gone, the tag last. A word C reserves for the
32
+ # implementation is an extension, and an enum's `: type` names no tag.
33
+ TAG = /\A(?:\s*__[\w$]*)*\s*(?<tag>#{CExtractorConstants::IDENTIFIER.source})?(?:\s*__[\w$]*)*\s*(?::.*)?\z/m unless const_defined?(:TAG, false)
34
+
35
+ # A typedef's one name, once its type is taken out
36
+ TYPEDEF_NAME = /\Atypedef\s+(?<name>#{CExtractorConstants::IDENTIFIER.source})\s*;\s*\z/ unless const_defined?(:TYPEDEF_NAME, false)
37
+
38
+ # A statement naming a tag without a body, perhaps giving it one typedef name
39
+ BODILESS = /\A(?:typedef\s+)?(?:struct|union|enum)\s+(?<tag>#{CExtractorConstants::IDENTIFIER.source})(?:\s+(?<name>#{CExtractorConstants::IDENTIFIER.source}))?\s*;\s*\z/ unless const_defined?(:BODILESS, false)
40
+
41
+ # The tag a type statement names and the one name a typedef gives it, each nil where absent.
42
+ # A typedef declaring several names, or a pointer, gives the type no one name.
43
+ # struct node { int v; }; tag node
44
+ # typedef struct node { int v; } node_t; tag node, type_name node_t
45
+ # typedef struct node node_t; tag node, type_name node_t
46
+ def self.names(text)
47
+ split = split( text, text[/\Atypedef\s+/].to_s.bytesize )
48
+ return { tag: split.tag, type_name: split.declarators[TYPEDEF_NAME, :name] } if split
49
+
50
+ found = text.match( BODILESS )
51
+ return { tag: found && found[:tag], type_name: found && found[:name] }
52
+ end
53
+
54
+ # The declaration split at the type it defines, or nil when it defines none. `from` is where
55
+ # the type's keyword may start, past the declaration's leading run of decorators and attributes.
56
+ def self.split(text, from)
57
+ scanner = StringScanner.new( text )
58
+ scanner.pos = from
59
+ return nil unless scanner.skip( KEYWORD )
60
+
61
+ head = _head( scanner )
62
+ return nil unless head and CExtractorDeclarator._skip_balanced( scanner )
63
+
64
+ _skip_extensions( scanner )
65
+ return Split.new(
66
+ type: text.byteslice( from, scanner.pos - from ).strip, tag: head[TAG, :tag],
67
+ declarators: "#{text.byteslice( 0, from )}#{scanner.rest}"
68
+ )
69
+ end
70
+
71
+ # The type's head between its keyword and its body, with each group taken out, or nil when
72
+ # no body follows. The scanner stops at the body's '{'. A group straight after a word means a
73
+ # macro spells the tag, as in `struct FOO_TYPE(bar) {`, so the head names no tag of its own.
74
+ def self._head(scanner)
75
+ head = +''
76
+ while (before = scanner.scan_until( HEAD_TOKEN ))
77
+ head << before.delete_suffix( scanner.matched )
78
+ return _body_at( scanner, head ) if scanner.matched == '{'
79
+ return nil unless scanner.matched.start_with?( '(', '[' )
80
+
81
+ head = +'(' if head.match?( /[A-Za-z0-9_$]\s*\z/ ) and !head.match?( /(?<![\w$])__[\w$]*\s*\z/ )
82
+ return nil unless _skip_group( scanner )
83
+ end
84
+
85
+ return nil
86
+ end
87
+
88
+ # The head, with the scanner moved back onto the body's '{'
89
+ def self._body_at(scanner, head)
90
+ scanner.pos -= 1
91
+ return head
92
+ end
93
+
94
+ # Moves the scanner, just past a group's opening, past its close. False when it never closes.
95
+ def self._skip_group(scanner)
96
+ scanner.pos -= 1
97
+ return CExtractorDeclarator._skip_balanced( scanner )
98
+ end
99
+
100
+ # Moves the scanner past the extensions after a type's body, such as `__attribute__((packed))`
101
+ # or `__packed`, and the space around them. A group that never closes ends the extensions.
102
+ def self._skip_extensions(scanner)
103
+ loop do
104
+ scanner.skip( /\s*/ )
105
+ next if scanner.skip( CExtractorConstants::BARE_EXTENSION )
106
+ break unless scanner.skip( CExtractorConstants::ATTRIBUTE_CALL ) or scanner.check( /\[\s*\[/ )
107
+ break unless CExtractorDeclarator._skip_balanced( scanner )
108
+ end
109
+ end
110
+
111
+ end