ceedling 1.1.0 → 1.1.1

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 (148) hide show
  1. checksums.yaml +4 -4
  2. data/GIT_COMMIT_SHA +1 -1
  3. data/README.md +7 -4
  4. data/docs/Changelog.md +66 -38
  5. data/docs/KnownIssues.md +9 -0
  6. data/docs/ReleaseNotes.md +5 -1
  7. data/docs/mkdocs/getting-started/installation.md +8 -1
  8. data/docs/mkdocs/getting-started/quick-start.md +20 -2
  9. data/docs/mkdocs/help.md +2 -2
  10. data/docs/mkdocs/index.md +13 -6
  11. data/docs/mkdocs/overview/build-system.md +4 -4
  12. data/docs/mkdocs/plugins/bullseye.md +6 -0
  13. data/docs/mkdocs/plugins/command-hooks.md +20 -15
  14. data/docs/mkdocs/plugins/gcov/gcovr.md +130 -109
  15. data/docs/mkdocs/plugins/gcov/index.md +6 -0
  16. data/docs/mkdocs/plugins/index.md +40 -0
  17. data/docs/mkdocs/plugins/valgrind.md +6 -0
  18. data/docs/mkdocs/testing-guide/partials/index.md +22 -13
  19. data/lib/ceedling/config/configurator.rb +2 -1
  20. data/lib/ceedling/preprocess/preprocessinator.rb +3 -2
  21. data/lib/ceedling/preprocess/preprocessinator_file_assembler.rb +27 -13
  22. data/lib/ceedling/test_invoker/test_build_executor.rb +3 -4
  23. data/lib/ceedling/test_invoker/test_build_planner.rb +0 -2
  24. data/lib/ceedling/test_invoker/test_invoker_types.rb +1 -1
  25. data/lib/ceedling/tool_executor.rb +5 -0
  26. data/lib/version.rb +1 -1
  27. data/plugins/command_hooks/lib/command_hooks.rb +4 -0
  28. data/plugins/gcov/lib/console_reportinator.rb +3 -1
  29. data/plugins/gcov/lib/gcov.rb +3 -3
  30. data/plugins/gcov/lib/gcov_reportinator.rb +4 -0
  31. data/plugins/gcov/lib/gcovr_reportinator.rb +61 -14
  32. data/plugins/gcov/lib/reportgenerator_reportinator.rb +3 -1
  33. data/site-local/404.html +3 -3
  34. data/site-local/assets/javascripts/{bundle.79ae519e.min.js → bundle.d7400e89.min.js} +2 -2
  35. data/site-local/assets/javascripts/{bundle.79ae519e.min.js.map → bundle.d7400e89.min.js.map} +2 -2
  36. data/site-local/assets/stylesheets/main.ec1eaa64.min.css +1 -0
  37. data/site-local/assets/stylesheets/{main.484c7ddc.min.css.map → main.ec1eaa64.min.css.map} +1 -1
  38. data/site-local/configuration/environment-vars.html +3 -3
  39. data/site-local/configuration/global-collections.html +3 -3
  40. data/site-local/configuration/index.html +3 -3
  41. data/site-local/configuration/loading.html +3 -3
  42. data/site-local/configuration/mixins.html +3 -3
  43. data/site-local/configuration/parallel-builds.html +3 -3
  44. data/site-local/configuration/project-file.html +3 -3
  45. data/site-local/configuration/reference/cexception.html +3 -3
  46. data/site-local/configuration/reference/cmock.html +3 -3
  47. data/site-local/configuration/reference/defines.html +3 -3
  48. data/site-local/configuration/reference/environment.html +3 -3
  49. data/site-local/configuration/reference/extension.html +3 -3
  50. data/site-local/configuration/reference/files.html +3 -3
  51. data/site-local/configuration/reference/flags.html +3 -3
  52. data/site-local/configuration/reference/index.html +3 -3
  53. data/site-local/configuration/reference/libraries.html +3 -3
  54. data/site-local/configuration/reference/mixins.html +3 -3
  55. data/site-local/configuration/reference/paths.html +3 -3
  56. data/site-local/configuration/reference/plugins.html +3 -3
  57. data/site-local/configuration/reference/project.html +3 -3
  58. data/site-local/configuration/reference/release-build.html +3 -3
  59. data/site-local/configuration/reference/test-build.html +3 -3
  60. data/site-local/configuration/reference/test-runner.html +3 -3
  61. data/site-local/configuration/reference/tools.html +3 -3
  62. data/site-local/configuration/reference/unity.html +3 -3
  63. data/site-local/configuration/which-ceedling.html +3 -3
  64. data/site-local/development/index.html +3 -3
  65. data/site-local/development/plugins/configuration.html +3 -3
  66. data/site-local/development/plugins/index.html +3 -3
  67. data/site-local/development/plugins/plugin-subclass.html +3 -3
  68. data/site-local/development/plugins/rake-tasks.html +3 -3
  69. data/site-local/development/workflow.html +3 -3
  70. data/site-local/getting-started/command-line.html +3 -3
  71. data/site-local/getting-started/example-projects/cipher-quest.html +3 -3
  72. data/site-local/getting-started/example-projects/index.html +3 -3
  73. data/site-local/getting-started/example-projects/temp-sensor.html +3 -3
  74. data/site-local/getting-started/example-projects/wondrous-forest.html +3 -3
  75. data/site-local/getting-started/index.html +3 -3
  76. data/site-local/getting-started/installation.html +12 -4
  77. data/site-local/getting-started/quick-start.html +18 -4
  78. data/site-local/help.html +4 -4
  79. data/site-local/index.html +13 -8
  80. data/site-local/overview/build-system.html +6 -6
  81. data/site-local/overview/index.html +3 -3
  82. data/site-local/overview/test-environments.html +3 -3
  83. data/site-local/overview/tools-and-frameworks.html +3 -3
  84. data/site-local/plugins/beep.html +3 -3
  85. data/site-local/plugins/bullseye.html +9 -3
  86. data/site-local/plugins/command-hooks.html +42 -38
  87. data/site-local/plugins/compile-commands-json-db.html +3 -3
  88. data/site-local/plugins/cppcheck.html +3 -3
  89. data/site-local/plugins/dependencies.html +3 -3
  90. data/site-local/plugins/fff.html +3 -3
  91. data/site-local/plugins/gcov/examples.html +3 -3
  92. data/site-local/plugins/gcov/gcovr.html +325 -227
  93. data/site-local/plugins/gcov/index.html +9 -3
  94. data/site-local/plugins/gcov/overview.html +3 -3
  95. data/site-local/plugins/gcov/reportgenerator.html +3 -3
  96. data/site-local/plugins/gcov/reporting.html +3 -3
  97. data/site-local/plugins/gcov/setup.html +3 -3
  98. data/site-local/plugins/gcov/tool-versions.html +3 -3
  99. data/site-local/plugins/gcov/troubleshooting.html +3 -3
  100. data/site-local/plugins/index.html +79 -15
  101. data/site-local/plugins/module-generator.html +3 -3
  102. data/site-local/plugins/report-build-warnings-log.html +3 -3
  103. data/site-local/plugins/report-tests-gtestlike-stdout.html +3 -3
  104. data/site-local/plugins/report-tests-ide-stdout.html +3 -3
  105. data/site-local/plugins/report-tests-log-factory.html +3 -3
  106. data/site-local/plugins/report-tests-pretty-stdout.html +3 -3
  107. data/site-local/plugins/report-tests-raw-output-log.html +3 -3
  108. data/site-local/plugins/report-tests-teamcity-stdout.html +3 -3
  109. data/site-local/plugins/valgrind.html +9 -3
  110. data/site-local/project/release-history.html +3 -3
  111. data/site-local/project/upgrade.html +3 -3
  112. data/site-local/reference/build-directives.html +3 -3
  113. data/site-local/reference/command-line.html +3 -3
  114. data/site-local/reference/environment-vars.html +3 -3
  115. data/site-local/reference/gcov-plugin.html +3 -3
  116. data/site-local/reference/global-collections.html +3 -3
  117. data/site-local/reference/index.html +3 -3
  118. data/site-local/reference/partials-macros.html +3 -3
  119. data/site-local/reference/project-configuration.html +3 -3
  120. data/site-local/sitemap.xml.gz +0 -0
  121. data/site-local/snapshot/examples/cipher_quest/index.html +3 -3
  122. data/site-local/snapshot/examples/temp_sensor/index.html +3 -3
  123. data/site-local/snapshot/examples/wondrous_forest/index.html +3 -3
  124. data/site-local/testing-guide/build-directives.html +3 -3
  125. data/site-local/testing-guide/conventions.html +3 -3
  126. data/site-local/testing-guide/frameworks.html +3 -3
  127. data/site-local/testing-guide/index.html +3 -3
  128. data/site-local/testing-guide/partials/configuration.html +3 -3
  129. data/site-local/testing-guide/partials/conventions.html +3 -3
  130. data/site-local/testing-guide/partials/directives.html +3 -3
  131. data/site-local/testing-guide/partials/example.html +3 -3
  132. data/site-local/testing-guide/partials/index.html +25 -16
  133. data/site-local/testing-guide/partials/overview.html +3 -3
  134. data/site-local/testing-guide/partials/variables.html +3 -3
  135. data/site-local/testing-guide/test-cases.html +3 -3
  136. data/site-local/testing-guide/test-sample.html +3 -3
  137. data/site-local/testing-guide/test-suite-anatomy.html +3 -3
  138. data/spec/support/system/system_context.rb +3 -1
  139. data/spec/system/support/gcov_common_test_cases.rb +4 -1
  140. data/spec/units/preprocess/preprocessinator_file_assembler_spec.rb +155 -0
  141. data/spec/units/test_build_executor_spec.rb +114 -0
  142. data/vendor/unity/auto/generate_test_runner.rb +55 -5
  143. data/vendor/unity/src/unity.h +1 -1
  144. data/vendor/unity/test/testdata/testRunnerGeneratorEmpty.c +13 -0
  145. data/vendor/unity/test/tests/test_generate_test_runner.rb +11 -0
  146. metadata +9 -7
  147. data/site-local/assets/stylesheets/main.484c7ddc.min.css +0 -1
  148. data/vendor/unity/auto/run_test.erb +0 -37
@@ -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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4028,6 +4028,12 @@
4028
4028
  <p>The <code>gcov</code> plugin integrates the code coverage abilities of the GNU compiler
4029
4029
  collection with test builds. It provides simple coverage metrics by default and
4030
4030
  can optionally produce sophisticated coverage reports.</p>
4031
+ <div class="admonition note">
4032
+ <p class="admonition-title">Note</p>
4033
+ <p>The Gcov plugin creates a duplicate test build with <code>gcov:</code> command line
4034
+ plugin tasks. <a href="../index.html#understanding-plugin-build-duplication">This is intentional and needed</a>.</p>
4035
+ </div>
4036
+ <hr />
4031
4037
  <div class="grid cards">
4032
4038
  <ul>
4033
4039
  <li>
@@ -4143,7 +4149,7 @@ can optionally produce sophisticated coverage reports.</p>
4143
4149
  <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.2c215733.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>
4144
4150
 
4145
4151
 
4146
- <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
4152
+ <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
4147
4153
 
4148
4154
 
4149
4155
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4403,7 +4403,7 @@ taken from the <a href="https://www.gcovr.com/en/stable/guide.html">Gcovr User G
4403
4403
  <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.2c215733.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>
4404
4404
 
4405
4405
 
4406
- <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
4406
+ <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
4407
4407
 
4408
4408
 
4409
4409
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4157,7 +4157,7 @@
4157
4157
  <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.2c215733.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>
4158
4158
 
4159
4159
 
4160
- <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
4160
+ <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
4161
4161
 
4162
4162
 
4163
4163
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4329,7 +4329,7 @@ these tools.</p>
4329
4329
  <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.2c215733.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>
4330
4330
 
4331
4331
 
4332
- <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
4332
+ <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
4333
4333
 
4334
4334
 
4335
4335
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4590,7 +4590,7 @@ report generation only when desired.</p>
4590
4590
  <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.2c215733.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
4591
 
4592
4592
 
4593
- <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
4593
+ <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
4594
4594
 
4595
4595
 
4596
4596
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4262,7 +4262,7 @@ stable since version 4. We recommend using <code>reportgenerator</code> 5.0 and
4262
4262
  <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.2c215733.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>
4263
4263
 
4264
4264
 
4265
- <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
4265
+ <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
4266
4266
 
4267
4267
 
4268
4268
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4306,7 +4306,7 @@ environment and packages:</p>
4306
4306
  <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.2c215733.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>
4307
4307
 
4308
4308
 
4309
- <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
4309
+ <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
4310
4310
 
4311
4311
 
4312
4312
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -3945,10 +3945,10 @@
3945
3945
  <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
3946
3946
 
3947
3947
  <li class="md-nav__item">
3948
- <a href="#console-test-results" class="md-nav__link">
3948
+ <a href="#understanding-plugin-build-duplication" class="md-nav__link">
3949
3949
  <span class="md-ellipsis">
3950
3950
 
3951
- Console Test Results
3951
+ Understanding plugin build duplication
3952
3952
 
3953
3953
  </span>
3954
3954
  </a>
@@ -3956,6 +3956,29 @@
3956
3956
  </li>
3957
3957
 
3958
3958
  <li class="md-nav__item">
3959
+ <a href="#directory" class="md-nav__link">
3960
+ <span class="md-ellipsis">
3961
+
3962
+ Directory
3963
+
3964
+ </span>
3965
+ </a>
3966
+
3967
+ <nav class="md-nav" aria-label="Directory">
3968
+ <ul class="md-nav__list">
3969
+
3970
+ <li class="md-nav__item">
3971
+ <a href="#console-test-results" class="md-nav__link">
3972
+ <span class="md-ellipsis">
3973
+
3974
+ Console Test Results
3975
+
3976
+ </span>
3977
+ </a>
3978
+
3979
+ </li>
3980
+
3981
+ <li class="md-nav__item">
3959
3982
  <a href="#test-results-reports" class="md-nav__link">
3960
3983
  <span class="md-ellipsis">
3961
3984
 
@@ -3965,8 +3988,8 @@
3965
3988
  </a>
3966
3989
 
3967
3990
  </li>
3968
-
3969
- <li class="md-nav__item">
3991
+
3992
+ <li class="md-nav__item">
3970
3993
  <a href="#static-dynamic-analysis" class="md-nav__link">
3971
3994
  <span class="md-ellipsis">
3972
3995
 
@@ -3976,8 +3999,8 @@
3976
3999
  </a>
3977
4000
 
3978
4001
  </li>
3979
-
3980
- <li class="md-nav__item">
4002
+
4003
+ <li class="md-nav__item">
3981
4004
  <a href="#code-coverage" class="md-nav__link">
3982
4005
  <span class="md-ellipsis">
3983
4006
 
@@ -3987,8 +4010,8 @@
3987
4010
  </a>
3988
4011
 
3989
4012
  </li>
3990
-
3991
- <li class="md-nav__item">
4013
+
4014
+ <li class="md-nav__item">
3992
4015
  <a href="#mocking-test-doubles" class="md-nav__link">
3993
4016
  <span class="md-ellipsis">
3994
4017
 
@@ -3998,8 +4021,8 @@
3998
4021
  </a>
3999
4022
 
4000
4023
  </li>
4001
-
4002
- <li class="md-nav__item">
4024
+
4025
+ <li class="md-nav__item">
4003
4026
  <a href="#build-integration" class="md-nav__link">
4004
4027
  <span class="md-ellipsis">
4005
4028
 
@@ -4009,8 +4032,8 @@
4009
4032
  </a>
4010
4033
 
4011
4034
  </li>
4012
-
4013
- <li class="md-nav__item">
4035
+
4036
+ <li class="md-nav__item">
4014
4037
  <a href="#project-release-builds" class="md-nav__link">
4015
4038
  <span class="md-ellipsis">
4016
4039
 
@@ -4019,6 +4042,11 @@
4019
4042
  </span>
4020
4043
  </a>
4021
4044
 
4045
+ </li>
4046
+
4047
+ </ul>
4048
+ </nav>
4049
+
4022
4050
  </li>
4023
4051
 
4024
4052
  </ul>
@@ -4106,6 +4134,42 @@ to Ceedling build steps. Alternatively, you can
4106
4134
  </div>
4107
4135
  <p>See the <a href="../configuration/reference/plugins.html"><code>:plugins</code> configuration reference</a>
4108
4136
  for how to enable built-in plugins and load custom plugins in your project.</p>
4137
+ <hr />
4138
+ <h2 id="understanding-plugin-build-duplication">Understanding plugin build duplication</h2>
4139
+ <div class="admonition warning">
4140
+ <p class="admonition-title">Warning</p>
4141
+ <p>Build-related plugins intentionally execute duplicated builds.</p>
4142
+ </div>
4143
+ <p>Plugins including <a href="gcov/index.html">Gcov</a>, <a href="bullseye.html">Bullseye</a>, and <a href="valgrind.html">Valgrind</a>
4144
+ recreate test build tasks. That is, the command line build task <code>test:foo</code> also exists
4145
+ as <code>gcov:foo</code>, <code>bullseye:foo</code>, and/or <code>valgrind:foo</code> if these plugins are enabled.
4146
+ Each of these triggers a full rebuild of the named test with instrumentation
4147
+ activated. <strong>This duplication is intentional and very necessary.</strong></p>
4148
+ <p>These plugins modify executable code or the environment in which a test suite
4149
+ executable runs. Duplicating and segregating the build tasks addresses several
4150
+ important issues:</p>
4151
+ <ol>
4152
+ <li><strong>Conflicting interactions</strong>. Enabling multiple plugins without
4153
+ duplicated tasks (i.e. integrated build tasks) can bring about conflicts and
4154
+ undefined behavior. For instance, Gcov’s instrumentation does not
4155
+ necessarily play nice with Valgrind’s memory-instrumented emulation
4156
+ runtime, and the two should be kept entirely segregated.</li>
4157
+ <li><strong>Unforeseen effects</strong>. These plugins can directly alter the functioning of
4158
+ the code under test. For instance, coverage instrumentation inserted into
4159
+ your compiled code can alter its function or timing. As such, it is vital
4160
+ to maintain distinct builds to compare them. Your vanilla test suite build
4161
+ may function slightly differently than the coverage-instrumented build.</li>
4162
+ <li><strong>Optional instrumentation</strong>. The <code>&lt;plugin&gt;:</code> command line task convention
4163
+ also provides a very simple opt-in scheme. Plugins automatically enabled
4164
+ for every build drives the desire to optional disable them. Valgrind testing
4165
+ can require 25-50x the execution time of a test suite, and you likely will
4166
+ want the option to easily disable it. While Ceedling could certainly provide
4167
+ that option at the command line for otherwise always-on plugins, this
4168
+ plugin task namespacing scheme naturally accomplished this along with the
4169
+ needs of (1) and (2).</li>
4170
+ </ol>
4171
+ <hr />
4172
+ <h2 id="directory">Directory</h2>
4109
4173
  <h3 id="console-test-results">Console Test Results</h3>
4110
4174
  <div class="grid cards">
4111
4175
  <ul>
@@ -4341,7 +4405,7 @@ build target.</p>
4341
4405
  <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.2c215733.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>
4342
4406
 
4343
4407
 
4344
- <script src="../assets/javascripts/bundle.79ae519e.min.js"></script>
4408
+ <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
4345
4409
 
4346
4410
 
4347
4411
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4581,7 +4581,7 @@ generate files like <code>MY_NEW_MODULE.c</code>. This keeps everyone on your te
4581
4581
  <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.2c215733.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>
4582
4582
 
4583
4583
 
4584
- <script src="../assets/javascripts/bundle.79ae519e.min.js"></script>
4584
+ <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
4585
4585
 
4586
4586
 
4587
4587
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4222,7 +4222,7 @@ your configuration file using <code>:report_build_warnings_log:</code> ↳ <code
4222
4222
  <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.2c215733.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>
4223
4223
 
4224
4224
 
4225
- <script src="../assets/javascripts/bundle.79ae519e.min.js"></script>
4225
+ <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
4226
4226
 
4227
4227
 
4228
4228
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4350,7 +4350,7 @@ of 49 Ceedling tests in 18 test files but only includes logging for 6 tests.</p>
4350
4350
  <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.2c215733.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>
4351
4351
 
4352
4352
 
4353
- <script src="../assets/javascripts/bundle.79ae519e.min.js"></script>
4353
+ <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
4354
4354
 
4355
4355
 
4356
4356
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4263,7 +4263,7 @@ plugin.</p>
4263
4263
  <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.2c215733.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>
4264
4264
 
4265
4265
 
4266
- <script src="../assets/javascripts/bundle.79ae519e.min.js"></script>
4266
+ <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
4267
4267
 
4268
4268
 
4269
4269
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4785,7 +4785,7 @@
4785
4785
  <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.2c215733.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>
4786
4786
 
4787
4787
 
4788
- <script src="../assets/javascripts/bundle.79ae519e.min.js"></script>
4788
+ <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
4789
4789
 
4790
4790
 
4791
4791
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4258,7 +4258,7 @@ plugin.</p>
4258
4258
  <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.2c215733.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>
4259
4259
 
4260
4260
 
4261
- <script src="../assets/javascripts/bundle.79ae519e.min.js"></script>
4261
+ <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
4262
4262
 
4263
4263
 
4264
4264
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4285,7 +4285,7 @@ root&gt;/artifacts/&lt;context&gt;/&lt;test file&gt;.raw.log</code>.</p>
4285
4285
  <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.2c215733.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>
4286
4286
 
4287
4287
 
4288
- <script src="../assets/javascripts/bundle.79ae519e.min.js"></script>
4288
+ <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
4289
4289
 
4290
4290
 
4291
4291
  </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.7.6">
24
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
25
25
 
26
26
 
27
27
 
@@ -29,7 +29,7 @@
29
29
 
30
30
 
31
31
 
32
- <link rel="stylesheet" href="../assets/stylesheets/main.484c7ddc.min.css">
32
+ <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
33
33
 
34
34
 
35
35
  <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -4284,7 +4284,7 @@ underlying Java language in which TeamCity is written,
4284
4284
  <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.2c215733.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>
4285
4285
 
4286
4286
 
4287
- <script src="../assets/javascripts/bundle.79ae519e.min.js"></script>
4287
+ <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
4288
4288
 
4289
4289
 
4290
4290
  </body>