ceedling 1.2.1 → 1.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (545) hide show
  1. checksums.yaml +4 -4
  2. data/GIT_COMMIT_SHA +1 -1
  3. data/README.md +11 -9
  4. data/Rakefile +2 -1
  5. data/assets/features/ceedling +1 -1
  6. data/assets/fixtures/test_source_file_duplicate_basenames/test_calc_typo.c +14 -0
  7. data/assets/fixtures/tests_with_duplicate_test_names/test_foo.c +21 -0
  8. data/assets/fixtures/tests_with_partials_coverage/src/private_macro.c +7 -0
  9. data/assets/fixtures/tests_with_partials_coverage/src/private_macro.h +5 -0
  10. data/assets/fixtures/tests_with_partials_coverage/src/tally.c +13 -0
  11. data/assets/fixtures/tests_with_partials_coverage/src/tally.h +4 -0
  12. data/assets/fixtures/tests_with_partials_coverage/test/test_private_macro.c +10 -0
  13. data/assets/fixtures/tests_with_partials_coverage/test/test_tally.c +9 -0
  14. data/bin/actionator.rb +6 -12
  15. data/bin/app_cfg.rb +14 -1
  16. data/bin/ceedling +13 -3
  17. data/bin/cli.rb +25 -6
  18. data/bin/cli_handler.rb +113 -73
  19. data/bin/cli_helper.rb +51 -78
  20. data/bin/installation_selector.rb +81 -0
  21. data/bin/launchinator.rb +69 -0
  22. data/bin/mixin_resolvinator.rb +26 -36
  23. data/bin/objects.yml +13 -0
  24. data/bin/path_validator.rb +25 -29
  25. data/bin/versionator.rb +47 -48
  26. data/ceedling.gemspec +19 -15
  27. data/docs/BreakingChanges.md +86 -1
  28. data/docs/Changelog.md +145 -3
  29. data/docs/KnownIssues.md +179 -6
  30. data/docs/ReleaseNotes.md +13 -0
  31. data/examples/wondrous_forest/README.md +29 -1
  32. data/examples/wondrous_forest/src/ForestUnits.h +23 -0
  33. data/examples/wondrous_forest/src/RainGauge.c +59 -0
  34. data/examples/wondrous_forest/src/RainGauge.h +39 -0
  35. data/examples/wondrous_forest/src/RainTipIsr.c +17 -0
  36. data/examples/wondrous_forest/src/RainTipIsr.h +14 -0
  37. data/examples/wondrous_forest/test/TestRainGauge.c +126 -0
  38. data/lib/ceedling/build_log_writer.rb +33 -0
  39. data/lib/ceedling/c_extractor/README.md +15 -7
  40. data/lib/ceedling/c_extractor/c_extractor.rb +25 -14
  41. data/lib/ceedling/c_extractor/c_extractor_code_text.rb +84 -54
  42. data/lib/ceedling/c_extractor/c_extractor_constants.rb +18 -7
  43. data/lib/ceedling/c_extractor/c_extractor_declarations.rb +319 -283
  44. data/lib/ceedling/c_extractor/c_extractor_declarator.rb +285 -0
  45. data/lib/ceedling/c_extractor/c_extractor_defined_type.rb +111 -0
  46. data/lib/ceedling/c_extractor/c_extractor_definitions.rb +174 -121
  47. data/lib/ceedling/c_extractor/c_extractor_functions.rb +191 -162
  48. data/lib/ceedling/c_extractor/c_extractor_preprocessing.rb +46 -55
  49. data/lib/ceedling/c_extractor/c_extractor_statement.rb +30 -0
  50. data/lib/ceedling/c_extractor/c_extractor_types.rb +63 -41
  51. data/lib/ceedling/c_extractor/c_module_edits.rb +48 -0
  52. data/lib/ceedling/c_identifier.rb +21 -0
  53. data/lib/ceedling/ceedling.h +8 -0
  54. data/lib/ceedling/config/build_root_policy.rb +70 -0
  55. data/lib/ceedling/config/configurator.rb +18 -19
  56. data/lib/ceedling/config/configurator_builder.rb +75 -28
  57. data/lib/ceedling/config/configurator_paths_validator.rb +179 -0
  58. data/lib/ceedling/config/configurator_plugins.rb +1 -1
  59. data/lib/ceedling/config/configurator_setup.rb +44 -33
  60. data/lib/ceedling/config/configurator_validator.rb +1 -110
  61. data/lib/ceedling/constants.rb +5 -1
  62. data/lib/ceedling/defaults.rb +35 -5
  63. data/lib/ceedling/dependencies/CACHE_SCHEMA.md +118 -0
  64. data/lib/ceedling/dependencies/README.md +18 -16
  65. data/lib/ceedling/dependencies/dependency_cache_store.rb +43 -21
  66. data/lib/ceedling/dependencies/dependency_hasher.rb +35 -1
  67. data/lib/ceedling/dependencies/dependency_tracker.rb +9 -3
  68. data/lib/ceedling/dependencies/dependinator.rb +13 -1
  69. data/lib/ceedling/diagnostics/DOCTOR.md +142 -0
  70. data/lib/ceedling/diagnostics/README.md +5 -0
  71. data/lib/ceedling/diagnostics/build_step_doctor.rb +110 -0
  72. data/lib/ceedling/diagnostics/duplicate_symbol_specialist.rb +108 -0
  73. data/lib/ceedling/diagnostics/guidance_phrases.rb +30 -0
  74. data/lib/ceedling/diagnostics/header_collision_guidance.rb +56 -0
  75. data/lib/ceedling/diagnostics/header_collision_specialist.rb +152 -0
  76. data/lib/ceedling/diagnostics/include_depth_specialist.rb +132 -0
  77. data/lib/ceedling/diagnostics/missing_symbol_specialist.rb +111 -0
  78. data/lib/ceedling/diagnostics/partial_name_specialist.rb +134 -0
  79. data/lib/ceedling/diagnostics/toolchain_output.rb +44 -0
  80. data/lib/ceedling/filename_extension.rb +7 -1
  81. data/lib/ceedling/filesystem/FILE_TREE.md +253 -0
  82. data/lib/ceedling/filesystem/PATH_HANDLING.md +360 -0
  83. data/lib/ceedling/filesystem/README.md +46 -0
  84. data/lib/ceedling/filesystem/build_roots.rb +105 -0
  85. data/lib/ceedling/filesystem/build_subpath.rb +187 -0
  86. data/lib/ceedling/filesystem/destination_collision.rb +25 -0
  87. data/lib/ceedling/{file_finder.rb → filesystem/file_finder.rb} +177 -156
  88. data/lib/ceedling/filesystem/file_finder_helper.rb +154 -0
  89. data/lib/ceedling/filesystem/file_path_collection_utils.rb +183 -0
  90. data/lib/ceedling/{file_path_utils.rb → filesystem/file_path_utils.rb} +200 -167
  91. data/lib/ceedling/{file_system_wrapper.rb → filesystem/file_system_wrapper.rb} +6 -5
  92. data/lib/ceedling/filesystem/file_tree.rb +241 -0
  93. data/lib/ceedling/{file_wrapper.rb → filesystem/file_wrapper.rb} +149 -65
  94. data/lib/ceedling/filesystem/path_exclusions.rb +30 -0
  95. data/lib/ceedling/{path_matcher.rb → filesystem/path_matcher.rb} +48 -23
  96. data/lib/ceedling/{path_mirror.rb → filesystem/path_mirror.rb} +19 -18
  97. data/lib/ceedling/filesystem/path_spellings.rb +55 -0
  98. data/lib/ceedling/filesystem/project_paths.rb +184 -0
  99. data/lib/ceedling/filesystem/test_build_layout.rb +114 -0
  100. data/lib/ceedling/filesystem/win_long_paths.rb +153 -0
  101. data/lib/ceedling/filesystem/win_path_limit.rb +83 -0
  102. data/lib/ceedling/filesystem/win_path_prober.rb +52 -0
  103. data/lib/ceedling/filesystem/working_dir.rb +40 -0
  104. data/lib/ceedling/generators/generator.rb +32 -70
  105. data/lib/ceedling/generators/generator_helper.rb +0 -44
  106. data/lib/ceedling/generators/generator_mocks.rb +5 -0
  107. data/lib/ceedling/generators/generator_partials.rb +306 -244
  108. data/lib/ceedling/generators/generator_test_results_backtrace.rb +7 -7
  109. data/lib/ceedling/generators/generator_test_runner.rb +5 -8
  110. data/lib/ceedling/generators/partial_header_writer.rb +95 -0
  111. data/lib/ceedling/generators/partial_source_writer.rb +137 -0
  112. data/lib/ceedling/handoff.rb +121 -0
  113. data/lib/ceedling/includes/header_search.rb +225 -0
  114. data/lib/ceedling/includes/include_factory.rb +9 -12
  115. data/lib/ceedling/includes/include_pathinator.rb +112 -33
  116. data/lib/ceedling/includes/includes.rb +150 -38
  117. data/lib/ceedling/installation.rb +92 -0
  118. data/lib/ceedling/library_resolver.rb +99 -0
  119. data/lib/ceedling/objects.yml +112 -6
  120. data/lib/ceedling/partials/README.md +110 -16
  121. data/lib/ceedling/partials/carry_plan.rb +71 -0
  122. data/lib/ceedling/partials/definition_head.rb +74 -0
  123. data/lib/ceedling/partials/include_groups.rb +37 -0
  124. data/lib/ceedling/partials/interface_extras.rb +25 -0
  125. data/lib/ceedling/partials/partializer.rb +603 -124
  126. data/lib/ceedling/partials/partializer_config.rb +8 -1
  127. data/lib/ceedling/partials/partializer_helper.rb +851 -145
  128. data/lib/ceedling/partials/partializer_reconciler.rb +174 -0
  129. data/lib/ceedling/partials/partializer_utils.rb +89 -109
  130. data/lib/ceedling/partials/partials.rb +153 -10
  131. data/lib/ceedling/partials/type_macros.rb +126 -0
  132. data/lib/ceedling/plugins/report_log_writer_plugin.rb +3 -5
  133. data/lib/ceedling/preprocess/README.md +43 -33
  134. data/lib/ceedling/preprocess/preprocessinator.rb +100 -186
  135. data/lib/ceedling/preprocess/preprocessinator_code_finder.rb +65 -72
  136. data/lib/ceedling/preprocess/preprocessinator_file_assembler.rb +32 -76
  137. data/lib/ceedling/preprocess/preprocessinator_includes_handler.rb +1 -1
  138. data/lib/ceedling/preprocess/preprocessinator_line_marker_includes_extractor.rb +1 -1
  139. data/lib/ceedling/preprocess/preprocessinator_reconstructor.rb +51 -14
  140. data/lib/ceedling/rake_app/rakefile_component_resolver.rb +10 -17
  141. data/lib/ceedling/rakefile.rb +15 -1
  142. data/lib/ceedling/rakefiles/base/tasks_base.rake +1 -1
  143. data/lib/ceedling/rakefiles/release/rules_release.rake +4 -7
  144. data/lib/ceedling/release_invoker/release_build_executor.rb +33 -44
  145. data/lib/ceedling/release_invoker/release_build_planner.rb +14 -6
  146. data/lib/ceedling/reportinator.rb +3 -4
  147. data/lib/ceedling/setupinator.rb +104 -87
  148. data/lib/ceedling/test_context_extractor.rb +5 -1
  149. data/lib/ceedling/test_invoker/HEADER_COLLISIONS.md +21 -7
  150. data/lib/ceedling/test_invoker/PIPELINE.md +62 -19
  151. data/lib/ceedling/test_invoker/README.md +1 -1
  152. data/lib/ceedling/test_invoker/derived_search_path_notices.rb +45 -0
  153. data/lib/ceedling/test_invoker/mock_locator.rb +175 -10
  154. data/lib/ceedling/test_invoker/partial_files_preprocessinator.rb +181 -0
  155. data/lib/ceedling/test_invoker/partials_manager.rb +271 -302
  156. data/lib/ceedling/test_invoker/standin_headerinator.rb +19 -17
  157. data/lib/ceedling/test_invoker/test_bare_includes_extractinator.rb +26 -3
  158. data/lib/ceedling/test_invoker/test_build_executor.rb +358 -234
  159. data/lib/ceedling/test_invoker/test_build_planner.rb +46 -33
  160. data/lib/ceedling/test_invoker/test_build_setup.rb +43 -18
  161. data/lib/ceedling/test_invoker/test_build_validations.rb +35 -47
  162. data/lib/ceedling/test_invoker/test_derived_search_paths.rb +189 -0
  163. data/lib/ceedling/test_invoker/test_file_preprocessinator.rb +2 -3
  164. data/lib/ceedling/test_invoker/test_includes_reconcilinator.rb +1 -1
  165. data/lib/ceedling/test_invoker/test_invoker.rb +6 -1
  166. data/lib/ceedling/test_invoker/test_invoker_types.rb +28 -20
  167. data/lib/ceedling/test_invoker/test_pipeline_helpers.rb +6 -4
  168. data/lib/ceedling/test_invoker/test_pipeline_manager.rb +25 -8
  169. data/lib/ceedling/test_invoker/test_runner_generatinator.rb +31 -3
  170. data/lib/ceedling/test_invoker/test_search_paths.rb +30 -8
  171. data/lib/ceedling/test_invoker/test_source_file_directive_resolver.rb +40 -20
  172. data/lib/ceedling/test_invoker/test_substitutions.rb +72 -0
  173. data/lib/ceedling/tools/shell_quoting.rb +45 -0
  174. data/lib/ceedling/{tool_executor.rb → tools/tool_executor.rb} +9 -3
  175. data/lib/ceedling/tools/tool_quoting.rb +79 -0
  176. data/lib/ceedling/{tool_validator.rb → tools/tool_validator.rb} +18 -7
  177. data/lib/ceedling/yaml_wrapper.rb +3 -2
  178. data/lib/version.rb +1 -1
  179. data/plugins/bullseye/bullseye.rake +1 -3
  180. data/plugins/bullseye/config/defaults_bullseye.rb +1 -1
  181. data/plugins/bullseye/lib/bullseye.rb +24 -9
  182. data/plugins/command_hooks/lib/command_hooks.rb +1 -1
  183. data/plugins/cppcheck/config/defaults_cppcheck.rb +1 -1
  184. data/plugins/dependencies/config/defaults.yml +6 -6
  185. data/plugins/dependencies/dependencies.rake +4 -1
  186. data/plugins/dependencies/lib/dependencies.rb +18 -8
  187. data/plugins/dependencies/lib/dependency_spec.rb +17 -5
  188. data/plugins/fff/lib/fff.rb +79 -46
  189. data/plugins/fff/lib/fff_mock_generator.rb +12 -9
  190. data/plugins/fff/spec/fff_cmock_wrapper_spec.rb +262 -0
  191. data/plugins/fff/spec/fff_mock_header_generator_spec.rb +9 -0
  192. data/plugins/fff/spec/fff_mock_source_generator_spec.rb +20 -0
  193. data/plugins/gcov/config/defaults_gcov.rb +1 -1
  194. data/plugins/gcov/lib/console_reportinator.rb +28 -36
  195. data/plugins/gcov/lib/gcov.rb +9 -2
  196. data/plugins/gcov/lib/gcovr_reportinator.rb +8 -40
  197. data/plugins/gcov/lib/gcovr_thresholds.rb +74 -0
  198. data/plugins/gcov/lib/reportgenerator_reportinator.rb +3 -2
  199. data/plugins/module_generator/lib/module_generator.rb +3 -3
  200. data/plugins/report_tests_teamcity_stdout/lib/report_tests_teamcity_stdout.rb +53 -80
  201. data/plugins/sanitize/lib/sanitize_records.rb +3 -6
  202. data/plugins/valgrind/lib/valgrind.rb +14 -7
  203. data/site-local/404.html +2 -2
  204. data/site-local/assets/javascripts/{bundle.c21346df.min.js → bundle.a5f9d56c.min.js} +1 -1
  205. data/site-local/assets/javascripts/{bundle.c21346df.min.js.map → bundle.a5f9d56c.min.js.map} +2 -2
  206. data/site-local/configuration/environment-vars.html +2 -2
  207. data/site-local/configuration/global-collections.html +3 -3
  208. data/site-local/configuration/index.html +2 -2
  209. data/site-local/configuration/loading.html +2 -2
  210. data/site-local/configuration/mixins.html +2 -2
  211. data/site-local/configuration/parallel-builds.html +2 -2
  212. data/site-local/configuration/project-file.html +2 -2
  213. data/site-local/configuration/reference/cexception.html +2 -2
  214. data/site-local/configuration/reference/cmock.html +7 -3
  215. data/site-local/configuration/reference/defines.html +2 -2
  216. data/site-local/configuration/reference/environment.html +2 -2
  217. data/site-local/configuration/reference/extension.html +2 -2
  218. data/site-local/configuration/reference/files.html +65 -12
  219. data/site-local/configuration/reference/flags.html +2 -2
  220. data/site-local/configuration/reference/index.html +2 -2
  221. data/site-local/configuration/reference/libraries.html +23 -5
  222. data/site-local/configuration/reference/mixins.html +2 -2
  223. data/site-local/configuration/reference/partials.html +84 -2
  224. data/site-local/configuration/reference/paths.html +36 -8
  225. data/site-local/configuration/reference/plugins.html +2 -2
  226. data/site-local/configuration/reference/project.html +264 -12
  227. data/site-local/configuration/reference/release-build.html +4 -2
  228. data/site-local/configuration/reference/test-build.html +2 -2
  229. data/site-local/configuration/reference/test-runner.html +2 -2
  230. data/site-local/configuration/reference/tools.html +58 -4
  231. data/site-local/configuration/reference/unity.html +2 -2
  232. data/site-local/configuration/which-ceedling.html +379 -19
  233. data/site-local/development/index.html +2 -2
  234. data/site-local/development/plugins/configuration.html +2 -2
  235. data/site-local/development/plugins/index.html +2 -2
  236. data/site-local/development/plugins/plugin-subclass.html +5 -4
  237. data/site-local/development/plugins/rake-tasks.html +2 -2
  238. data/site-local/development/releases.html +7 -3
  239. data/site-local/development/workflow.html +50 -45
  240. data/site-local/getting-started/builds.html +4 -2
  241. data/site-local/getting-started/command-line.html +58 -6
  242. data/site-local/getting-started/example-projects/cipher-quest.html +2 -2
  243. data/site-local/getting-started/example-projects/index.html +2 -2
  244. data/site-local/getting-started/example-projects/temp-sensor.html +2 -2
  245. data/site-local/getting-started/example-projects/wondrous-forest.html +10 -2
  246. data/site-local/getting-started/index.html +2 -2
  247. data/site-local/getting-started/installation.html +2 -2
  248. data/site-local/getting-started/quick-start.html +2 -2
  249. data/site-local/help.html +2 -2
  250. data/site-local/index.html +2 -2
  251. data/site-local/overview/build-system.html +2 -2
  252. data/site-local/overview/index.html +2 -2
  253. data/site-local/overview/test-environments.html +2 -2
  254. data/site-local/overview/tools-and-frameworks.html +2 -2
  255. data/site-local/plugins/beep.html +2 -2
  256. data/site-local/plugins/bullseye/index.html +45 -38
  257. data/site-local/plugins/bullseye/licensing.html +2 -2
  258. data/site-local/plugins/command-hooks.html +4 -4
  259. data/site-local/plugins/compile-commands-json-db.html +2 -2
  260. data/site-local/plugins/cppcheck.html +2 -2
  261. data/site-local/plugins/dependencies.html +8 -5
  262. data/site-local/plugins/fff.html +58 -13
  263. data/site-local/plugins/gcov/examples.html +2 -2
  264. data/site-local/plugins/gcov/gcovr.html +23 -14
  265. data/site-local/plugins/gcov/index.html +2 -2
  266. data/site-local/plugins/gcov/overview.html +2 -2
  267. data/site-local/plugins/gcov/reportgenerator.html +18 -14
  268. data/site-local/plugins/gcov/reporting.html +2 -2
  269. data/site-local/plugins/gcov/setup.html +4 -3
  270. data/site-local/plugins/gcov/tool-versions.html +2 -2
  271. data/site-local/plugins/gcov/troubleshooting.html +2 -2
  272. data/site-local/plugins/index.html +2 -2
  273. data/site-local/plugins/module-generator.html +2 -2
  274. data/site-local/plugins/report-build-warnings-log.html +2 -2
  275. data/site-local/plugins/report-tests-gtestlike-stdout.html +2 -2
  276. data/site-local/plugins/report-tests-ide-stdout.html +2 -2
  277. data/site-local/plugins/report-tests-log-factory.html +2 -2
  278. data/site-local/plugins/report-tests-pretty-stdout.html +2 -2
  279. data/site-local/plugins/report-tests-raw-output-log.html +5 -3
  280. data/site-local/plugins/report-tests-teamcity-stdout.html +8 -5
  281. data/site-local/plugins/sanitize.html +9 -8
  282. data/site-local/plugins/valgrind.html +10 -9
  283. data/site-local/project/index.html +2 -2
  284. data/site-local/project/release-history.html +2 -2
  285. data/site-local/project/sbom.html +2 -2
  286. data/site-local/project/upgrade.html +5 -2
  287. data/site-local/reference/build-directives.html +2 -2
  288. data/site-local/reference/command-line.html +11 -4
  289. data/site-local/reference/environment-vars.html +2 -2
  290. data/site-local/reference/gcov-plugin.html +2 -2
  291. data/site-local/reference/global-collections.html +12 -12
  292. data/site-local/reference/index.html +2 -2
  293. data/site-local/reference/partials-macros.html +47 -2
  294. data/site-local/reference/project-configuration.html +2 -2
  295. data/site-local/sitemap.xml.gz +0 -0
  296. data/site-local/snapshot/examples/cipher_quest/index.html +2 -2
  297. data/site-local/snapshot/examples/temp_sensor/index.html +2 -2
  298. data/site-local/snapshot/examples/wondrous_forest/index.html +72 -15
  299. data/site-local/snapshot/plugins/bullseye/config/defaults_bullseye.rb +1 -1
  300. data/site-local/snapshot/plugins/gcov/config/defaults_gcov.rb +1 -1
  301. data/site-local/testing-guide/build-directives.html +2 -2
  302. data/site-local/testing-guide/conventions.html +113 -15
  303. data/site-local/testing-guide/frameworks.html +2 -2
  304. data/site-local/testing-guide/index.html +2 -2
  305. data/site-local/testing-guide/partials/configuration.html +31 -4
  306. data/site-local/testing-guide/partials/conventions.html +509 -8
  307. data/site-local/testing-guide/partials/directives.html +4 -3
  308. data/site-local/testing-guide/partials/example.html +2 -2
  309. data/site-local/testing-guide/partials/index.html +2 -2
  310. data/site-local/testing-guide/partials/overview.html +30 -12
  311. data/site-local/testing-guide/partials/variables.html +169 -4
  312. data/site-local/testing-guide/test-cases.html +2 -2
  313. data/site-local/testing-guide/test-sample.html +2 -2
  314. data/site-local/testing-guide/test-suite-anatomy.html +2 -2
  315. data/spec/integration/actionator_file_operations_spec.rb +91 -1
  316. data/spec/integration/build_step_doctor_spec.rb +270 -0
  317. data/spec/integration/c_extractor_composition_spec.rb +254 -4
  318. data/spec/integration/compile_commands_json_db_spec.rb +1 -1
  319. data/spec/integration/configurator_validation_spec.rb +1 -1
  320. data/spec/integration/dependencies/dependency_tracker_cache_hardening_spec.rb +26 -0
  321. data/spec/integration/dependencies/dependency_tracker_core_spec.rb +22 -0
  322. data/spec/integration/includes_extraction_spec.rb +27 -14
  323. data/spec/integration/launcher_handoff_spec.rb +297 -0
  324. data/spec/integration/mixin_loading_spec.rb +1 -1
  325. data/spec/integration/module_generator_spec.rb +3 -3
  326. data/spec/integration/nested_test_artifacts_spec.rb +99 -0
  327. data/spec/integration/partial_files_preprocessing_spec.rb +128 -0
  328. data/spec/integration/partials_carry_spec.rb +520 -0
  329. data/spec/integration/partials_declarations_spec.rb +655 -0
  330. data/spec/integration/partials_fallback_preprocessing_spec.rb +65 -0
  331. data/spec/integration/partials_function_pointers_spec.rb +277 -0
  332. data/spec/integration/partials_header_composition_spec.rb +268 -35
  333. data/spec/integration/partials_macro_decorators_spec.rb +267 -0
  334. data/spec/integration/partials_module_resolution_spec.rb +33 -23
  335. data/spec/integration/partials_symbol_linkage_spec.rb +13 -0
  336. data/spec/integration/path_intake_scenarios_spec.rb +101 -0
  337. data/spec/integration/path_length_reporting_spec.rb +64 -0
  338. data/spec/integration/path_scenarios_spec.rb +399 -0
  339. data/spec/integration/quote_include_isolator_spec.rb +57 -1
  340. data/spec/integration/report_build_warnings_log_spec.rb +1 -1
  341. data/spec/integration/report_tests_log_factory_spec.rb +1 -1
  342. data/spec/integration/test_build_parallel_barrier_spec.rb +1 -1
  343. data/spec/integration/test_executable_manifest_spec.rb +1 -1
  344. data/spec/integration/test_includes_extractinator_spec.rb +69 -3
  345. data/spec/integration/test_naming_spec.rb +201 -0
  346. data/spec/integration/test_source_file_checks_spec.rb +168 -0
  347. data/spec/integration/tool_executor_spec.rb +1 -1
  348. data/spec/integration/tool_validator_spec.rb +3 -3
  349. data/spec/integration/upgrade_docs_spec.rb +84 -0
  350. data/spec/integration/vendor_copy_transient_io_retry_spec.rb +74 -5
  351. data/spec/integration/win_long_paths_probe_spec.rb +46 -0
  352. data/spec/integration/win_path_limit_spec.rb +53 -0
  353. data/spec/integration/windows_registry_query_tool_spec.rb +41 -0
  354. data/spec/support/file_tree_helper.rb +88 -0
  355. data/spec/support/integration/configurator_integration_helper.rb +14 -9
  356. data/spec/support/integration/dependency_tracker_integration_helper.rb +1 -1
  357. data/spec/support/integration/partial_files_harness.rb +181 -0
  358. data/spec/support/integration/partials_generation_integration_helper.rb +239 -143
  359. data/spec/support/integration/path_scenario_harness.rb +175 -0
  360. data/spec/support/integration/spec_integration_helper.rb +9 -4
  361. data/spec/support/integration/test_includes_harness.rb +69 -37
  362. data/spec/support/integration/tool_executor_integration_helper.rb +14 -2
  363. data/spec/support/spec_helper.rb +2 -0
  364. data/spec/support/system/spec_system_helper.rb +7 -6
  365. data/spec/support/system/system_context.rb +21 -3
  366. data/spec/support/working_dir_tracking.rb +49 -0
  367. data/spec/system/build_output_mirroring_spec.rb +2 -2
  368. data/spec/system/bullseye_deployment_spec.rb +2 -0
  369. data/spec/system/conditional_mock_includes_spec.rb +1 -1
  370. data/spec/system/delta_builds_spec.rb +163 -23
  371. data/spec/system/encoding_stress_spec.rb +4 -4
  372. data/spec/system/example_wondrous_forest_spec.rb +2 -2
  373. data/spec/system/gcov_deployment_spec.rb +3 -0
  374. data/spec/system/header_include_path_validation_spec.rb +4 -4
  375. data/spec/system/header_search_paths_spec.rb +1083 -0
  376. data/spec/system/launcher_handoff_spec.rb +82 -0
  377. data/spec/system/mock_include_folders_spec.rb +212 -0
  378. data/spec/system/mockable_header_reassembly_spec.rb +184 -0
  379. data/spec/system/parent_directory_reference_spec.rb +5 -3
  380. data/spec/system/partials_carry_spec.rb +581 -0
  381. data/spec/system/partials_delta_builds_spec.rb +280 -0
  382. data/spec/system/partials_function_pointers_spec.rb +106 -0
  383. data/spec/system/partials_macro_decorators_spec.rb +127 -0
  384. data/spec/system/partials_module_disambiguation_spec.rb +125 -0
  385. data/spec/system/path_handling_probes_spec.rb +196 -0
  386. data/spec/system/pinned_thread_count_spec.rb +4 -4
  387. data/spec/system/preprocessing_fallback_conditionals_spec.rb +1 -1
  388. data/spec/system/preprocessing_parameterized_tests_spec.rb +1 -1
  389. data/spec/system/rake_release_task_path_disambiguation_spec.rb +6 -6
  390. data/spec/system/rake_test_task_path_disambiguation_spec.rb +85 -0
  391. data/spec/system/short_build_paths_spec.rb +87 -0
  392. data/spec/system/sibling_header_collision_spec.rb +30 -6
  393. data/spec/system/special_path_characters_spec.rb +86 -0
  394. data/spec/system/support/bullseye_common_test_cases.rb +42 -0
  395. data/spec/system/support/common_test_cases.rb +23 -21
  396. data/spec/system/support/gcov_common_test_cases.rb +37 -9
  397. data/spec/system/support/gcov_partials_test_cases.rb +48 -0
  398. data/spec/system/support/sanitize_common_test_cases.rb +2 -2
  399. data/spec/system/support/valgrind_common_test_cases.rb +12 -12
  400. data/spec/system/test_build_layout_spec.rb +209 -0
  401. data/spec/system/test_pipeline_stop_points_spec.rb +4 -4
  402. data/spec/system/test_runner_system_include_spec.rb +1 -1
  403. data/spec/system/test_source_file_directive_spec.rb +64 -5
  404. data/spec/units/bin/actionator_spec.rb +14 -17
  405. data/spec/units/bin/app_cfg_spec.rb +37 -0
  406. data/spec/units/bin/cli_handler_spec.rb +282 -6
  407. data/spec/units/bin/cli_helper_spec.rb +116 -45
  408. data/spec/units/bin/installation_selector_spec.rb +114 -0
  409. data/spec/units/bin/launchinator_spec.rb +171 -0
  410. data/spec/units/bin/path_validator_spec.rb +10 -0
  411. data/spec/units/bin/versionator_spec.rb +38 -6
  412. data/spec/units/build_log_writer_spec.rb +57 -0
  413. data/spec/units/c_extractor/c_extractor_code_text_spec.rb +67 -10
  414. data/spec/units/c_extractor/c_extractor_declarations_spec.rb +501 -4
  415. data/spec/units/c_extractor/c_extractor_declarator_spec.rb +245 -0
  416. data/spec/units/c_extractor/c_extractor_defined_type_spec.rb +45 -0
  417. data/spec/units/c_extractor/c_extractor_definitions_spec.rb +163 -3
  418. data/spec/units/c_extractor/c_extractor_functions_spec.rb +462 -21
  419. data/spec/units/c_extractor/c_extractor_preprocessing_spec.rb +39 -0
  420. data/spec/units/c_extractor/c_extractor_spec.rb +4 -4
  421. data/spec/units/c_extractor/c_extractor_types_spec.rb +163 -0
  422. data/spec/units/c_identifier_spec.rb +35 -0
  423. data/spec/units/config/build_root_policy_spec.rb +61 -0
  424. data/spec/units/config/configurator_builder_spec.rb +61 -6
  425. data/spec/units/config/configurator_paths_validator_spec.rb +292 -0
  426. data/spec/units/config/configurator_setup_spec.rb +80 -68
  427. data/spec/units/config/configurator_spec.rb +54 -6
  428. data/spec/units/config/configurator_validator_spec.rb +1 -172
  429. data/spec/units/dependencies/dependency_cache_store_spec.rb +98 -2
  430. data/spec/units/dependencies/dependency_debug_tree_spec.rb +1 -1
  431. data/spec/units/dependencies/dependency_hasher_spec.rb +42 -1
  432. data/spec/units/dependencies/dependency_path_normalizer_spec.rb +1 -1
  433. data/spec/units/dependencies/dependency_tracker_spec.rb +28 -1
  434. data/spec/units/dependencies/dependinator_spec.rb +17 -2
  435. data/spec/units/diagnostics/build_step_doctor_spec.rb +170 -0
  436. data/spec/units/diagnostics/duplicate_symbol_specialist_spec.rb +117 -0
  437. data/spec/units/diagnostics/header_collision_specialist_spec.rb +267 -0
  438. data/spec/units/diagnostics/include_depth_specialist_spec.rb +137 -0
  439. data/spec/units/diagnostics/missing_symbol_specialist_spec.rb +154 -0
  440. data/spec/units/diagnostics/partial_name_specialist_spec.rb +129 -0
  441. data/spec/units/diagnostics/toolchain_output_spec.rb +86 -0
  442. data/spec/units/encodinator_spec.rb +3 -4
  443. data/spec/units/filename_extension_spec.rb +11 -0
  444. data/spec/units/filesystem/build_roots_spec.rb +131 -0
  445. data/spec/units/filesystem/build_subpath_spec.rb +235 -0
  446. data/spec/units/filesystem/destination_collision_spec.rb +30 -0
  447. data/spec/units/{file_finder_helper_spec.rb → filesystem/file_finder_helper_spec.rb} +126 -1
  448. data/spec/units/filesystem/file_finder_spec.rb +845 -0
  449. data/spec/units/{file_path_collection_utils_spec.rb → filesystem/file_path_collection_utils_spec.rb} +181 -1
  450. data/spec/units/{file_path_utils_spec.rb → filesystem/file_path_utils_spec.rb} +435 -185
  451. data/spec/units/filesystem/file_system_wrapper_spec.rb +33 -0
  452. data/spec/units/filesystem/file_tree_spec.rb +511 -0
  453. data/spec/units/filesystem/file_tree_windows_spec.rb +78 -0
  454. data/spec/units/{file_wrapper_spec.rb → filesystem/file_wrapper_spec.rb} +286 -18
  455. data/spec/units/{path_matcher_spec.rb → filesystem/path_matcher_spec.rb} +48 -1
  456. data/spec/units/{path_mirror_spec.rb → filesystem/path_mirror_spec.rb} +32 -4
  457. data/spec/units/filesystem/project_paths_spec.rb +147 -0
  458. data/spec/units/filesystem/test_build_layout_spec.rb +216 -0
  459. data/spec/units/filesystem/win_long_paths_spec.rb +204 -0
  460. data/spec/units/filesystem/win_path_prober_spec.rb +158 -0
  461. data/spec/units/filesystem/working_dir_spec.rb +71 -0
  462. data/spec/units/generators/generator_helper_spec.rb +0 -60
  463. data/spec/units/generators/generator_mocks_spec.rb +13 -0
  464. data/spec/units/generators/generator_partials_spec.rb +656 -55
  465. data/spec/units/generators/generator_spec.rb +38 -6
  466. data/spec/units/generators/generator_test_results_backtrace_spec.rb +50 -46
  467. data/spec/units/generators/generator_test_results_spec.rb +1 -1
  468. data/spec/units/generators/generator_test_runner_spec.rb +9 -5
  469. data/spec/units/generators/partial_source_writer_spec.rb +129 -0
  470. data/spec/units/handoff_spec.rb +205 -0
  471. data/spec/units/includes/header_search_spec.rb +406 -0
  472. data/spec/units/includes/include_factory_spec.rb +23 -6
  473. data/spec/units/includes/include_pathinator_spec.rb +118 -8
  474. data/spec/units/includes/include_spec.rb +14 -0
  475. data/spec/units/includes/includes_spec.rb +176 -19
  476. data/spec/units/installation_spec.rb +228 -0
  477. data/spec/units/library_resolver_spec.rb +157 -0
  478. data/spec/units/loginator_spec.rb +31 -0
  479. data/spec/units/mock_locator_spec.rb +275 -6
  480. data/spec/units/partials/include_groups_spec.rb +42 -0
  481. data/spec/units/partials/partializer_config_spec.rb +32 -0
  482. data/spec/units/partials/partializer_helper_carry_spec.rb +661 -0
  483. data/spec/units/partials/partializer_helper_interface_extras_spec.rb +396 -0
  484. data/spec/units/partials/partializer_helper_spec.rb +529 -277
  485. data/spec/units/partials/partializer_reconciler_spec.rb +661 -0
  486. data/spec/units/partials/partializer_spec.rb +1579 -270
  487. data/spec/units/partials/partializer_utils_spec.rb +269 -232
  488. data/spec/units/partials/partials_rename_spec.rb +160 -0
  489. data/spec/units/partials_manager_spec.rb +561 -251
  490. data/spec/units/plugins/bullseye_spec.rb +49 -2
  491. data/spec/units/plugins/console_reportinator_spec.rb +73 -26
  492. data/spec/units/plugins/dependencies_spec.rb +33 -7
  493. data/spec/units/plugins/dependency_spec_spec.rb +17 -0
  494. data/spec/units/plugins/gcov_spec.rb +28 -3
  495. data/spec/units/plugins/gcovr_reportinator_spec.rb +19 -47
  496. data/spec/units/plugins/gcovr_thresholds_spec.rb +95 -0
  497. data/spec/units/plugins/module_generator_spec.rb +5 -5
  498. data/spec/units/plugins/report_build_warnings_log_spec.rb +3 -3
  499. data/spec/units/plugins/report_log_writer_plugin_spec.rb +10 -1
  500. data/spec/units/plugins/report_tests_raw_output_log_spec.rb +13 -2
  501. data/spec/units/plugins/report_tests_teamcity_stdout_spec.rb +77 -3
  502. data/spec/units/plugins/reportgenerator_reportinator_spec.rb +52 -4
  503. data/spec/units/plugins/sanitize_records_spec.rb +3 -1
  504. data/spec/units/plugins/sanitize_spec.rb +1 -1
  505. data/spec/units/plugins/valgrind_spec.rb +23 -8
  506. data/spec/units/preprocess/preprocessinator_code_finder_spec.rb +73 -10
  507. data/spec/units/preprocess/preprocessinator_comment_stripper_spec.rb +1 -1
  508. data/spec/units/preprocess/preprocessinator_file_assembler_spec.rb +125 -37
  509. data/spec/units/preprocess/preprocessinator_includes_handler_spec.rb +15 -0
  510. data/spec/units/preprocess/preprocessinator_reconstructor_spec.rb +197 -0
  511. data/spec/units/preprocess/preprocessinator_spec.rb +153 -95
  512. data/spec/units/rake_app/rakefile_component_resolver_spec.rb +21 -0
  513. data/spec/units/release_build_executor_spec.rb +53 -14
  514. data/spec/units/release_build_planner_spec.rb +15 -3
  515. data/spec/units/reportinator_spec.rb +5 -5
  516. data/spec/units/setupinator_spec.rb +51 -0
  517. data/spec/units/standin_headerinator_spec.rb +55 -9
  518. data/spec/units/test_build_executor_spec.rb +842 -166
  519. data/spec/units/test_build_planner_spec.rb +205 -15
  520. data/spec/units/test_build_setup_spec.rb +179 -30
  521. data/spec/units/test_context_extractor_spec.rb +36 -2
  522. data/spec/units/test_derived_search_paths_spec.rb +259 -0
  523. data/spec/units/test_file_preprocessinator_spec.rb +17 -1
  524. data/spec/units/test_includes_extractinator_spec.rb +61 -9
  525. data/spec/units/test_invoker/objects_wiring_spec.rb +24 -4
  526. data/spec/units/test_invoker/partial_files_preprocessinator_spec.rb +264 -0
  527. data/spec/units/test_invoker/test_substitutions_spec.rb +122 -0
  528. data/spec/units/test_invoker_spec.rb +14 -1
  529. data/spec/units/test_invoker_types_spec.rb +8 -7
  530. data/spec/units/test_pipeline_manager_spec.rb +54 -13
  531. data/spec/units/test_runner_generatinator_spec.rb +93 -1
  532. data/spec/units/test_search_paths_spec.rb +73 -5
  533. data/spec/units/test_source_file_directive_resolver_spec.rb +38 -7
  534. data/spec/units/tools/default_tools_quoting_spec.rb +117 -0
  535. data/spec/units/tools/shell_quoting_spec.rb +76 -0
  536. data/spec/units/{tool_executor_helper_spec.rb → tools/tool_executor_helper_spec.rb} +1 -1
  537. data/spec/units/{tool_executor_spec.rb → tools/tool_executor_spec.rb} +27 -1
  538. data/spec/units/{tool_validator_spec.rb → tools/tool_validator_spec.rb} +110 -1
  539. data/spec/units/windows_registry_query_tool_spec.rb +53 -0
  540. data/spec/units/yaml_wrapper_spec.rb +11 -0
  541. metadata +265 -36
  542. data/lib/ceedling/file_finder_helper.rb +0 -127
  543. data/lib/ceedling/file_path_collection_utils.rb +0 -164
  544. data/spec/units/file_finder_spec.rb +0 -495
  545. /data/lib/ceedling/{tool_executor_helper.rb → tools/tool_executor_helper.rb} +0 -0
@@ -0,0 +1,175 @@
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
+ # Runs a project layout through configuration, collection, build-path mapping, and the
9
+ # lookups that invert that mapping, without compiling anything.
10
+ #
11
+ # A scenario is a workspace: the project in `app/`, with siblings beside it (`shared/`,
12
+ # `vendor/`) for paths that reach outside the project, and a separate directory elsewhere
13
+ # for paths far outside it, as a vendor SDK installed at a drive's root is. YAML may name
14
+ # absolute paths with `%{ws}`, `%{app}` and `%{far}`. The workspace is resolved through File.realpath first, so a
15
+ # system temp directory behind a symlink (macOS's /tmp) doesn't add a second spelling.
16
+ #
17
+ # Test preprocessing is off, so no preprocessor is probed, and nothing is built.
18
+
19
+ require 'tmpdir'
20
+ require 'fileutils'
21
+ require 'configurator_integration_helper'
22
+ require 'ceedling/filesystem/file_path_utils'
23
+ require 'ceedling/filesystem/test_build_layout'
24
+ require 'ceedling/filesystem/file_finder'
25
+ require 'ceedling/filesystem/file_finder_helper'
26
+ require 'ceedling/test_invoker/test_build_setup'
27
+ require 'ceedling/test_invoker/test_invoker_types'
28
+
29
+ module PathScenarioHarness
30
+ include ConfiguratorIntegrationHelpers
31
+
32
+ # Runs each test of a batch in turn, in place of the thread pool
33
+ class SerialBatchinator
34
+ def exec(things:, **_options)
35
+ things.each { |thing| yield thing }
36
+ end
37
+ end
38
+
39
+ # A root spelled each way a project file might, for one place in the workspace
40
+ ROOT_SPELLINGS = {
41
+ plain: ->(root, **) { root },
42
+ dot_slash: ->(root, **) { "./#{root}" },
43
+ absolute: ->(root, app:, **) { File.join( app, root ) },
44
+ backslash: ->(root, **) { root.tr( '/', '\\' ) },
45
+ symlink: ->(root, ws:, **) { File.join( ws, 'link', root ) }
46
+ }.freeze
47
+
48
+ # Runs the block in a workspace holding `files` (paths relative to the workspace), from
49
+ # `cwd` within it, with `far` files in a directory outside the workspace. A `link`
50
+ # symlink to `app/` is made when `symlink` is set.
51
+ def in_workspace(files, cwd: 'app', symlink: false, far: {})
52
+ Dir.mktmpdir do |dir|
53
+ Dir.mktmpdir do |far_dir|
54
+ ws = File.realpath( dir )
55
+ @far = File.join( File.realpath( far_dir ), 'deep', 'sdk' )
56
+ write_files( ws, files )
57
+ write_files( @far, far )
58
+ FileUtils.mkdir_p( File.join( ws, 'app' ) )
59
+ File.symlink( File.join( ws, 'app' ), File.join( ws, 'link' ) ) if symlink
60
+
61
+ Dir.chdir( File.join( ws, cwd ) ) { yield ws, File.join( ws, 'app' ) }
62
+ end
63
+ end
64
+ end
65
+
66
+ def write_files(root, files)
67
+ files.each do |path, content|
68
+ FileUtils.mkdir_p( File.join( root, File.dirname( path ) ) )
69
+ File.write( File.join( root, path ), content )
70
+ end
71
+ end
72
+
73
+ # A project file for a scenario. `paths` and `files` are the :paths and :files sections.
74
+ def scenario_yaml(ws:, app:, paths:, files: {}, project: {})
75
+ config = {
76
+ project: { build_root: 'build', use_test_preprocessor: :none, use_mocks: true, release_build: true }.merge( project ),
77
+ paths: paths,
78
+ files: files
79
+ }
80
+ # Psych writes Symbol keys and values in the `:key:` form a project file uses
81
+ return YAML.dump( placed( config, ws: ws, app: app ) )
82
+ end
83
+
84
+ # Fills `%{ws}`, `%{app}` and `%{far}` in every string with the workspace's absolute paths
85
+ def placed(value, ws:, app:)
86
+ case value
87
+ when Hash then value.transform_values { |item| placed( item, ws: ws, app: app ) }
88
+ when Array then value.map { |item| placed( item, ws: ws, app: app ) }
89
+ when String then value.gsub( '%{ws}', ws ).gsub( '%{app}', app ).gsub( '%{far}', @far.to_s )
90
+ else value
91
+ end
92
+ end
93
+
94
+ # Configures the project, and prepares every test's build paths, as stage 1 of a build does
95
+ def scenario(yaml)
96
+ configurator = configure( yaml )[:configurator]
97
+
98
+ file_wrapper = FileWrapper.new( loginator: double( 'loginator', log: nil ), verbosinator: double( 'verbosinator', should_output?: false ) )
99
+ layout = TestBuildLayout.new( configurator: configurator, file_wrapper: file_wrapper )
100
+ file_path_utils = FilePathUtils.new( configurator: configurator, file_wrapper: file_wrapper, test_build_layout: layout )
101
+
102
+ collaborators = TestBuildSetup.constructor_keys.to_h { |key| [key, double( key.to_s )] }
103
+ setup = TestBuildSetup.new( collaborators.merge(
104
+ configurator: configurator, file_wrapper: file_wrapper, file_path_utils: file_path_utils, batchinator: SerialBatchinator.new
105
+ ) )
106
+ state = TestInvokerTypes::PipelineState.new( tests: configurator.collection_all_tests, testables: {}, context: :test, options: [], lock: Mutex.new )
107
+ setup.stage_prepare_build_paths( state )
108
+
109
+ finder = FileFinder.new(
110
+ configurator: configurator, file_finder_helper: FileFinderHelper.new( loginator: double( 'loginator', log: nil ) ),
111
+ file_path_utils: file_path_utils, file_wrapper: file_wrapper, yaml_wrapper: nil, test_build_layout: layout
112
+ )
113
+
114
+ return { configurator: configurator, state: state, paths: file_path_utils, finder: finder }
115
+ end
116
+
117
+ # Every build file a scenario's sources and headers map to, by kind
118
+ def placements(scene)
119
+ configurator, state, paths = scene.values_at( :configurator, :state, :paths )
120
+ testable = state.testables.values.first
121
+ sources = configurator.collection_all_source
122
+
123
+ return {
124
+ test_objects: paths.form_test_build_objects_filelist( testable.paths[:build], sources ),
125
+ release_objects: paths.form_release_build_objects_filelist( sources ),
126
+ preprocessed: configurator.collection_all_headers.map { |header| paths.form_preprocessed_file_filepath( header, testable.name ) },
127
+ mocks: configurator.collection_all_headers.map { |header| mock_output_path( scene, testable, header ) }
128
+ }
129
+ end
130
+
131
+ # Where a mock of `header` is generated, through the lookup a build's mock stage makes
132
+ def mock_output_path(scene, testable, header)
133
+ mock = "#{scene[:configurator].cmock_mock_prefix}#{File.basename( header )}"
134
+ _source, subdir = scene[:finder].resolve_mock( mock, complain: :ignore )
135
+ return nil if subdir.nil?
136
+
137
+ return scene[:paths].form_mock_output_path( testable.paths[:mocks], subdir )
138
+ end
139
+
140
+ # Every path lies within the build root, by real containment
141
+ def expect_inside_build(paths, build: File.expand_path( 'build' ))
142
+ paths.compact.each do |path|
143
+ expanded = File.expand_path( path )
144
+ expect(expanded).to start_with( build + '/' ), "#{path} lies outside #{build}/"
145
+ expect(path.split( %r{[\\/]} )).to_not include( '..' ), "#{path} holds `..`"
146
+ end
147
+ end
148
+
149
+ # Distinct inputs map to distinct build files
150
+ def expect_distinct(paths, label)
151
+ duplicates = paths.compact.group_by { |path| File.expand_path( path ) }.select { |_, group| group.size > 1 }.keys
152
+ expect(duplicates).to be_empty, "#{label} collide: #{duplicates.join( ', ' )}"
153
+ end
154
+
155
+ # No collection holds a file under the build root
156
+ def expect_collections_outside_build(configurator, build: File.expand_path( 'build' ))
157
+ entries = configurator.collection_all_source + configurator.collection_all_headers + configurator.collection_all_tests
158
+ inside = entries.select { |entry| File.expand_path( entry ).start_with?( build + '/' ) }
159
+ expect(inside).to be_empty, "collected from the build root: #{inside.join( ', ' )}"
160
+ end
161
+
162
+ # No file is collected twice, under two spellings
163
+ def expect_one_spelling_each(configurator)
164
+ entries = configurator.collection_all_source + configurator.collection_all_headers
165
+ twice = entries.group_by { |entry| File.realpath( entry ) rescue File.expand_path( entry ) }.select { |_, group| group.size > 1 }
166
+ expect(twice).to be_empty, "collected twice: #{twice.values.map { |group| group.join( ' and ' ) }.join( '; ' )}"
167
+ end
168
+
169
+ # Build placements relative to the build root, comparable across spellings
170
+ def relative_placements(scene, build: File.expand_path( 'build' ))
171
+ return placements( scene ).transform_values do |paths|
172
+ paths.compact.map { |path| File.expand_path( path ).delete_prefix( build + '/' ) }.sort
173
+ end
174
+ end
175
+ end
@@ -25,13 +25,14 @@ require 'fileutils'
25
25
 
26
26
  require 'ceedling/constants'
27
27
  require 'ceedling/defaults'
28
- require 'ceedling/file_wrapper'
28
+ require 'ceedling/filesystem/file_wrapper'
29
29
  require 'ceedling/yaml_wrapper'
30
30
  require 'ceedling/parsing_parcels'
31
31
  require 'ceedling/includes/includes'
32
32
  require 'ceedling/includes/include_factory'
33
+ require 'ceedling/filesystem/test_build_layout'
33
34
  require 'ceedling/preprocess/preprocessinator'
34
- require 'ceedling/tool_executor'
35
+ require 'ceedling/tools/tool_executor'
35
36
  require 'ceedling/quote_include_isolator'
36
37
  require 'ceedling/preprocess/preprocessinator_includes_handler'
37
38
  require 'ceedling/preprocess/preprocessinator_bare_includes_extractor'
@@ -85,6 +86,11 @@ module IntegrationSpecHelpers
85
86
  def cmock_mock_path
86
87
  'mocks'
87
88
  end
89
+
90
+ # A test's mock root lies below the mock path (TestBuildLayout)
91
+ def project_use_mocks
92
+ true
93
+ end
88
94
  end
89
95
 
90
96
  # A ToolExecutor that assembles the command from the tool definition the same way the
@@ -168,7 +174,7 @@ module IntegrationSpecHelpers
168
174
  @tool_exec = ShellingToolExecutor.new
169
175
  @fpu = ScratchFilePathUtils.new(@root)
170
176
  @file_wrapper = FileWrapper.new(loginator: NULL, verbosinator: NULL)
171
- factory = IncludeFactory.new(configurator: @cfg)
177
+ factory = IncludeFactory.new(configurator: @cfg, test_build_layout: TestBuildLayout.new(configurator: @cfg, file_wrapper: @file_wrapper))
172
178
  line_marker = PreprocessinatorLineMarkerIncludesExtractor.new(
173
179
  include_factory: factory, file_wrapper: @file_wrapper
174
180
  )
@@ -220,7 +226,6 @@ module IntegrationSpecHelpers
220
226
  directives_only_filepath: donly,
221
227
  fallback: (fallback || donly.nil?),
222
228
  flags: [],
223
- include_paths: search_paths,
224
229
  vendor_paths: [],
225
230
  defines: defines
226
231
  )
@@ -11,22 +11,25 @@
11
11
  # The stage objects are real: TestContextExtractor's text scan (stage 2), TestSearchPaths
12
12
  # (stage 3), and TestIncludesExtractinator's three passes with their StandinHeaderinator, MockLocator,
13
13
  # FileFinder, and the Preprocessinator graph from spec_integration_helper.rb (stage 4).
14
- # Thin stand-ins replace only what would drag in a whole build: a configurator holding
15
- # one small project's settings, a dependency tracker that always reports stale, a
16
- # sequential batchinator, an include pathinator that orders a directory's headers, and
17
- # a file path utility rooted in the scratch tree.
14
+ # IncludePathinator is real too. Thin stand-ins replace only what would drag in a whole
15
+ # build: a configurator holding one small project's settings, a dependency tracker that
16
+ # always reports stale, a sequential batchinator, and a file path utility rooted in the
17
+ # scratch tree.
18
18
  #
19
19
  # A harness works in the current directory, a project root holding `src/` and `test/`,
20
20
  # as a real build does.
21
21
 
22
22
  require 'spec_integration_helper'
23
23
  require 'ceedling/filename_extension'
24
- require 'ceedling/file_finder'
25
- require 'ceedling/file_finder_helper'
24
+ require 'ceedling/filesystem/file_finder'
25
+ require 'ceedling/filesystem/file_finder_helper'
26
+ require 'ceedling/filesystem/test_build_layout'
27
+ require 'ceedling/includes/include_pathinator'
26
28
  require 'ceedling/test_context_extractor'
27
29
  require 'ceedling/test_invoker/test_invoker_types'
28
30
  require 'ceedling/test_invoker/test_search_paths'
29
31
  require 'ceedling/test_invoker/mock_locator'
32
+ require 'ceedling/test_invoker/test_derived_search_paths'
30
33
  require 'ceedling/test_invoker/standin_headerinator'
31
34
  require 'ceedling/test_invoker/test_includes_extractinator'
32
35
  require 'ceedling/test_invoker/test_bare_includes_extractinator'
@@ -36,13 +39,16 @@ require 'ceedling/test_invoker/test_includes_reconcilinator'
36
39
  module IntegrationSpecHelpers
37
40
 
38
41
  # One small project: sources and headers under src/, tests under test/, mocks named
39
- # with a `mock_` prefix
42
+ # with a `mock_` prefix. `include_paths` and `all_headers`, when given, replace every
43
+ # directory below src/ and every header below it.
40
44
  class TestIncludesConfigurator < StubConfigurator
41
45
  attr_reader :test_build_preprocess_directives_only_available
42
46
 
43
- def initialize(directives_only:, bare_tool: DEFAULT_TEST_BARE_INCLUDES_PREPROCESSOR_TOOL)
47
+ def initialize(directives_only:, bare_tool: DEFAULT_TEST_BARE_INCLUDES_PREPROCESSOR_TOOL, include_paths: nil, all_headers: nil)
44
48
  super( bare_tool: bare_tool )
45
49
  @test_build_preprocess_directives_only_available = directives_only
50
+ @include_paths = include_paths
51
+ @all_headers = all_headers
46
52
  end
47
53
 
48
54
  def cmock_mock_path
@@ -52,6 +58,10 @@ module IntegrationSpecHelpers
52
58
  def get_cmock_config
53
59
  {}
54
60
  end
61
+
62
+ def cmock_mock_name_include_folder
63
+ true
64
+ end
55
65
  def project_use_mocks
56
66
  true
57
67
  end
@@ -86,11 +96,21 @@ module IntegrationSpecHelpers
86
96
  def paths_include
87
97
  ['src']
88
98
  end
99
+ # The canonical roots configuration computes from the three above
100
+ def collection_mirror_roots_headers
101
+ ['test', 'src']
102
+ end
103
+ def collection_mirror_roots_include
104
+ ['src']
105
+ end
106
+ def collection_paths_test
107
+ ['test']
108
+ end
89
109
  def collection_paths_support
90
110
  []
91
111
  end
92
112
  def collection_paths_include
93
- Dir.glob( 'src/**/' ).map { |dir| dir.chomp( '/' ) }.sort
113
+ @include_paths || Dir.glob( 'src/**/' ).map { |dir| dir.chomp( '/' ) }.sort
94
114
  end
95
115
  def collection_paths_libraries
96
116
  []
@@ -102,7 +122,7 @@ module IntegrationSpecHelpers
102
122
  []
103
123
  end
104
124
  def collection_all_headers
105
- Dir.glob( 'src/**/*.h' ).sort
125
+ @all_headers || Dir.glob( 'src/**/*.h' ).sort
106
126
  end
107
127
  end
108
128
 
@@ -122,20 +142,6 @@ module IntegrationSpecHelpers
122
142
  end
123
143
  end
124
144
 
125
- # Headers in search order, as IncludePathinator#ordered_header_files gives them
126
- class OrderedHeaders
127
- def ordered_header_files(paths)
128
- return paths.flat_map { |path| Dir.glob( File.join( path, '*.h' ) ).sort }.uniq
129
- end
130
-
131
- def lookup_test_directive_include_paths(_filepath)
132
- []
133
- end
134
- def collect_test_include_paths
135
- []
136
- end
137
- end
138
-
139
145
  class StaleDependinator
140
146
  def register(_target, **_options); end
141
147
  def stale?(_target)
@@ -154,20 +160,34 @@ module IntegrationSpecHelpers
154
160
  class TestIncludesHarness
155
161
  attr_reader :context_extractor
156
162
 
157
- def initialize(directives_only:, bare_tool: DEFAULT_TEST_BARE_INCLUDES_PREPROCESSOR_TOOL)
158
- @cfg = TestIncludesConfigurator.new( directives_only: directives_only, bare_tool: bare_tool )
163
+ def initialize(directives_only:, bare_tool: DEFAULT_TEST_BARE_INCLUDES_PREPROCESSOR_TOOL, include_paths: nil, all_headers: nil)
164
+ @cfg = TestIncludesConfigurator.new(
165
+ directives_only: directives_only, bare_tool: bare_tool, include_paths: include_paths, all_headers: all_headers
166
+ )
159
167
  @file_wrapper = FileWrapper.new( loginator: NULL, verbosinator: NULL )
160
168
  @fpu = TestIncludesFilePathUtils.new( 'build/scratch' )
161
- @headers = OrderedHeaders.new
169
+ @layout = TestBuildLayout.new( configurator: @cfg, file_wrapper: @file_wrapper )
162
170
 
163
171
  @context_extractor = TestContextExtractor.new(
164
- configurator: @cfg, parsing_parcels: ParsingParcels.new, include_factory: IncludeFactory.new( configurator: @cfg ),
172
+ configurator: @cfg, parsing_parcels: ParsingParcels.new, include_factory: IncludeFactory.new( configurator: @cfg, test_build_layout: @layout ),
165
173
  partializer_config: NULL, file_path_utils: @fpu, file_wrapper: @file_wrapper, yaml_wrapper: NULL, loginator: NULL
166
174
  )
167
175
  @context_extractor.setup
168
176
 
177
+ @headers = IncludePathinator.new(
178
+ configurator: @cfg, test_context_extractor: @context_extractor, loginator: NULL, file_wrapper: @file_wrapper
179
+ )
180
+ @headers.setup
181
+
169
182
  @search_paths = TestSearchPaths.new( configurator: @cfg, include_pathinator: @headers, test_context_extractor: @context_extractor )
170
- @locator = MockLocator.new( configurator: @cfg, include_pathinator: @headers, file_finder: file_finder, file_path_utils: @fpu )
183
+ @locator = MockLocator.new(
184
+ configurator: @cfg, include_pathinator: @headers, test_search_paths: @search_paths, file_finder: file_finder, file_path_utils: @fpu
185
+ )
186
+ @derived = TestDerivedSearchPaths.new(
187
+ configurator: @cfg, include_pathinator: @headers, test_search_paths: @search_paths, test_context_extractor: @context_extractor,
188
+ file_finder: file_finder, file_wrapper: @file_wrapper, loginator: NULL
189
+ )
190
+ @derived.setup
171
191
  @extractinator = build_extractinator
172
192
  end
173
193
 
@@ -177,12 +197,13 @@ module IntegrationSpecHelpers
177
197
  testable = testable_for( filepath, defines, flags )
178
198
  @context_extractor.collect_simple_context_from_file( filepath, nil, TestContextExtractor::Context::INCLUDES )
179
199
 
180
- # Stage 2's tolerant mock search paths and stage 3's search paths
181
- collection = @locator.header_collection( @search_paths.compose( filepath, testable.paths ) )
200
+ # Stage 2's derived and tolerant mock search paths, and stage 3's search paths
201
+ testable.derived_search_paths, testable.search_path_refusals = @derived.collect( testable )
182
202
  testable.mock_search_paths = @locator.directories(
183
- @context_extractor.lookup_mock_header_includes_list( filepath ), mocks_root: testable.paths[:mocks], collection: collection, complain: :silent
203
+ @context_extractor.lookup_mock_header_includes_list( filepath ), mocks_root: testable.paths[:mocks],
204
+ collection: @locator.header_search( testable ), complain: :silent
184
205
  )
185
- testable.search_paths = @search_paths.compose( filepath, testable.paths, testable.mock_search_paths )
206
+ testable.search_paths = @search_paths.compose( testable )
186
207
 
187
208
  state = TestInvokerTypes::PipelineState.new( testables: { testable.name.to_sym => testable }, context: :test, options: [], lock: Mutex.new )
188
209
  @extractinator.stage_collect_preprocessor_context( state )
@@ -199,21 +220,31 @@ module IntegrationSpecHelpers
199
220
  @context_extractor.lookup_mock_header_includes_list( filepath ).map( &:filename )
200
221
  end
201
222
 
223
+ # The #includes the rest of the build names `filepath`'s mocks by, folders and all
224
+ def mock_filepaths(filepath)
225
+ @context_extractor.lookup_mock_header_includes_list( filepath ).map( &:filepath )
226
+ end
227
+
228
+ # How the later stages find `testable`'s real headers
229
+ def header_search(testable)
230
+ return @locator.header_search( testable )
231
+ end
232
+
202
233
  private
203
234
 
204
235
  def file_finder
205
236
  finder = FileFinder.new(
206
237
  configurator: @cfg, file_finder_helper: FileFinderHelper.new( loginator: NULL ),
207
- file_path_utils: @fpu, file_wrapper: @file_wrapper, yaml_wrapper: NULL
238
+ file_path_utils: @fpu, file_wrapper: @file_wrapper, yaml_wrapper: NULL, test_build_layout: @layout
208
239
  )
209
240
  return finder
210
241
  end
211
242
 
212
243
  def build_extractinator
213
244
  handler = PreprocessinatorIncludesHandler.new(
214
- configurator: @cfg, include_factory: IncludeFactory.new( configurator: @cfg ),
245
+ configurator: @cfg, include_factory: IncludeFactory.new( configurator: @cfg, test_build_layout: @layout ),
215
246
  preprocessinator_line_marker_includes_extractor: PreprocessinatorLineMarkerIncludesExtractor.new(
216
- include_factory: IncludeFactory.new( configurator: @cfg ), file_wrapper: @file_wrapper
247
+ include_factory: IncludeFactory.new( configurator: @cfg, test_build_layout: @layout ), file_wrapper: @file_wrapper
217
248
  ),
218
249
  tool_executor: ShellingToolExecutor.new, file_wrapper: @file_wrapper, file_path_utils: @fpu, yaml_wrapper: YamlWrapper.new( file_wrapper: @file_wrapper ),
219
250
  parsing_parcels: ParsingParcels.new, quote_include_isolator: QuoteIncludeIsolator.new( file_wrapper: @file_wrapper, loginator: NULL ),
@@ -235,7 +266,8 @@ module IntegrationSpecHelpers
235
266
  common = { configurator: @cfg, loginator: NULL, reportinator: NULL, batchinator: SequentialBatchinator.new, preprocessinator: preprocessinator }
236
267
  return TestIncludesExtractinator.new(
237
268
  test_bare_includes_extractinator: TestBareIncludesExtractinator.new(
238
- **common, file_path_utils: @fpu, dependinator: StaleDependinator.new, test_search_paths: @search_paths, standin_headerinator: standins
269
+ **common, file_path_utils: @fpu, dependinator: StaleDependinator.new, test_search_paths: @search_paths, standin_headerinator: standins,
270
+ mock_locator: @locator
239
271
  ),
240
272
  test_includes_preprocessinator: TestIncludesPreprocessinator.new(
241
273
  **common, file_path_utils: @fpu, file_wrapper: @file_wrapper, dependinator: StaleDependinator.new
@@ -15,13 +15,15 @@
15
15
 
16
16
  require 'rbconfig'
17
17
 
18
- require 'ceedling/tool_executor'
19
- require 'ceedling/tool_executor_helper'
18
+ require 'ceedling/tools/tool_executor'
19
+ require 'ceedling/tools/tool_executor_helper'
20
20
  require 'ceedling/system_wrapper'
21
21
  require 'ceedling/system_utils'
22
22
  require 'ceedling/loginator'
23
23
  require 'ceedling/verbosinator'
24
24
  require 'ceedling/ruby_expandinator'
25
+ require 'ceedling/defaults'
26
+ require 'ceedling/filesystem/win_path_prober'
25
27
 
26
28
  module ToolExecutorIntegrationHelpers
27
29
  # Builds the real collaborator graph. Verbosity stays at the default (NORMAL) so
@@ -48,6 +50,16 @@ module ToolExecutorIntegrationHelpers
48
50
  def ruby_tool_config(name: 'ruby_probe', arguments: [])
49
51
  { name: name, executable: RbConfig.ruby, arguments: arguments }
50
52
  end
53
+
54
+ # A WinPathProber that probes below `build_root` and reads the registry through the real
55
+ # graph above, with the default Windows registry query tool. Configuration hands Ceedling
56
+ # an unfrozen copy of each default tool, so this does too.
57
+ def real_win_path_prober(build_root:, loginator:)
58
+ configurator = Struct.new( :project_build_root, :tools_windows_registry_query ).new(
59
+ build_root, Marshal.load( Marshal.dump( DEFAULT_WINDOWS_REGISTRY_QUERY_TOOL ) )
60
+ )
61
+ WinPathProber.new( configurator: configurator, tool_executor: real_tool_executor, loginator: loginator )
62
+ end
51
63
  end
52
64
 
53
65
  RSpec.configure do |config|
@@ -59,3 +59,5 @@ $: << File.join(here, '../../bin')
59
59
  $: << File.join(here, '../../lib')
60
60
  $: << File.join(here, '../../vendor/cmock/lib')
61
61
  $: << File.join(here, '../../vendor/unity/auto')
62
+
63
+ require 'working_dir_tracking'
@@ -5,6 +5,7 @@
5
5
  # SPDX-License-Identifier: MIT
6
6
  # =========================================================================
7
7
 
8
+ require 'digest'
8
9
  require 'fileutils'
9
10
  require 'tmpdir'
10
11
  require 'open3'
@@ -142,6 +143,7 @@ RSpec.configure do |config|
142
143
  $stderr.puts "\n" + ("=" * 72)
143
144
  $stderr.puts "FAILED: #{format_description.call(example)}"
144
145
  $stderr.puts "Temp dir: #{@c.dir}"
146
+ $stderr.puts "Project: #{@proj_name}" if defined?(@proj_name) && @proj_name
145
147
  $stderr.puts "Log file: #{log_path}"
146
148
  if @c.respond_to?(:console_summary) && !@c.console_summary.nil?
147
149
  $stderr.puts "-" * 72
@@ -259,13 +261,12 @@ def html_docs_bundle_available?
259
261
  Dir.exist?(File.join(File.dirname(__FILE__), '..', '..', '..', 'site-local'))
260
262
  end
261
263
 
264
+ # A project directory name unique to the current example, kept short because Windows
265
+ # paths stop at 260 characters and a project's deepest build file sits well over 100
266
+ # below it. The full description, nested groups and all, tells apart same-named examples
267
+ # sharing one spec file's temp dir. Failure reports print the name beside the example.
262
268
  def unique_proj_name(prefix)
263
- safe = RSpec.current_example.description
264
- .downcase
265
- .gsub(/[^a-z0-9]+/, '_')
266
- .gsub(/\A_+|_+\z/, '')
267
- .slice(0, 60)
268
- "#{prefix}_#{safe}"
269
+ "#{prefix}_#{Digest::SHA256.hexdigest( RSpec.current_example.full_description )[0, 8]}"
269
270
  end
270
271
 
271
272
  def convert_slashes(path)
@@ -6,9 +6,11 @@
6
6
  # =========================================================================
7
7
 
8
8
  require 'fileutils'
9
+ require 'securerandom'
10
+ require 'tmpdir'
9
11
  require 'bundler'
10
12
  require 'ceedling/encodinator'
11
- require 'ceedling/file_wrapper'
13
+ require 'ceedling/filesystem/file_wrapper'
12
14
  require 'ceedling/verbosinator'
13
15
  require 'ceedling/yaml_wrapper'
14
16
  require_relative 'gem_dir_layout'
@@ -145,13 +147,29 @@ class SystemContext
145
147
  # or fail/) is determined by done!.
146
148
  base = File.join(Dir.pwd, ARTIFACTS_DIR, 'proj')
147
149
  FileUtils.mkdir_p(base)
148
- @dir = Dir.mktmpdir(nil, base)
150
+ @dir = self.class.brief_tmpdir(base)
149
151
  else
150
- @dir = Dir.mktmpdir
152
+ @dir = self.class.brief_tmpdir(Dir.tmpdir)
151
153
  end
152
154
  @gem = GemDirLayout.new(@dir)
153
155
  end
154
156
 
157
+ # A new directory below `base` with a 7-character name, where Dir.mktmpdir's runs to
158
+ # 22. Windows paths stop at 260 characters, and a project's deepest build file sits
159
+ # well over 100 below this directory. Dir.mkdir is atomic, so concurrent runs never
160
+ # share one.
161
+ def self.brief_tmpdir(base)
162
+ loop do
163
+ dir = File.join(base, "s#{SecureRandom.hex(3)}")
164
+ begin
165
+ Dir.mkdir(dir)
166
+ return dir
167
+ rescue Errno::EEXIST
168
+ next
169
+ end
170
+ end
171
+ end
172
+
155
173
  def done!
156
174
  if keep_all? || (keep_failures_only? && @failed)
157
175
  # 'all' mode: preserve pass and fail artifacts for post-run inspection.
@@ -0,0 +1,49 @@
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 'ceedling/filesystem/working_dir'
9
+
10
+ # WorkingDir reads the working directory once, and Ceedling changes directory only through
11
+ # WorkingDir.chdir. Specs change directory in-process with Dir.chdir all the time, so here
12
+ # every Dir.chdir forgets the working directory too, and each spec's paths resolve against
13
+ # the directory it is in. `untracked` suspends that, so a spec can show what Ceedling
14
+ # itself does.
15
+ module WorkingDirTracking
16
+
17
+ @paused = false
18
+
19
+ def self.untracked
20
+ previous = @paused
21
+ @paused = true
22
+ yield
23
+ ensure
24
+ @paused = previous
25
+ end
26
+
27
+ def self.forget
28
+ WorkingDir.forget unless @paused
29
+ end
30
+
31
+ module DirChdir
32
+ def chdir(*args)
33
+ WorkingDirTracking.forget
34
+ return super unless block_given?
35
+
36
+ super( *args ) do |*yielded|
37
+ WorkingDirTracking.forget
38
+ yield( *yielded )
39
+ ensure
40
+ WorkingDirTracking.forget
41
+ end
42
+ ensure
43
+ WorkingDirTracking.forget
44
+ end
45
+ end
46
+
47
+ end
48
+
49
+ Dir.singleton_class.prepend( WorkingDirTracking::DirChdir )
@@ -62,8 +62,8 @@ ceedling_system_tests do
62
62
  expect(output).to_not match(/Ambiguous/)
63
63
  expect(output).to match(/^Linking /)
64
64
 
65
- expect(File.exist?('build/release/out/foo/bar.o')).to be true
66
- expect(File.exist?('build/release/out/baz/bar.o')).to be true
65
+ expect(File.exist?('build/release/out/src/foo/bar.o')).to be true
66
+ expect(File.exist?('build/release/out/src/baz/bar.o')).to be true
67
67
 
68
68
  binary = Dir.glob('build/artifacts/release/*.out').first
69
69
  run_output = `#{binary}`
@@ -68,6 +68,8 @@ ceedling_system_tests do
68
68
  test_case :bullseye_xml_report_disabled_by_default
69
69
  test_case :bullseye_xml_report_cobertura
70
70
  test_case :bullseye_xml_report_native
71
+ test_case :bullseye_report_task_same_command_line
72
+ test_case :bullseye_report_task_without_coverage
71
73
  end
72
74
 
73
75
  describe "Coverage thresholds" do
@@ -128,7 +128,7 @@ ceedling_system_tests do
128
128
 
129
129
  # The runner initializes and verifies the newly enabled module's mock
130
130
  in_project do
131
- expect(File.read( 'build/test/runners/test_Case_02_runner.c' )).to include( 'mock_MyModulePart2' )
131
+ expect(File.read( 'build/test/runners/test/test_Case_02_runner.c' )).to include( 'mock_MyModulePart2' )
132
132
  end
133
133
  end
134
134