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
|
@@ -55,13 +55,15 @@ describe 'Partial header composition' do
|
|
|
55
55
|
# ---------------------------------------------------------------------------
|
|
56
56
|
|
|
57
57
|
# Issue #1319, first reporter. Types live in the module header and reference types
|
|
58
|
-
# from a header the
|
|
58
|
+
# from a header the module header includes. The source includes that header again,
|
|
59
|
+
# after the module's own header.
|
|
59
60
|
it 'compiles when the module header is included before its dependency' do
|
|
60
61
|
@result = generate_partial(
|
|
61
62
|
module_name: 'lm75b',
|
|
62
63
|
header: <<~C,
|
|
63
64
|
#ifndef LM75B_H
|
|
64
65
|
#define LM75B_H
|
|
66
|
+
#include "foundation.h"
|
|
65
67
|
typedef struct {
|
|
66
68
|
S16 os_over_temperature_deci_c;
|
|
67
69
|
U8 pin_state;
|
|
@@ -70,6 +72,7 @@ describe 'Partial header composition' do
|
|
|
70
72
|
#endif
|
|
71
73
|
C
|
|
72
74
|
source: "#include <string.h>\n#include \"lm75b.h\"\n#include \"foundation.h\"\n",
|
|
75
|
+
header_includes: ['foundation.h'],
|
|
73
76
|
source_includes: ['<string.h>', 'lm75b.h', 'foundation.h'],
|
|
74
77
|
extra: { 'foundation.h' => FOUNDATION_H }
|
|
75
78
|
)
|
|
@@ -195,10 +198,12 @@ describe 'Partial header composition' do
|
|
|
195
198
|
header: <<~C,
|
|
196
199
|
#ifndef ALERTMANAGER_H
|
|
197
200
|
#define ALERTMANAGER_H
|
|
201
|
+
#include "foundation.h"
|
|
198
202
|
typedef struct { S16 level; } AlertEntry_t;
|
|
199
203
|
#endif
|
|
200
204
|
C
|
|
201
205
|
source: "#include \"alertmanager.h\"\n#include \"facade.h\"\n#include \"foundation.h\"\n",
|
|
206
|
+
header_includes: ['foundation.h'],
|
|
202
207
|
source_includes: ['alertmanager.h', 'facade.h', 'foundation.h'],
|
|
203
208
|
extra: {
|
|
204
209
|
'foundation.h' => FOUNDATION_H,
|
|
@@ -345,6 +350,34 @@ describe 'Partial header composition' do
|
|
|
345
350
|
expect( @result.types_h.to_s ).to include('typedef unsigned char counter_t;')
|
|
346
351
|
expect( @result.types_h.to_s ).not_to include('unsigned long')
|
|
347
352
|
end
|
|
353
|
+
|
|
354
|
+
# An aggregate carrying a declarator defines its type once, in the types header. The extern
|
|
355
|
+
# and the definition both name it, since C treats two anonymous structs as unrelated types.
|
|
356
|
+
it 'keeps one type for an aggregate defined inline on a variable' do
|
|
357
|
+
@result = generate_partial(
|
|
358
|
+
module_name: 'slotted',
|
|
359
|
+
header: "#ifndef SLOTTED_H\n#define SLOTTED_H\n#endif\n",
|
|
360
|
+
source: "#include \"slotted.h\"\nstatic struct { int depth; } slot;\n",
|
|
361
|
+
source_includes: ['slotted.h']
|
|
362
|
+
)
|
|
363
|
+
|
|
364
|
+
compile = compile_partial( @result, prelude: "#include \"ceedling_partial_slotted_impl.c\"\n" )
|
|
365
|
+
expect( compile.ok ).to be(true), "expected a clean compile, got: #{compile.first_error}"
|
|
366
|
+
end
|
|
367
|
+
|
|
368
|
+
# A tag-only forward declaration is a type statement. Read as a variable, it would become
|
|
369
|
+
# `extern struct node;`, an empty declaration with a storage class, which is a diagnostic in
|
|
370
|
+
# its own right and an error under -Werror.
|
|
371
|
+
it 'preserves a forward declaration as a forward declaration' do
|
|
372
|
+
@result = generate_partial(
|
|
373
|
+
module_name: 'fwd',
|
|
374
|
+
header: "#ifndef FWD_H\n#define FWD_H\nstruct node;\ntypedef struct node* node_ref_t;\n#endif\n",
|
|
375
|
+
source: "#include \"fwd.h\"\nstruct node { int value; };\nstatic node_ref_t head;\n",
|
|
376
|
+
source_includes: ['fwd.h']
|
|
377
|
+
)
|
|
378
|
+
|
|
379
|
+
expect( @result.impl_h.to_s ).not_to include('extern struct node;')
|
|
380
|
+
end
|
|
348
381
|
end
|
|
349
382
|
|
|
350
383
|
# ---------------------------------------------------------------------------
|
|
@@ -405,6 +438,39 @@ describe 'Partial header composition' do
|
|
|
405
438
|
expect( @result.type_names( :types_h ) ).to include('valve_t')
|
|
406
439
|
end
|
|
407
440
|
|
|
441
|
+
# A header-only module has no source to place its header, so its types header has no
|
|
442
|
+
# position to take. It still has to come ahead of the prototypes that use its types.
|
|
443
|
+
it 'compiles for a header-only module whose prototypes use its own types' do
|
|
444
|
+
@result = generate_partial(
|
|
445
|
+
module_name: 'gpio', source: nil, tests_expose: nil, mocks_expose: PartializerConfig::PUBLIC,
|
|
446
|
+
header: <<~C,
|
|
447
|
+
#ifndef GPIO_H
|
|
448
|
+
#define GPIO_H
|
|
449
|
+
#include <stdint.h>
|
|
450
|
+
typedef enum { GPIO_IN, GPIO_OUT } gpio_dir_t;
|
|
451
|
+
void gpio_set(uint32_t pin, gpio_dir_t dir);
|
|
452
|
+
#endif
|
|
453
|
+
C
|
|
454
|
+
header_includes: ['<stdint.h>']
|
|
455
|
+
)
|
|
456
|
+
|
|
457
|
+
compile = compile_interface( @result )
|
|
458
|
+
expect( compile.ok ).to be(true), "expected a clean compile, got: #{compile.first_error}"
|
|
459
|
+
end
|
|
460
|
+
|
|
461
|
+
it 'compiles for a module whose source never includes its own header' do
|
|
462
|
+
@result = generate_partial(
|
|
463
|
+
module_name: 'valve', tests_expose: nil, mocks_expose: PartializerConfig::PUBLIC,
|
|
464
|
+
header: "#ifndef VALVE_H\n#define VALVE_H\ntypedef struct { int port; } valve_t;\nvoid valve_open(valve_t* v);\n#endif\n",
|
|
465
|
+
source: "#include \"base.h\"\nint valve_count(void) { return 0; }\n",
|
|
466
|
+
source_includes: ['base.h'],
|
|
467
|
+
extra: { 'base.h' => "#ifndef BASE_H\n#define BASE_H\n#endif\n" }
|
|
468
|
+
)
|
|
469
|
+
|
|
470
|
+
compile = compile_interface( @result )
|
|
471
|
+
expect( compile.ok ).to be(true), "expected a clean compile, got: #{compile.first_error}"
|
|
472
|
+
end
|
|
473
|
+
|
|
408
474
|
end
|
|
409
475
|
|
|
410
476
|
# ---------------------------------------------------------------------------
|
|
@@ -505,8 +571,9 @@ describe 'Partial header composition' do
|
|
|
505
571
|
it 'compiles with a system header ahead of the module header' do
|
|
506
572
|
@result = generate_partial(
|
|
507
573
|
module_name: 'lm75b',
|
|
508
|
-
header: "#ifndef LM75B_H\n#define LM75B_H\ntypedef struct { U8 pin; } lm75b_t;\n#endif\n",
|
|
574
|
+
header: "#ifndef LM75B_H\n#define LM75B_H\n#include \"foundation.h\"\ntypedef struct { U8 pin; } lm75b_t;\n#endif\n",
|
|
509
575
|
source: "#include <string.h>\n#include \"lm75b.h\"\n#include \"foundation.h\"\n",
|
|
576
|
+
header_includes: ['foundation.h'],
|
|
510
577
|
source_includes: ['<string.h>', 'lm75b.h', 'foundation.h'],
|
|
511
578
|
extra: { 'foundation.h' => FOUNDATION_H }
|
|
512
579
|
)
|
|
@@ -783,6 +850,98 @@ describe 'Partial header composition' do
|
|
|
783
850
|
}
|
|
784
851
|
end
|
|
785
852
|
|
|
853
|
+
# ---------------------------------------------------------------------------
|
|
854
|
+
context 'function return types' do
|
|
855
|
+
# ---------------------------------------------------------------------------
|
|
856
|
+
|
|
857
|
+
# A Partial strips each selected function's storage class so a test can call it. Only the
|
|
858
|
+
# storage class goes. Every word of the return type stays, and a qualifier is part of it.
|
|
859
|
+
RETURN_TYPES_H = <<~C
|
|
860
|
+
#ifndef SHAPES_H
|
|
861
|
+
#define SHAPES_H
|
|
862
|
+
struct point { int x; };
|
|
863
|
+
typedef unsigned char octet_t;
|
|
864
|
+
struct point *shapes_origin(void);
|
|
865
|
+
unsigned long shapes_big(void);
|
|
866
|
+
const char *shapes_name(void);
|
|
867
|
+
octet_t *shapes_buffer(void);
|
|
868
|
+
#endif
|
|
869
|
+
C
|
|
870
|
+
|
|
871
|
+
RETURN_TYPES_C = <<~C
|
|
872
|
+
#include "shapes.h"
|
|
873
|
+
static struct point origin;
|
|
874
|
+
static const int table[2] = { 1, 2 };
|
|
875
|
+
static octet_t buffer[4];
|
|
876
|
+
struct point *shapes_origin(void) { return &origin; }
|
|
877
|
+
unsigned long shapes_big(void) { return 4000000000UL; }
|
|
878
|
+
const char *shapes_name(void) { return "shapes"; }
|
|
879
|
+
octet_t *shapes_buffer(void) { return buffer; }
|
|
880
|
+
static const int *shapes_table(void) { return table; }
|
|
881
|
+
C
|
|
882
|
+
|
|
883
|
+
def generate_shapes
|
|
884
|
+
generate_partial(
|
|
885
|
+
module_name: 'shapes', header: RETURN_TYPES_H, source: RETURN_TYPES_C,
|
|
886
|
+
source_includes: ['shapes.h']
|
|
887
|
+
)
|
|
888
|
+
end
|
|
889
|
+
|
|
890
|
+
it 'keeps every return type whole in the implementation header' do
|
|
891
|
+
@result = generate_shapes
|
|
892
|
+
|
|
893
|
+
expect( @result.impl_h ).to include( 'struct point *shapes_origin(void);' )
|
|
894
|
+
expect( @result.impl_h ).to include( 'unsigned long shapes_big(void);' )
|
|
895
|
+
expect( @result.impl_h ).to include( 'const char *shapes_name(void);' )
|
|
896
|
+
expect( @result.impl_h ).to include( 'octet_t *shapes_buffer(void);' )
|
|
897
|
+
expect( @result.impl_h ).to include( 'const int *shapes_table(void);' )
|
|
898
|
+
end
|
|
899
|
+
|
|
900
|
+
it 'keeps every return type whole in the implementation source' do
|
|
901
|
+
@result = generate_shapes
|
|
902
|
+
|
|
903
|
+
expect( @result.impl_c ).to include( 'struct point *shapes_origin(void) {' )
|
|
904
|
+
expect( @result.impl_c ).to include( 'unsigned long shapes_big(void) {' )
|
|
905
|
+
expect( @result.impl_c ).to include( 'const char *shapes_name(void) {' )
|
|
906
|
+
expect( @result.impl_c ).to include( 'const int *shapes_table(void) {' )
|
|
907
|
+
expect( @result.impl_c ).not_to match( /^static const int \*shapes_table/ )
|
|
908
|
+
end
|
|
909
|
+
|
|
910
|
+
it 'keeps every return type whole in the mockable interface' do
|
|
911
|
+
@result = generate_shapes
|
|
912
|
+
|
|
913
|
+
expect( @result.interface_h ).to include( 'struct point *shapes_origin(void);' )
|
|
914
|
+
expect( @result.interface_h ).to include( 'const char *shapes_name(void);' )
|
|
915
|
+
end
|
|
916
|
+
|
|
917
|
+
# A dropped qualifier or type word still compiles in some shapes, so warnings count too
|
|
918
|
+
it 'compiles the implementation source without a diagnostic' do
|
|
919
|
+
@result = generate_shapes
|
|
920
|
+
|
|
921
|
+
compile = compile_objects( @result )
|
|
922
|
+
expect( compile.ok ).to be(true), "expected a clean compile, got: #{compile.first_error}"
|
|
923
|
+
expect( compile.stderr ).to be_empty
|
|
924
|
+
end
|
|
925
|
+
end
|
|
926
|
+
|
|
927
|
+
# ---------------------------------------------------------------------------
|
|
928
|
+
context 'a variable the header declares and the source defines' do
|
|
929
|
+
# ---------------------------------------------------------------------------
|
|
930
|
+
|
|
931
|
+
# Both files name one variable. The implementation header declares it once, so a test
|
|
932
|
+
# build that warns on redundant declarations stays clean.
|
|
933
|
+
it 'declares the variable once in the implementation header' do
|
|
934
|
+
@result = generate_partial(
|
|
935
|
+
module_name: 'moded',
|
|
936
|
+
header: "#ifndef MODED_H\n#define MODED_H\nextern int moded_mode;\nint moded_get(void);\n#endif\n",
|
|
937
|
+
source: "#include \"moded.h\"\nint moded_mode = 3;\nint moded_get(void) { return moded_mode; }\n",
|
|
938
|
+
source_includes: ['moded.h']
|
|
939
|
+
)
|
|
940
|
+
|
|
941
|
+
expect( @result.impl_h.scan( 'extern int moded_mode;' ).size ).to eq(1)
|
|
942
|
+
end
|
|
943
|
+
end
|
|
944
|
+
|
|
786
945
|
# ---------------------------------------------------------------------------
|
|
787
946
|
context 'C shapes the extraction model does not yet carry' do
|
|
788
947
|
# ---------------------------------------------------------------------------
|
|
@@ -816,39 +975,6 @@ describe 'Partial header composition' do
|
|
|
816
975
|
expect( compile.ok ).to be(true), "expected a clean compile, got: #{compile.first_error}"
|
|
817
976
|
end
|
|
818
977
|
|
|
819
|
-
# An aggregate carrying a declarator is not a standalone type definition, so it reaches
|
|
820
|
-
# the variable extractor whole. Re-emitting it as both an extern and a definition states
|
|
821
|
-
# an anonymous struct twice, and C treats two anonymous structs as unrelated types.
|
|
822
|
-
it 'keeps one type for an aggregate defined inline on a variable' do
|
|
823
|
-
pending 'an aggregate carrying a declarator is classified as a variable -- follow-on work'
|
|
824
|
-
|
|
825
|
-
@result = generate_partial(
|
|
826
|
-
module_name: 'slotted',
|
|
827
|
-
header: "#ifndef SLOTTED_H\n#define SLOTTED_H\n#endif\n",
|
|
828
|
-
source: "#include \"slotted.h\"\nstatic struct { int depth; } slot;\n",
|
|
829
|
-
source_includes: ['slotted.h']
|
|
830
|
-
)
|
|
831
|
-
|
|
832
|
-
compile = compile_partial( @result, prelude: "#include \"ceedling_partial_slotted_impl.c\"\n" )
|
|
833
|
-
expect( compile.ok ).to be(true), "expected a clean compile, got: #{compile.first_error}"
|
|
834
|
-
end
|
|
835
|
-
|
|
836
|
-
# A tag-only forward declaration has no declarator, and reaching the variable extractor
|
|
837
|
-
# turns it into `extern struct node;`. That is an empty declaration with a storage class,
|
|
838
|
-
# which is a diagnostic in its own right and an error under -Werror.
|
|
839
|
-
it 'preserves a forward declaration as a forward declaration' do
|
|
840
|
-
pending 'a tag-only forward declaration is classified as a variable -- follow-on work'
|
|
841
|
-
|
|
842
|
-
@result = generate_partial(
|
|
843
|
-
module_name: 'fwd',
|
|
844
|
-
header: "#ifndef FWD_H\n#define FWD_H\nstruct node;\ntypedef struct node* node_ref_t;\n#endif\n",
|
|
845
|
-
source: "#include \"fwd.h\"\nstruct node { int value; };\nstatic node_ref_t head;\n",
|
|
846
|
-
source_includes: ['fwd.h']
|
|
847
|
-
)
|
|
848
|
-
|
|
849
|
-
expect( @result.impl_h.to_s ).not_to include('extern struct node;')
|
|
850
|
-
end
|
|
851
|
-
|
|
852
978
|
# Directives-only preprocessing passes both #define and #undef through, and extraction
|
|
853
979
|
# keeps only #define. A macro the module deliberately scoped to a few lines therefore
|
|
854
980
|
# becomes visible everywhere the generated headers reach, the test file included.
|
|
@@ -886,4 +1012,111 @@ describe 'Partial header composition' do
|
|
|
886
1012
|
end
|
|
887
1013
|
end
|
|
888
1014
|
|
|
1015
|
+
|
|
1016
|
+
# ---------------------------------------------------------------------------
|
|
1017
|
+
context "includes the source names after the module's header" do
|
|
1018
|
+
# ---------------------------------------------------------------------------
|
|
1019
|
+
|
|
1020
|
+
# A later header that includes the module's header reaches only the spoofed guard, so it
|
|
1021
|
+
# finds the module's types and macros only in what a generated header writes ahead of it.
|
|
1022
|
+
SENSOR_LOG_H = <<~C
|
|
1023
|
+
#ifndef SENSOR_LOG_H
|
|
1024
|
+
#define SENSOR_LOG_H
|
|
1025
|
+
#include "sensor.h"
|
|
1026
|
+
void sensor_log_status(sensor_status_t status);
|
|
1027
|
+
#endif
|
|
1028
|
+
C
|
|
1029
|
+
|
|
1030
|
+
# Issue #1402. The source's own type uses the header's type, so the types header holds both.
|
|
1031
|
+
it "compiles when a later header uses the module header's types" do
|
|
1032
|
+
@result = generate_partial(
|
|
1033
|
+
module_name: 'sensor',
|
|
1034
|
+
header: <<~C,
|
|
1035
|
+
#ifndef SENSOR_H
|
|
1036
|
+
#define SENSOR_H
|
|
1037
|
+
#include <stdint.h>
|
|
1038
|
+
typedef enum { SENSOR_OK, SENSOR_ERROR } sensor_status_t;
|
|
1039
|
+
sensor_status_t sensor_read(int32_t *value);
|
|
1040
|
+
#endif
|
|
1041
|
+
C
|
|
1042
|
+
source: <<~C,
|
|
1043
|
+
#include "sensor_config.h"
|
|
1044
|
+
#include "sensor.h"
|
|
1045
|
+
#include "sensor_log.h"
|
|
1046
|
+
#include <stdint.h>
|
|
1047
|
+
typedef struct { int32_t value; sensor_status_t status; } sensor_reading_t;
|
|
1048
|
+
sensor_status_t sensor_read(int32_t *value) {
|
|
1049
|
+
sensor_reading_t reading = { SENSOR_DEFAULT_VALUE, SENSOR_OK };
|
|
1050
|
+
*value = reading.value;
|
|
1051
|
+
sensor_log_status(reading.status);
|
|
1052
|
+
return reading.status;
|
|
1053
|
+
}
|
|
1054
|
+
C
|
|
1055
|
+
header_includes: ['<stdint.h>'],
|
|
1056
|
+
source_includes: ['sensor_config.h', 'sensor.h', 'sensor_log.h', '<stdint.h>'],
|
|
1057
|
+
extra: {
|
|
1058
|
+
'sensor_config.h' => "#ifndef SENSOR_CONFIG_H\n#define SENSOR_CONFIG_H\n#define SENSOR_DEFAULT_VALUE 42\n#endif\n",
|
|
1059
|
+
'sensor_log.h' => SENSOR_LOG_H
|
|
1060
|
+
}
|
|
1061
|
+
)
|
|
1062
|
+
|
|
1063
|
+
compile = compile_partial( @result )
|
|
1064
|
+
expect( compile.ok ).to be(true), "expected a clean compile, got: #{compile.first_error}"
|
|
1065
|
+
|
|
1066
|
+
alone = compile_types_header_alone( @result )
|
|
1067
|
+
expect( alone.ok ).to be(true), "expected the types header to compile alone, got: #{alone.first_error}"
|
|
1068
|
+
end
|
|
1069
|
+
|
|
1070
|
+
# A module with no types gets no types header, so its implementation and interface headers
|
|
1071
|
+
# write its macros ahead of the later includes themselves
|
|
1072
|
+
it "compiles when a later header uses a macro of a module with no types" do
|
|
1073
|
+
@result = generate_partial(
|
|
1074
|
+
module_name: 'sensor',
|
|
1075
|
+
header: <<~C,
|
|
1076
|
+
#ifndef SENSOR_H
|
|
1077
|
+
#define SENSOR_H
|
|
1078
|
+
#define SENSOR_COUNT 4
|
|
1079
|
+
void sensor_read(void);
|
|
1080
|
+
#endif
|
|
1081
|
+
C
|
|
1082
|
+
source: <<~C,
|
|
1083
|
+
#include "sensor.h"
|
|
1084
|
+
#include "sensor_log.h"
|
|
1085
|
+
void sensor_read(void) {
|
|
1086
|
+
int log[SENSOR_COUNT] = { 0 };
|
|
1087
|
+
sensor_log_all(log);
|
|
1088
|
+
}
|
|
1089
|
+
C
|
|
1090
|
+
source_includes: ['sensor.h', 'sensor_log.h'],
|
|
1091
|
+
extra: {
|
|
1092
|
+
'sensor_log.h' => "#ifndef SENSOR_LOG_H\n#define SENSOR_LOG_H\n#include \"sensor.h\"\nvoid sensor_log_all(int log[SENSOR_COUNT]);\n#endif\n"
|
|
1093
|
+
}
|
|
1094
|
+
)
|
|
1095
|
+
|
|
1096
|
+
expect( @result.types_h ).to be_nil
|
|
1097
|
+
compile = compile_both_headers( @result )
|
|
1098
|
+
expect( compile.ok ).to be(true), "expected a clean compile, got: #{compile.first_error}"
|
|
1099
|
+
end
|
|
1100
|
+
|
|
1101
|
+
# The mocked module's interface header declares its types, so it stands where the real
|
|
1102
|
+
# header stood: ahead of the module's header, whose types use it
|
|
1103
|
+
it "keeps a mocked Partial's interface header ahead of the module's types" do
|
|
1104
|
+
@result = generate_partial(
|
|
1105
|
+
module_name: 'host',
|
|
1106
|
+
header: "#ifndef HOST_H\n#define HOST_H\ntypedef struct { guest_handle_t h; } host_t;\n#endif\n",
|
|
1107
|
+
source: "#include \"guest.h\"\n#include \"host.h\"\n#include \"later.h\"\n",
|
|
1108
|
+
source_includes: ['guest.h', 'host.h', 'later.h'],
|
|
1109
|
+
partials: other_partial( 'guest', mocked: true ),
|
|
1110
|
+
extra: {
|
|
1111
|
+
'guest.h' => "#ifndef GUEST_H\n#define GUEST_H\ntypedef int guest_handle_t;\n#endif\n",
|
|
1112
|
+
'later.h' => "#ifndef LATER_H\n#define LATER_H\n#endif\n"
|
|
1113
|
+
}
|
|
1114
|
+
)
|
|
1115
|
+
|
|
1116
|
+
body = @result.types_h.to_s
|
|
1117
|
+
expect( body.index( 'ceedling_partial_guest_interface.h' ) ).to be < body.index( 'host_t;' )
|
|
1118
|
+
expect( body.index( '"later.h"' ) ).to be > body.index( 'host_t;' )
|
|
1119
|
+
end
|
|
1120
|
+
end
|
|
1121
|
+
|
|
889
1122
|
end
|
|
@@ -0,0 +1,267 @@
|
|
|
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
|
+
# Selected functions and file-scope variables whose storage class or inline specifier a macro
|
|
9
|
+
# supplies.
|
|
10
|
+
#
|
|
11
|
+
# A project can hide `static` behind a macro of its own, such as `#define PRIVATE static`. A
|
|
12
|
+
# Partial strips `static` from every function and variable it exposes, so each links from the
|
|
13
|
+
# test. The implementation header declares the expanded, stripped declaration. The
|
|
14
|
+
# implementation source must define the same one, or the macro, carried in with the module's
|
|
15
|
+
# header, makes the definition static again after a non-static declaration.
|
|
16
|
+
#
|
|
17
|
+
# Each case compiles and links real objects with warnings as errors, in accurate and fallback
|
|
18
|
+
# preprocessing alike, since both reconcile with the full expansion.
|
|
19
|
+
|
|
20
|
+
require 'spec_helper'
|
|
21
|
+
require 'spec_integration_helper'
|
|
22
|
+
require 'partials_generation_integration_helper'
|
|
23
|
+
|
|
24
|
+
describe 'Partial functions and variables whose decorators a macro supplies' do
|
|
25
|
+
|
|
26
|
+
include_context 'requires gcc'
|
|
27
|
+
|
|
28
|
+
after(:each) { cleanup_dir( @dir ) }
|
|
29
|
+
|
|
30
|
+
ENGINE_HEADER = <<~C
|
|
31
|
+
#ifndef ENGINE_H
|
|
32
|
+
#define ENGINE_H
|
|
33
|
+
#define PRIVATE static
|
|
34
|
+
#define STATICINLINE static inline
|
|
35
|
+
#define EXTERN extern
|
|
36
|
+
#define LEN 2
|
|
37
|
+
int engine_get(void);
|
|
38
|
+
#endif
|
|
39
|
+
C
|
|
40
|
+
|
|
41
|
+
def engine(source, mode:, header: ENGINE_HEADER, **options)
|
|
42
|
+
result = generate_partial(
|
|
43
|
+
module_name: 'engine', header: header, source: source, source_includes: ['engine.h'], mode: mode, **options
|
|
44
|
+
)
|
|
45
|
+
@dir = result.dir
|
|
46
|
+
return result
|
|
47
|
+
end
|
|
48
|
+
|
|
49
|
+
def link_cleanly(result, references:)
|
|
50
|
+
link = link_partial( result, references: references, flags: '-Wall -Werror' )
|
|
51
|
+
expect( link.ok ).to be( true ), "expected a clean link, got: #{link.first_diagnostic}"
|
|
52
|
+
end
|
|
53
|
+
|
|
54
|
+
[:accurate, :fallback].each do |mode|
|
|
55
|
+
context "with #{mode} preprocessing" do
|
|
56
|
+
before { skip 'directives-only preprocessing is unavailable' if mode == :accurate and !directives_only_supported? }
|
|
57
|
+
|
|
58
|
+
it 'links a selected function a macro makes static' do
|
|
59
|
+
result = engine( "#include \"engine.h\"\nPRIVATE int helper(void) { return 41; }\nint engine_get(void) { return helper() + 1; }\n", mode: mode )
|
|
60
|
+
|
|
61
|
+
expect( result.impl_c ).to include( 'int helper(void) { return 41; }' )
|
|
62
|
+
expect( result.impl_c ).not_to include( 'PRIVATE int helper' )
|
|
63
|
+
link_cleanly( result, references: ['helper', 'engine_get'] )
|
|
64
|
+
end
|
|
65
|
+
|
|
66
|
+
# Fallback keeps comments in the text it extracts, where a ';' or a split name could mislead
|
|
67
|
+
it 'links a selected function whose head holds comments' do
|
|
68
|
+
source = "#include \"engine.h\"\nPRIVATE int helper /* c */ (int a) /* adds; */ { return a ? helper( a - 1 ) : 41; }\n" \
|
|
69
|
+
"int engine_get(void) { return helper( 2 ) + 1; }\n"
|
|
70
|
+
result = engine( source, mode: mode )
|
|
71
|
+
|
|
72
|
+
expect( result.impl_c ).not_to include( 'PRIVATE int helper' )
|
|
73
|
+
link_cleanly( result, references: ['helper', 'engine_get'] )
|
|
74
|
+
end
|
|
75
|
+
|
|
76
|
+
# Each body line keeps its own line, so coverage and diagnostics still point at the module
|
|
77
|
+
it 'keeps the function name and every body line at their own lines' do
|
|
78
|
+
source = "#include \"engine.h\"\nPRIVATE int\nhelper(int a,\n int b)\n{\n return a + b;\n}\nint engine_get(void) { return helper( 20, 22 ); }\n"
|
|
79
|
+
result = engine( source, mode: mode )
|
|
80
|
+
|
|
81
|
+
expect( result.impl_c ).to match( /^#line 3 "[^"]*engine\.c"\nint helper\(int a, int b\)\n\n\{\n return a \+ b;\n\}/ )
|
|
82
|
+
link_cleanly( result, references: ['helper'] )
|
|
83
|
+
end
|
|
84
|
+
|
|
85
|
+
it 'links a selected function a macro makes static and inline' do
|
|
86
|
+
result = engine( "#include \"engine.h\"\nSTATICINLINE int twice(int v) { return v * 2; }\nint engine_get(void) { return twice( 21 ); }\n", mode: mode )
|
|
87
|
+
|
|
88
|
+
expect( result.impl_c ).to include( 'int twice(int v) { return v * 2; }' )
|
|
89
|
+
link_cleanly( result, references: ['twice', 'engine_get'] )
|
|
90
|
+
end
|
|
91
|
+
end
|
|
92
|
+
end
|
|
93
|
+
|
|
94
|
+
# A variable's storage class can come from a macro too. Its extern and its definition then
|
|
95
|
+
# take the expanded declaration, less `static`, so the two agree and the name links.
|
|
96
|
+
[:accurate, :fallback].each do |mode|
|
|
97
|
+
context "a file-scope variable, with #{mode} preprocessing" do
|
|
98
|
+
before { skip 'directives-only preprocessing is unavailable' if mode == :accurate and !directives_only_supported? }
|
|
99
|
+
|
|
100
|
+
it 'links a variable a macro makes static' do
|
|
101
|
+
result = engine( "#include \"engine.h\"\nPRIVATE int counter;\nint engine_get(void) { return counter; }\n", mode: mode )
|
|
102
|
+
|
|
103
|
+
expect( result.impl_h ).to include( 'extern int counter;' )
|
|
104
|
+
expect( result.impl_h ).not_to include( 'extern PRIVATE' )
|
|
105
|
+
link_cleanly( result, references: ['counter', 'engine_get'] )
|
|
106
|
+
end
|
|
107
|
+
|
|
108
|
+
it 'links a qualified array a macro makes static, with its initializer' do
|
|
109
|
+
result = engine( "#include \"engine.h\"\nPRIVATE const unsigned char table[LEN] = { 1, 2 };\nint engine_get(void) { return table[1]; }\n", mode: mode )
|
|
110
|
+
|
|
111
|
+
expect( result.impl_h ).to include( 'extern const unsigned char table[2];' )
|
|
112
|
+
expect( result.impl_c ).to include( 'const unsigned char table[2] = { 1, 2 };' )
|
|
113
|
+
link_cleanly( result, references: ['table', 'engine_get'] )
|
|
114
|
+
end
|
|
115
|
+
|
|
116
|
+
# A variable only declared extern gets a weak definition, however `extern` is spelled
|
|
117
|
+
it 'gives a variable a macro declares extern its weak definition' do
|
|
118
|
+
result = engine( "#include \"engine.h\"\nEXTERN int shared;\nint engine_get(void) { return shared; }\n", mode: mode )
|
|
119
|
+
|
|
120
|
+
expect( result.impl_h ).to include( 'extern int shared;' )
|
|
121
|
+
expect( result.impl_h ).not_to include( 'extern EXTERN' )
|
|
122
|
+
expect( result.impl_c ).to include( '__attribute__((weak)) int shared;' )
|
|
123
|
+
link_cleanly( result, references: ['shared', 'engine_get'] )
|
|
124
|
+
end
|
|
125
|
+
|
|
126
|
+
# A variable the module defines needs no weak definition, whatever its declaration says
|
|
127
|
+
it 'gives no weak definition to a variable a macro declares extern and the module defines' do
|
|
128
|
+
result = engine( "#include \"engine.h\"\nEXTERN int shared;\nint shared = 1;\nint engine_get(void) { return shared; }\n", mode: mode )
|
|
129
|
+
|
|
130
|
+
expect( result.impl_c ).not_to include( '__attribute__((weak))' )
|
|
131
|
+
link_cleanly( result, references: ['shared', 'engine_get'] )
|
|
132
|
+
end
|
|
133
|
+
|
|
134
|
+
it 'links each variable of a compound declaration a macro makes static' do
|
|
135
|
+
result = engine( "#include \"engine.h\"\nPRIVATE int low = 1, *high;\nint engine_get(void) { return low + (high != 0); }\n", mode: mode )
|
|
136
|
+
|
|
137
|
+
expect( result.impl_h ).to include( 'extern int low;' )
|
|
138
|
+
link_cleanly( result, references: ['low', 'high', 'engine_get'] )
|
|
139
|
+
end
|
|
140
|
+
|
|
141
|
+
# The type a macro hid ahead of it is named once and declared once
|
|
142
|
+
it 'links a variable a macro makes static that defines its own type' do
|
|
143
|
+
result = engine( "#include \"engine.h\"\nPRIVATE struct { int a; } state;\nint engine_get(void) { return state.a; }\n", mode: mode )
|
|
144
|
+
|
|
145
|
+
expect( result.types_h.scan( 'ceedling_partial_engine_state_t;' ).size ).to eq( 1 )
|
|
146
|
+
expect( result.impl_h ).to include( 'extern ceedling_partial_engine_state_t state;' )
|
|
147
|
+
link_cleanly( result, references: ['state', 'engine_get'] )
|
|
148
|
+
end
|
|
149
|
+
|
|
150
|
+
it 'links a variable a macro makes static that defines a tagged type' do
|
|
151
|
+
result = engine( "#include \"engine.h\"\nPRIVATE struct pair { int a; } first;\nint engine_get(void) { return first.a; }\n", mode: mode )
|
|
152
|
+
|
|
153
|
+
link_cleanly( result, references: ['first', 'engine_get'] )
|
|
154
|
+
end
|
|
155
|
+
end
|
|
156
|
+
end
|
|
157
|
+
|
|
158
|
+
# A macro after a type's closing brace, as `struct pk { … } PACKED;`, reads as a variable in
|
|
159
|
+
# the written text. The expansion shows the macro belongs to the type, so the type keeps it.
|
|
160
|
+
[:accurate, :fallback].each do |mode|
|
|
161
|
+
context "a type a macro ends, with #{mode} preprocessing" do
|
|
162
|
+
before { skip 'directives-only preprocessing is unavailable' if mode == :accurate and !directives_only_supported? }
|
|
163
|
+
|
|
164
|
+
def ended_types(declarations, mode:, extra: {}, includes: [])
|
|
165
|
+
header = "#ifndef ENGINE_H\n#define ENGINE_H\n#{includes.map { |name| "#include \"#{name}\"\n" }.join}" \
|
|
166
|
+
"#define PACKED __attribute__((packed))\n#define ALIGNED(n) __attribute__((aligned(n)))\n" \
|
|
167
|
+
"#{declarations}int engine_get(void);\n#endif\n"
|
|
168
|
+
engine( "#include \"engine.h\"\nint engine_get(void) { return 0; }\n", mode: mode, header: header, extra: extra, header_includes: includes )
|
|
169
|
+
end
|
|
170
|
+
|
|
171
|
+
# The link's test translation unit asserts the layout through the generated headers
|
|
172
|
+
def link_holding(result, assertion)
|
|
173
|
+
link = link_partial( result, references: ['engine_get'], stubs: "_Static_assert( #{assertion}, \"layout kept\" );\n", flags: '-Wall -Werror' )
|
|
174
|
+
expect( link.ok ).to be( true ), "expected a clean link, got: #{link.first_diagnostic}"
|
|
175
|
+
end
|
|
176
|
+
|
|
177
|
+
it 'keeps the macro with its type, so the type keeps its layout' do
|
|
178
|
+
result = ended_types( "struct pk { char c; int i; } PACKED;\n", mode: mode )
|
|
179
|
+
|
|
180
|
+
expect( result.types_h ).to include( 'struct pk { char c; int i; } PACKED;' )
|
|
181
|
+
expect( result.impl_h ).not_to match( /\bPACKED;/ )
|
|
182
|
+
link_holding( result, 'sizeof( struct pk ) == 5' )
|
|
183
|
+
end
|
|
184
|
+
|
|
185
|
+
# Variables after the macro read it as the start of their type, and the type keeps it too
|
|
186
|
+
{
|
|
187
|
+
'one variable' => ["struct pk { char c; int i; } PACKED inst;\n", 'inst', 'sizeof( inst ) == 5'],
|
|
188
|
+
'a static variable' => ["static struct pk { char c; int i; } PACKED inst;\n", 'inst', 'sizeof( inst ) == 5'],
|
|
189
|
+
'two variables' => ["struct pk { char c; int i; } PACKED i1, i2;\n", 'i1', 'sizeof( i1 ) == 5 && sizeof( i2 ) == 5'],
|
|
190
|
+
'an initialized const variable' => ["const struct pk { char c; int i; } PACKED inst = { 1, 2 };\n", 'inst', 'sizeof( inst ) == 5'],
|
|
191
|
+
'a pointer' => ["struct pk { char c; int i; } PACKED *gp;\n", 'gp', 'sizeof( *gp ) == 5']
|
|
192
|
+
}.each do |shape, (declaration, variable, assertion)|
|
|
193
|
+
it "keeps the macro with its type ahead of #{shape}" do
|
|
194
|
+
result = engine( "#include \"engine.h\"\n#{declaration}int engine_get(void) { return sizeof( #{variable} ); }\n",
|
|
195
|
+
mode: mode, header: "#ifndef ENGINE_H\n#define ENGINE_H\n#define PACKED __attribute__((packed))\nint engine_get(void);\n#endif\n" )
|
|
196
|
+
|
|
197
|
+
expect( result.impl_h ).not_to match( /PACKED \*?#{variable}/ )
|
|
198
|
+
link = link_partial( result, references: [variable, 'engine_get'], stubs: "_Static_assert( #{assertion}, \"layout kept\" );\n", flags: '-Wall -Werror' )
|
|
199
|
+
expect( link.ok ).to be( true ), "expected a clean link, got: #{link.first_diagnostic}"
|
|
200
|
+
end
|
|
201
|
+
end
|
|
202
|
+
|
|
203
|
+
# A macro for a storage class or a qualifier after the brace belongs to the variable
|
|
204
|
+
it 'keeps a storage class and a qualifier a macro writes after the brace with the variable' do
|
|
205
|
+
header = "#ifndef ENGINE_H\n#define ENGINE_H\n#define PRIVATE static\n#define CONST const\nint engine_get(void);\n#endif\n"
|
|
206
|
+
source = "#include \"engine.h\"\nstruct pk { char c; int i; } PRIVATE inst;\nstruct pc { char c; } CONST ro = { 1 };\n" \
|
|
207
|
+
"int engine_get(void) { return inst.i + ro.c; }\n"
|
|
208
|
+
result = engine( source, mode: mode, header: header )
|
|
209
|
+
|
|
210
|
+
expect( result.types_h ).not_to match( /\}\s*(?:PRIVATE|CONST|static|const)\b/ )
|
|
211
|
+
link = link_partial( result, references: ['inst', 'ro', 'engine_get'], flags: '-Wall -Werror' )
|
|
212
|
+
expect( link.ok ).to be( true ), "expected a clean link, got: #{link.first_diagnostic}"
|
|
213
|
+
end
|
|
214
|
+
|
|
215
|
+
it 'keeps a function-like macro with its type' do
|
|
216
|
+
result = ended_types( "struct al { char c; } ALIGNED(8);\n", mode: mode )
|
|
217
|
+
|
|
218
|
+
expect( result.types_h ).to include( 'struct al { char c; } ALIGNED(8);' )
|
|
219
|
+
link_holding( result, '_Alignof( struct al ) == 8' )
|
|
220
|
+
end
|
|
221
|
+
|
|
222
|
+
it 'keeps the macro with a type a storage class declares alone' do
|
|
223
|
+
link_holding( ended_types( "static struct pk { char c; int i; } PACKED;\n", mode: mode ), 'sizeof( struct pk ) == 5' )
|
|
224
|
+
end
|
|
225
|
+
|
|
226
|
+
# The types header reaches the macro through the module header's own includes
|
|
227
|
+
it 'keeps a macro another header defines with its type' do
|
|
228
|
+
toolchain = "#ifndef TOOLCHAIN_H\n#define TOOLCHAIN_H\n#define TIGHT __attribute__((packed))\n#endif\n"
|
|
229
|
+
result = ended_types( "struct pk { char c; int i; } TIGHT;\n", mode: mode, extra: { 'toolchain.h' => toolchain }, includes: ['toolchain.h'] )
|
|
230
|
+
|
|
231
|
+
link_holding( result, 'sizeof( struct pk ) == 5' )
|
|
232
|
+
end
|
|
233
|
+
|
|
234
|
+
# A macro that names a real variable leaves a variable behind in the expansion too, and a
|
|
235
|
+
# forward declaration of its tag defines nothing that says otherwise
|
|
236
|
+
it 'keeps a variable a macro names after a type it defines' do
|
|
237
|
+
header = "#ifndef ENGINE_H\n#define ENGINE_H\n#define MY_VAR g_var\nint engine_get(void);\n#endif\n"
|
|
238
|
+
result = engine( "#include \"engine.h\"\nstruct pt;\nstruct pt { int a; } MY_VAR;\nint engine_get(void) { return MY_VAR.a; }\n", mode: mode, header: header )
|
|
239
|
+
|
|
240
|
+
expect( result.types_h ).not_to include( '} MY_VAR;' )
|
|
241
|
+
link = link_partial( result, references: ['MY_VAR', 'engine_get'], flags: '-Wall -Werror -fno-common' )
|
|
242
|
+
expect( link.ok ).to be( true ), "expected a clean link, got: #{link.first_diagnostic}"
|
|
243
|
+
end
|
|
244
|
+
end
|
|
245
|
+
end
|
|
246
|
+
|
|
247
|
+
context 'with accurate preprocessing' do
|
|
248
|
+
before { skip 'directives-only preprocessing is unavailable' unless directives_only_supported? }
|
|
249
|
+
|
|
250
|
+
it 'links a selected function from a source with CRLF line endings' do
|
|
251
|
+
source = "#include \"engine.h\"\r\nPRIVATE int helper(void)\r\n{\r\n return 41;\r\n}\r\nint engine_get(void) { return helper() + 1; }\r\n"
|
|
252
|
+
link_cleanly( engine( source, mode: :accurate ), references: ['helper', 'engine_get'] )
|
|
253
|
+
end
|
|
254
|
+
|
|
255
|
+
# The mock takes the private function's place, and the tested public one calls it
|
|
256
|
+
it 'compiles a public function under test that calls its private neighbor through the mock' do
|
|
257
|
+
result = engine(
|
|
258
|
+
"#include \"engine.h\"\nPRIVATE int helper(void) { return 41; }\nint engine_get(void) { return helper() + 1; }\n",
|
|
259
|
+
mode: :accurate, tests_expose: PartializerConfig::PUBLIC, mocks_expose: PartializerConfig::PRIVATE
|
|
260
|
+
)
|
|
261
|
+
|
|
262
|
+
expect( result.interface_h ).to include( 'int helper(void);' )
|
|
263
|
+
compile = compile_objects( result, flags: '-Wall -Werror' )
|
|
264
|
+
expect( compile.ok ).to be( true ), "expected a clean compile, got: #{compile.first_diagnostic}"
|
|
265
|
+
end
|
|
266
|
+
end
|
|
267
|
+
end
|