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
|
@@ -0,0 +1,285 @@
|
|
|
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 'strscan'
|
|
9
|
+
require 'ceedling/c_extractor/c_extractor_constants'
|
|
10
|
+
|
|
11
|
+
# Reads the parenthesized declarator a C declaration may have, as in `int (*hook)(int)`.
|
|
12
|
+
#
|
|
13
|
+
# The declared name sits inside that group, past pointer stars and qualifiers. What follows the
|
|
14
|
+
# name decides what the declaration declares. A parameter list makes it a function, even one
|
|
15
|
+
# returning a function pointer. Anything else makes it an object, such as a pointer to a function
|
|
16
|
+
# or to an array. A plain declaration has no such group, and each caller reads it its own way.
|
|
17
|
+
# Every scan here is a single forward pass, so a declaration's cost stays linear.
|
|
18
|
+
module CExtractorDeclarator
|
|
19
|
+
|
|
20
|
+
# A declaration's parenthesized declarator. `follows` is the '(' or '[' right after the name,
|
|
21
|
+
# or nil. `base_type` is the text ahead of the group, and `declarator` the group onward.
|
|
22
|
+
Parenthesized = Struct.new( :name, :follows, :base_type, :declarator, keyword_init: true ) unless const_defined?(:Parenthesized, false)
|
|
23
|
+
|
|
24
|
+
# A calling convention, which may come ahead of a group's star
|
|
25
|
+
CALLING_CONVENTION = /(?:#{CExtractorConstants::MSVC_CALLING_CONVENTIONS.join( '|' )})\b/ unless const_defined?(:CALLING_CONVENTION, false)
|
|
26
|
+
|
|
27
|
+
# A '(' opening a declarator, perhaps through redundant parentheses and a calling convention
|
|
28
|
+
POINTER_GROUP = /\([\s(]*(?:#{CALLING_CONVENTION}\s*)*\*/ unless const_defined?(:POINTER_GROUP, false)
|
|
29
|
+
|
|
30
|
+
# A type specifier ending the text ahead of a group, whose argument the group holds
|
|
31
|
+
SPECIFIER_AHEAD = /(?<![\w$])(?:#{CExtractorConstants::SPECIFIERS_WITH_ARGUMENTS.join( '|' )})\s*\z/ unless const_defined?(:SPECIFIER_AHEAD, false)
|
|
32
|
+
|
|
33
|
+
# A nested pointer group. After a word, a '(' that opens one is no parameter list.
|
|
34
|
+
NESTED_GROUP = /\(\s*(?:#{CALLING_CONVENTION}\s*)*\*/ unless const_defined?(:NESTED_GROUP, false)
|
|
35
|
+
|
|
36
|
+
# Words that qualify a pointer ahead of the name, including ones a compiler adds. A '(' after
|
|
37
|
+
# one of these still opens a redundant group, as in `(* const (name))`.
|
|
38
|
+
QUALIFIERS = (CExtractorConstants::TYPE_QUALIFIER_KEYWORDS + CExtractorConstants::MSVC_CALLING_CONVENTIONS +
|
|
39
|
+
%w[__restrict __restrict__ _Nullable _Nonnull _Null_unspecified __far __near __huge __ptr32 __ptr64 __unaligned]).freeze unless const_defined?(:QUALIFIERS, false)
|
|
40
|
+
|
|
41
|
+
# An identifier, which GCC and Clang let hold '$'
|
|
42
|
+
WORD = CExtractorConstants::IDENTIFIER unless const_defined?(:WORD, false)
|
|
43
|
+
|
|
44
|
+
# Space between a group's tokens. Fallback preprocessing leaves comments in place.
|
|
45
|
+
GAP = %r{(?:\s|/\*.*?\*/|//[^\n]*)*}m unless const_defined?(:GAP, false)
|
|
46
|
+
|
|
47
|
+
# A string or character literal, or a comment. What looks like code inside one isn't. A literal
|
|
48
|
+
# may run past a line's end here, as CExtractorCodeText#skip_c_string reads one, so blanking
|
|
49
|
+
# comments and passing literals agree on where each ends.
|
|
50
|
+
LITERAL_OR_COMMENT = %r{"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|/\*.*?\*/|//[^\n]*}m unless const_defined?(:LITERAL_OR_COMMENT, false)
|
|
51
|
+
|
|
52
|
+
# A bracket, or a literal or comment whose brackets don't count toward a group's balance
|
|
53
|
+
BALANCE_TOKEN = Regexp.union( /[()\[\]{}]/, LITERAL_OR_COMMENT ) unless const_defined?(:BALANCE_TOKEN, false)
|
|
54
|
+
|
|
55
|
+
# A balance token, or the '=' that may start an initializer
|
|
56
|
+
INITIALIZER_TOKEN = Regexp.union( /=/, BALANCE_TOKEN ) unless const_defined?(:INITIALIZER_TOKEN, false)
|
|
57
|
+
|
|
58
|
+
# Where a walk through a declarator group stands. That is the name read so far, and how many
|
|
59
|
+
# '(' have passed since the last star. Those only group the name, and close right after it.
|
|
60
|
+
GroupWalk = Struct.new( :name, :opens ) unless const_defined?(:GroupWalk, false)
|
|
61
|
+
|
|
62
|
+
# What may follow a declarator's name. That is the group's own ')', a parameter list or an
|
|
63
|
+
# array size.
|
|
64
|
+
NAME_ENDS = [')', '(', '['].freeze unless const_defined?(:NAME_ENDS, false)
|
|
65
|
+
|
|
66
|
+
# How each delimiter changes the nesting depth
|
|
67
|
+
DEPTH_CHANGE = { '(' => 1, '[' => 1, '{' => 1, ')' => -1, ']' => -1, '}' => -1 }.freeze unless const_defined?(:DEPTH_CHANGE, false)
|
|
68
|
+
|
|
69
|
+
# The declaration's parenthesized declarator, or nil when it has none. The text has no
|
|
70
|
+
# initializer (see without_initializer). Words and attributes ahead of the group are passed
|
|
71
|
+
# over like the type, and end up in the base type. A group whose name ends any other way,
|
|
72
|
+
# such as at the ',' of a macro's arguments, is no declarator.
|
|
73
|
+
def self.parenthesized(text)
|
|
74
|
+
text = text.sub( /\s*;\s*\z/, '' )
|
|
75
|
+
start = _group_start( text )
|
|
76
|
+
return nil if start.nil?
|
|
77
|
+
|
|
78
|
+
name, ending = _name_in( text, start )
|
|
79
|
+
return nil unless NAME_ENDS.include?( ending )
|
|
80
|
+
|
|
81
|
+
return Parenthesized.new( name: name, follows: (ending == ')' ? nil : ending),
|
|
82
|
+
base_type: text.byteslice( 0, start ).strip, declarator: Extent.text( text, start ) )
|
|
83
|
+
end
|
|
84
|
+
|
|
85
|
+
# The declaration up to any initializer, less its semicolon. Only an '=' outside brackets,
|
|
86
|
+
# parentheses and braces starts one, and a bracket in a comment or literal doesn't count.
|
|
87
|
+
def self.without_initializer(text)
|
|
88
|
+
scanner = StringScanner.new( text )
|
|
89
|
+
depth = 0
|
|
90
|
+
while scanner.skip_until( INITIALIZER_TOKEN )
|
|
91
|
+
depth += DEPTH_CHANGE.fetch( scanner.matched, 0 )
|
|
92
|
+
return text.byteslice( 0, scanner.pos - 1 ).rstrip if scanner.matched == '=' and depth.zero?
|
|
93
|
+
end
|
|
94
|
+
|
|
95
|
+
return text.sub( /\s*;\s*\z/, '' )
|
|
96
|
+
end
|
|
97
|
+
|
|
98
|
+
# Where the declarator group opens. That is the first top-level '(' whose next token is a '*',
|
|
99
|
+
# perhaps after a calling convention. Any other group is a parameter list or a macro's
|
|
100
|
+
# arguments, a bracket holds an array size, and a brace holds a struct's members, so each is
|
|
101
|
+
# passed over whole. So is a type specifier's argument, as in `typeof(*p)`.
|
|
102
|
+
def self._group_start(text)
|
|
103
|
+
scanner = StringScanner.new( text )
|
|
104
|
+
while scanner.skip_until( /[(\[{]/ )
|
|
105
|
+
open = scanner.pos - 1
|
|
106
|
+
scanner.pos = open
|
|
107
|
+
return open if scanner.match?( POINTER_GROUP ) and !_specifier_argument?( text, open )
|
|
108
|
+
return nil unless _skip_balanced( scanner )
|
|
109
|
+
end
|
|
110
|
+
|
|
111
|
+
return nil
|
|
112
|
+
end
|
|
113
|
+
|
|
114
|
+
# Whether the group at `open` follows a specifier. Only the few bytes ahead of it are read,
|
|
115
|
+
# which the longest specifier and its space fit in. Every caller collapses whitespace and
|
|
116
|
+
# blanks or removes comments first, so nothing longer sits between the two.
|
|
117
|
+
def self._specifier_argument?(text, open)
|
|
118
|
+
from = [open - 24, 0].max
|
|
119
|
+
return text.byteslice( from, open - from ).scrub( '' ).match?( SPECIFIER_AHEAD )
|
|
120
|
+
end
|
|
121
|
+
|
|
122
|
+
# Moves the scanner past the group, bracket or brace it sits at. A bracket in a string, a
|
|
123
|
+
# character literal or a comment doesn't count. False when the text ends first.
|
|
124
|
+
def self._skip_balanced(scanner)
|
|
125
|
+
depth = 0
|
|
126
|
+
while scanner.skip_until( BALANCE_TOKEN )
|
|
127
|
+
depth += DEPTH_CHANGE.fetch( scanner.matched, 0 )
|
|
128
|
+
return true if depth.zero?
|
|
129
|
+
end
|
|
130
|
+
|
|
131
|
+
return false
|
|
132
|
+
end
|
|
133
|
+
|
|
134
|
+
# The name inside the group at `start`, with the character that ends it. The name is the last
|
|
135
|
+
# word ahead of that end that isn't a qualifier. A star or '(' ahead of the name clears any word
|
|
136
|
+
# read so far, since a qualifier the list lacks may come before the name. Parentheses around the
|
|
137
|
+
# name close before its end is read. After the name, a '(' opens a parameter list unless a
|
|
138
|
+
# nested pointer group starts there.
|
|
139
|
+
def self._name_in(text, start)
|
|
140
|
+
scanner = StringScanner.new( text )
|
|
141
|
+
scanner.pos = start + 1
|
|
142
|
+
walk = GroupWalk.new( nil, 0 )
|
|
143
|
+
|
|
144
|
+
while (step = _next_in_group( scanner, walk.name ))
|
|
145
|
+
_take_step( walk, step )
|
|
146
|
+
end
|
|
147
|
+
|
|
148
|
+
return [walk.name, _name_end( scanner, walk.opens )]
|
|
149
|
+
end
|
|
150
|
+
|
|
151
|
+
# Moves the scanner past the next token in a group and says what it was. That is :star, :group
|
|
152
|
+
# for a '(' passed through, or the word read. It is nil at anything else, which ends the name.
|
|
153
|
+
def self._next_in_group(scanner, name)
|
|
154
|
+
scanner.skip( GAP )
|
|
155
|
+
return :star if scanner.skip( /\*/ )
|
|
156
|
+
return scanner.scan( WORD ) unless scanner.check( /\(/ ) and (name.nil? or scanner.match?( NESTED_GROUP ))
|
|
157
|
+
|
|
158
|
+
scanner.pos += 1
|
|
159
|
+
return :group
|
|
160
|
+
end
|
|
161
|
+
|
|
162
|
+
# Records one step of the walk. A qualifier changes nothing. A star clears the name and the '('
|
|
163
|
+
# counted, and a '(' clears the name and counts one more.
|
|
164
|
+
def self._take_step(walk, step)
|
|
165
|
+
return if QUALIFIERS.include?( step )
|
|
166
|
+
|
|
167
|
+
walk.opens = (step == :star) ? 0 : walk.opens + 1 unless step.is_a?( String )
|
|
168
|
+
walk.name = step.is_a?( String ) ? step : nil
|
|
169
|
+
end
|
|
170
|
+
|
|
171
|
+
# What ends the name. A ')' closing a parenthesis that only groups the name is passed, and the
|
|
172
|
+
# first character past those decides, as in `(*(get)(void))` and `(*(get(void)))` alike.
|
|
173
|
+
def self._name_end(scanner, opens)
|
|
174
|
+
loop do
|
|
175
|
+
scanner.skip( GAP )
|
|
176
|
+
return scanner.peek( 1 ) unless scanner.check( /\)/ ) and opens.positive?
|
|
177
|
+
|
|
178
|
+
scanner.pos += 1
|
|
179
|
+
opens -= 1
|
|
180
|
+
end
|
|
181
|
+
end
|
|
182
|
+
|
|
183
|
+
# Where a declarator's text ends. An extern repeats the text, from the group's '(' through its
|
|
184
|
+
# last suffix. What follows the last suffix is left out. An extern needs no attribute or macro
|
|
185
|
+
# there, and some draw a warning. An asm label there is read apart (see AsmLabel).
|
|
186
|
+
module Extent
|
|
187
|
+
|
|
188
|
+
# Words, such as a macro, that may sit ahead of an array size among a declarator's suffixes
|
|
189
|
+
SUFFIX_WORDS = /(?:#{WORD}#{GAP})+/ unless const_defined?(:SUFFIX_WORDS, false)
|
|
190
|
+
|
|
191
|
+
# The declarator's text from its group's '(' at `start`
|
|
192
|
+
def self.text(text, start)
|
|
193
|
+
scanner = StringScanner.new( text )
|
|
194
|
+
scanner.pos = start
|
|
195
|
+
return text.byteslice( start, text.bytesize - start ).strip unless CExtractorDeclarator._skip_balanced( scanner )
|
|
196
|
+
|
|
197
|
+
finish = _suffixes_end( scanner )
|
|
198
|
+
return text.byteslice( start, finish - start ).strip
|
|
199
|
+
end
|
|
200
|
+
|
|
201
|
+
# Where the last of a declarator's parameter lists and array sizes ends, read from the scanner
|
|
202
|
+
# just past the group. A word may sit ahead of an array size, but a word ahead of a '(' makes
|
|
203
|
+
# a macro call, an attribute or an asm label, which ends the suffixes.
|
|
204
|
+
def self._suffixes_end(scanner)
|
|
205
|
+
finish = scanner.pos
|
|
206
|
+
loop do
|
|
207
|
+
scanner.skip( GAP )
|
|
208
|
+
opening = scanner.skip( SUFFIX_WORDS ) ? /\[/ : /[(\[]/
|
|
209
|
+
break unless scanner.check( opening ) and CExtractorDeclarator._skip_balanced( scanner )
|
|
210
|
+
|
|
211
|
+
finish = scanner.pos
|
|
212
|
+
end
|
|
213
|
+
|
|
214
|
+
return finish
|
|
215
|
+
end
|
|
216
|
+
|
|
217
|
+
end
|
|
218
|
+
|
|
219
|
+
# An asm label, as in `int g __asm__("sym") = 1;`, which names the symbol a declaration's
|
|
220
|
+
# object or function takes. A compiler applies it to the declarations it sees, so a test's own
|
|
221
|
+
# declaration must carry it too. A record keeps the label apart from the name and type it
|
|
222
|
+
# reads. Only a label outside brackets and ahead of any initializer counts.
|
|
223
|
+
module AsmLabel
|
|
224
|
+
|
|
225
|
+
# A run of word characters read whole, among which a label's keyword may be, or an
|
|
226
|
+
# initializer token. A number is read whole too, so no keyword is found inside one.
|
|
227
|
+
TOKEN = Regexp.union( INITIALIZER_TOKEN, /[\w$]+/ ) unless const_defined?(:TOKEN, false)
|
|
228
|
+
|
|
229
|
+
# The keywords that open a label
|
|
230
|
+
KEYWORDS = %w[asm __asm __asm__].freeze unless const_defined?(:KEYWORDS, false)
|
|
231
|
+
|
|
232
|
+
# What follows a label's keyword, up to the '(' of its string
|
|
233
|
+
OPEN = /#{GAP}\(/ unless const_defined?(:OPEN, false)
|
|
234
|
+
|
|
235
|
+
# The first label as written, such as `__asm__("sym")`, or nil
|
|
236
|
+
def self.of(text)
|
|
237
|
+
range = _ranges( text ).first
|
|
238
|
+
return range && text.byteslice( range.begin, range.size )
|
|
239
|
+
end
|
|
240
|
+
|
|
241
|
+
# The declaration without its labels ahead of any initializer. A compound declaration may hold
|
|
242
|
+
# one per declarator. The space around a label collapses to one, or to none ahead of a
|
|
243
|
+
# semicolon or comma.
|
|
244
|
+
def self.without(text)
|
|
245
|
+
ranges = _ranges( text )
|
|
246
|
+
return text if ranges.empty?
|
|
247
|
+
|
|
248
|
+
cuts = [0, *ranges.flat_map { |range| [range.begin, range.end] }, text.bytesize]
|
|
249
|
+
return cuts.each_slice( 2 ).map { |from, to| text.byteslice( from, to - from ) }.reduce { |kept, piece| _joined( kept, piece ) }
|
|
250
|
+
end
|
|
251
|
+
|
|
252
|
+
# Two pieces of text a label sat between, with the space between them collapsed
|
|
253
|
+
def self._joined(before, after)
|
|
254
|
+
before = before.rstrip
|
|
255
|
+
after = after.lstrip
|
|
256
|
+
return (after.empty? or after.start_with?( ';', ',' )) ? "#{before}#{after}" : "#{before} #{after}"
|
|
257
|
+
end
|
|
258
|
+
|
|
259
|
+
# Where each label sits, from its keyword through its ')'. The walk stops at an initializer.
|
|
260
|
+
def self._ranges(text)
|
|
261
|
+
scanner = StringScanner.new( text )
|
|
262
|
+
depth = 0
|
|
263
|
+
ranges = []
|
|
264
|
+
while scanner.skip_until( TOKEN ) and !(scanner.matched == '=' and depth.zero?)
|
|
265
|
+
token = scanner.matched
|
|
266
|
+
depth += DEPTH_CHANGE.fetch( token, 0 )
|
|
267
|
+
from = scanner.pos - token.bytesize
|
|
268
|
+
ranges << (from...scanner.pos) if _opens?( scanner, token, depth )
|
|
269
|
+
end
|
|
270
|
+
|
|
271
|
+
return ranges
|
|
272
|
+
end
|
|
273
|
+
|
|
274
|
+
# Whether the token just read opens a label outside brackets. On true, the scanner has passed
|
|
275
|
+
# the label's ')'.
|
|
276
|
+
def self._opens?(scanner, token, depth)
|
|
277
|
+
return false unless depth.zero? and KEYWORDS.include?( token ) and scanner.match?( OPEN )
|
|
278
|
+
|
|
279
|
+
scanner.skip( GAP )
|
|
280
|
+
return CExtractorDeclarator._skip_balanced( scanner )
|
|
281
|
+
end
|
|
282
|
+
|
|
283
|
+
end
|
|
284
|
+
|
|
285
|
+
end
|
|
@@ -0,0 +1,111 @@
|
|
|
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 'strscan'
|
|
9
|
+
require 'ceedling/c_extractor/c_extractor_constants'
|
|
10
|
+
require 'ceedling/c_extractor/c_extractor_declarator'
|
|
11
|
+
|
|
12
|
+
# Reads a struct, union or enum that a declaration defines ahead of its declarators, as in
|
|
13
|
+
# `static struct pair { int a; } g_p1, g_p2;`. Such a statement holds two things. The type is
|
|
14
|
+
# defined once, and each variable names it. Separating them lets every variable be read like
|
|
15
|
+
# any other, and lets a type be written once wherever a module's types go.
|
|
16
|
+
#
|
|
17
|
+
# Every scan here is a single forward pass over text whose comments are already blanked.
|
|
18
|
+
module CExtractorDefinedType
|
|
19
|
+
|
|
20
|
+
# A declaration split at the type it defines. `type` runs from the keyword through the body's
|
|
21
|
+
# '}' and any extensions after it, which belong to the type. `tag` is the type's tag, or nil.
|
|
22
|
+
# `declarators` is the declaration with the type taken out.
|
|
23
|
+
Split = Struct.new( :type, :tag, :declarators, keyword_init: true ) unless const_defined?(:Split, false)
|
|
24
|
+
|
|
25
|
+
KEYWORD = /(?:struct|union|enum)(?![\w$])/ unless const_defined?(:KEYWORD, false)
|
|
26
|
+
|
|
27
|
+
# A token in a type's head. A group or a bracket is passed whole. A '{' opens the body, and any
|
|
28
|
+
# other token here means the declaration names a type without defining one.
|
|
29
|
+
HEAD_TOKEN = Regexp.union( /[{(\[;=*,]/, CExtractorDeclarator::LITERAL_OR_COMMENT ) unless const_defined?(:HEAD_TOKEN, false)
|
|
30
|
+
|
|
31
|
+
# A head's words once its groups are gone, the tag last. A word C reserves for the
|
|
32
|
+
# implementation is an extension, and an enum's `: type` names no tag.
|
|
33
|
+
TAG = /\A(?:\s*__[\w$]*)*\s*(?<tag>#{CExtractorConstants::IDENTIFIER.source})?(?:\s*__[\w$]*)*\s*(?::.*)?\z/m unless const_defined?(:TAG, false)
|
|
34
|
+
|
|
35
|
+
# A typedef's one name, once its type is taken out
|
|
36
|
+
TYPEDEF_NAME = /\Atypedef\s+(?<name>#{CExtractorConstants::IDENTIFIER.source})\s*;\s*\z/ unless const_defined?(:TYPEDEF_NAME, false)
|
|
37
|
+
|
|
38
|
+
# A statement naming a tag without a body, perhaps giving it one typedef name
|
|
39
|
+
BODILESS = /\A(?:typedef\s+)?(?:struct|union|enum)\s+(?<tag>#{CExtractorConstants::IDENTIFIER.source})(?:\s+(?<name>#{CExtractorConstants::IDENTIFIER.source}))?\s*;\s*\z/ unless const_defined?(:BODILESS, false)
|
|
40
|
+
|
|
41
|
+
# The tag a type statement names and the one name a typedef gives it, each nil where absent.
|
|
42
|
+
# A typedef declaring several names, or a pointer, gives the type no one name.
|
|
43
|
+
# struct node { int v; }; tag node
|
|
44
|
+
# typedef struct node { int v; } node_t; tag node, type_name node_t
|
|
45
|
+
# typedef struct node node_t; tag node, type_name node_t
|
|
46
|
+
def self.names(text)
|
|
47
|
+
split = split( text, text[/\Atypedef\s+/].to_s.bytesize )
|
|
48
|
+
return { tag: split.tag, type_name: split.declarators[TYPEDEF_NAME, :name] } if split
|
|
49
|
+
|
|
50
|
+
found = text.match( BODILESS )
|
|
51
|
+
return { tag: found && found[:tag], type_name: found && found[:name] }
|
|
52
|
+
end
|
|
53
|
+
|
|
54
|
+
# The declaration split at the type it defines, or nil when it defines none. `from` is where
|
|
55
|
+
# the type's keyword may start, past the declaration's leading run of decorators and attributes.
|
|
56
|
+
def self.split(text, from)
|
|
57
|
+
scanner = StringScanner.new( text )
|
|
58
|
+
scanner.pos = from
|
|
59
|
+
return nil unless scanner.skip( KEYWORD )
|
|
60
|
+
|
|
61
|
+
head = _head( scanner )
|
|
62
|
+
return nil unless head and CExtractorDeclarator._skip_balanced( scanner )
|
|
63
|
+
|
|
64
|
+
_skip_extensions( scanner )
|
|
65
|
+
return Split.new(
|
|
66
|
+
type: text.byteslice( from, scanner.pos - from ).strip, tag: head[TAG, :tag],
|
|
67
|
+
declarators: "#{text.byteslice( 0, from )}#{scanner.rest}"
|
|
68
|
+
)
|
|
69
|
+
end
|
|
70
|
+
|
|
71
|
+
# The type's head between its keyword and its body, with each group taken out, or nil when
|
|
72
|
+
# no body follows. The scanner stops at the body's '{'. A group straight after a word means a
|
|
73
|
+
# macro spells the tag, as in `struct FOO_TYPE(bar) {`, so the head names no tag of its own.
|
|
74
|
+
def self._head(scanner)
|
|
75
|
+
head = +''
|
|
76
|
+
while (before = scanner.scan_until( HEAD_TOKEN ))
|
|
77
|
+
head << before.delete_suffix( scanner.matched )
|
|
78
|
+
return _body_at( scanner, head ) if scanner.matched == '{'
|
|
79
|
+
return nil unless scanner.matched.start_with?( '(', '[' )
|
|
80
|
+
|
|
81
|
+
head = +'(' if head.match?( /[A-Za-z0-9_$]\s*\z/ ) and !head.match?( /(?<![\w$])__[\w$]*\s*\z/ )
|
|
82
|
+
return nil unless _skip_group( scanner )
|
|
83
|
+
end
|
|
84
|
+
|
|
85
|
+
return nil
|
|
86
|
+
end
|
|
87
|
+
|
|
88
|
+
# The head, with the scanner moved back onto the body's '{'
|
|
89
|
+
def self._body_at(scanner, head)
|
|
90
|
+
scanner.pos -= 1
|
|
91
|
+
return head
|
|
92
|
+
end
|
|
93
|
+
|
|
94
|
+
# Moves the scanner, just past a group's opening, past its close. False when it never closes.
|
|
95
|
+
def self._skip_group(scanner)
|
|
96
|
+
scanner.pos -= 1
|
|
97
|
+
return CExtractorDeclarator._skip_balanced( scanner )
|
|
98
|
+
end
|
|
99
|
+
|
|
100
|
+
# Moves the scanner past the extensions after a type's body, such as `__attribute__((packed))`
|
|
101
|
+
# or `__packed`, and the space around them. A group that never closes ends the extensions.
|
|
102
|
+
def self._skip_extensions(scanner)
|
|
103
|
+
loop do
|
|
104
|
+
scanner.skip( /\s*/ )
|
|
105
|
+
next if scanner.skip( CExtractorConstants::BARE_EXTENSION )
|
|
106
|
+
break unless scanner.skip( CExtractorConstants::ATTRIBUTE_CALL ) or scanner.check( /\[\s*\[/ )
|
|
107
|
+
break unless CExtractorDeclarator._skip_balanced( scanner )
|
|
108
|
+
end
|
|
109
|
+
end
|
|
110
|
+
|
|
111
|
+
end
|