RubyGems - ceedling - Versions diffs - 1.2.0 → 1.2.2 - Mend

ceedling 1.2.0 → 1.2.2

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 (383) hide show

checksums.yaml +4 -4
data/GIT_COMMIT_SHA +1 -1
data/README.md +57 -58
data/Rakefile +5 -3
data/assets/features/ceedling +1 -1
data/assets/fixtures/test_source_file_duplicate_basenames/test_calc_typo.c +14 -0
data/assets/fixtures/tests_with_duplicate_test_names/test_foo.c +21 -0
data/bin/actionator.rb +6 -12
data/bin/app_cfg.rb +35 -1
data/bin/ceedling +13 -3
data/bin/cli.rb +25 -6
data/bin/cli_handler.rb +119 -73
data/bin/cli_helper.rb +56 -78
data/bin/installation_selector.rb +81 -0
data/bin/launchinator.rb +69 -0
data/bin/mixin_resolvinator.rb +26 -36
data/bin/objects.yml +13 -0
data/bin/path_validator.rb +25 -29
data/bin/versionator.rb +47 -48
data/ceedling.gemspec +19 -15
data/docs/BreakingChanges.md +70 -1
data/docs/Changelog.md +84 -3
data/docs/KnownIssues.md +90 -4
data/docs/ReleaseNotes.md +13 -0
data/docs/overrides/main.html +11 -8
data/lib/ceedling/build_log_writer.rb +33 -0
data/lib/ceedling/config/build_root_policy.rb +70 -0
data/lib/ceedling/config/configurator.rb +19 -18
data/lib/ceedling/config/configurator_builder.rb +58 -28
data/lib/ceedling/config/configurator_paths_validator.rb +179 -0
data/lib/ceedling/config/configurator_plugins.rb +1 -1
data/lib/ceedling/config/configurator_setup.rb +39 -41
data/lib/ceedling/config/configurator_validator.rb +1 -110
data/lib/ceedling/defaults.rb +4 -4
data/lib/ceedling/dependencies/README.md +18 -16
data/lib/ceedling/dependencies/dependency_cache_store.rb +20 -3
data/lib/ceedling/dependencies/dependency_hasher.rb +35 -1
data/lib/ceedling/filename_extension.rb +7 -1
data/lib/ceedling/filesystem/FILE_TREE.md +253 -0
data/lib/ceedling/filesystem/PATH_HANDLING.md +304 -0
data/lib/ceedling/filesystem/README.md +41 -0
data/lib/ceedling/filesystem/build_subpath.rb +102 -0
data/lib/ceedling/filesystem/destination_collision.rb +25 -0
data/lib/ceedling/{file_finder.rb → filesystem/file_finder.rb} +159 -104
data/lib/ceedling/{file_finder_helper.rb → filesystem/file_finder_helper.rb} +36 -31
data/lib/ceedling/filesystem/file_path_collection_utils.rb +183 -0
data/lib/ceedling/{file_path_utils.rb → filesystem/file_path_utils.rb} +108 -97
data/lib/ceedling/{file_system_wrapper.rb → filesystem/file_system_wrapper.rb} +6 -5
data/lib/ceedling/filesystem/file_tree.rb +241 -0
data/lib/ceedling/{file_wrapper.rb → filesystem/file_wrapper.rb} +65 -28
data/lib/ceedling/filesystem/path_exclusions.rb +30 -0
data/lib/ceedling/{path_matcher.rb → filesystem/path_matcher.rb} +27 -23
data/lib/ceedling/{path_mirror.rb → filesystem/path_mirror.rb} +19 -18
data/lib/ceedling/filesystem/path_spellings.rb +55 -0
data/lib/ceedling/filesystem/project_paths.rb +184 -0
data/lib/ceedling/filesystem/working_dir.rb +40 -0
data/lib/ceedling/generators/generator.rb +5 -6
data/lib/ceedling/generators/generator_partials.rb +1 -1
data/lib/ceedling/generators/generator_test_results_backtrace.rb +7 -7
data/lib/ceedling/handoff.rb +121 -0
data/lib/ceedling/includes/include_factory.rb +3 -3
data/lib/ceedling/includes/include_pathinator.rb +67 -10
data/lib/ceedling/includes/includes.rb +1 -1
data/lib/ceedling/installation.rb +92 -0
data/lib/ceedling/library_resolver.rb +99 -0
data/lib/ceedling/objects.yml +23 -2
data/lib/ceedling/partials/partializer.rb +4 -4
data/lib/ceedling/partials/partializer_config.rb +3 -1
data/lib/ceedling/plugins/report_log_writer_plugin.rb +3 -5
data/lib/ceedling/preprocess/preprocessinator_file_assembler.rb +1 -1
data/lib/ceedling/preprocess/preprocessinator_includes_handler.rb +1 -1
data/lib/ceedling/preprocess/preprocessinator_line_marker_includes_extractor.rb +1 -1
data/lib/ceedling/rake_app/rakefile_component_resolver.rb +10 -17
data/lib/ceedling/rake_app/test_task_name.rb +29 -0
data/lib/ceedling/rakefile.rb +16 -1
data/lib/ceedling/rakefiles/base/tasks_base.rake +1 -1
data/lib/ceedling/rakefiles/release/rules_release.rake +4 -7
data/lib/ceedling/rakefiles/tests/rules_tests.rake +3 -20
data/lib/ceedling/rakefiles/tests/rules_tests_generate.rake +4 -30
data/lib/ceedling/release_invoker/release_build_executor.rb +33 -44
data/lib/ceedling/release_invoker/release_build_planner.rb +14 -6
data/lib/ceedling/reportinator.rb +3 -4
data/lib/ceedling/setupinator.rb +95 -87
data/lib/ceedling/test_context_extractor.rb +5 -1
data/lib/ceedling/test_invoker/PIPELINE.md +9 -7
data/lib/ceedling/test_invoker/mock_locator.rb +60 -2
data/lib/ceedling/test_invoker/partials_manager.rb +12 -0
data/lib/ceedling/test_invoker/standin_headerinator.rb +22 -13
data/lib/ceedling/test_invoker/test_build_executor.rb +42 -41
data/lib/ceedling/test_invoker/test_build_planner.rb +37 -18
data/lib/ceedling/test_invoker/test_build_setup.rb +17 -12
data/lib/ceedling/test_invoker/test_build_validations.rb +16 -31
data/lib/ceedling/test_invoker/test_file_preprocessinator.rb +1 -1
data/lib/ceedling/test_invoker/test_invoker.rb +6 -1
data/lib/ceedling/test_invoker/test_pipeline_helpers.rb +1 -1
data/lib/ceedling/test_invoker/test_source_file_directive_resolver.rb +40 -20
data/lib/ceedling/tool_executor.rb +9 -3
data/lib/ceedling/yaml_wrapper.rb +3 -2
data/lib/version.rb +1 -1
data/plugins/bullseye/bullseye.rake +6 -9
data/plugins/bullseye/config/defaults_bullseye.rb +1 -1
data/plugins/bullseye/lib/bullseye.rb +9 -7
data/plugins/cppcheck/config/defaults_cppcheck.rb +1 -1
data/plugins/dependencies/config/defaults.yml +6 -6
data/plugins/dependencies/dependencies.rake +4 -1
data/plugins/dependencies/lib/dependencies.rb +18 -8
data/plugins/dependencies/lib/dependency_spec.rb +17 -5
data/plugins/fff/lib/fff.rb +45 -39
data/plugins/fff/spec/fff_cmock_wrapper_spec.rb +128 -0
data/plugins/gcov/config/defaults_gcov.rb +1 -1
data/plugins/gcov/gcov.rake +6 -9
data/plugins/gcov/lib/console_reportinator.rb +4 -18
data/plugins/gcov/lib/gcov.rb +9 -2
data/plugins/gcov/lib/gcovr_reportinator.rb +8 -40
data/plugins/gcov/lib/gcovr_thresholds.rb +74 -0
data/plugins/gcov/lib/reportgenerator_reportinator.rb +1 -1
data/plugins/module_generator/lib/module_generator.rb +3 -3
data/plugins/report_tests_teamcity_stdout/lib/report_tests_teamcity_stdout.rb +53 -80
data/plugins/sanitize/lib/sanitize_records.rb +3 -6
data/plugins/sanitize/sanitize.rake +6 -6
data/plugins/valgrind/lib/valgrind.rb +14 -7
data/plugins/valgrind/valgrind.rake +6 -6
data/site-local/404.html +6 -20
data/site-local/assets/javascripts/{bundle.d7400e89.min.js → bundle.c21346df.min.js} +3 -3
data/site-local/assets/javascripts/{bundle.d7400e89.min.js.map → bundle.c21346df.min.js.map} +2 -2
data/site-local/assets/javascripts/workers/{search.2c215733.min.js → search.a7633da7.min.js} +2 -2
data/site-local/assets/javascripts/workers/{search.2c215733.min.js.map → search.a7633da7.min.js.map} +1 -1
data/site-local/assets/stylesheets/main.57a0d79d.min.css +6 -0
data/site-local/assets/stylesheets/main.57a0d79d.min.css.map +1 -0
data/site-local/assets/stylesheets/palette.fb2fffe2.min.css +4 -0
data/site-local/assets/stylesheets/palette.fb2fffe2.min.css.map +1 -0
data/site-local/configuration/environment-vars.html +6 -20
data/site-local/configuration/global-collections.html +6 -20
data/site-local/configuration/index.html +6 -20
data/site-local/configuration/loading.html +6 -20
data/site-local/configuration/mixins.html +10 -24
data/site-local/configuration/parallel-builds.html +6 -20
data/site-local/configuration/project-file.html +8 -22
data/site-local/configuration/reference/cexception.html +6 -20
data/site-local/configuration/reference/cmock.html +8 -21
data/site-local/configuration/reference/defines.html +16 -30
data/site-local/configuration/reference/environment.html +10 -24
data/site-local/configuration/reference/extension.html +6 -20
data/site-local/configuration/reference/files.html +22 -30
data/site-local/configuration/reference/flags.html +13 -27
data/site-local/configuration/reference/index.html +6 -20
data/site-local/configuration/reference/libraries.html +27 -23
data/site-local/configuration/reference/mixins.html +6 -20
data/site-local/configuration/reference/partials.html +6 -20
data/site-local/configuration/reference/paths.html +38 -29
data/site-local/configuration/reference/plugins.html +6 -20
data/site-local/configuration/reference/project.html +32 -36
data/site-local/configuration/reference/release-build.html +8 -20
data/site-local/configuration/reference/test-build.html +6 -20
data/site-local/configuration/reference/test-runner.html +6 -20
data/site-local/configuration/reference/tools.html +27 -32
data/site-local/configuration/reference/unity.html +6 -20
data/site-local/configuration/which-ceedling.html +383 -37
data/site-local/development/index.html +6 -20
data/site-local/development/plugins/configuration.html +6 -20
data/site-local/development/plugins/index.html +6 -20
data/site-local/development/plugins/plugin-subclass.html +54 -68
data/site-local/development/plugins/rake-tasks.html +8 -22
data/site-local/development/releases.html +84 -29
data/site-local/development/workflow.html +62 -71
data/site-local/getting-started/builds.html +8 -20
data/site-local/getting-started/command-line.html +62 -24
data/site-local/getting-started/example-projects/cipher-quest.html +6 -20
data/site-local/getting-started/example-projects/index.html +6 -20
data/site-local/getting-started/example-projects/temp-sensor.html +6 -20
data/site-local/getting-started/example-projects/wondrous-forest.html +6 -20
data/site-local/getting-started/index.html +6 -20
data/site-local/getting-started/installation.html +6 -20
data/site-local/getting-started/quick-start.html +6 -20
data/site-local/help.html +6 -20
data/site-local/index.html +11 -24
data/site-local/overview/build-system.html +6 -20
data/site-local/overview/index.html +6 -20
data/site-local/overview/test-environments.html +6 -20
data/site-local/overview/tools-and-frameworks.html +6 -20
data/site-local/plugins/beep.html +6 -20
data/site-local/plugins/bullseye/index.html +13 -24
data/site-local/plugins/bullseye/licensing.html +14 -28
data/site-local/plugins/command-hooks.html +8 -22
data/site-local/plugins/compile-commands-json-db.html +6 -20
data/site-local/plugins/cppcheck.html +8 -22
data/site-local/plugins/dependencies.html +16 -27
data/site-local/plugins/fff.html +49 -32
data/site-local/plugins/gcov/examples.html +7 -21
data/site-local/plugins/gcov/gcovr.html +22 -33
data/site-local/plugins/gcov/index.html +6 -20
data/site-local/plugins/gcov/overview.html +9 -20
data/site-local/plugins/gcov/reportgenerator.html +9 -23
data/site-local/plugins/gcov/reporting.html +6 -20
data/site-local/plugins/gcov/setup.html +8 -21
data/site-local/plugins/gcov/tool-versions.html +6 -20
data/site-local/plugins/gcov/troubleshooting.html +10 -24
data/site-local/plugins/index.html +6 -20
data/site-local/plugins/module-generator.html +21 -35
data/site-local/plugins/report-build-warnings-log.html +53 -67
data/site-local/plugins/report-tests-gtestlike-stdout.html +6 -20
data/site-local/plugins/report-tests-ide-stdout.html +43 -57
data/site-local/plugins/report-tests-log-factory.html +50 -64
data/site-local/plugins/report-tests-pretty-stdout.html +7 -21
data/site-local/plugins/report-tests-raw-output-log.html +9 -21
data/site-local/plugins/report-tests-teamcity-stdout.html +20 -31
data/site-local/plugins/sanitize.html +56 -65
data/site-local/plugins/valgrind.html +49 -58
data/site-local/project/index.html +6 -20
data/site-local/project/release-history.html +6 -20
data/site-local/project/sbom.html +6 -20
data/site-local/project/upgrade.html +9 -20
data/site-local/reference/build-directives.html +6 -20
data/site-local/reference/command-line.html +15 -22
data/site-local/reference/environment-vars.html +6 -20
data/site-local/reference/gcov-plugin.html +6 -20
data/site-local/reference/global-collections.html +6 -20
data/site-local/reference/index.html +6 -20
data/site-local/reference/partials-macros.html +6 -20
data/site-local/reference/project-configuration.html +6 -20
data/site-local/sitemap.xml.gz +0 -0
data/site-local/snapshot/examples/cipher_quest/index.html +16 -30
data/site-local/snapshot/examples/temp_sensor/index.html +8 -22
data/site-local/snapshot/examples/wondrous_forest/index.html +6 -20
data/site-local/snapshot/plugins/bullseye/config/defaults_bullseye.rb +1 -1
data/site-local/snapshot/plugins/gcov/config/defaults_gcov.rb +1 -1
data/site-local/testing-guide/build-directives.html +14 -28
data/site-local/testing-guide/conventions.html +66 -27
data/site-local/testing-guide/frameworks.html +11 -25
data/site-local/testing-guide/index.html +6 -20
data/site-local/testing-guide/partials/configuration.html +8 -22
data/site-local/testing-guide/partials/conventions.html +8 -22
data/site-local/testing-guide/partials/directives.html +16 -30
data/site-local/testing-guide/partials/example.html +14 -28
data/site-local/testing-guide/partials/index.html +6 -20
data/site-local/testing-guide/partials/overview.html +6 -20
data/site-local/testing-guide/partials/variables.html +11 -25
data/site-local/testing-guide/test-cases.html +13 -27
data/site-local/testing-guide/test-sample.html +12 -26
data/site-local/testing-guide/test-suite-anatomy.html +6 -20
data/spec/integration/actionator_file_operations_spec.rb +91 -1
data/spec/integration/compile_commands_json_db_spec.rb +1 -1
data/spec/integration/configurator_pipeline_spec.rb +10 -0
data/spec/integration/configurator_validation_spec.rb +1 -1
data/spec/integration/dependencies/dependency_tracker_cache_hardening_spec.rb +26 -0
data/spec/integration/dependencies/dependency_tracker_core_spec.rb +62 -0
data/spec/integration/launcher_handoff_spec.rb +297 -0
data/spec/integration/mixin_loading_spec.rb +1 -1
data/spec/integration/module_generator_spec.rb +3 -3
data/spec/integration/nested_test_artifacts_spec.rb +99 -0
data/spec/integration/partials_module_resolution_spec.rb +7 -4
data/spec/integration/path_intake_scenarios_spec.rb +101 -0
data/spec/integration/path_scenarios_spec.rb +322 -0
data/spec/integration/quote_include_isolator_spec.rb +1 -1
data/spec/integration/rake_task_registry_plugins_spec.rb +95 -0
data/spec/integration/report_build_warnings_log_spec.rb +1 -1
data/spec/integration/report_tests_log_factory_spec.rb +1 -1
data/spec/integration/test_executable_manifest_spec.rb +1 -1
data/spec/integration/test_includes_extractinator_spec.rb +2 -1
data/spec/integration/test_naming_spec.rb +198 -0
data/spec/integration/test_source_file_checks_spec.rb +166 -0
data/spec/integration/tool_validator_spec.rb +1 -1
data/spec/integration/upgrade_docs_spec.rb +84 -0
data/spec/integration/vendor_copy_transient_io_retry_spec.rb +192 -75
data/spec/support/file_tree_helper.rb +88 -0
data/spec/support/integration/configurator_integration_helper.rb +10 -7
data/spec/support/integration/dependency_tracker_integration_helper.rb +1 -1
data/spec/support/integration/partials_generation_integration_helper.rb +2 -2
data/spec/support/integration/path_scenario_harness.rb +173 -0
data/spec/support/integration/spec_integration_helper.rb +1 -1
data/spec/support/integration/test_includes_harness.rb +13 -2
data/spec/support/spec_helper.rb +2 -0
data/spec/support/system/spec_system_helper.rb +7 -6
data/spec/support/system/system_context.rb +21 -3
data/spec/support/working_dir_tracking.rb +49 -0
data/spec/system/build_output_mirroring_spec.rb +2 -2
data/spec/system/conditional_mock_includes_spec.rb +1 -1
data/spec/system/delta_builds_spec.rb +137 -11
data/spec/system/gcov_deployment_spec.rb +1 -0
data/spec/system/header_include_path_validation_spec.rb +4 -4
data/spec/system/launcher_handoff_spec.rb +82 -0
data/spec/system/mock_include_folders_spec.rb +91 -0
data/spec/system/parent_directory_reference_spec.rb +5 -3
data/spec/system/path_handling_probes_spec.rb +192 -0
data/spec/system/preprocessing_parameterized_tests_spec.rb +1 -1
data/spec/system/rake_release_task_path_disambiguation_spec.rb +6 -6
data/spec/system/rake_test_task_path_disambiguation_spec.rb +85 -0
data/spec/system/special_path_characters_spec.rb +86 -0
data/spec/system/support/common_test_cases.rb +23 -21
data/spec/system/support/gcov_common_test_cases.rb +37 -9
data/spec/system/support/sanitize_common_test_cases.rb +2 -2
data/spec/system/support/valgrind_common_test_cases.rb +12 -12
data/spec/system/test_pipeline_stop_points_spec.rb +4 -4
data/spec/system/test_runner_system_include_spec.rb +1 -1
data/spec/system/test_source_file_directive_spec.rb +34 -5
data/spec/units/bin/actionator_spec.rb +14 -17
data/spec/units/bin/app_cfg_spec.rb +47 -0
data/spec/units/bin/cli_handler_spec.rb +284 -7
data/spec/units/bin/cli_helper_spec.rb +126 -45
data/spec/units/bin/installation_selector_spec.rb +114 -0
data/spec/units/bin/launchinator_spec.rb +171 -0
data/spec/units/bin/path_validator_spec.rb +10 -0
data/spec/units/bin/versionator_spec.rb +38 -6
data/spec/units/build_log_writer_spec.rb +57 -0
data/spec/units/config/build_root_policy_spec.rb +61 -0
data/spec/units/config/configurator_builder_spec.rb +37 -6
data/spec/units/config/configurator_paths_validator_spec.rb +292 -0
data/spec/units/config/configurator_setup_spec.rb +65 -103
data/spec/units/config/configurator_spec.rb +37 -6
data/spec/units/config/configurator_validator_spec.rb +1 -172
data/spec/units/default_tools_quoting_spec.rb +83 -0
data/spec/units/dependencies/dependency_cache_store_spec.rb +33 -2
data/spec/units/dependencies/dependency_debug_tree_spec.rb +1 -1
data/spec/units/dependencies/dependency_hasher_spec.rb +42 -1
data/spec/units/dependencies/dependency_path_normalizer_spec.rb +1 -1
data/spec/units/dependencies/dependency_tracker_spec.rb +3 -1
data/spec/units/filename_extension_spec.rb +11 -0
data/spec/units/filesystem/build_subpath_spec.rb +122 -0
data/spec/units/filesystem/destination_collision_spec.rb +30 -0
data/spec/units/{file_finder_helper_spec.rb → filesystem/file_finder_helper_spec.rb} +46 -1
data/spec/units/{file_finder_spec.rb → filesystem/file_finder_spec.rb} +188 -22
data/spec/units/{file_path_collection_utils_spec.rb → filesystem/file_path_collection_utils_spec.rb} +181 -1
data/spec/units/{file_path_utils_spec.rb → filesystem/file_path_utils_spec.rb} +204 -87
data/spec/units/filesystem/file_system_wrapper_spec.rb +33 -0
data/spec/units/filesystem/file_tree_spec.rb +511 -0
data/spec/units/filesystem/file_tree_windows_spec.rb +78 -0
data/spec/units/{file_wrapper_spec.rb → filesystem/file_wrapper_spec.rb} +154 -32
data/spec/units/{path_matcher_spec.rb → filesystem/path_matcher_spec.rb} +12 -1
data/spec/units/{path_mirror_spec.rb → filesystem/path_mirror_spec.rb} +32 -4
data/spec/units/filesystem/project_paths_spec.rb +147 -0
data/spec/units/filesystem/working_dir_spec.rb +71 -0
data/spec/units/generators/generator_spec.rb +12 -6
data/spec/units/generators/generator_test_results_backtrace_spec.rb +50 -46
data/spec/units/generators/generator_test_results_spec.rb +1 -1
data/spec/units/handoff_spec.rb +205 -0
data/spec/units/includes/include_factory_spec.rb +3 -3
data/spec/units/includes/include_pathinator_spec.rb +46 -0
data/spec/units/installation_spec.rb +228 -0
data/spec/units/library_resolver_spec.rb +157 -0
data/spec/units/mock_locator_spec.rb +76 -1
data/spec/units/partials/partializer_config_spec.rb +7 -0
data/spec/units/partials/partializer_spec.rb +1 -0
data/spec/units/partials_manager_spec.rb +17 -0
data/spec/units/plugins/bullseye_spec.rb +15 -2
data/spec/units/plugins/console_reportinator_spec.rb +18 -20
data/spec/units/plugins/dependencies_spec.rb +33 -7
data/spec/units/plugins/dependency_spec_spec.rb +17 -0
data/spec/units/plugins/gcov_spec.rb +28 -3
data/spec/units/plugins/gcovr_reportinator_spec.rb +19 -47
data/spec/units/plugins/gcovr_thresholds_spec.rb +95 -0
data/spec/units/plugins/module_generator_spec.rb +5 -5
data/spec/units/plugins/report_build_warnings_log_spec.rb +3 -3
data/spec/units/plugins/report_log_writer_plugin_spec.rb +10 -1
data/spec/units/plugins/report_tests_raw_output_log_spec.rb +13 -2
data/spec/units/plugins/report_tests_teamcity_stdout_spec.rb +77 -3
data/spec/units/plugins/reportgenerator_reportinator_spec.rb +1 -1
data/spec/units/plugins/sanitize_records_spec.rb +3 -1
data/spec/units/plugins/sanitize_spec.rb +1 -1
data/spec/units/plugins/valgrind_spec.rb +23 -8
data/spec/units/preprocess/preprocessinator_comment_stripper_spec.rb +1 -1
data/spec/units/rake_app/rakefile_component_resolver_spec.rb +21 -0
data/spec/units/rake_app/test_task_name_spec.rb +47 -0
data/spec/units/release_build_executor_spec.rb +53 -14
data/spec/units/release_build_planner_spec.rb +15 -3
data/spec/units/reportinator_spec.rb +5 -5
data/spec/units/standin_headerinator_spec.rb +31 -1
data/spec/units/test_build_executor_spec.rb +107 -5
data/spec/units/test_build_planner_spec.rb +104 -2
data/spec/units/test_build_setup_spec.rb +96 -12
data/spec/units/test_context_extractor_spec.rb +25 -0
data/spec/units/test_file_preprocessinator_spec.rb +17 -1
data/spec/units/test_includes_extractinator_spec.rb +5 -1
data/spec/units/test_invoker/objects_wiring_spec.rb +6 -3
data/spec/units/test_invoker_spec.rb +14 -1
data/spec/units/test_source_file_directive_resolver_spec.rb +38 -7
data/spec/units/tool_executor_spec.rb +26 -0
data/spec/units/yaml_wrapper_spec.rb +11 -0
metadata +122 -33
data/lib/ceedling/file_path_collection_utils.rb +0 -164
data/site-local/assets/stylesheets/main.ec1eaa64.min.css +0 -1
data/site-local/assets/stylesheets/main.ec1eaa64.min.css.map +0 -1
data/site-local/assets/stylesheets/palette.ab4e12ef.min.css +0 -1
data/site-local/assets/stylesheets/palette.ab4e12ef.min.css.map +0 -1

data/site-local/development/plugins/rake-tasks.html CHANGED Viewed

@@ -19,7 +19,7 @@
       <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
@@ -27,10 +27,10 @@
-      <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.57a0d79d.min.css">
-        <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
+        <link rel="stylesheet" href="../../assets/stylesheets/palette.fb2fffe2.min.css">
@@ -87,30 +87,16 @@
     </div>
     <div data-md-component="announce">
-        <aside class="md-banner">
-          <div class="md-banner__inner md-grid md-typeset">
-          </div>
-        </aside>
     </div>
       <div data-md-color-scheme="default" data-md-component="outdated" hidden>
           <aside class="md-banner md-banner--warning">
             <div class="md-banner__inner md-grid md-typeset">
-    You are not viewing the latest version.
+              You are not viewing the latest version.
     <a href="../../..">
       <strong>Click here to go to latest.</strong>
     </a>
             </div>
             <script>var el=document.querySelector("[data-md-component=outdated]"),base=new URL("../.."),outdated=__md_get("__outdated",sessionStorage,base);!0===outdated&&el&&(el.hidden=!1)</script>
           </aside>
@@ -4416,9 +4402,9 @@
 </div>
 <h2 id="example-rake-task">Example Rake task</h2>
 <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="c1"># Only tasks with description are listed by `ceedling -T`</span>
-<a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="n">desc</span><span class="w"> </span><span class="s2">&quot;Print hello world to console&quot;</span>
+<a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="n">desc</span><span class="w"> </span><span class="s2">"Print hello world to console"</span>
 <a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="n">task</span><span class="w"> </span><span class="ss">:hello_world</span><span class="w"> </span><span class="k">do</span>
-<a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="n">sh</span><span class="w"> </span><span class="s2">&quot;echo Hello World!&quot;</span>
+<a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="n">sh</span><span class="w"> </span><span class="s2">"echo Hello World!"</span>
 <a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="k">end</span>
 </code></pre></div>
 <p>Resulting, example command line:</p>
@@ -4518,10 +4504,10 @@ See <a href="../../getting-started/builds.html">Delta Builds</a> for how this tr
-      <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>
+      <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>
-      <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
+      <script src="../../assets/javascripts/bundle.c21346df.min.js"></script>
   </body>

data/site-local/development/releases.html CHANGED Viewed

@@ -21,7 +21,7 @@
       <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
@@ -29,10 +29,10 @@
-      <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.57a0d79d.min.css">
-        <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
+        <link rel="stylesheet" href="../assets/stylesheets/palette.fb2fffe2.min.css">
@@ -89,30 +89,16 @@
     </div>
     <div data-md-component="announce">
-        <aside class="md-banner">
-          <div class="md-banner__inner md-grid md-typeset">
-          </div>
-        </aside>
     </div>
       <div data-md-color-scheme="default" data-md-component="outdated" hidden>
           <aside class="md-banner md-banner--warning">
             <div class="md-banner__inner md-grid md-typeset">
-    You are not viewing the latest version.
+              You are not viewing the latest version.
     <a href="../..">
       <strong>Click here to go to latest.</strong>
     </a>
             </div>
             <script>var el=document.querySelector("[data-md-component=outdated]"),base=new URL(".."),outdated=__md_get("__outdated",sessionStorage,base);!0===outdated&&el&&(el.hidden=!1)</script>
           </aside>
@@ -4143,6 +4129,23 @@
     </span>
   </a>
+    <nav class="md-nav" aria-label="Documentation deployment">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#revising-an-earlier-versions-documentation" class="md-nav__link">
+    <span class="md-ellipsis">
+        Revising an earlier version’s documentation
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
 </li>
     </ul>
@@ -4453,6 +4456,23 @@
     </span>
   </a>
+    <nav class="md-nav" aria-label="Documentation deployment">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#revising-an-earlier-versions-documentation" class="md-nav__link">
+    <span class="md-ellipsis">
+        Revising an earlier version’s documentation
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
 </li>
     </ul>
@@ -4533,9 +4553,17 @@ release.</p>
 <li><code>master</code> holds the latest release and subsequent patch releases.</li>
 <li><code>next_version</code> holds the next minor or major release.</li>
 </ul>
-<p>Both branches are protected. Changes reach them only through pull requests, and
-only a maintainer merges a pull request, once CI passes. Direct pushes,
-force-pushes, and branch deletion are blocked.</p>
+<p>Both branches are protected by a GitHub ruleset. Changes reach them only through
+pull requests, and a pull request merges only once the <strong>CI Gate</strong> check passes.
+Direct pushes, force-pushes, and branch deletion are blocked. Only a maintainer
+merges a pull request.</p>
+<p>CI Gate reduces every CI job to one result. A pull request that changes only
+documentation skips the test suites and still passes CI Gate, so it is ready to
+merge in minutes. The development workflow guide describes <a href="https://github.com/ThrowTheSwitch/Ceedling/blob/master/.github/WORKFLOWS.md">what counts as
+documentation</a>.</p>
+<p>Maintainers squash-merge community pull requests, so each lands as one commit
+attributed to its author. Maintainers may merge their own branches with a merge
+commit to keep their history.</p>
 <h3 id="patch-work">Patch work</h3>
 <p>Branch from <code>master</code> for a patch fix. Open the pull request against <code>master</code>.</p>
 <p>Short-lived topic branches are the norm. Delete the branch once the pull request
@@ -4546,13 +4574,16 @@ merges.</p>
 <p><code>rake lint:changed</code> assumes this. It compares against <code>next_version</code> unless you
 name another branch or revision.</p>
 <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="w"> </span>&gt;<span class="w"> </span>rake<span class="w"> </span>lint:changed
-<a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w"> </span>&gt;<span class="w"> </span>rake<span class="w"> </span><span class="s2">&quot;lint:changed[master]&quot;</span>
+<a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w"> </span>&gt;<span class="w"> </span>rake<span class="w"> </span><span class="s2">"lint:changed[master]"</span>
 </code></pre></div>
 <h2 id="tags-drive-releases">Tags drive releases</h2>
 <p>Pushing a tag publishes. Nothing else does.</p>
 <p>Full releases are tagged on <code>master</code>. Pre-releases are tagged on <code>next_version</code>.
 Neither workflow checks which branch a tag points at, so the convention is yours
 to keep.</p>
+<p>Only repository administrators can create, move, or delete <code>v</code> tags. A pushed
+release tag is left where it is, so a published version always points at the code
+it was built from.</p>
 <table>
 <thead>
 <tr>
@@ -4565,17 +4596,22 @@ to keep.</p>
 <tr>
 <td><code>v1.2.0</code></td>
 <td><code>release.yml</code></td>
-<td>GitHub release</td>
+<td>GitHub release, and the gem published to RubyGems.org</td>
 </tr>
 <tr>
 <td><code>v1.2.0-pre.1</code></td>
 <td><code>prerelease.yml</code></td>
-<td>GitHub pre-release</td>
+<td>GitHub pre-release only</td>
 </tr>
 </tbody>
 </table>
 <p>A hyphenated suffix becomes a dot in the gem version, which is RubyGems
 pre-release notation. Tag <code>v1.2.0-pre.1</code> builds <code>ceedling-1.2.0.pre.1.gem</code>.</p>
+<p>A full release reaches RubyGems.org through <a href="https://guides.rubygems.org/trusted-publishing/">trusted publishing</a>. The release
+workflow exchanges its own GitHub identity for a short-lived RubyGems credential
+and pushes the gem it built. No maintainer holds or handles an API key.
+Pre-release gems are attached to the GitHub pre-release and never pushed to
+RubyGems.org.</p>
 <div class="admonition warning">
 <p class="admonition-title">Warning</p>
 <p>Neither workflow runs the test suite. Both build and publish directly from the
@@ -4618,9 +4654,12 @@ release, then commit and continue development.</p>
 <li>Push <code>v1.2.0-pre.1</code> from <code>next_version</code>. CI creates a GitHub-available pre-release.</li>
 <li>Iterate with <code>-pre.2</code> and onward as needed.</li>
 <li>Bring the work onto <code>master</code> once the release is ready.</li>
-<li>Push <code>v1.2.0</code> from <code>master</code>. CI creates the GitHub-available release.</li>
-<li>A maintainer with RubyGems permissions downloads the Ceedling gem from (4) and manually pushes to RubyGems.org.</li>
-<li>Bump <code>lib/version.rb</code> and continue development.</li>
+<li>Date the release’s sections in <code>docs/Changelog.md</code>, <code>docs/BreakingChanges.md</code>, and <code>docs/KnownIssues.md</code>.</li>
+<li>Push <code>v1.2.0</code> from <code>master</code>. CI creates the GitHub-available release and publishes the gem to RubyGems.org.</li>
+<li>Bump <code>lib/version.rb</code> and continue development. Open the next release’s sections:</li>
+<li><code>docs/Changelog.md</code>: a new, empty section.</li>
+<li><code>docs/KnownIssues.md</code>: a copy of the released section. Remove each issue the next release resolves, and close the released section by naming it.</li>
+<li><code>docs/BreakingChanges.md</code>: a section only once the next release breaks something.</li>
 </ol>
 <h2 id="documentation-deployment">Documentation deployment</h2>
 <p>Documentation versions are deployed by hand, separately from the gem. These tasks
@@ -4630,6 +4669,22 @@ take a bare version number rather than a tag.</p>
 </code></pre></div>
 <p>The full task list is in the <a href="workflow.html#documentation">documentation section</a> of the development
 workflow guide.</p>
+<h3 id="revising-an-earlier-versions-documentation">Revising an earlier version’s documentation</h3>
+<p>Once a newer release becomes <code>latest</code>, its <code>docs/mkdocs/</code> content is the primary
+source of the published site. An earlier version’s published documentation can
+still need an occasional revision. A <code>docs-</code> tag records the source of each such
+version’s published documentation.</p>
+<ol>
+<li>Branch from the version’s <code>docs-&lt;version&gt;</code> tag, or from its release tag if it
+   has no <code>docs-</code> tag yet.</li>
+<li>Revise <code>docs/mkdocs/</code>.</li>
+<li>Deploy without changing <code>latest</code>, for example <code>rake docs:deploy:release[1.1.0]</code>.</li>
+<li>Point the annotated <code>docs-&lt;version&gt;</code> tag at the deployed commit, with a message
+   naming what was deployed. <code>docs-1.1.0</code> is an example.</li>
+</ol>
+<p>The branch need not merge anywhere. The tag is the record of what the published
+documentation was built from. Only repository administrators can create, move, or
+delete <code>docs-</code> tags.</p>
 <p><br/><br/></p>
@@ -4698,10 +4753,10 @@ workflow guide.</p>
-      <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>
+      <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>
-      <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
+      <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
   </body>

data/site-local/development/workflow.html CHANGED Viewed

@@ -21,7 +21,7 @@
       <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
@@ -29,10 +29,10 @@
-      <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.57a0d79d.min.css">
-        <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
+        <link rel="stylesheet" href="../assets/stylesheets/palette.fb2fffe2.min.css">
@@ -89,30 +89,16 @@
     </div>
     <div data-md-component="announce">
-        <aside class="md-banner">
-          <div class="md-banner__inner md-grid md-typeset">
-          </div>
-        </aside>
     </div>
       <div data-md-color-scheme="default" data-md-component="outdated" hidden>
           <aside class="md-banner md-banner--warning">
             <div class="md-banner__inner md-grid md-typeset">
-    You are not viewing the latest version.
+              You are not viewing the latest version.
     <a href="../..">
       <strong>Click here to go to latest.</strong>
     </a>
             </div>
             <script>var el=document.querySelector("[data-md-component=outdated]"),base=new URL(".."),outdated=__md_get("__outdated",sessionStorage,base);!0===outdated&&el&&(el.hidden=!1)</script>
           </aside>
@@ -4026,6 +4012,23 @@
     </span>
   </a>
+    <nav class="md-nav" aria-label="Code organization">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#running-your-repository-with-which-ceedling" class="md-nav__link">
+    <span class="md-ellipsis">
+        Running your repository with Which Ceedling
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
 </li>
         <li class="md-nav__item">
@@ -4365,17 +4368,6 @@
       </ul>
     </nav>
-</li>
-        <li class="md-nav__item">
-  <a href="#bin-vs-lib" class="md-nav__link">
-    <span class="md-ellipsis">
-        bin/ vs. lib/
-    </span>
-  </a>
 </li>
     </ul>
@@ -4625,6 +4617,23 @@
     </span>
   </a>
+    <nav class="md-nav" aria-label="Code organization">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#running-your-repository-with-which-ceedling" class="md-nav__link">
+    <span class="md-ellipsis">
+        Running your repository with Which Ceedling
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
 </li>
         <li class="md-nav__item">
@@ -4964,17 +4973,6 @@
       </ul>
     </nav>
-</li>
-        <li class="md-nav__item">
-  <a href="#bin-vs-lib" class="md-nav__link">
-    <span class="md-ellipsis">
-        bin/ vs. lib/
-    </span>
-  </a>
 </li>
     </ul>
@@ -5063,6 +5061,20 @@
    processing, validation, and plugin loading.</li>
 <li>Triggering the build/plugin task named at the command line.</li>
 </ol>
+<h3 id="running-your-repository-with-which-ceedling">Running your repository with Which Ceedling</h3>
+<p>Depending on what you’re working on you may need to run Ceedling using
+a specialized approach.</p>
+<p>To run your local repository on a project, either:</p>
+<ol>
+<li>Point <code>:project</code> ↳ <code>:which_ceedling</code> or <code>WHICH_CEEDLING</code> at your
+   repository, then run the <code>ceedling</code> command you already have installed. It hands
+   each command off to your repository’s own <code>bin/ceedling</code>, so your changes
+   in both <code>bin/</code> and <code>lib/</code> run.</li>
+<li>Run your repository’s <code>bin/ceedling</code> directly. Do this for a command or
+   option only your repository knows, or to attach a debugger.</li>
+</ol>
+<p>See <a href="../configuration/which-ceedling.html#ceedling-development">Which Ceedling: Ceedling development</a> for the
+details and caveats.</p>
 <h2 id="installation-options">Installation options</h2>
 <h3 id="local-installation">Local installation</h3>
 <p>After installing Ruby…</p>
@@ -5202,7 +5214,7 @@ flag must be passed explicitly every time.</p>
 <p class="admonition-title">Tip</p>
 <p>If you'd rather not remember the <code>--prefer-local</code>, add a shell alias,
 e.g. in <code>~/.bashrc</code> / <code>~/.zshrc</code>:</p>
-<div class="highlight"><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="nb">alias</span><span class="w"> </span>bundle-install-local<span class="o">=</span><span class="s2">&quot;bundle install --prefer-local&quot;</span>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="nb">alias</span><span class="w"> </span>bundle-install-local<span class="o">=</span><span class="s2">"bundle install --prefer-local"</span>
 </code></pre></div>
 </div>
 <h3 id="checking-your-environment-without-installing-anything">Checking your environment without installing anything</h3>
@@ -5232,10 +5244,10 @@ statements and conventions are often messy.</p>
 <p>Each curated entry records three things. The license is an SPDX identifier
 or expression. <code>verified_for</code> is the version the license was read against.
 <code>source</code> names where it was read.</p>
-<div class="highlight"><pre><span></span><code><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="s1">&#39;rake&#39;</span><span class="w"> </span><span class="o">=&gt;</span><span class="w"> </span><span class="p">{</span>
-<a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="w">  </span><span class="ss">license</span><span class="p">:</span><span class="w"> </span><span class="s1">&#39;MIT&#39;</span><span class="p">,</span>
-<a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="w">  </span><span class="ss">verified_for</span><span class="p">:</span><span class="w"> </span><span class="s1">&#39;13.2.1&#39;</span><span class="p">,</span>
-<a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="w">  </span><span class="ss">source</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;the gem&#39;s own gemspec&quot;</span>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="s1">'rake'</span><span class="w"> </span><span class="o">=&gt;</span><span class="w"> </span><span class="p">{</span>
+<a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="w">  </span><span class="ss">license</span><span class="p">:</span><span class="w"> </span><span class="s1">'MIT'</span><span class="p">,</span>
+<a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="w">  </span><span class="ss">verified_for</span><span class="p">:</span><span class="w"> </span><span class="s1">'13.2.1'</span><span class="p">,</span>
+<a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="w">  </span><span class="ss">source</span><span class="p">:</span><span class="w"> </span><span class="s2">"the gem's own gemspec"</span>
 <a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="p">},</span>
 </code></pre></div>
 <p><code>rake sbom:build</code> refuses to run when the list and the resolved dependencies
@@ -5366,7 +5378,7 @@ once with the setup task.</p>
 <p>Then lint the whole project, or only the files your branch changed.</p>
 <div class="highlight"><pre><span></span><code><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="w"> </span>&gt;<span class="w"> </span>rake<span class="w"> </span>lint
 <a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="w"> </span>&gt;<span class="w"> </span>rake<span class="w"> </span>lint:changed
-<a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="w"> </span>&gt;<span class="w"> </span>rake<span class="w"> </span><span class="s2">&quot;lint:changed[master]&quot;</span>
+<a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="w"> </span>&gt;<span class="w"> </span>rake<span class="w"> </span><span class="s2">"lint:changed[master]"</span>
 </code></pre></div>
 <p><code>lint:changed</code> is the faster loop while working on a branch. It compares against
 <code>next_version</code> unless you name another branch or revision. Quote the task name so
@@ -5409,8 +5421,8 @@ once with the setup task.</p>
 <div class="highlight"><pre><span></span><code><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a><span class="w"> </span>&gt;<span class="w"> </span>rake<span class="w"> </span>profile:setup
 </code></pre></div>
 <p>Then profile any example project against any Ceedling build task.</p>
-<div class="highlight"><pre><span></span><code><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a><span class="w"> </span>&gt;<span class="w"> </span>rake<span class="w"> </span><span class="s2">&quot;profile:run[temp_sensor,test:all]&quot;</span>
-<a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a><span class="w"> </span>&gt;<span class="w"> </span>rake<span class="w"> </span><span class="s2">&quot;profile:run[temp_sensor,clobber test:all]&quot;</span>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a><span class="w"> </span>&gt;<span class="w"> </span>rake<span class="w"> </span><span class="s2">"profile:run[temp_sensor,test:all]"</span>
+<a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a><span class="w"> </span>&gt;<span class="w"> </span>rake<span class="w"> </span><span class="s2">"profile:run[temp_sensor,clobber test:all]"</span>
 </code></pre></div>
 <p>The first argument names a project under <code>examples/</code>. The choices are
 <code>cipher_quest</code>, <code>temp_sensor</code>, and <code>wondrous_forest</code>. The second argument is
@@ -5574,27 +5586,6 @@ configuration is in <code>mkdocs.yml</code> while the local site bundle configur
 port 8000, VS Code detects it and shows a notification. The <strong>Ports</strong> panel also
 provides an <strong>Open in Browser</strong> button.</p>
 <p><strong>Hosted site:</strong> <a href="https://docs.throwtheswitch.org/Ceedling/">https://docs.throwtheswitch.org/Ceedling/</a></p>
-<h2 id="bin-vs-lib"><code>bin/</code> vs. <code>lib/</code></h2>
-<p>Most of Ceedling’s functionality is contained in the application code residing
-in <code>lib/</code>. Ceedling’s command line handling, startup configuration, project
-file loading, and mixin handling are contained in a “bootloader” in <code>bin/</code>.
-The code in <code>bin/</code> is the source of the <code>ceedling</code> command line tool and
-launches the application from <code>lib/</code>.</p>
-<p>Depending on what you’re working on you may need to run Ceedling using
-a specialized approach.</p>
-<p>If you are only working in <code>lib/</code>, you can:</p>
-<ol>
-<li>Run Ceedling using the <code>ceedling</code> command line utility you already have
-   installed. The code in <code>bin/</code> will run from your locally installed gem or
-   from within your Docker container and launch the Ceedling application for
-   you.</li>
-<li>Modify a project file by setting a path value for <code>:project</code> ↳ <code>:which_ceedling</code>
-   that points to the local copy of Ceedling you cloned from the Git repository.</li>
-</ol>
-<p>If you are working in <code>bin/</code>, running <code>ceedling</code> at the command line will not
-call your modified code. Instead, you must execute the path to the executable
-<code>ceedling</code> in the <code>bin/</code> folder of the local Ceedling repository you are
-working on.</p>
 <p><br/><br/></p>
@@ -5663,10 +5654,10 @@ working on.</p>
-      <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>
+      <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>
-      <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
+      <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
   </body>

data/site-local/getting-started/builds.html CHANGED Viewed

@@ -21,7 +21,7 @@
       <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
@@ -29,10 +29,10 @@
-      <link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.57a0d79d.min.css">
-        <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
+        <link rel="stylesheet" href="../assets/stylesheets/palette.fb2fffe2.min.css">
@@ -89,30 +89,16 @@
     </div>
     <div data-md-component="announce">
-        <aside class="md-banner">
-          <div class="md-banner__inner md-grid md-typeset">
-          </div>
-        </aside>
     </div>
       <div data-md-color-scheme="default" data-md-component="outdated" hidden>
           <aside class="md-banner md-banner--warning">
             <div class="md-banner__inner md-grid md-typeset">
-    You are not viewing the latest version.
+              You are not viewing the latest version.
     <a href="../..">
       <strong>Click here to go to latest.</strong>
     </a>
             </div>
             <script>var el=document.querySelector("[data-md-component=outdated]"),base=new URL(".."),outdated=__md_get("__outdated",sessionStorage,base);!0===outdated&&el&&(el.hidden=!1)</script>
           </aside>
@@ -4466,6 +4452,8 @@
 </ol>
 <p>Where a C file change ripples out only along that file’s dependency chain, a shared configuration change ripples out across every target that reads that piece of configuration — often the whole project. File changes tend to trigger depth-oriented rebuilds while configuration changes tend to trigger breadth-oriented rebuilds.</p>
 <h2 id="delta-build-special-cases">Delta build special cases</h2>
+<p>An upgrade that changes where Ceedling organizes build output rebuilds everything once. The first build after upgrading logs a warning saying so. Run <code>ceedling clobber</code> to remove the output left in the old layout, which coverage reports in particular would otherwise still read.</p>
+<p>A link artifact is relinked when a dependent library changes. Ceedling finds library files <a href="../configuration/reference/libraries.html"><code>:libraries</code></a> among <code>:paths</code> ↳ <code>:libraries</code>, and tracks the libraries the <a href="../plugins/dependencies.html">Dependencies plugin</a> builds. A library found only on your toolchain’s own search paths, or through a <code>-L</code> written into <code>:flags</code>, is not tracked. Run <code>ceedling clobber</code> after any such “untracked” library changes.</p>
 <p>Add the <a href="command-line.html#ceedling-build-tasks"><code>--force-test-rerun</code></a> flag to test build tasks to bypass the checks for only running changed test fixture executables. This command line flag forces those executables to run and produce fresh test results.</p>
 <p>When <a href="../configuration/reference/unity.html#shuffle_tests">Unity’s test shuffling feature</a> is enabled, delta builds automatically rerun test fixture executables to randomize test case order regardless of change or lack thereof in a test’s dependency tree. That is, since the feature requires test executables to run in order to shuffle test case order, effectively, delta builds are disabled for test fixture executables.</p>
 <h2 id="delta-build-examples">Delta build examples</h2>
@@ -4597,10 +4585,10 @@ object’s own source changed.</p>
-      <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>
+      <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>
-      <script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
+      <script src="../assets/javascripts/bundle.c21346df.min.js"></script>
   </body>