ceedling 1.2.2 → 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 +1 -1
- 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/docs/BreakingChanges.md +16 -0
- data/docs/Changelog.md +71 -0
- data/docs/KnownIssues.md +91 -4
- 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/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/configurator.rb +4 -3
- data/lib/ceedling/config/configurator_builder.rb +17 -0
- data/lib/ceedling/config/configurator_setup.rb +29 -5
- data/lib/ceedling/constants.rb +5 -1
- data/lib/ceedling/defaults.rb +31 -1
- data/lib/ceedling/dependencies/CACHE_SCHEMA.md +118 -0
- data/lib/ceedling/dependencies/README.md +1 -1
- data/lib/ceedling/dependencies/dependency_cache_store.rb +30 -25
- 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/filesystem/PATH_HANDLING.md +83 -27
- data/lib/ceedling/filesystem/README.md +6 -1
- data/lib/ceedling/filesystem/build_roots.rb +105 -0
- data/lib/ceedling/filesystem/build_subpath.rb +110 -25
- data/lib/ceedling/filesystem/file_finder.rb +76 -110
- data/lib/ceedling/filesystem/file_finder_helper.rb +33 -11
- data/lib/ceedling/filesystem/file_path_utils.rb +113 -91
- data/lib/ceedling/filesystem/file_wrapper.rb +105 -28
- data/lib/ceedling/filesystem/path_matcher.rb +21 -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/generators/generator.rb +27 -64
- 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 +305 -243
- 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/includes/header_search.rb +225 -0
- data/lib/ceedling/includes/include_factory.rb +9 -12
- data/lib/ceedling/includes/include_pathinator.rb +53 -31
- data/lib/ceedling/includes/includes.rb +149 -37
- data/lib/ceedling/objects.yml +89 -4
- 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 +599 -120
- data/lib/ceedling/partials/partializer_config.rb +5 -0
- 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/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 +31 -75
- data/lib/ceedling/preprocess/preprocessinator_reconstructor.rb +51 -14
- data/lib/ceedling/setupinator.rb +16 -3
- data/lib/ceedling/test_invoker/HEADER_COLLISIONS.md +21 -7
- data/lib/ceedling/test_invoker/PIPELINE.md +57 -16
- 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 +116 -9
- data/lib/ceedling/test_invoker/partial_files_preprocessinator.rb +181 -0
- data/lib/ceedling/test_invoker/partials_manager.rb +265 -308
- data/lib/ceedling/test_invoker/standin_headerinator.rb +8 -15
- data/lib/ceedling/test_invoker/test_bare_includes_extractinator.rb +26 -3
- data/lib/ceedling/test_invoker/test_build_executor.rb +338 -198
- data/lib/ceedling/test_invoker/test_build_planner.rb +13 -19
- data/lib/ceedling/test_invoker/test_build_setup.rb +26 -6
- data/lib/ceedling/test_invoker/test_build_validations.rb +23 -20
- data/lib/ceedling/test_invoker/test_derived_search_paths.rb +189 -0
- data/lib/ceedling/test_invoker/test_file_preprocessinator.rb +1 -2
- data/lib/ceedling/test_invoker/test_includes_reconcilinator.rb +1 -1
- data/lib/ceedling/test_invoker/test_invoker_types.rb +28 -20
- data/lib/ceedling/test_invoker/test_pipeline_helpers.rb +5 -3
- 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_substitutions.rb +72 -0
- data/lib/ceedling/tools/shell_quoting.rb +45 -0
- data/lib/ceedling/tools/tool_quoting.rb +79 -0
- data/lib/ceedling/{tool_validator.rb → tools/tool_validator.rb} +18 -7
- data/lib/version.rb +1 -1
- data/plugins/bullseye/bullseye.rake +1 -3
- data/plugins/bullseye/lib/bullseye.rb +15 -2
- data/plugins/command_hooks/lib/command_hooks.rb +1 -1
- data/plugins/fff/lib/fff.rb +42 -15
- data/plugins/fff/lib/fff_mock_generator.rb +12 -9
- data/plugins/fff/spec/fff_cmock_wrapper_spec.rb +134 -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/lib/console_reportinator.rb +25 -19
- data/plugins/gcov/lib/reportgenerator_reportinator.rb +2 -1
- 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 +5 -2
- 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 +56 -9
- 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 +2 -2
- 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 +7 -2
- data/site-local/configuration/reference/plugins.html +2 -2
- data/site-local/configuration/reference/project.html +247 -5
- data/site-local/configuration/reference/release-build.html +2 -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 +49 -4
- data/site-local/configuration/reference/unity.html +2 -2
- data/site-local/configuration/which-ceedling.html +2 -2
- 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 +2 -2
- data/site-local/development/workflow.html +2 -2
- data/site-local/getting-started/builds.html +2 -2
- data/site-local/getting-started/command-line.html +2 -2
- 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 +2 -2
- data/site-local/plugins/fff.html +16 -2
- data/site-local/plugins/gcov/examples.html +2 -2
- data/site-local/plugins/gcov/gcovr.html +8 -2
- 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 +2 -2
- 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 +2 -2
- data/site-local/plugins/report-tests-teamcity-stdout.html +2 -2
- data/site-local/plugins/sanitize.html +2 -2
- data/site-local/plugins/valgrind.html +2 -2
- 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 +2 -2
- data/site-local/reference/build-directives.html +2 -2
- data/site-local/reference/command-line.html +2 -2
- 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/testing-guide/build-directives.html +2 -2
- data/site-local/testing-guide/conventions.html +67 -22
- 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/build_step_doctor_spec.rb +270 -0
- data/spec/integration/c_extractor_composition_spec.rb +254 -4
- data/spec/integration/includes_extraction_spec.rb +27 -14
- data/spec/integration/nested_test_artifacts_spec.rb +1 -1
- 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 +26 -19
- data/spec/integration/partials_symbol_linkage_spec.rb +13 -0
- data/spec/integration/path_length_reporting_spec.rb +64 -0
- data/spec/integration/path_scenarios_spec.rb +80 -3
- data/spec/integration/quote_include_isolator_spec.rb +56 -0
- data/spec/integration/test_build_parallel_barrier_spec.rb +1 -1
- data/spec/integration/test_includes_extractinator_spec.rb +70 -5
- data/spec/integration/test_naming_spec.rb +6 -3
- data/spec/integration/test_source_file_checks_spec.rb +5 -3
- data/spec/integration/tool_executor_spec.rb +1 -1
- data/spec/integration/tool_validator_spec.rb +2 -2
- 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/integration/configurator_integration_helper.rb +8 -3
- data/spec/support/integration/partial_files_harness.rb +181 -0
- data/spec/support/integration/partials_generation_integration_helper.rb +237 -141
- data/spec/support/integration/path_scenario_harness.rb +4 -2
- data/spec/support/integration/spec_integration_helper.rb +8 -3
- data/spec/support/integration/test_includes_harness.rb +56 -35
- data/spec/support/integration/tool_executor_integration_helper.rb +14 -2
- data/spec/system/bullseye_deployment_spec.rb +2 -0
- data/spec/system/delta_builds_spec.rb +26 -12
- 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 +2 -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/mock_include_folders_spec.rb +121 -0
- data/spec/system/mockable_header_reassembly_spec.rb +184 -0
- 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 +16 -12
- data/spec/system/pinned_thread_count_spec.rb +4 -4
- data/spec/system/preprocessing_fallback_conditionals_spec.rb +1 -1
- data/spec/system/short_build_paths_spec.rb +87 -0
- data/spec/system/sibling_header_collision_spec.rb +30 -6
- data/spec/system/support/bullseye_common_test_cases.rb +42 -0
- data/spec/system/support/common_test_cases.rb +2 -2
- data/spec/system/support/gcov_partials_test_cases.rb +48 -0
- data/spec/system/test_build_layout_spec.rb +209 -0
- data/spec/system/test_source_file_directive_spec.rb +35 -5
- 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/configurator_builder_spec.rb +24 -0
- data/spec/units/config/configurator_setup_spec.rb +72 -4
- data/spec/units/config/configurator_spec.rb +27 -1
- data/spec/units/dependencies/dependency_cache_store_spec.rb +68 -3
- data/spec/units/dependencies/dependency_tracker_spec.rb +25 -0
- 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/filesystem/build_roots_spec.rb +131 -0
- data/spec/units/filesystem/build_subpath_spec.rb +113 -0
- data/spec/units/filesystem/file_finder_helper_spec.rb +80 -0
- data/spec/units/filesystem/file_finder_spec.rb +242 -58
- data/spec/units/filesystem/file_path_utils_spec.rb +251 -118
- data/spec/units/filesystem/file_wrapper_spec.rb +191 -6
- data/spec/units/filesystem/path_matcher_spec.rb +36 -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/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 +26 -0
- 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/includes/header_search_spec.rb +406 -0
- data/spec/units/includes/include_factory_spec.rb +22 -5
- data/spec/units/includes/include_pathinator_spec.rb +77 -13
- data/spec/units/includes/include_spec.rb +14 -0
- data/spec/units/includes/includes_spec.rb +176 -19
- data/spec/units/loginator_spec.rb +31 -0
- data/spec/units/mock_locator_spec.rb +199 -5
- data/spec/units/partials/include_groups_spec.rb +42 -0
- data/spec/units/partials/partializer_config_spec.rb +25 -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 +1578 -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 +554 -261
- data/spec/units/plugins/bullseye_spec.rb +34 -0
- data/spec/units/plugins/console_reportinator_spec.rb +58 -9
- data/spec/units/plugins/report_tests_teamcity_stdout_spec.rb +1 -1
- data/spec/units/plugins/reportgenerator_reportinator_spec.rb +51 -3
- data/spec/units/preprocess/preprocessinator_code_finder_spec.rb +73 -10
- 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/setupinator_spec.rb +51 -0
- data/spec/units/standin_headerinator_spec.rb +27 -11
- data/spec/units/test_build_executor_spec.rb +780 -166
- data/spec/units/test_build_planner_spec.rb +116 -28
- data/spec/units/test_build_setup_spec.rb +83 -18
- data/spec/units/test_context_extractor_spec.rb +11 -2
- data/spec/units/test_derived_search_paths_spec.rb +259 -0
- data/spec/units/test_includes_extractinator_spec.rb +56 -8
- data/spec/units/test_invoker/objects_wiring_spec.rb +20 -3
- 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_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/{default_tools_quoting_spec.rb → tools/default_tools_quoting_spec.rb} +39 -5
- 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} +1 -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
- metadata +161 -16
- /data/lib/ceedling/{tool_executor.rb → tools/tool_executor.rb} +0 -0
- /data/lib/ceedling/{tool_executor_helper.rb → tools/tool_executor_helper.rb} +0 -0
|
@@ -5,153 +5,206 @@
|
|
|
5
5
|
# SPDX-License-Identifier: MIT
|
|
6
6
|
# =========================================================================
|
|
7
7
|
|
|
8
|
+
require 'strscan'
|
|
9
|
+
require 'ceedling/c_extractor/c_extractor_constants'
|
|
10
|
+
require 'ceedling/c_extractor/c_extractor_declarator'
|
|
11
|
+
|
|
8
12
|
class CExtractorDefinitions
|
|
9
13
|
|
|
10
14
|
constructor :c_extractor_code_text
|
|
11
15
|
|
|
12
|
-
#
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
#
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
#
|
|
16
|
+
# How a brace changes a body's nesting depth
|
|
17
|
+
BRACE_DEPTH = { '{' => 1, '}' => -1 }.freeze unless const_defined?(:BRACE_DEPTH, false)
|
|
18
|
+
|
|
19
|
+
# Text without a literal, a comment, a brace or a ';', which a statement's scan takes in one step
|
|
20
|
+
PLAIN_RUN = %r{[^"'/{};]+} unless const_defined?(:PLAIN_RUN, false)
|
|
21
|
+
|
|
22
|
+
# A group only a function's head ends with, `(void)` or one around a pointer as in `(*get(void))`
|
|
23
|
+
FUNCTION_GROUP = /\A(?:\(\s*void\s*\)\z|#{CExtractorDeclarator::POINTER_GROUP.source})/ unless const_defined?(:FUNCTION_GROUP, false)
|
|
24
|
+
|
|
25
|
+
# A tag named but not defined, as in `struct node;`, ending its statement
|
|
26
|
+
FORWARD_DECLARATION = /\A(?:struct|union)\s+#{CExtractorConstants::IDENTIFIER.source}\s*;\z/ unless const_defined?(:FORWARD_DECLARATION, false)
|
|
27
|
+
|
|
28
|
+
# Extracts a typedef from its keyword through the ';' that ends it. Called as a feature
|
|
29
|
+
# extractor by CExtractor#extract_next_feature. A ';' inside a struct, union or enum body, a
|
|
30
|
+
# literal or a comment doesn't end it. Comments in the text become a single space, and
|
|
31
|
+
# literals stay as written.
|
|
19
32
|
#
|
|
20
|
-
# @param scanner [StringScanner] positioned at the start of potential typedef
|
|
33
|
+
# @param scanner [StringScanner] positioned at the start of a potential typedef
|
|
21
34
|
# @return [Array(Boolean, String)]
|
|
22
|
-
# [true, "typedef struct { int x; } Point
|
|
23
|
-
# [false, nil
|
|
35
|
+
# [true, "typedef struct { int x; } Point;"] the typedef's text
|
|
36
|
+
# [false, nil ] no typedef here, or no ';' before the text ends
|
|
24
37
|
def try_extract_typedef(scanner)
|
|
25
|
-
return [false, nil] unless scanner.check(/typedef\
|
|
38
|
+
return [false, nil] unless scanner.check(/typedef(?![\w$])/)
|
|
26
39
|
|
|
27
40
|
text = +''
|
|
28
|
-
depth = 0
|
|
41
|
+
depth = 0
|
|
29
42
|
|
|
30
43
|
until scanner.eos?
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
# Capture string/char literals verbatim — a ';' inside must not terminate
|
|
35
|
-
before = scanner.pos
|
|
36
|
-
@c_extractor_code_text.skip_c_string(scanner, ch)
|
|
37
|
-
text << scanner.string[before...scanner.pos]
|
|
38
|
-
|
|
39
|
-
elsif scanner.check(%r{/[/*]})
|
|
40
|
-
# Replace comment with a single space — a ';' inside must not terminate
|
|
41
|
-
@c_extractor_code_text.skip_comment(scanner)
|
|
42
|
-
text << ' '
|
|
43
|
-
|
|
44
|
-
elsif scanner.scan(/\{/)
|
|
45
|
-
depth += 1
|
|
46
|
-
text << '{'
|
|
47
|
-
|
|
48
|
-
elsif scanner.scan(/\}/)
|
|
49
|
-
depth -= 1
|
|
50
|
-
text << '}'
|
|
51
|
-
|
|
52
|
-
elsif depth == 0 && scanner.scan(/;/)
|
|
53
|
-
text << ';'
|
|
54
|
-
scanner.scan(/[ \t]*\n/) # absorb optional trailing newline
|
|
55
|
-
return [true, text.rstrip]
|
|
56
|
-
|
|
57
|
-
else
|
|
58
|
-
text << scanner.getch
|
|
59
|
-
end
|
|
44
|
+
token = _take_token( scanner, text )
|
|
45
|
+
depth += BRACE_DEPTH.fetch( token, 0 )
|
|
46
|
+
return [true, _finish( scanner, text )] if depth.zero? and token == ';'
|
|
60
47
|
end
|
|
61
48
|
|
|
62
|
-
[false, nil]
|
|
49
|
+
[false, nil]
|
|
63
50
|
end
|
|
64
51
|
|
|
65
|
-
#
|
|
66
|
-
#
|
|
52
|
+
# Extracts a file-scope struct, enum or union type definition that has no typedef, or a
|
|
53
|
+
# struct or union forward declaration. Called as a feature extractor by
|
|
54
|
+
# CExtractor#extract_next_feature.
|
|
67
55
|
#
|
|
68
|
-
#
|
|
69
|
-
#
|
|
70
|
-
#
|
|
71
|
-
#
|
|
72
|
-
#
|
|
56
|
+
# The same keyword can lead a variable or a function. A variable's initializer and a
|
|
57
|
+
# function's body are braced too, so the text ahead of the first '{' must head a type (see
|
|
58
|
+
# _type_head?). Only a ';' may follow the closing '}', perhaps after extensions, comments and
|
|
59
|
+
# line breaks, which the text keeps as written. Comments in the head and the body become a
|
|
60
|
+
# single space, and literals stay as written.
|
|
73
61
|
#
|
|
74
|
-
#
|
|
75
|
-
# struct [tag] { member-list };
|
|
76
|
-
# enum [tag] { enumerator-list };
|
|
77
|
-
# union [tag] { member-list };
|
|
62
|
+
# Extracts:
|
|
63
|
+
# struct [attributes] [tag] { member-list } [extensions];
|
|
64
|
+
# enum [attributes] [tag] [: type] { enumerator-list } [extensions];
|
|
65
|
+
# union [attributes] [tag] { member-list } [extensions];
|
|
66
|
+
# struct tag; a forward declaration, which names the tag only
|
|
78
67
|
#
|
|
79
|
-
#
|
|
80
|
-
# struct
|
|
81
|
-
# struct
|
|
68
|
+
# Declines, leaving the scanner where it was, so a later extractor reads the statement:
|
|
69
|
+
# struct ops g = { 1 }; a variable with an initializer
|
|
70
|
+
# struct ops *make(void) { ... }; a function
|
|
71
|
+
# struct ops { int a; } g; a type with a variable, which the variable extractor splits
|
|
82
72
|
#
|
|
83
|
-
# @param scanner [StringScanner] positioned at potential aggregate definition
|
|
73
|
+
# @param scanner [StringScanner] positioned at a potential aggregate definition
|
|
84
74
|
# @return [Array(Boolean, String|nil)]
|
|
85
|
-
# [true, "struct Foo { int x; }
|
|
86
|
-
# [false, nil
|
|
75
|
+
# [true, "struct Foo { int x; };"] the definition's text
|
|
76
|
+
# [false, nil ] no type definition here, or the text ends first. The scanner doesn't move.
|
|
87
77
|
def try_extract_aggregate_definition(scanner)
|
|
88
|
-
return [false, nil] unless scanner.check(/(?:struct|enum|union)\
|
|
78
|
+
return [false, nil] unless scanner.check(/(?:struct|enum|union)(?![\w$])/)
|
|
89
79
|
|
|
90
|
-
start_pos
|
|
91
|
-
text
|
|
92
|
-
|
|
80
|
+
start_pos = scanner.pos
|
|
81
|
+
text = _aggregate_text( scanner )
|
|
82
|
+
scanner.pos = start_pos if text.nil?
|
|
83
|
+
return [!text.nil?, text]
|
|
84
|
+
end
|
|
85
|
+
|
|
86
|
+
private
|
|
87
|
+
|
|
88
|
+
# The type definition's text, or nil when the statement defines no type or the text ends first
|
|
89
|
+
def _aggregate_text(scanner)
|
|
90
|
+
text = +''
|
|
91
|
+
depth = 0
|
|
93
92
|
|
|
94
93
|
until scanner.eos?
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
@c_extractor_code_text.skip_c_string(scanner, ch)
|
|
101
|
-
text << scanner.string[before...scanner.pos]
|
|
102
|
-
|
|
103
|
-
elsif scanner.check(%r{/[/*]})
|
|
104
|
-
# Replace comment with a single space — ';' inside must not terminate
|
|
105
|
-
@c_extractor_code_text.skip_comment(scanner)
|
|
106
|
-
text << ' '
|
|
107
|
-
|
|
108
|
-
elsif scanner.scan(/\{/)
|
|
109
|
-
depth += 1
|
|
110
|
-
text << '{'
|
|
111
|
-
|
|
112
|
-
elsif scanner.scan(/\}/)
|
|
113
|
-
depth -= 1
|
|
114
|
-
text << '}'
|
|
115
|
-
|
|
116
|
-
if depth == 0
|
|
117
|
-
# Body closed. Speculatively advance past whitespace/comments to peek at next char.
|
|
118
|
-
# Do NOT commit whitespace to text yet — we may need to rollback entirely.
|
|
119
|
-
ws_start = scanner.pos
|
|
120
|
-
loop do
|
|
121
|
-
init = scanner.pos
|
|
122
|
-
scanner.skip(/\s+/)
|
|
123
|
-
@c_extractor_code_text.skip_comment(scanner) if scanner.check(%r{/[/*]})
|
|
124
|
-
break if scanner.pos == init
|
|
125
|
-
end
|
|
126
|
-
|
|
127
|
-
if scanner.peek(1) == ';'
|
|
128
|
-
# Standalone type definition — commit
|
|
129
|
-
text << scanner.string[ws_start...scanner.pos] # include whitespace before ';'
|
|
130
|
-
text << scanner.scan(/;/)
|
|
131
|
-
scanner.scan(/[ \t]*\n/) # absorb optional trailing newline
|
|
132
|
-
return [true, text.rstrip]
|
|
133
|
-
else
|
|
134
|
-
# Declarator present (variable name, '*', '[', etc.) — not a standalone type definition.
|
|
135
|
-
# Rollback entirely so the variable extractor sees the full text.
|
|
136
|
-
scanner.pos = start_pos
|
|
137
|
-
return [false, nil]
|
|
138
|
-
end
|
|
139
|
-
end
|
|
140
|
-
|
|
141
|
-
elsif depth == 0 && scanner.scan(/;/)
|
|
142
|
-
# Hit ';' at depth 0 before any '{' — forward declaration or variable declaration.
|
|
143
|
-
# Neither is a standalone aggregate type definition; rollback.
|
|
144
|
-
scanner.pos = start_pos
|
|
145
|
-
return [false, nil]
|
|
146
|
-
|
|
147
|
-
else
|
|
148
|
-
text << scanner.getch
|
|
149
|
-
end
|
|
94
|
+
token = _take_token( scanner, text )
|
|
95
|
+
return _bodiless( scanner, token, text ) if depth.zero? and _not_a_type_body?( token, text )
|
|
96
|
+
|
|
97
|
+
depth += BRACE_DEPTH.fetch( token, 0 )
|
|
98
|
+
return _type_end( scanner, text ) if token == '}' and depth.zero?
|
|
150
99
|
end
|
|
151
100
|
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
101
|
+
return nil
|
|
102
|
+
end
|
|
103
|
+
|
|
104
|
+
# Whether a token outside any body ends the search for a type's body. A ';' first means a
|
|
105
|
+
# declaration without one. A '{' that opens a variable's initializer or a function's body
|
|
106
|
+
# means the statement defines no type.
|
|
107
|
+
def _not_a_type_body?(token, text)
|
|
108
|
+
return true if token == ';'
|
|
109
|
+
|
|
110
|
+
return (token == '{' and !_type_head?( text.chop ))
|
|
111
|
+
end
|
|
112
|
+
|
|
113
|
+
# A statement that ends its search for a body without one. Only a tag alone, ended by ';',
|
|
114
|
+
# declares a type.
|
|
115
|
+
def _bodiless(scanner, token, text)
|
|
116
|
+
return (token == ';' and text.strip.match?( FORWARD_DECLARATION )) ? _finish( scanner, text ) : nil
|
|
117
|
+
end
|
|
118
|
+
|
|
119
|
+
# Whether the text ahead of a body's '{' heads a type. A type's head never holds an '=' or a
|
|
120
|
+
# star outside its groups, as a variable's initializer and a pointer-returning function do.
|
|
121
|
+
# Nor does it end in `(void)` or a group around a pointer, as a function's head can. Any other
|
|
122
|
+
# group ending the head may belong to a macro spelling the tag, as in `struct FOO_TYPE(bar) {`,
|
|
123
|
+
# so the head stays a type's. A function with other parameters then reads as a type only when
|
|
124
|
+
# a stray ';' follows its body. Groups are emptied first, so nothing inside one counts.
|
|
125
|
+
def _type_head?(head)
|
|
126
|
+
flat = head.match?( /[(\[]/ ) ? _empty_groups( head ) : head
|
|
127
|
+
return !(flat.match?( /[=*]/ ) or flat.match?( /\(p\)\s*\z/ ))
|
|
128
|
+
end
|
|
129
|
+
|
|
130
|
+
# The head with each top-level group reduced to a stand-in, so `struct ops make(int a)` reads
|
|
131
|
+
# `struct ops make()` and `struct ops make(void)` reads `struct ops make(p)`. A bracket inside a
|
|
132
|
+
# literal or a comment doesn't count.
|
|
133
|
+
def _empty_groups(head)
|
|
134
|
+
scanner = StringScanner.new( head )
|
|
135
|
+
flat = +''
|
|
136
|
+
while (before = scanner.scan_until( /(?=[(\[])/ ))
|
|
137
|
+
flat << before
|
|
138
|
+
emptied = _emptied_group( scanner )
|
|
139
|
+
break if emptied.nil?
|
|
140
|
+
|
|
141
|
+
flat << emptied
|
|
142
|
+
end
|
|
143
|
+
|
|
144
|
+
return flat << scanner.rest
|
|
145
|
+
end
|
|
146
|
+
|
|
147
|
+
# What stands for the group at the scanner, once the scanner has passed it, or nil when the
|
|
148
|
+
# group never closes. A group only a function's head ends with reads `(p)`, and any other `()`.
|
|
149
|
+
def _emptied_group(scanner)
|
|
150
|
+
from = scanner.pos
|
|
151
|
+
return nil unless CExtractorDeclarator._skip_balanced( scanner )
|
|
152
|
+
|
|
153
|
+
return scanner.string.byteslice( from, scanner.pos - from ).match?( FUNCTION_GROUP ) ? '(p)' : '()'
|
|
154
|
+
end
|
|
155
|
+
|
|
156
|
+
# The definition's text through its ';', or nil. Extensions, comments and line breaks may sit
|
|
157
|
+
# between the body's '}' and the ';', and the text keeps them as written. Anything else there
|
|
158
|
+
# is a declarator, or the text ends first.
|
|
159
|
+
def _type_end(scanner, text)
|
|
160
|
+
after = scanner.pos
|
|
161
|
+
return nil unless _skip_type_extensions( scanner ) and scanner.scan( /;/ )
|
|
162
|
+
|
|
163
|
+
text << scanner.string.byteslice( after, scanner.pos - after )
|
|
164
|
+
return _finish( scanner, text )
|
|
165
|
+
end
|
|
166
|
+
|
|
167
|
+
# A statement's text, once the scanner has passed the blanks and the line break after it
|
|
168
|
+
def _finish(scanner, text)
|
|
169
|
+
scanner.scan(/[ \t]*\n/)
|
|
170
|
+
return text.rstrip
|
|
171
|
+
end
|
|
172
|
+
|
|
173
|
+
# Passes whitespace, comments and extensions after a type's body, or says false when an
|
|
174
|
+
# attribute's arguments never close. An extension is a word C reserves for the implementation,
|
|
175
|
+
# such as the common `__packed` macro, or an attribute with its arguments. A module's own
|
|
176
|
+
# variable may not legally take such a name. Any other reserved word with arguments, such as
|
|
177
|
+
# `__asm__("...")`, begins a statement of its own.
|
|
178
|
+
def _skip_type_extensions(scanner)
|
|
179
|
+
loop do
|
|
180
|
+
@c_extractor_code_text.skip_deadspace( scanner )
|
|
181
|
+
next if scanner.skip( CExtractorConstants::BARE_EXTENSION )
|
|
182
|
+
return true unless scanner.skip( CExtractorConstants::ATTRIBUTE_CALL )
|
|
183
|
+
return false unless CExtractorDeclarator._skip_balanced( scanner )
|
|
184
|
+
end
|
|
185
|
+
end
|
|
186
|
+
|
|
187
|
+
# Moves the scanner past one token of a statement and appends it to `text`. A literal is one
|
|
188
|
+
# token and a comment becomes a space, so neither can end the statement or change its depth.
|
|
189
|
+
# A run of plain text is one token as well, so the scan doesn't step one character at a time.
|
|
190
|
+
def _take_token(scanner, text)
|
|
191
|
+
return _next_token( scanner ).tap { |token| text << token }
|
|
192
|
+
end
|
|
193
|
+
|
|
194
|
+
def _next_token(scanner)
|
|
195
|
+
quote = scanner.peek( 1 )
|
|
196
|
+
return _literal( scanner, quote ) if quote == '"' or quote == "'"
|
|
197
|
+
return scanner.scan( PLAIN_RUN ) || scanner.getch unless scanner.check( %r{/[/*]} )
|
|
198
|
+
|
|
199
|
+
@c_extractor_code_text.skip_comment( scanner )
|
|
200
|
+
return ' '
|
|
201
|
+
end
|
|
202
|
+
|
|
203
|
+
# The scanner's positions count bytes, so the literal is sliced by bytes too
|
|
204
|
+
def _literal(scanner, quote)
|
|
205
|
+
before = scanner.pos
|
|
206
|
+
@c_extractor_code_text.skip_c_string( scanner, quote )
|
|
207
|
+
return scanner.string.byteslice( before, scanner.pos - before )
|
|
155
208
|
end
|
|
156
209
|
|
|
157
210
|
end
|