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/configuration/reference/index.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>
@@ -4550,10 +4536,10 @@ test fixture. Includes shortcuts for modifying built-in tools.</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/configuration/reference/libraries.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>
@@ -4542,14 +4528,32 @@ command line argument will be <code>-lm</code>.</p>
 <p><strong>Default</strong>: <code>-l${1}</code> (GCC format)</p>
 <h2 id="path_flag"><code>:path_flag</code></h2>
 <p>Command line argument format for adding a library search path.</p>
-<p>Library search paths may be added to your project with <code>:paths</code> ↳ <code>:libraries</code>.</p>
+<p>Library search paths may be added to your project with <code>:paths</code> ↳ <code>:libraries</code>.
+Each directory those entries collect becomes one argument, as for any <code>:paths</code>
+entry. A glob names each directory it matches, and a <code>-:</code> entry removes
+directories. An entry that collects no existing directory adds no argument.</p>
 <p><strong>Default</strong>: <code>-L "${1}"</code> (GCC format)</p>
 <h2 id="libraries-notes"><code>:libraries</code> notes</h2>
 <ul>
-<li>If you've specified your own link step, you are going to want to add <code>${4}</code> to
+<li>
+<p>A <a href="../../getting-started/builds.html#delta-build-special-cases">delta build</a>
+  relinks when a library file entry in <code>:libraries</code> changes names or paths.
+  A library Ceedling cannot find, such as one internal to your toolchain’s
+  search paths, is not tracked. Ceedling looks for named libraries within
+  <code>:paths</code> ↳ <code>:libraries</code>:</p>
+<ul>
+<li>A bare name such as <code>m</code> as <code>libm.a</code>, <code>libm.so</code>, and the other typical
+  names toolchains use.</li>
+<li>An entry such as <code>:libm.a</code> as that exact filename.</li>
+<li>And a full filepath as itself.</li>
+</ul>
+</li>
+<li>
+<p>If you've specified your own link step, you are going to want to add <code>${4}</code> to
   your argument list in the position where library files should be added to the
   command line. For <code>gcc</code>, this is often at the very end. Other tools may vary.
-  See the <code>:tools</code> section for more.</li>
+  See the <code>:tools</code> section for more.</p>
+</li>
 </ul>
 <p><br/><br/></p>
@@ -4619,10 +4623,10 @@ command line argument will be <code>-lm</code>.</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/configuration/reference/mixins.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>
@@ -4449,10 +4435,10 @@ in the <a href="../mixins.html">discussion of project files and mixins</a>.</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/configuration/reference/partials.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>
@@ -4478,10 +4464,10 @@ lookup table). Ordinarily, there’s no reason to lower it.</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/configuration/reference/paths.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>
@@ -4755,15 +4741,15 @@ regardless of platform, but you will see the effects in logging.</p>
 <h3 id="advanced-entries-with-globs-and-string-expansion">Advanced entries with globs and string expansion</h3>
 <div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nt">:paths</span><span class="p">:</span>
 <a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="w">  </span><span class="nt">:test</span><span class="p">:</span><span class="w">                             </span>
-<a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">test/**/f???</span><span class="w">             </span><span class="c1"># Every 4 character &quot;f-series&quot; subdirectory beneath test/</span>
+<a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">test/**/f???</span><span class="w">             </span><span class="c1"># Every 4 character "f-series" subdirectory beneath test/</span>
 <a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a>
 <a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w">  </span><span class="nt">:my_things</span><span class="p">:</span><span class="w">                  </span><span class="c1"># Custom path list</span>
-<a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;#{PROJECT_ROOT}/other&quot;</span><span class="w">  </span><span class="c1"># Inline Ruby string expansion using Ceedling global constant</span>
+<a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">"#{PROJECT_ROOT}/other"</span><span class="w">  </span><span class="c1"># Inline Ruby string expansion using Ceedling global constant</span>
 </code></pre></div>
 <div class="highlight"><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="nt">:paths</span><span class="p">:</span>
 <a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="w">  </span><span class="nt">:test</span><span class="p">:</span><span class="w">                             </span>
 <a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">test/{foo,b*,xyz}</span><span class="w">  </span><span class="c1"># Path list will include test/foo/, test/xyz/, and any subdirectories </span>
-<a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="w">                         </span><span class="c1"># beneath test/ beginning with &#39;b&#39;, including just test/b/</span>
+<a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="w">                         </span><span class="c1"># beneath test/ beginning with 'b', including just test/b/</span>
 </code></pre></div>
 <p>Globs and inline Ruby string expansion can require trial and error to arrive at
 your intended results. Ceedling provides as much validation of paths as is
@@ -4845,7 +4831,19 @@ files contained in those paths. A custom list is just that — a custom list of
 paths.</p>
 <h2 id="paths-configuration-options-notes"><code>:paths</code> configuration options &amp; notes</h2>
 <ol>
-<li>A path can be absolute (fully qualified) or relative.</li>
+<li>A path can be absolute (fully qualified) or relative. A relative path is relative to
+   the working directory, where you run <code>ceedling</code>, not to your project file’s
+   directory. For a project file named with <code>--project</code> from another directory, write
+   its paths relative to that other directory.</li>
+<li><code>~</code> at the start of a path names your home directory. <code>~user</code> is a directory named
+   <code>~user</code>.</li>
+<li>A path reached through a symlink names the place the symlink leads to, so two
+   entries reaching one directory collect it once. Directories found below an entry
+   keep the spelling they are found by, as an <code>#include</code> reaches them.</li>
+<li>An entry based above the build root, such as <code>./**</code> or <code>../**</code>, collects nothing
+   from it. An entry within the build root collects from it with a warning, but no entry
+   collects from the directories Ceedling and its plugins create, such as <code>test/</code>,
+   <code>release/</code>, <code>vendor/</code>, and <code>artifacts/</code> below the build root, or the mocks directory.</li>
 <li>A path can include a glob matcher (more on this below).</li>
 <li>A path can use <a href="../project-file.html#inline-ruby-string-expansion">inline Ruby string expansion</a>.</li>
 <li>Subtractive paths are possible and useful. See the documentation below.</li>
@@ -4897,6 +4895,17 @@ collection.</p>
 <p>By default, paths are additive. For pretty alignment in your YAML, you may also
 use <code>+:</code>, but strictly speaking, it’s not necessary.</p>
 <p>Subtractive paths may be simple paths or globs just like any other path entry.</p>
+<p>A subtractive entry removes the directories it names and every directory below them.
+An additive entry naming one of those directories more closely keeps it:</p>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nt">:paths</span><span class="p">:</span>
+<a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="w">  </span><span class="nt">:source</span><span class="p">:</span>
+<a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">src/**</span>
+<a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">-:src/legacy</span><span class="w">       </span><span class="c1"># Removes src/legacy/ and every directory below it...</span>
+<a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">src/legacy/keep</span><span class="w">    </span><span class="c1"># ...except src/legacy/keep/, which this entry names</span>
+</code></pre></div>
+<p>A subtractive entry that names nothing logs a warning, so a mistyped entry does
+not pass unnoticed. Below the build root, where nothing exists before a first
+build, it passes without a word.</p>
 <div class="admonition warning">
 <p class="admonition-title">Quote the whole entry, decoration included</p>
 <p>YAML keeps quote marks that begin partway through a value as part of the
@@ -4904,11 +4913,11 @@ value. Quoting only the path leaves quote marks in the path, and
 Ceedling rejects the entry. Quote an entry whenever it holds <code>#{…}</code>
 <a href="../project-file.html#inline-ruby-string-expansion">inline Ruby string expansion</a>, because YAML
 otherwise reads the <code>#</code> as the start of a comment.</p>
-<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="c1"># Correct</span>
-<a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;-:#{ENV[&#39;SRC_ROOT&#39;]}/vendor/legacy&quot;</span>
-<a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a>
-<a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="c1"># Incorrect -- the quote marks become part of the path</span>
-<a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">-:&quot;#{ENV[&#39;SRC_ROOT&#39;]}/vendor/legacy&quot;</span>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="c1"># Correct</span>
+<a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">"-:#{ENV['SRC_ROOT']}/vendor/legacy"</span>
+<a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a>
+<a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="c1"># Incorrect -- the quote marks become part of the path</span>
+<a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">-:"#{ENV['SRC_ROOT']}/vendor/legacy"</span>
 </code></pre></div>
 </div>
 <div class="admonition note">
@@ -4994,10 +5003,10 @@ a test executable’s own compile/link list.</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/configuration/reference/plugins.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>
@@ -4516,10 +4502,10 @@ test results (usually <code>report_tests_pretty_stdout</code>).</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>