ceedling 1.2.1 → 1.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/GIT_COMMIT_SHA +1 -1
- data/README.md +11 -9
- data/Rakefile +2 -1
- 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/assets/fixtures/tests_with_partials_coverage/src/private_macro.c +7 -0
- data/assets/fixtures/tests_with_partials_coverage/src/private_macro.h +5 -0
- data/assets/fixtures/tests_with_partials_coverage/src/tally.c +13 -0
- data/assets/fixtures/tests_with_partials_coverage/src/tally.h +4 -0
- data/assets/fixtures/tests_with_partials_coverage/test/test_private_macro.c +10 -0
- data/assets/fixtures/tests_with_partials_coverage/test/test_tally.c +9 -0
- data/bin/actionator.rb +6 -12
- data/bin/app_cfg.rb +14 -1
- data/bin/ceedling +13 -3
- data/bin/cli.rb +25 -6
- data/bin/cli_handler.rb +113 -73
- data/bin/cli_helper.rb +51 -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 +86 -1
- data/docs/Changelog.md +145 -3
- data/docs/KnownIssues.md +179 -6
- data/docs/ReleaseNotes.md +13 -0
- data/examples/wondrous_forest/README.md +29 -1
- data/examples/wondrous_forest/src/ForestUnits.h +23 -0
- data/examples/wondrous_forest/src/RainGauge.c +59 -0
- data/examples/wondrous_forest/src/RainGauge.h +39 -0
- data/examples/wondrous_forest/src/RainTipIsr.c +17 -0
- data/examples/wondrous_forest/src/RainTipIsr.h +14 -0
- data/examples/wondrous_forest/test/TestRainGauge.c +126 -0
- data/lib/ceedling/build_log_writer.rb +33 -0
- data/lib/ceedling/c_extractor/README.md +15 -7
- data/lib/ceedling/c_extractor/c_extractor.rb +25 -14
- data/lib/ceedling/c_extractor/c_extractor_code_text.rb +84 -54
- data/lib/ceedling/c_extractor/c_extractor_constants.rb +18 -7
- data/lib/ceedling/c_extractor/c_extractor_declarations.rb +319 -283
- data/lib/ceedling/c_extractor/c_extractor_declarator.rb +285 -0
- data/lib/ceedling/c_extractor/c_extractor_defined_type.rb +111 -0
- data/lib/ceedling/c_extractor/c_extractor_definitions.rb +174 -121
- data/lib/ceedling/c_extractor/c_extractor_functions.rb +191 -162
- data/lib/ceedling/c_extractor/c_extractor_preprocessing.rb +46 -55
- data/lib/ceedling/c_extractor/c_extractor_statement.rb +30 -0
- data/lib/ceedling/c_extractor/c_extractor_types.rb +63 -41
- data/lib/ceedling/c_extractor/c_module_edits.rb +48 -0
- data/lib/ceedling/c_identifier.rb +21 -0
- data/lib/ceedling/ceedling.h +8 -0
- data/lib/ceedling/config/build_root_policy.rb +70 -0
- data/lib/ceedling/config/configurator.rb +18 -19
- data/lib/ceedling/config/configurator_builder.rb +75 -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 +44 -33
- data/lib/ceedling/config/configurator_validator.rb +1 -110
- data/lib/ceedling/constants.rb +5 -1
- data/lib/ceedling/defaults.rb +35 -5
- data/lib/ceedling/dependencies/CACHE_SCHEMA.md +118 -0
- data/lib/ceedling/dependencies/README.md +18 -16
- data/lib/ceedling/dependencies/dependency_cache_store.rb +43 -21
- data/lib/ceedling/dependencies/dependency_hasher.rb +35 -1
- data/lib/ceedling/dependencies/dependency_tracker.rb +9 -3
- data/lib/ceedling/dependencies/dependinator.rb +13 -1
- data/lib/ceedling/diagnostics/DOCTOR.md +142 -0
- data/lib/ceedling/diagnostics/README.md +5 -0
- data/lib/ceedling/diagnostics/build_step_doctor.rb +110 -0
- data/lib/ceedling/diagnostics/duplicate_symbol_specialist.rb +108 -0
- data/lib/ceedling/diagnostics/guidance_phrases.rb +30 -0
- data/lib/ceedling/diagnostics/header_collision_guidance.rb +56 -0
- data/lib/ceedling/diagnostics/header_collision_specialist.rb +152 -0
- data/lib/ceedling/diagnostics/include_depth_specialist.rb +132 -0
- data/lib/ceedling/diagnostics/missing_symbol_specialist.rb +111 -0
- data/lib/ceedling/diagnostics/partial_name_specialist.rb +134 -0
- data/lib/ceedling/diagnostics/toolchain_output.rb +44 -0
- data/lib/ceedling/filename_extension.rb +7 -1
- data/lib/ceedling/filesystem/FILE_TREE.md +253 -0
- data/lib/ceedling/filesystem/PATH_HANDLING.md +360 -0
- data/lib/ceedling/filesystem/README.md +46 -0
- data/lib/ceedling/filesystem/build_roots.rb +105 -0
- data/lib/ceedling/filesystem/build_subpath.rb +187 -0
- data/lib/ceedling/filesystem/destination_collision.rb +25 -0
- data/lib/ceedling/{file_finder.rb → filesystem/file_finder.rb} +177 -156
- data/lib/ceedling/filesystem/file_finder_helper.rb +154 -0
- data/lib/ceedling/filesystem/file_path_collection_utils.rb +183 -0
- data/lib/ceedling/{file_path_utils.rb → filesystem/file_path_utils.rb} +200 -167
- 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} +149 -65
- data/lib/ceedling/filesystem/path_exclusions.rb +30 -0
- data/lib/ceedling/{path_matcher.rb → filesystem/path_matcher.rb} +48 -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/test_build_layout.rb +114 -0
- data/lib/ceedling/filesystem/win_long_paths.rb +153 -0
- data/lib/ceedling/filesystem/win_path_limit.rb +83 -0
- data/lib/ceedling/filesystem/win_path_prober.rb +52 -0
- data/lib/ceedling/filesystem/working_dir.rb +40 -0
- data/lib/ceedling/generators/generator.rb +32 -70
- data/lib/ceedling/generators/generator_helper.rb +0 -44
- data/lib/ceedling/generators/generator_mocks.rb +5 -0
- data/lib/ceedling/generators/generator_partials.rb +306 -244
- data/lib/ceedling/generators/generator_test_results_backtrace.rb +7 -7
- data/lib/ceedling/generators/generator_test_runner.rb +5 -8
- data/lib/ceedling/generators/partial_header_writer.rb +95 -0
- data/lib/ceedling/generators/partial_source_writer.rb +137 -0
- data/lib/ceedling/handoff.rb +121 -0
- data/lib/ceedling/includes/header_search.rb +225 -0
- data/lib/ceedling/includes/include_factory.rb +9 -12
- data/lib/ceedling/includes/include_pathinator.rb +112 -33
- data/lib/ceedling/includes/includes.rb +150 -38
- data/lib/ceedling/installation.rb +92 -0
- data/lib/ceedling/library_resolver.rb +99 -0
- data/lib/ceedling/objects.yml +112 -6
- data/lib/ceedling/partials/README.md +110 -16
- data/lib/ceedling/partials/carry_plan.rb +71 -0
- data/lib/ceedling/partials/definition_head.rb +74 -0
- data/lib/ceedling/partials/include_groups.rb +37 -0
- data/lib/ceedling/partials/interface_extras.rb +25 -0
- data/lib/ceedling/partials/partializer.rb +603 -124
- data/lib/ceedling/partials/partializer_config.rb +8 -1
- data/lib/ceedling/partials/partializer_helper.rb +851 -145
- data/lib/ceedling/partials/partializer_reconciler.rb +174 -0
- data/lib/ceedling/partials/partializer_utils.rb +89 -109
- data/lib/ceedling/partials/partials.rb +153 -10
- data/lib/ceedling/partials/type_macros.rb +126 -0
- data/lib/ceedling/plugins/report_log_writer_plugin.rb +3 -5
- data/lib/ceedling/preprocess/README.md +43 -33
- data/lib/ceedling/preprocess/preprocessinator.rb +100 -186
- data/lib/ceedling/preprocess/preprocessinator_code_finder.rb +65 -72
- data/lib/ceedling/preprocess/preprocessinator_file_assembler.rb +32 -76
- 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/preprocess/preprocessinator_reconstructor.rb +51 -14
- data/lib/ceedling/rake_app/rakefile_component_resolver.rb +10 -17
- data/lib/ceedling/rakefile.rb +15 -1
- data/lib/ceedling/rakefiles/base/tasks_base.rake +1 -1
- data/lib/ceedling/rakefiles/release/rules_release.rake +4 -7
- 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 +104 -87
- data/lib/ceedling/test_context_extractor.rb +5 -1
- data/lib/ceedling/test_invoker/HEADER_COLLISIONS.md +21 -7
- data/lib/ceedling/test_invoker/PIPELINE.md +62 -19
- data/lib/ceedling/test_invoker/README.md +1 -1
- data/lib/ceedling/test_invoker/derived_search_path_notices.rb +45 -0
- data/lib/ceedling/test_invoker/mock_locator.rb +175 -10
- data/lib/ceedling/test_invoker/partial_files_preprocessinator.rb +181 -0
- data/lib/ceedling/test_invoker/partials_manager.rb +271 -302
- data/lib/ceedling/test_invoker/standin_headerinator.rb +19 -17
- data/lib/ceedling/test_invoker/test_bare_includes_extractinator.rb +26 -3
- data/lib/ceedling/test_invoker/test_build_executor.rb +358 -234
- data/lib/ceedling/test_invoker/test_build_planner.rb +46 -33
- data/lib/ceedling/test_invoker/test_build_setup.rb +43 -18
- data/lib/ceedling/test_invoker/test_build_validations.rb +35 -47
- data/lib/ceedling/test_invoker/test_derived_search_paths.rb +189 -0
- data/lib/ceedling/test_invoker/test_file_preprocessinator.rb +2 -3
- data/lib/ceedling/test_invoker/test_includes_reconcilinator.rb +1 -1
- data/lib/ceedling/test_invoker/test_invoker.rb +6 -1
- data/lib/ceedling/test_invoker/test_invoker_types.rb +28 -20
- data/lib/ceedling/test_invoker/test_pipeline_helpers.rb +6 -4
- data/lib/ceedling/test_invoker/test_pipeline_manager.rb +25 -8
- data/lib/ceedling/test_invoker/test_runner_generatinator.rb +31 -3
- data/lib/ceedling/test_invoker/test_search_paths.rb +30 -8
- data/lib/ceedling/test_invoker/test_source_file_directive_resolver.rb +40 -20
- data/lib/ceedling/test_invoker/test_substitutions.rb +72 -0
- data/lib/ceedling/tools/shell_quoting.rb +45 -0
- data/lib/ceedling/{tool_executor.rb → tools/tool_executor.rb} +9 -3
- data/lib/ceedling/tools/tool_quoting.rb +79 -0
- data/lib/ceedling/{tool_validator.rb → tools/tool_validator.rb} +18 -7
- data/lib/ceedling/yaml_wrapper.rb +3 -2
- data/lib/version.rb +1 -1
- data/plugins/bullseye/bullseye.rake +1 -3
- data/plugins/bullseye/config/defaults_bullseye.rb +1 -1
- data/plugins/bullseye/lib/bullseye.rb +24 -9
- data/plugins/command_hooks/lib/command_hooks.rb +1 -1
- 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 +79 -46
- data/plugins/fff/lib/fff_mock_generator.rb +12 -9
- data/plugins/fff/spec/fff_cmock_wrapper_spec.rb +262 -0
- data/plugins/fff/spec/fff_mock_header_generator_spec.rb +9 -0
- data/plugins/fff/spec/fff_mock_source_generator_spec.rb +20 -0
- data/plugins/gcov/config/defaults_gcov.rb +1 -1
- data/plugins/gcov/lib/console_reportinator.rb +28 -36
- 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 +3 -2
- 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/valgrind/lib/valgrind.rb +14 -7
- data/site-local/404.html +2 -2
- data/site-local/assets/javascripts/{bundle.c21346df.min.js → bundle.a5f9d56c.min.js} +1 -1
- data/site-local/assets/javascripts/{bundle.c21346df.min.js.map → bundle.a5f9d56c.min.js.map} +2 -2
- data/site-local/configuration/environment-vars.html +2 -2
- data/site-local/configuration/global-collections.html +3 -3
- data/site-local/configuration/index.html +2 -2
- data/site-local/configuration/loading.html +2 -2
- data/site-local/configuration/mixins.html +2 -2
- data/site-local/configuration/parallel-builds.html +2 -2
- data/site-local/configuration/project-file.html +2 -2
- data/site-local/configuration/reference/cexception.html +2 -2
- data/site-local/configuration/reference/cmock.html +7 -3
- data/site-local/configuration/reference/defines.html +2 -2
- data/site-local/configuration/reference/environment.html +2 -2
- data/site-local/configuration/reference/extension.html +2 -2
- data/site-local/configuration/reference/files.html +65 -12
- data/site-local/configuration/reference/flags.html +2 -2
- data/site-local/configuration/reference/index.html +2 -2
- data/site-local/configuration/reference/libraries.html +23 -5
- data/site-local/configuration/reference/mixins.html +2 -2
- data/site-local/configuration/reference/partials.html +84 -2
- data/site-local/configuration/reference/paths.html +36 -8
- data/site-local/configuration/reference/plugins.html +2 -2
- data/site-local/configuration/reference/project.html +264 -12
- data/site-local/configuration/reference/release-build.html +4 -2
- data/site-local/configuration/reference/test-build.html +2 -2
- data/site-local/configuration/reference/test-runner.html +2 -2
- data/site-local/configuration/reference/tools.html +58 -4
- data/site-local/configuration/reference/unity.html +2 -2
- data/site-local/configuration/which-ceedling.html +379 -19
- data/site-local/development/index.html +2 -2
- data/site-local/development/plugins/configuration.html +2 -2
- data/site-local/development/plugins/index.html +2 -2
- data/site-local/development/plugins/plugin-subclass.html +5 -4
- data/site-local/development/plugins/rake-tasks.html +2 -2
- data/site-local/development/releases.html +7 -3
- data/site-local/development/workflow.html +50 -45
- data/site-local/getting-started/builds.html +4 -2
- data/site-local/getting-started/command-line.html +58 -6
- data/site-local/getting-started/example-projects/cipher-quest.html +2 -2
- data/site-local/getting-started/example-projects/index.html +2 -2
- data/site-local/getting-started/example-projects/temp-sensor.html +2 -2
- data/site-local/getting-started/example-projects/wondrous-forest.html +10 -2
- data/site-local/getting-started/index.html +2 -2
- data/site-local/getting-started/installation.html +2 -2
- data/site-local/getting-started/quick-start.html +2 -2
- data/site-local/help.html +2 -2
- data/site-local/index.html +2 -2
- data/site-local/overview/build-system.html +2 -2
- data/site-local/overview/index.html +2 -2
- data/site-local/overview/test-environments.html +2 -2
- data/site-local/overview/tools-and-frameworks.html +2 -2
- data/site-local/plugins/beep.html +2 -2
- data/site-local/plugins/bullseye/index.html +45 -38
- data/site-local/plugins/bullseye/licensing.html +2 -2
- data/site-local/plugins/command-hooks.html +4 -4
- data/site-local/plugins/compile-commands-json-db.html +2 -2
- data/site-local/plugins/cppcheck.html +2 -2
- data/site-local/plugins/dependencies.html +8 -5
- data/site-local/plugins/fff.html +58 -13
- data/site-local/plugins/gcov/examples.html +2 -2
- data/site-local/plugins/gcov/gcovr.html +23 -14
- data/site-local/plugins/gcov/index.html +2 -2
- data/site-local/plugins/gcov/overview.html +2 -2
- data/site-local/plugins/gcov/reportgenerator.html +18 -14
- data/site-local/plugins/gcov/reporting.html +2 -2
- data/site-local/plugins/gcov/setup.html +4 -3
- data/site-local/plugins/gcov/tool-versions.html +2 -2
- data/site-local/plugins/gcov/troubleshooting.html +2 -2
- data/site-local/plugins/index.html +2 -2
- data/site-local/plugins/module-generator.html +2 -2
- data/site-local/plugins/report-build-warnings-log.html +2 -2
- data/site-local/plugins/report-tests-gtestlike-stdout.html +2 -2
- data/site-local/plugins/report-tests-ide-stdout.html +2 -2
- data/site-local/plugins/report-tests-log-factory.html +2 -2
- data/site-local/plugins/report-tests-pretty-stdout.html +2 -2
- data/site-local/plugins/report-tests-raw-output-log.html +5 -3
- data/site-local/plugins/report-tests-teamcity-stdout.html +8 -5
- data/site-local/plugins/sanitize.html +9 -8
- data/site-local/plugins/valgrind.html +10 -9
- data/site-local/project/index.html +2 -2
- data/site-local/project/release-history.html +2 -2
- data/site-local/project/sbom.html +2 -2
- data/site-local/project/upgrade.html +5 -2
- data/site-local/reference/build-directives.html +2 -2
- data/site-local/reference/command-line.html +11 -4
- data/site-local/reference/environment-vars.html +2 -2
- data/site-local/reference/gcov-plugin.html +2 -2
- data/site-local/reference/global-collections.html +12 -12
- data/site-local/reference/index.html +2 -2
- data/site-local/reference/partials-macros.html +47 -2
- data/site-local/reference/project-configuration.html +2 -2
- data/site-local/sitemap.xml.gz +0 -0
- data/site-local/snapshot/examples/cipher_quest/index.html +2 -2
- data/site-local/snapshot/examples/temp_sensor/index.html +2 -2
- data/site-local/snapshot/examples/wondrous_forest/index.html +72 -15
- 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 +2 -2
- data/site-local/testing-guide/conventions.html +113 -15
- data/site-local/testing-guide/frameworks.html +2 -2
- data/site-local/testing-guide/index.html +2 -2
- data/site-local/testing-guide/partials/configuration.html +31 -4
- data/site-local/testing-guide/partials/conventions.html +509 -8
- data/site-local/testing-guide/partials/directives.html +4 -3
- data/site-local/testing-guide/partials/example.html +2 -2
- data/site-local/testing-guide/partials/index.html +2 -2
- data/site-local/testing-guide/partials/overview.html +30 -12
- data/site-local/testing-guide/partials/variables.html +169 -4
- data/site-local/testing-guide/test-cases.html +2 -2
- data/site-local/testing-guide/test-sample.html +2 -2
- data/site-local/testing-guide/test-suite-anatomy.html +2 -2
- data/spec/integration/actionator_file_operations_spec.rb +91 -1
- data/spec/integration/build_step_doctor_spec.rb +270 -0
- data/spec/integration/c_extractor_composition_spec.rb +254 -4
- data/spec/integration/compile_commands_json_db_spec.rb +1 -1
- 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 +22 -0
- data/spec/integration/includes_extraction_spec.rb +27 -14
- 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/partial_files_preprocessing_spec.rb +128 -0
- data/spec/integration/partials_carry_spec.rb +520 -0
- data/spec/integration/partials_declarations_spec.rb +655 -0
- data/spec/integration/partials_fallback_preprocessing_spec.rb +65 -0
- data/spec/integration/partials_function_pointers_spec.rb +277 -0
- data/spec/integration/partials_header_composition_spec.rb +268 -35
- data/spec/integration/partials_macro_decorators_spec.rb +267 -0
- data/spec/integration/partials_module_resolution_spec.rb +33 -23
- data/spec/integration/partials_symbol_linkage_spec.rb +13 -0
- data/spec/integration/path_intake_scenarios_spec.rb +101 -0
- data/spec/integration/path_length_reporting_spec.rb +64 -0
- data/spec/integration/path_scenarios_spec.rb +399 -0
- data/spec/integration/quote_include_isolator_spec.rb +57 -1
- 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_build_parallel_barrier_spec.rb +1 -1
- data/spec/integration/test_executable_manifest_spec.rb +1 -1
- data/spec/integration/test_includes_extractinator_spec.rb +69 -3
- data/spec/integration/test_naming_spec.rb +201 -0
- data/spec/integration/test_source_file_checks_spec.rb +168 -0
- data/spec/integration/tool_executor_spec.rb +1 -1
- data/spec/integration/tool_validator_spec.rb +3 -3
- data/spec/integration/upgrade_docs_spec.rb +84 -0
- data/spec/integration/vendor_copy_transient_io_retry_spec.rb +74 -5
- data/spec/integration/win_long_paths_probe_spec.rb +46 -0
- data/spec/integration/win_path_limit_spec.rb +53 -0
- data/spec/integration/windows_registry_query_tool_spec.rb +41 -0
- data/spec/support/file_tree_helper.rb +88 -0
- data/spec/support/integration/configurator_integration_helper.rb +14 -9
- data/spec/support/integration/dependency_tracker_integration_helper.rb +1 -1
- data/spec/support/integration/partial_files_harness.rb +181 -0
- data/spec/support/integration/partials_generation_integration_helper.rb +239 -143
- data/spec/support/integration/path_scenario_harness.rb +175 -0
- data/spec/support/integration/spec_integration_helper.rb +9 -4
- data/spec/support/integration/test_includes_harness.rb +69 -37
- data/spec/support/integration/tool_executor_integration_helper.rb +14 -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/bullseye_deployment_spec.rb +2 -0
- data/spec/system/conditional_mock_includes_spec.rb +1 -1
- data/spec/system/delta_builds_spec.rb +163 -23
- data/spec/system/encoding_stress_spec.rb +4 -4
- data/spec/system/example_wondrous_forest_spec.rb +2 -2
- data/spec/system/gcov_deployment_spec.rb +3 -0
- data/spec/system/header_include_path_validation_spec.rb +4 -4
- data/spec/system/header_search_paths_spec.rb +1083 -0
- data/spec/system/launcher_handoff_spec.rb +82 -0
- data/spec/system/mock_include_folders_spec.rb +212 -0
- data/spec/system/mockable_header_reassembly_spec.rb +184 -0
- data/spec/system/parent_directory_reference_spec.rb +5 -3
- data/spec/system/partials_carry_spec.rb +581 -0
- data/spec/system/partials_delta_builds_spec.rb +280 -0
- data/spec/system/partials_function_pointers_spec.rb +106 -0
- data/spec/system/partials_macro_decorators_spec.rb +127 -0
- data/spec/system/partials_module_disambiguation_spec.rb +125 -0
- data/spec/system/path_handling_probes_spec.rb +196 -0
- data/spec/system/pinned_thread_count_spec.rb +4 -4
- data/spec/system/preprocessing_fallback_conditionals_spec.rb +1 -1
- 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/short_build_paths_spec.rb +87 -0
- data/spec/system/sibling_header_collision_spec.rb +30 -6
- data/spec/system/special_path_characters_spec.rb +86 -0
- data/spec/system/support/bullseye_common_test_cases.rb +42 -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/gcov_partials_test_cases.rb +48 -0
- 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_build_layout_spec.rb +209 -0
- 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 +64 -5
- data/spec/units/bin/actionator_spec.rb +14 -17
- data/spec/units/bin/app_cfg_spec.rb +37 -0
- data/spec/units/bin/cli_handler_spec.rb +282 -6
- data/spec/units/bin/cli_helper_spec.rb +116 -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/c_extractor/c_extractor_code_text_spec.rb +67 -10
- data/spec/units/c_extractor/c_extractor_declarations_spec.rb +501 -4
- data/spec/units/c_extractor/c_extractor_declarator_spec.rb +245 -0
- data/spec/units/c_extractor/c_extractor_defined_type_spec.rb +45 -0
- data/spec/units/c_extractor/c_extractor_definitions_spec.rb +163 -3
- data/spec/units/c_extractor/c_extractor_functions_spec.rb +462 -21
- data/spec/units/c_extractor/c_extractor_preprocessing_spec.rb +39 -0
- data/spec/units/c_extractor/c_extractor_spec.rb +4 -4
- data/spec/units/c_extractor/c_extractor_types_spec.rb +163 -0
- data/spec/units/c_identifier_spec.rb +35 -0
- data/spec/units/config/build_root_policy_spec.rb +61 -0
- data/spec/units/config/configurator_builder_spec.rb +61 -6
- data/spec/units/config/configurator_paths_validator_spec.rb +292 -0
- data/spec/units/config/configurator_setup_spec.rb +80 -68
- data/spec/units/config/configurator_spec.rb +54 -6
- data/spec/units/config/configurator_validator_spec.rb +1 -172
- data/spec/units/dependencies/dependency_cache_store_spec.rb +98 -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 +28 -1
- data/spec/units/dependencies/dependinator_spec.rb +17 -2
- data/spec/units/diagnostics/build_step_doctor_spec.rb +170 -0
- data/spec/units/diagnostics/duplicate_symbol_specialist_spec.rb +117 -0
- data/spec/units/diagnostics/header_collision_specialist_spec.rb +267 -0
- data/spec/units/diagnostics/include_depth_specialist_spec.rb +137 -0
- data/spec/units/diagnostics/missing_symbol_specialist_spec.rb +154 -0
- data/spec/units/diagnostics/partial_name_specialist_spec.rb +129 -0
- data/spec/units/diagnostics/toolchain_output_spec.rb +86 -0
- data/spec/units/encodinator_spec.rb +3 -4
- data/spec/units/filename_extension_spec.rb +11 -0
- data/spec/units/filesystem/build_roots_spec.rb +131 -0
- data/spec/units/filesystem/build_subpath_spec.rb +235 -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} +126 -1
- data/spec/units/filesystem/file_finder_spec.rb +845 -0
- 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} +435 -185
- 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} +286 -18
- data/spec/units/{path_matcher_spec.rb → filesystem/path_matcher_spec.rb} +48 -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/test_build_layout_spec.rb +216 -0
- data/spec/units/filesystem/win_long_paths_spec.rb +204 -0
- data/spec/units/filesystem/win_path_prober_spec.rb +158 -0
- data/spec/units/filesystem/working_dir_spec.rb +71 -0
- data/spec/units/generators/generator_helper_spec.rb +0 -60
- data/spec/units/generators/generator_mocks_spec.rb +13 -0
- data/spec/units/generators/generator_partials_spec.rb +656 -55
- data/spec/units/generators/generator_spec.rb +38 -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/generators/generator_test_runner_spec.rb +9 -5
- data/spec/units/generators/partial_source_writer_spec.rb +129 -0
- data/spec/units/handoff_spec.rb +205 -0
- data/spec/units/includes/header_search_spec.rb +406 -0
- data/spec/units/includes/include_factory_spec.rb +23 -6
- data/spec/units/includes/include_pathinator_spec.rb +118 -8
- data/spec/units/includes/include_spec.rb +14 -0
- data/spec/units/includes/includes_spec.rb +176 -19
- data/spec/units/installation_spec.rb +228 -0
- data/spec/units/library_resolver_spec.rb +157 -0
- data/spec/units/loginator_spec.rb +31 -0
- data/spec/units/mock_locator_spec.rb +275 -6
- data/spec/units/partials/include_groups_spec.rb +42 -0
- data/spec/units/partials/partializer_config_spec.rb +32 -0
- data/spec/units/partials/partializer_helper_carry_spec.rb +661 -0
- data/spec/units/partials/partializer_helper_interface_extras_spec.rb +396 -0
- data/spec/units/partials/partializer_helper_spec.rb +529 -277
- data/spec/units/partials/partializer_reconciler_spec.rb +661 -0
- data/spec/units/partials/partializer_spec.rb +1579 -270
- data/spec/units/partials/partializer_utils_spec.rb +269 -232
- data/spec/units/partials/partials_rename_spec.rb +160 -0
- data/spec/units/partials_manager_spec.rb +561 -251
- data/spec/units/plugins/bullseye_spec.rb +49 -2
- data/spec/units/plugins/console_reportinator_spec.rb +73 -26
- 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 +52 -4
- 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_code_finder_spec.rb +73 -10
- data/spec/units/preprocess/preprocessinator_comment_stripper_spec.rb +1 -1
- data/spec/units/preprocess/preprocessinator_file_assembler_spec.rb +125 -37
- data/spec/units/preprocess/preprocessinator_includes_handler_spec.rb +15 -0
- data/spec/units/preprocess/preprocessinator_reconstructor_spec.rb +197 -0
- data/spec/units/preprocess/preprocessinator_spec.rb +153 -95
- data/spec/units/rake_app/rakefile_component_resolver_spec.rb +21 -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/setupinator_spec.rb +51 -0
- data/spec/units/standin_headerinator_spec.rb +55 -9
- data/spec/units/test_build_executor_spec.rb +842 -166
- data/spec/units/test_build_planner_spec.rb +205 -15
- data/spec/units/test_build_setup_spec.rb +179 -30
- data/spec/units/test_context_extractor_spec.rb +36 -2
- data/spec/units/test_derived_search_paths_spec.rb +259 -0
- data/spec/units/test_file_preprocessinator_spec.rb +17 -1
- data/spec/units/test_includes_extractinator_spec.rb +61 -9
- data/spec/units/test_invoker/objects_wiring_spec.rb +24 -4
- data/spec/units/test_invoker/partial_files_preprocessinator_spec.rb +264 -0
- data/spec/units/test_invoker/test_substitutions_spec.rb +122 -0
- data/spec/units/test_invoker_spec.rb +14 -1
- data/spec/units/test_invoker_types_spec.rb +8 -7
- data/spec/units/test_pipeline_manager_spec.rb +54 -13
- data/spec/units/test_runner_generatinator_spec.rb +93 -1
- data/spec/units/test_search_paths_spec.rb +73 -5
- data/spec/units/test_source_file_directive_resolver_spec.rb +38 -7
- data/spec/units/tools/default_tools_quoting_spec.rb +117 -0
- data/spec/units/tools/shell_quoting_spec.rb +76 -0
- data/spec/units/{tool_executor_helper_spec.rb → tools/tool_executor_helper_spec.rb} +1 -1
- data/spec/units/{tool_executor_spec.rb → tools/tool_executor_spec.rb} +27 -1
- data/spec/units/{tool_validator_spec.rb → tools/tool_validator_spec.rb} +110 -1
- data/spec/units/windows_registry_query_tool_spec.rb +53 -0
- data/spec/units/yaml_wrapper_spec.rb +11 -0
- metadata +265 -36
- data/lib/ceedling/file_finder_helper.rb +0 -127
- data/lib/ceedling/file_path_collection_utils.rb +0 -164
- data/spec/units/file_finder_spec.rb +0 -495
- /data/lib/ceedling/{tool_executor_helper.rb → tools/tool_executor_helper.rb} +0 -0
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
# =========================================================================
|
|
2
|
+
# Ceedling - Test-Centered Build System for C
|
|
3
|
+
# ThrowTheSwitch.org
|
|
4
|
+
# Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
|
|
5
|
+
# SPDX-License-Identifier: MIT
|
|
6
|
+
# =========================================================================
|
|
7
|
+
|
|
8
|
+
require 'fileutils'
|
|
9
|
+
require 'ceedling/constants' # for Verbosity enumeration
|
|
10
|
+
require 'ceedling/exceptions'
|
|
11
|
+
require 'ceedling/filesystem/path_matcher'
|
|
12
|
+
|
|
13
|
+
class FileFinderHelper
|
|
14
|
+
|
|
15
|
+
constructor :loginator
|
|
16
|
+
|
|
17
|
+
def setup
|
|
18
|
+
@noticed = []
|
|
19
|
+
@notice_mutex = Mutex.new
|
|
20
|
+
end
|
|
21
|
+
|
|
22
|
+
def find_file_in_collection(filename, file_list, complain)
|
|
23
|
+
found = PathMatcher.match(filename, file_list)
|
|
24
|
+
return found unless found.nil?
|
|
25
|
+
|
|
26
|
+
return not_found_in_collection(filename, file_list, complain)
|
|
27
|
+
end
|
|
28
|
+
|
|
29
|
+
# As `#find_file_in_collection`, but never raises on ambiguity. A query matching more
|
|
30
|
+
# than one file resolves to the first in `file_list`'s order, or to a HeaderSearch's
|
|
31
|
+
# first in search order, with an ℹ️ NOTICE naming what else matched so the choice isn't
|
|
32
|
+
# silent. Every test that names the file makes the same choice, so a build notes it once.
|
|
33
|
+
def resolve_file_in_collection(filename, file_list, complain)
|
|
34
|
+
found, others = resolve_in_collection(filename, file_list)
|
|
35
|
+
return not_found_in_collection(filename, file_list, complain) if found.nil?
|
|
36
|
+
|
|
37
|
+
unless others.empty?
|
|
38
|
+
msg = "Multiple files matched '#{filename}' but chose '#{found}' by search-path priority. " \
|
|
39
|
+
"Other candidates: #{others.join(', ')}. Add more path to '#{filename}' at its point " \
|
|
40
|
+
"of reference to select a different file."
|
|
41
|
+
first = @notice_mutex.synchronize { !@noticed.include?( msg ) && @noticed << msg }
|
|
42
|
+
@loginator.log( msg, Verbosity::COMPLAIN, LogLabels::NOTICE ) if first
|
|
43
|
+
end
|
|
44
|
+
|
|
45
|
+
return found
|
|
46
|
+
end
|
|
47
|
+
|
|
48
|
+
# The winner and the other candidates for `filename`, from a file list or a
|
|
49
|
+
# HeaderSearch, which finds a header as the compiler does
|
|
50
|
+
def resolve_in_collection(filename, collection)
|
|
51
|
+
return PathMatcher.resolve(filename, collection) unless collection.respond_to?( :header_candidates )
|
|
52
|
+
|
|
53
|
+
found = collection.header_candidates( filename )
|
|
54
|
+
return [found.first, found.drop( 1 )]
|
|
55
|
+
end
|
|
56
|
+
|
|
57
|
+
def find_best_path_in_collection(pathname, path_list, complain, description)
|
|
58
|
+
# search our collection for the specified exact path
|
|
59
|
+
raise "No path list provided for #{description} search" if path_list.nil?
|
|
60
|
+
return pathname if path_list.include?(pathname)
|
|
61
|
+
|
|
62
|
+
# The closest match shares the most path segments, especially those ENDING the same. The
|
|
63
|
+
# first of equally close matches wins, and the first path when none shares a segment.
|
|
64
|
+
pieces = reversed_pieces( pathname )
|
|
65
|
+
scores = path_list.map { |path| match_score( pieces, reversed_pieces( path ) ) }
|
|
66
|
+
|
|
67
|
+
complain_of_no_path( "Found no path `#{pathname}` in #{description} search paths.", complain ) if scores.max.to_i.zero? and !pieces.empty?
|
|
68
|
+
|
|
69
|
+
return path_list[best_index( scores )]
|
|
70
|
+
end
|
|
71
|
+
|
|
72
|
+
def handle_missing_file(filename, complain, extra_message = '')
|
|
73
|
+
case (complain)
|
|
74
|
+
when :error then blow_up(filename, extra_message)
|
|
75
|
+
when :warn
|
|
76
|
+
gripe(filename, extra_message)
|
|
77
|
+
return nil
|
|
78
|
+
when :ignore then return nil
|
|
79
|
+
end
|
|
80
|
+
|
|
81
|
+
return nil
|
|
82
|
+
end
|
|
83
|
+
|
|
84
|
+
### Private ###
|
|
85
|
+
|
|
86
|
+
private
|
|
87
|
+
|
|
88
|
+
# Shared by both #find_file_in_collection and #resolve_file_in_collection: neither
|
|
89
|
+
# can find any candidate at all, so the query's own basename gets one last check
|
|
90
|
+
# against every list entry case-insensitively -- catches the common slip of a
|
|
91
|
+
# filename typed with the wrong case before falling through to the caller's own
|
|
92
|
+
# not-found handling. An entry ending in the very same text is no such slip. It lies
|
|
93
|
+
# where the search doesn't reach, as a HeaderSearch's hint files may.
|
|
94
|
+
#
|
|
95
|
+
# `complain` of :silent skips that check. A caller asks for silence when it can't know
|
|
96
|
+
# whether the reference is even live, such as a scan of #includes that ignores #if, and
|
|
97
|
+
# a later, authoritative lookup reports a real slip.
|
|
98
|
+
#
|
|
99
|
+
# A HeaderSearch's refusal comes first. It explains why the header lies beyond every
|
|
100
|
+
# search path, which a case check can't.
|
|
101
|
+
def not_found_in_collection(filename, file_list, complain)
|
|
102
|
+
return nil if complain == :silent
|
|
103
|
+
|
|
104
|
+
refusal = file_list.respond_to?( :refusal ) ? file_list.refusal( filename ) : nil
|
|
105
|
+
return handle_missing_file( filename, complain, refusal ) unless refusal.nil?
|
|
106
|
+
|
|
107
|
+
files = file_list.respond_to?( :hint_files ) ? file_list.hint_files( filename ) : file_list
|
|
108
|
+
matches = letter_case_slips( filename, files )
|
|
109
|
+
if (matches.length > 0)
|
|
110
|
+
blow_up(filename, "However, a filename having different capitalization was found: '#{matches[0]}'.")
|
|
111
|
+
end
|
|
112
|
+
|
|
113
|
+
return handle_missing_file(filename, complain)
|
|
114
|
+
end
|
|
115
|
+
|
|
116
|
+
# The files ending in `filename` spelled in another letter case
|
|
117
|
+
def letter_case_slips(filename, files)
|
|
118
|
+
pattern = /(?:\\|\/|^)(#{Regexp.escape(filename)})$/i
|
|
119
|
+
return files.find_all { |file| (tail = file[pattern, 1]) && tail != filename }
|
|
120
|
+
end
|
|
121
|
+
|
|
122
|
+
def blow_up(filename, extra_message="")
|
|
123
|
+
error = ["Found no file `#{filename}` in search paths.", extra_message].join(' ').strip
|
|
124
|
+
raise CeedlingException.new( error )
|
|
125
|
+
end
|
|
126
|
+
|
|
127
|
+
def gripe(filename, extra_message="")
|
|
128
|
+
warning = ["Found no file `#{filename}` in search paths.", extra_message].join(' ').strip
|
|
129
|
+
@loginator.log( warning, Verbosity::COMPLAIN )
|
|
130
|
+
end
|
|
131
|
+
|
|
132
|
+
def reversed_pieces(path)
|
|
133
|
+
return path.split( /(?:\\|\/)/ ).reverse
|
|
134
|
+
end
|
|
135
|
+
|
|
136
|
+
# Three for each trailing segment matched in place, and one for each segment found anywhere
|
|
137
|
+
def match_score(pieces, candidate)
|
|
138
|
+
in_place = pieces.zip( candidate ).count { |piece, other| piece == other }
|
|
139
|
+
return (in_place * 3) + pieces.count { |piece| candidate.include?( piece ) }
|
|
140
|
+
end
|
|
141
|
+
|
|
142
|
+
# The first of the highest scores, or the first when none scores
|
|
143
|
+
def best_index(scores)
|
|
144
|
+
best = scores.max.to_i
|
|
145
|
+
return best.zero? ? 0 : scores.index( best )
|
|
146
|
+
end
|
|
147
|
+
|
|
148
|
+
def complain_of_no_path(message, complain)
|
|
149
|
+
raise CeedlingException.new( message ) if complain == :error
|
|
150
|
+
|
|
151
|
+
@loginator.log( message, Verbosity::COMPLAIN ) if complain == :warn
|
|
152
|
+
end
|
|
153
|
+
|
|
154
|
+
end
|
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
# =========================================================================
|
|
2
|
+
# Ceedling - Test-Centered Build System for C
|
|
3
|
+
# ThrowTheSwitch.org
|
|
4
|
+
# Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
|
|
5
|
+
# SPDX-License-Identifier: MIT
|
|
6
|
+
# =========================================================================
|
|
7
|
+
|
|
8
|
+
require 'set'
|
|
9
|
+
require 'pathname'
|
|
10
|
+
require 'fileutils'
|
|
11
|
+
require 'ceedling/filesystem/file_path_utils'
|
|
12
|
+
require 'ceedling/exceptions'
|
|
13
|
+
require 'ceedling/filesystem/project_paths'
|
|
14
|
+
require 'ceedling/filesystem/path_spellings'
|
|
15
|
+
require 'ceedling/filesystem/path_exclusions'
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
class FilePathCollectionUtils
|
|
19
|
+
|
|
20
|
+
# One collected directory: its spelling through its entry's real base, both of its
|
|
21
|
+
# spellings, and how far below the nearest base of an entry naming it it lies
|
|
22
|
+
Named = Struct.new( :spelled, :spellings, :distance )
|
|
23
|
+
|
|
24
|
+
constructor :file_wrapper
|
|
25
|
+
|
|
26
|
+
# The directories one or more (+:/-:) paths and globs name, once each, spelled through
|
|
27
|
+
# each entry's base as the base really is, as an #include or a test name reaches them. A
|
|
28
|
+
# `-:` entry drops the directories it names and every directory below them, except one an
|
|
29
|
+
# additive entry naming it names nearer. Each path in `exclude` does so too, except where
|
|
30
|
+
# an entry naming a directory is based no farther away. Each path in `reserved`, and every
|
|
31
|
+
# directory below it, is never collected.
|
|
32
|
+
def collect_paths(paths, exclude: [], reserved: [])
|
|
33
|
+
# Nil input (e.g. unconfigured section) is treated as an empty list
|
|
34
|
+
return [] if paths.nil?
|
|
35
|
+
|
|
36
|
+
additive, subtractive = paths.partition { |entry| FilePathUtils.add_path?( entry ) }
|
|
37
|
+
minus = PathExclusions.of( directories_of( subtractive ), exclude, reserved )
|
|
38
|
+
|
|
39
|
+
kept = named_directories( additive ).select { |named| minus.keeps?( named.spellings, named.distance ) }
|
|
40
|
+
return kept.map { |named| ProjectPaths.relative( named.spelled ) }
|
|
41
|
+
end
|
|
42
|
+
|
|
43
|
+
# Given a file list, add to it or remove from it considering (+:/-:) aggregation operators.
|
|
44
|
+
# Rake's FileList does not robustly handle relative filepaths and patterns.
|
|
45
|
+
# So, we rebuild the FileList ourselves and return it. A revision adds no file below a
|
|
46
|
+
# path in `exclude` unless the revision is based no farther away, and none below a path in
|
|
47
|
+
# `reserved` at all.
|
|
48
|
+
def revise_filelist(list, revisions, exclude: [], reserved: [])
|
|
49
|
+
# Nil list produces an empty FileList; nil revisions leaves the list unchanged
|
|
50
|
+
return FileList.new([]) if list.nil?
|
|
51
|
+
|
|
52
|
+
additive, subtractive = (revisions || []).partition { |revision| FilePathUtils.add_path?( revision ) }
|
|
53
|
+
kept = kept_files( list, additive, subtractive, PathExclusions.of( [], exclude, reserved ) )
|
|
54
|
+
|
|
55
|
+
# #104 -- every entry here is already a concrete, real file, but plain FileList.new or
|
|
56
|
+
# #include re-reads each as a glob, silently dropping a literal `[`/`]`.
|
|
57
|
+
# FileWrapper#instantiate_file_list_literal adds every entry as-is.
|
|
58
|
+
result = @file_wrapper.instantiate_file_list_literal( kept.map { |path| ProjectPaths.relative( path ) } )
|
|
59
|
+
result.resolve() # Force expansion to prevent race conditions in threaded context
|
|
60
|
+
return result
|
|
61
|
+
end
|
|
62
|
+
|
|
63
|
+
# The places files below `entries` mirror below, each spelled canonically: the base of a
|
|
64
|
+
# `/**` or `/*` entry, every directory a glob within an entry names, or the entry itself.
|
|
65
|
+
# A `-:` exclusion roots nothing. A `[`/`]` is part of a name (#104), never a glob.
|
|
66
|
+
def collect_mirror_roots(entries)
|
|
67
|
+
return [] if entries.nil?
|
|
68
|
+
|
|
69
|
+
roots = entries.select { |entry| FilePathUtils.add_path?( entry ) }.flat_map { |entry| entry_roots( entry ) }
|
|
70
|
+
return roots.map { |root| ProjectPaths.canonical( root ) }.uniq
|
|
71
|
+
end
|
|
72
|
+
|
|
73
|
+
# A path relative to the working directory, or absolute when it has no relative form
|
|
74
|
+
def shortest_path_from_working(path)
|
|
75
|
+
return ProjectPaths.relative( ProjectPaths.absolute( path ) )
|
|
76
|
+
end
|
|
77
|
+
|
|
78
|
+
private
|
|
79
|
+
|
|
80
|
+
# Every directory additive entries name, once each by its real spelling, with its distance
|
|
81
|
+
# below the nearest base of the entries naming it
|
|
82
|
+
def named_directories(entries)
|
|
83
|
+
named = {}
|
|
84
|
+
entries.each do |entry|
|
|
85
|
+
bases = PathSpellings.of( [FilePathUtils.no_decorators( entry )] )
|
|
86
|
+
entry_directories( entry ).each { |dir| name_directory( named, dir, bases ) }
|
|
87
|
+
end
|
|
88
|
+
|
|
89
|
+
return named.values
|
|
90
|
+
end
|
|
91
|
+
|
|
92
|
+
# Records `dir`, the first spelling of its real place kept, nearer if these bases are
|
|
93
|
+
def name_directory(named, dir, bases)
|
|
94
|
+
both = [dir, ProjectPaths.real_absolute( dir )]
|
|
95
|
+
found = (named[PathSpellings.key( both.last )] ||= Named.new( dir, both, Float::INFINITY ))
|
|
96
|
+
found.distance = [found.distance, PathSpellings.nearer( both, bases )].min
|
|
97
|
+
end
|
|
98
|
+
|
|
99
|
+
# The listed files and those additive revisions name, less those `-:` revisions name, each
|
|
100
|
+
# compared through its directory as it really is
|
|
101
|
+
def kept_files(list, additive, subtractive, excluded)
|
|
102
|
+
real = {}
|
|
103
|
+
minus = Set.new( files_of( subtractive ).map { |path| real_key( path, real ) } )
|
|
104
|
+
added = added_files( additive, excluded, real )
|
|
105
|
+
return (list.map { |path| ProjectPaths.absolute( path ) } + added).uniq { |path| real_key( path, real ) }.reject { |path| minus.include?( real_key( path, real ) ) }
|
|
106
|
+
end
|
|
107
|
+
|
|
108
|
+
# The files additive revisions name that `excluded` keeps, each judged by its distance
|
|
109
|
+
# below the base of the revision naming it
|
|
110
|
+
def added_files(additive, excluded, real)
|
|
111
|
+
return files_of( additive ) if excluded.none?
|
|
112
|
+
|
|
113
|
+
return additive.flat_map do |revision|
|
|
114
|
+
bases = PathSpellings.of( [FilePathUtils.no_decorators( revision )] )
|
|
115
|
+
revision_files( revision ).select do |file|
|
|
116
|
+
spellings = [file, real_spelling( file, real )]
|
|
117
|
+
excluded.keeps?( spellings, PathSpellings.nearer( spellings, bases ) )
|
|
118
|
+
end
|
|
119
|
+
end
|
|
120
|
+
end
|
|
121
|
+
|
|
122
|
+
def directories_of(entries)
|
|
123
|
+
return entries.flat_map { |entry| entry_directories( entry ) }
|
|
124
|
+
end
|
|
125
|
+
|
|
126
|
+
def files_of(revisions)
|
|
127
|
+
return revisions.flat_map { |revision| revision_files( revision ) }
|
|
128
|
+
end
|
|
129
|
+
|
|
130
|
+
# Every directory one entry names, absolute and spelled through its base as the base
|
|
131
|
+
# really is, so one place is never collected under two spellings of that base
|
|
132
|
+
def entry_directories(entry)
|
|
133
|
+
path = ProjectPaths.standardize( FilePathUtils.no_aggregation_decorators( entry ) )
|
|
134
|
+
dirs = listed_directories( path )
|
|
135
|
+
dirs = with_parents( dirs, path ) if path.end_with?( '/**', '/*' )
|
|
136
|
+
|
|
137
|
+
return PathSpellings.through_real( dirs.map { |dir| ProjectPaths.absolute( dir ) }, ProjectPaths.absolute( FilePathUtils.no_decorators( path ) ) )
|
|
138
|
+
end
|
|
139
|
+
|
|
140
|
+
# #104 -- FilePathUtils.subdirectory_glob escapes a literal `[`/`]` in the path itself, so
|
|
141
|
+
# it's matched literally rather than read as glob syntax. Sorted for Github Issue #860.
|
|
142
|
+
def listed_directories(path)
|
|
143
|
+
entries = @file_wrapper.directory_listing( FilePathUtils.subdirectory_glob( path ) ).sort
|
|
144
|
+
return entries.select { |entry| @file_wrapper.directory?( entry ) }
|
|
145
|
+
end
|
|
146
|
+
|
|
147
|
+
# Ceedling's recursive glob convention includes the directory above each match, unlike
|
|
148
|
+
# Ruby's, and the base directory itself when nothing below it matches
|
|
149
|
+
def with_parents(dirs, path)
|
|
150
|
+
parents = dirs.map { |dir| File.join( dir, '..' ) }
|
|
151
|
+
parents << FilePathUtils.no_decorators( path ) if dirs.empty?
|
|
152
|
+
return parents + dirs
|
|
153
|
+
end
|
|
154
|
+
|
|
155
|
+
def entry_roots(entry)
|
|
156
|
+
path = ProjectPaths.standardize( FilePathUtils.no_aggregation_decorators( entry ) ).sub( %r{(?:/\*\*?)+\z}, '' )
|
|
157
|
+
return [path] unless path.match?( /[*?{]/ )
|
|
158
|
+
|
|
159
|
+
listing = @file_wrapper.directory_listing( FilePathUtils.escape_glob_brackets( path ) )
|
|
160
|
+
return listing.sort.select { |listed| @file_wrapper.directory?( listed ) }
|
|
161
|
+
end
|
|
162
|
+
|
|
163
|
+
# Every file one :files revision names, absolute and spelled through its base as the base
|
|
164
|
+
# really is. #104 -- a literal `[`/`]` is escaped as in `listed_directories`.
|
|
165
|
+
def revision_files(revision)
|
|
166
|
+
path = ProjectPaths.standardize( FilePathUtils.no_aggregation_decorators( revision ) )
|
|
167
|
+
files = @file_wrapper.directory_listing( FilePathUtils.escape_glob_brackets( path ) ).sort.reject { |entry| @file_wrapper.directory?( entry ) }
|
|
168
|
+
|
|
169
|
+
return PathSpellings.through_real( files.map { |file| ProjectPaths.absolute( file ) }, ProjectPaths.absolute( FilePathUtils.no_decorators( path ) ) )
|
|
170
|
+
end
|
|
171
|
+
|
|
172
|
+
# A file compared through its directory as it really is, keeping its own name. Each
|
|
173
|
+
# directory is resolved once per call, in `real`.
|
|
174
|
+
def real_key(file, real)
|
|
175
|
+
return PathSpellings.key( real_spelling( file, real ) )
|
|
176
|
+
end
|
|
177
|
+
|
|
178
|
+
def real_spelling(file, real)
|
|
179
|
+
dir = File.dirname( file )
|
|
180
|
+
return File.join( (real[dir] ||= ProjectPaths.real_absolute( dir )), File.basename( file ) )
|
|
181
|
+
end
|
|
182
|
+
|
|
183
|
+
end
|