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
@@ -17,7 +17,7 @@
17
17
 
18
18
 
19
19
  <link rel="icon" href="../../../assets/images/favicon.png">
20
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
20
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
21
21
 
22
22
 
23
23
 
@@ -4535,7 +4535,7 @@ characters (colons, brackets, spaces) from shell interpretation:</p>
4535
4535
  <script id="__config" type="application/json">{"annotate": null, "base": "../../..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
4536
4536
 
4537
4537
 
4538
- <script src="../../../assets/javascripts/bundle.c21346df.min.js"></script>
4538
+ <script src="../../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4539
4539
 
4540
4540
 
4541
4541
  </body>
@@ -17,7 +17,7 @@
17
17
 
18
18
 
19
19
  <link rel="icon" href="../../../assets/images/favicon.png">
20
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
20
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
21
21
 
22
22
 
23
23
 
@@ -4659,7 +4659,7 @@ registers the helper with CMock:</p>
4659
4659
  <script id="__config" type="application/json">{"annotate": null, "base": "../../..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
4660
4660
 
4661
4661
 
4662
- <script src="../../../assets/javascripts/bundle.c21346df.min.js"></script>
4662
+ <script src="../../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4663
4663
 
4664
4664
 
4665
4665
  </body>
@@ -17,7 +17,7 @@
17
17
 
18
18
 
19
19
  <link rel="icon" href="../../../assets/images/favicon.png">
20
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
20
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
21
21
 
22
22
 
23
23
 
@@ -4200,6 +4200,17 @@
4200
4200
  </span>
4201
4201
  </a>
4202
4202
 
4203
+ </li>
4204
+
4205
+ <li class="md-nav__item">
4206
+ <a href="#what-a-partial-carries" class="md-nav__link">
4207
+ <span class="md-ellipsis">
4208
+
4209
+ What a Partial Carries
4210
+
4211
+ </span>
4212
+ </a>
4213
+
4203
4214
  </li>
4204
4215
 
4205
4216
  <li class="md-nav__item">
@@ -4280,6 +4291,8 @@ Ceedling's Partials feature alongside traditional mock-based testing.</p>
4280
4291
  and <code>static</code> variables that are normally inaccessible to the linker</li>
4281
4292
  <li><strong>Every major Partials pattern</strong> across a range of sensor and system modules</li>
4282
4293
  <li><strong>Partials and mocks used together</strong> in the same test suite</li>
4294
+ <li><strong>Carrying</strong> β€” a Partial bringing along the helpers, prototypes, and
4295
+ variables its selected functions rely on</li>
4283
4296
  </ul>
4284
4297
  <p>This project is test-suite only (no release build).</p>
4285
4298
  <hr />
@@ -4298,19 +4311,24 @@ Ceedling's Partials feature alongside traditional mock-based testing.</p>
4298
4311
  <a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>β”‚ β”œβ”€β”€ ForestMonitor.c/.h
4299
4312
  <a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>β”‚ β”œβ”€β”€ SensorHal.c/.h
4300
4313
  <a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a>β”‚ β”œβ”€β”€ UartDriver.c/.h
4301
- <a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a>β”‚ β”œβ”€β”€ sensors/soil/Calibration.c/.h # Same module name as the one below
4302
- <a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>β”‚ β”œβ”€β”€ sensors/light/Calibration.c/.h # Told apart by directory
4303
- <a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>β”‚ └── Types.h
4304
- <a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a>└── test/ # Test files β€” Using Partials and traditional assertions/mocks
4305
- <a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a> β”œβ”€β”€ TestTemperatureSensor.c
4306
- <a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a> β”œβ”€β”€ TestHumiditySensor.c
4307
- <a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a> β”œβ”€β”€ TestLightSensor.c
4308
- <a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a> β”œβ”€β”€ TestSoilMoisture.c
4309
- <a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a> β”œβ”€β”€ TestAlertManager.c
4310
- <a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a> β”œβ”€β”€ TestEventQueue.c
4311
- <a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a> β”œβ”€β”€ TestForestMonitor.c
4312
- <a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a> β”œβ”€β”€ TestSensorHal.c
4313
- <a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a> └── TestUartDriver.c
4314
+ <a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a>β”‚ β”œβ”€β”€ RainGauge.c/.h
4315
+ <a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>β”‚ β”œβ”€β”€ RainTipIsr.c/.h # Defines the tip counter RainGauge.h declares extern
4316
+ <a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>β”‚ β”œβ”€β”€ ForestUnits.h # C99 inline functions, no source file of its own
4317
+ <a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a>β”‚ β”œβ”€β”€ sensors/soil/Calibration.c/.h # Same module name as the one below
4318
+ <a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a>β”‚ β”œβ”€β”€ sensors/light/Calibration.c/.h # Told apart by directory
4319
+ <a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a>β”‚ └── Types.h
4320
+ <a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a>└── test/ # Test files β€” Using Partials and traditional assertions/mocks
4321
+ <a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a> β”œβ”€β”€ TestTemperatureSensor.c
4322
+ <a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a> β”œβ”€β”€ TestHumiditySensor.c
4323
+ <a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a> β”œβ”€β”€ TestLightSensor.c
4324
+ <a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a> β”œβ”€β”€ TestSoilMoisture.c
4325
+ <a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a> β”œβ”€β”€ TestAlertManager.c
4326
+ <a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a> β”œβ”€β”€ TestEventQueue.c
4327
+ <a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a> β”œβ”€β”€ TestForestMonitor.c
4328
+ <a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a> β”œβ”€β”€ TestSensorHal.c
4329
+ <a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a> β”œβ”€β”€ TestUartDriver.c
4330
+ <a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a> β”œβ”€β”€ TestRainGauge.c
4331
+ <a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a> └── TestCalibration.c
4314
4332
  </code></pre></div>
4315
4333
  <hr />
4316
4334
  <h2 id="partials-patterns-used">Partials Patterns Used</h2>
@@ -4362,8 +4380,47 @@ Ceedling's Partials feature alongside traditional mock-based testing.</p>
4362
4380
  <td>TestCalibration.c</td>
4363
4381
  <td><code>TEST_PARTIAL_PRIVATE_MODULE_AT</code> β€” two same-named modules</td>
4364
4382
  </tr>
4383
+ <tr>
4384
+ <td>TestRainGauge.c</td>
4385
+ <td><code>TEST_PARTIAL_PUBLIC_MODULE</code> + a subtracted, stubbed function</td>
4386
+ </tr>
4387
+ </tbody>
4388
+ </table>
4389
+ <hr />
4390
+ <h2 id="what-a-partial-carries">What a Partial Carries</h2>
4391
+ <p>A Partial brings along what its selected functions rely on. <code>TestRainGauge.c</code>
4392
+ selects RainGauge's public functions and subtracts one of them. Those
4393
+ functions rely on code the test does not select, so the Partial carries it.
4394
+ Run the test with <code>--verbosity=debug</code> to see each carried item and why.</p>
4395
+ <table>
4396
+ <thead>
4397
+ <tr>
4398
+ <th>Carried item</th>
4399
+ <th>Why the Partial needs it</th>
4400
+ </tr>
4401
+ </thead>
4402
+ <tbody>
4403
+ <tr>
4404
+ <td><code>RainGauge_TipsToMicrometers()</code></td>
4405
+ <td><code>RainGauge.h</code> defines this <code>static inline</code> helper, and <code>RainGauge_Update()</code> calls it</td>
4406
+ </tr>
4407
+ <tr>
4408
+ <td><code>extern inline</code> prototype of <code>ForestUnits_MicrometersToTenthsMm()</code></td>
4409
+ <td><code>ForestUnits.h</code> defines the function C99 <code>inline</code>. The prototype makes the Partial hold its external definition</td>
4410
+ </tr>
4411
+ <tr>
4412
+ <td>Prototype of <code>RainGauge_ReportStorm()</code></td>
4413
+ <td>The test subtracts this function and defines a stub. <code>RainGauge_Update()</code> calls the stub</td>
4414
+ </tr>
4415
+ <tr>
4416
+ <td>Weak definition of <code>g_rain_tip_count</code></td>
4417
+ <td><code>RainGauge.h</code> declares the counter <code>extern</code>. Its real definition in <code>RainTipIsr.c</code>, which the test links, takes precedence</td>
4418
+ </tr>
4365
4419
  </tbody>
4366
4420
  </table>
4421
+ <p>Each carried item keeps its original spelling. A <code>#line</code> directive ahead of
4422
+ each points back to its original file and line. Coverage of the carried
4423
+ helper therefore counts toward <code>RainGauge.h</code>.</p>
4367
4424
  <hr />
4368
4425
  <h2 id="running-the-tests">Running the Tests</h2>
4369
4426
  <p>Run all tests:</p>
@@ -4449,7 +4506,7 @@ Ceedling's Partials feature alongside traditional mock-based testing.</p>
4449
4506
  <script id="__config" type="application/json">{"annotate": null, "base": "../../..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
4450
4507
 
4451
4508
 
4452
- <script src="../../../assets/javascripts/bundle.c21346df.min.js"></script>
4509
+ <script src="../../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4453
4510
 
4454
4511
 
4455
4512
  </body>
@@ -51,7 +51,7 @@ DEFAULT_BULLSEYE_LINKER_TOOL = {
51
51
  }
52
52
 
53
53
  DEFAULT_BULLSEYE_FIXTURE_TOOL = {
54
- :executable => '${1}'.freeze,
54
+ :executable => '"${1}"'.freeze, # Test executable, quoted as a path
55
55
  :name => 'default_bullseye_fixture'.freeze,
56
56
  :optional => false.freeze,
57
57
  :arguments => [].freeze
@@ -41,7 +41,7 @@ DEFAULT_GCOV_LINKER_TOOL = {
41
41
  }
42
42
 
43
43
  DEFAULT_GCOV_FIXTURE_TOOL = {
44
- :executable => '${1}'.freeze,
44
+ :executable => '"${1}"'.freeze, # Test executable, quoted as a path
45
45
  :name => 'default_gcov_fixture'.freeze,
46
46
  :optional => false.freeze,
47
47
  :arguments => [].freeze
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -4800,7 +4800,7 @@ per line within your test file.</p>
4800
4800
  <script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
4801
4801
 
4802
4802
 
4803
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4803
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4804
4804
 
4805
4805
 
4806
4806
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -1334,6 +1334,17 @@
1334
1334
  </span>
1335
1335
  </a>
1336
1336
 
1337
+ </li>
1338
+
1339
+ <li class="md-nav__item">
1340
+ <a href="#test-names-build-output" class="md-nav__link">
1341
+ <span class="md-ellipsis">
1342
+
1343
+ Test names &amp; build output
1344
+
1345
+ </span>
1346
+ </a>
1347
+
1337
1348
  </li>
1338
1349
 
1339
1350
  <li class="md-nav__item">
@@ -4705,6 +4716,17 @@
4705
4716
  </span>
4706
4717
  </a>
4707
4718
 
4719
+ </li>
4720
+
4721
+ <li class="md-nav__item">
4722
+ <a href="#test-names-build-output" class="md-nav__link">
4723
+ <span class="md-ellipsis">
4724
+
4725
+ Test names &amp; build output
4726
+
4727
+ </span>
4728
+ </a>
4729
+
4708
4730
  </li>
4709
4731
 
4710
4732
  <li class="md-nav__item">
@@ -5043,30 +5065,44 @@ Any directory structure will do. Tests can be held in subdirectories
5043
5065
  within source directories, or tests and source directories
5044
5066
  can be wholly separated at the top of your project’s directory
5045
5067
  tree.</p>
5068
+ <div class="admonition warning">
5069
+ <p class="admonition-title">Windows path lengths</p>
5070
+ <p>Ceedling mirrors your source paths in its build paths. In some cases build
5071
+ paths can exceed Windows’ classic 260-character limit. Without special
5072
+ handling, a path that long can cause build failure with mysterious β€œNo
5073
+ such file or directory” or other errors rather than a clear length error.
5074
+ Ceedling intervenes by reporting each build path that nears or passes the
5075
+ limit to aid troublehsooting.</p>
5076
+ <p>If your Windows host has long paths enabled or you can enable it, see
5077
+ <a href="../configuration/reference/project.html#win_path_limit"><code>:project</code> ↳ <code>:win_path_limit</code></a>
5078
+ for more options.</p>
5079
+ </div>
5046
5080
  <h2 id="distinguishing-same-named-files">Distinguishing same-named files</h2>
5047
5081
  <h3 id="header-source-files">Header / source files</h3>
5048
5082
  <p>Ceedling distinguishes files by their full relative path, not just their
5049
5083
  filename. A project may have, for example, both <code>src/drivers/uart.c</code> and
5050
5084
  <code>src/sensors/uart.c</code> without one hiding or colliding with the other.</p>
5051
- <p>Distinguishing files is mostly an issue in test builds. If two files share
5052
- a name without enough path to distinguish them, Ceedling resolves the reference
5053
- to the first match among the file collection. File collections are ordered per
5054
- your project configuration (<code>:paths</code>). The ordering of collected files is
5055
- identical to the search path ordering provided to the compiler from the same
5056
- <code>:paths</code> configuration plus any use of
5057
- <a href="build-directives.html#test_include_path"><code>TEST_INCLUDE_PATH()</code></a> directives in
5058
- a test file. When Ceedling finds more than one reference, it uses the first
5059
- in the ordered file list but logs an informational notice naming multi-file
5060
- matches, so the choice is not silent.</p>
5085
+ <p>Distinguishing files is mostly an issue in test builds. Ceedling finds a
5086
+ header named by an <code>#include</code> the way your compiler does. It joins each of the
5087
+ test’s search paths, in order, with the path the <code>#include</code> names, and the
5088
+ first file that exists wins. A search path therefore reaches headers in the
5089
+ directories below it, as in <code>#include "drivers/uart.h"</code> with <code>src/</code> as a search
5090
+ path. Search paths are ordered per your project configuration (<code>:paths</code>) plus
5091
+ any use of <a href="build-directives.html#test_include_path"><code>TEST_INCLUDE_PATH()</code></a>
5092
+ directives in a test file. When more than one search path holds the header,
5093
+ Ceedling uses the first but logs an informational notice naming the others, so
5094
+ the choice is not silent.</p>
5095
+ <p>A source file a test needs resolves by its trailing path against the file
5096
+ collection, which is ordered by the same <code>:paths</code> configuration.</p>
5061
5097
  <p>If Ceedling uses the wrong match for lack of path information, your test build
5062
5098
  fails downstream with an ordinary compilation error indirectly revealing the
5063
5099
  issue. Add enough path at the point of reference to select the file you actually
5064
5100
  meant.</p>
5065
5101
  <ul>
5066
5102
  <li>Use paths in <code>#include</code> directives in your test files to distinguish header
5067
- files of the same name (mocks are distiguished by the same filepath as the
5068
- headers from which they are generated). Examples: <code>#include "foo/bar/file.h"</code>
5069
- and/or <code>#include "foo/bar/mock_file.h"</code>.</li>
5103
+ files of the same name. A mock is distinguished by the same path as the
5104
+ header it is generated from, below one of your search paths. Examples:
5105
+ <code>#include "foo/bar/file.h"</code> and/or <code>#include "foo/bar/mock_file.h"</code>.</li>
5070
5106
  <li>Use the <a href="build-directives.html"><code>TEST_SOURCE_FILE()</code> build directive macro</a>
5071
5107
  to provide a path to distinguish source files of the same name to be
5072
5108
  compiled and linked with a test executable.</li>
@@ -5119,6 +5155,14 @@ and function declarations.</p>
5119
5155
  <li>The <a href="build-directives.html#test_include_path"><code>TEST_INCLUDE_PATH(...)</code></a> build directive
5120
5156
  macro. This is only available within test files.</li>
5121
5157
  </ol>
5158
+ <p>A header whose own directory no search path lists needs no search path of its
5159
+ own, as is usual for one that
5160
+ <a href="../configuration/reference/files.html#files-include"><code>:files</code> ↳ <code>:include</code></a> adds.
5161
+ When a test’s <code>#include</code> names such a header, Ceedling adds the directory that
5162
+ <code>#include</code> implies to the test’s search paths. A bare name for a header outside
5163
+ the working directory is the exception, as
5164
+ <a href="../configuration/reference/files.html#files-include"><code>:files</code> ↳ <code>:include</code></a>
5165
+ explains.</p>
5122
5166
  <p>In testing contexts, you have three options for assembling the core of
5123
5167
  the search path list used by Ceedling for test builds:</p>
5124
5168
  <ol>
@@ -5146,6 +5190,8 @@ it is assembled from a variety of sources. In order:</p>
5146
5190
  <li>Internal paths for CMock’s C code (if respective feature enabled)</li>
5147
5191
  <li><code>:paths</code> ↳ <code>:test_toolchain_include</code> list from your project
5148
5192
  configuration</li>
5193
+ <li>Directories the test’s <code>#include</code>s imply for headers whose own directories
5194
+ no search path lists, such as headers <code>:files</code> ↳ <code>:include</code> adds</li>
5149
5195
  </ol>
5150
5196
  <p>The paths lists above are documented in detail in the discussion of
5151
5197
  project configuration.</p>
@@ -5240,6 +5286,58 @@ of its own. Whether yours does depends on your toolchain.</p>
5240
5286
  <p>Before 1.2.0, Ceedling wrote no manifest. With a toolchain that embeds none,
5241
5287
  test files with these words in their names could not be run on Windows without
5242
5288
  administrator privileges.</p>
5289
+ <h3 id="test-names-build-output">Test names &amp; build output</h3>
5290
+ <p>Ceedling names each test by its path from your project’s root, without its
5291
+ file extension. <code>test/unit/test_calc.c</code> is named <code>test/unit/test_calc</code>. Every
5292
+ test gets its own build output, even when test files share a filename.</p>
5293
+ <p>A test’s name is its path, so one test’s build directory could lie inside another’s.
5294
+ <code>test/test_calc.c</code> and <code>test/test_calc/test_io.c</code> would build into
5295
+ <code>build/test/out/test/test_calc/</code> and a folder within it, and the two tests’ objects
5296
+ and mocks would mix. Each build directory that holds files of every test, such as
5297
+ <code>build/test/out/</code> or <code>build/test/mocks/</code>, therefore gives each test a directory of
5298
+ its own: the test’s name followed by <code>_t_</code>. The marker closes every test’s name, so
5299
+ no test’s directory can hold another’s. Ceedling renames a folder of your own called
5300
+ <code>_t_</code> in these paths, as the last paragraph below explains, so the marker always ends
5301
+ a name. <code>test/test_calc</code> builds to <code>build/test/out/test/test_calc/_t_/</code>.</p>
5302
+ <p>The name places a test’s output beneath each build directory:</p>
5303
+ <ul>
5304
+ <li>Executable: <code>build/test/out/test/unit/test_calc/_t_/</code></li>
5305
+ <li>Mocks: <code>build/test/mocks/test/unit/test_calc/_t_/</code></li>
5306
+ <li>Results: <code>build/test/results/test/unit/test_calc.pass</code></li>
5307
+ <li>Logs from plugins and backtraces, such as
5308
+ <code>build/artifacts/valgrind/test/unit/test_calc.log</code> or
5309
+ <code>build/logs/test/test/unit/test_calc/&lt;test case&gt;.gdb.log</code></li>
5310
+ </ul>
5311
+ <p>Within a test’s directory, each object sits at its source’s own path from your
5312
+ project’s root, so same-named sources never share a path. <code>src/drivers/uart.c</code>
5313
+ compiles to <code>build/test/out/test/unit/test_calc/_t_/src/drivers/uart.o</code>. Preprocessed
5314
+ files and dependency files follow the same layout, and a release build places its
5315
+ objects the same way below <code>build/release/out/</code>. Mocks sit below their test’s own
5316
+ mock directory, and runners and Unity, CMock, and CException objects sit directly in
5317
+ the test’s directory.</p>
5318
+ <p>A long <code>:paths</code> root gives way to a short name in build paths. A root far outside
5319
+ your project, such as a vendor’s include directory, or one nested deep inside it,
5320
+ is written as its own directory name and 8 hexadecimal digits, and everything below
5321
+ the root keeps its path. With <code>../../../Keil_v5/ARM/CMSIS/Include</code> among your
5322
+ <code>:paths</code>, a preprocessed copy of <code>Include/cmsis_os2.h</code> lands at
5323
+ <code>build/test/preprocess/files/&lt;test&gt;/_t_/directives_only/raw/_Include_3F2A91C0/cmsis_os2.h</code>.
5324
+ A root is shortened only when its short name is shorter than its own path, so roots
5325
+ such as <code>src/</code> and <code>test/</code> are unchanged. <code>build/build_roots.yml</code> lists each shortened
5326
+ root and its short name, and <code>--verbosity=debug</code> logs them. Test names never change.</p>
5327
+ <p>A test or source outside your project, and outside every shortened root, keeps its
5328
+ whole path. Each <code>..</code> becomes <code>_up_</code>, so <code>../shared/test/test_io.c</code> is named
5329
+ <code>_up_/shared/test/test_io</code>. A path
5330
+ with no relative form, such as one on another Windows drive, sits beneath <code>_abs_</code>,
5331
+ and a file of the running Ceedling installation outside your project, such as a
5332
+ plugin’s source, beneath <code>_ceedling_</code>. None of these reaches outside the build
5333
+ directory. A directory of your project that is itself named like one of these, or like a
5334
+ shortened root, gains a leading <code>_</code> (e.g. <code>__up_/</code>), so it never shares a name with
5335
+ a path outside your project. In a test build, a directory named <code>_t_</code> gains one too,
5336
+ so it never ends a test’s name. A release build places it as it is.</p>
5337
+ <p>Two tests share a name only if their paths differ in extension alone (e.g.
5338
+ <code>test_a.c</code> and <code>test_a.cpp</code>). A build that includes either test stops with an
5339
+ error naming both files. Two sources that would build to one file stop a build the
5340
+ same way.</p>
5243
5341
  <h3 id="source-mock-files-to-compile-and-link">Source &amp; mock files to compile and link</h3>
5244
5342
  <p>Ceedling knows what files to compile and link into each individual
5245
5343
  test executable by way of the <code>#include</code> list contained in each
@@ -5767,7 +5865,7 @@ much simpler exit code convention than Unity: <code>0</code> = πŸ™‚ while <code>
5767
5865
  <script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
5768
5866
 
5769
5867
 
5770
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
5868
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
5771
5869
 
5772
5870
 
5773
5871
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -4731,7 +4731,7 @@ if you wish to use it in your project.</p>
4731
4731
  <script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
4732
4732
 
4733
4733
 
4734
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4734
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4735
4735
 
4736
4736
 
4737
4737
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -4410,7 +4410,7 @@ quite enough β€” adding source files, handling include paths, and more.</p>
4410
4410
  <script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
4411
4411
 
4412
4412
 
4413
- <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
4413
+ <script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4414
4414
 
4415
4415
 
4416
4416
  </body>
@@ -21,7 +21,7 @@
21
21
 
22
22
 
23
23
  <link rel="icon" href="../../assets/images/favicon.png">
24
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
25
25
 
26
26
 
27
27
 
@@ -1463,6 +1463,17 @@
1463
1463
  </span>
1464
1464
  </a>
1465
1465
 
1466
+ </li>
1467
+
1468
+ <li class="md-nav__item">
1469
+ <a href="#variable-type-names" class="md-nav__link">
1470
+ <span class="md-ellipsis">
1471
+
1472
+ Variable type names
1473
+
1474
+ </span>
1475
+ </a>
1476
+
1466
1477
  </li>
1467
1478
 
1468
1479
  </ul>
@@ -4380,6 +4391,17 @@
4380
4391
  </span>
4381
4392
  </a>
4382
4393
 
4394
+ </li>
4395
+
4396
+ <li class="md-nav__item">
4397
+ <a href="#variable-type-names" class="md-nav__link">
4398
+ <span class="md-ellipsis">
4399
+
4400
+ Variable type names
4401
+
4402
+ </span>
4403
+ </a>
4404
+
4383
4405
  </li>
4384
4406
 
4385
4407
  </ul>
@@ -4497,8 +4519,9 @@ directive macros:</p>
4497
4519
  <div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="cp">#include</span><span class="w"> </span><span class="cpf">"unity.h"</span>
4498
4520
  <a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="cp">#include</span><span class="w"> </span><span class="cpf">"ceedling.h"</span><span class="w"> </span><span class="c1">// Required -- defines all Partial directive macros</span>
4499
4521
  </code></pre></div>
4500
- <p><code>ceedling.h</code> defines the <code>TEST_PARTIAL_*</code>, <code>MOCK_PARTIAL_*</code>, <code>*_CONFIG</code>, and
4501
- <code>PARTIAL_LOCAL_VAR()</code> macros. Without this include, the macros are undefined.</p>
4522
+ <p><code>ceedling.h</code> defines the <code>TEST_PARTIAL_*</code>, <code>MOCK_PARTIAL_*</code>, <code>*_CONFIG</code>,
4523
+ <code>PARTIAL_LOCAL_VAR()</code>, <code>PARTIAL_TYPE()</code> and <code>PARTIAL_LOCAL_TYPE()</code> macros.
4524
+ Without this include, the macros are undefined.</p>
4502
4525
  <h2 id="partials-macro-categories">Partials macro categories</h2>
4503
4526
  <p>See the <a href="../../reference/partials-macros.html">Partials Macros Reference</a> for the complete listing.</p>
4504
4527
  <h3 id="module-selection"><a href="../../reference/partials-macros.html#module-selection-macros">Module selection</a></h3>
@@ -4519,6 +4542,10 @@ and can be accessed directly in your test cases.</p>
4519
4542
  <p><code>PARTIAL_LOCAL_VAR(function_name, variable_name)</code></p>
4520
4543
  <p>Accesses a function-scoped <code>static</code> variable that Ceedling has promoted to
4521
4544
  module scope in a generated Partial.</p>
4545
+ <h3 id="variable-type-names"><a href="../../reference/partials-macros.html#variable-type-names">Variable type names</a></h3>
4546
+ <p><code>PARTIAL_TYPE(module, variable)</code> / <code>PARTIAL_LOCAL_TYPE(module, function, variable)</code></p>
4547
+ <p>Name the type a Partial gives a variable declared together with its type, as in
4548
+ <code>static struct { int count; } s_ctx;</code>.</p>
4522
4549
  <p><br/><br/></p>
4523
4550
 
4524
4551
 
@@ -4590,7 +4617,7 @@ module scope in a generated Partial.</p>
4590
4617
  <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
4591
4618
 
4592
4619
 
4593
- <script src="../../assets/javascripts/bundle.c21346df.min.js"></script>
4620
+ <script src="../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
4594
4621
 
4595
4622
 
4596
4623
  </body>