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
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
|
|
18
18
|
|
|
19
19
|
<link rel="icon" href="../../../assets/images/favicon.png">
|
|
20
|
-
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.
|
|
20
|
+
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
|
|
21
21
|
|
|
22
22
|
|
|
23
23
|
|
|
@@ -4535,7 +4535,7 @@ characters (colons, brackets, spaces) from shell interpretation:</p>
|
|
|
4535
4535
|
<script id="__config" type="application/json">{"annotate": null, "base": "../../..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
|
|
4536
4536
|
|
|
4537
4537
|
|
|
4538
|
-
<script src="../../../assets/javascripts/bundle.
|
|
4538
|
+
<script src="../../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
|
4539
4539
|
|
|
4540
4540
|
|
|
4541
4541
|
</body>
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
|
|
18
18
|
|
|
19
19
|
<link rel="icon" href="../../../assets/images/favicon.png">
|
|
20
|
-
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.
|
|
20
|
+
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
|
|
21
21
|
|
|
22
22
|
|
|
23
23
|
|
|
@@ -4659,7 +4659,7 @@ registers the helper with CMock:</p>
|
|
|
4659
4659
|
<script id="__config" type="application/json">{"annotate": null, "base": "../../..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
|
|
4660
4660
|
|
|
4661
4661
|
|
|
4662
|
-
<script src="../../../assets/javascripts/bundle.
|
|
4662
|
+
<script src="../../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
|
4663
4663
|
|
|
4664
4664
|
|
|
4665
4665
|
</body>
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
|
|
18
18
|
|
|
19
19
|
<link rel="icon" href="../../../assets/images/favicon.png">
|
|
20
|
-
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.
|
|
20
|
+
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
|
|
21
21
|
|
|
22
22
|
|
|
23
23
|
|
|
@@ -4200,6 +4200,17 @@
|
|
|
4200
4200
|
</span>
|
|
4201
4201
|
</a>
|
|
4202
4202
|
|
|
4203
|
+
</li>
|
|
4204
|
+
|
|
4205
|
+
<li class="md-nav__item">
|
|
4206
|
+
<a href="#what-a-partial-carries" class="md-nav__link">
|
|
4207
|
+
<span class="md-ellipsis">
|
|
4208
|
+
|
|
4209
|
+
What a Partial Carries
|
|
4210
|
+
|
|
4211
|
+
</span>
|
|
4212
|
+
</a>
|
|
4213
|
+
|
|
4203
4214
|
</li>
|
|
4204
4215
|
|
|
4205
4216
|
<li class="md-nav__item">
|
|
@@ -4280,6 +4291,8 @@ Ceedling's Partials feature alongside traditional mock-based testing.</p>
|
|
|
4280
4291
|
and <code>static</code> variables that are normally inaccessible to the linker</li>
|
|
4281
4292
|
<li><strong>Every major Partials pattern</strong> across a range of sensor and system modules</li>
|
|
4282
4293
|
<li><strong>Partials and mocks used together</strong> in the same test suite</li>
|
|
4294
|
+
<li><strong>Carrying</strong> β a Partial bringing along the helpers, prototypes, and
|
|
4295
|
+
variables its selected functions rely on</li>
|
|
4283
4296
|
</ul>
|
|
4284
4297
|
<p>This project is test-suite only (no release build).</p>
|
|
4285
4298
|
<hr />
|
|
@@ -4298,19 +4311,24 @@ Ceedling's Partials feature alongside traditional mock-based testing.</p>
|
|
|
4298
4311
|
<a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>β βββ ForestMonitor.c/.h
|
|
4299
4312
|
<a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>β βββ SensorHal.c/.h
|
|
4300
4313
|
<a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a>β βββ UartDriver.c/.h
|
|
4301
|
-
<a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a>β βββ
|
|
4302
|
-
<a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>β βββ
|
|
4303
|
-
<a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>β
|
|
4304
|
-
<a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a
|
|
4305
|
-
<a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a
|
|
4306
|
-
<a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a
|
|
4307
|
-
<a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a
|
|
4308
|
-
<a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a> βββ
|
|
4309
|
-
<a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a> βββ
|
|
4310
|
-
<a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a> βββ
|
|
4311
|
-
<a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a> βββ
|
|
4312
|
-
<a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a> βββ
|
|
4313
|
-
<a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a>
|
|
4314
|
+
<a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a>β βββ RainGauge.c/.h
|
|
4315
|
+
<a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>β βββ RainTipIsr.c/.h # Defines the tip counter RainGauge.h declares extern
|
|
4316
|
+
<a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>β βββ ForestUnits.h # C99 inline functions, no source file of its own
|
|
4317
|
+
<a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a>β βββ sensors/soil/Calibration.c/.h # Same module name as the one below
|
|
4318
|
+
<a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a>β βββ sensors/light/Calibration.c/.h # Told apart by directory
|
|
4319
|
+
<a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a>β βββ Types.h
|
|
4320
|
+
<a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a>βββ test/ # Test files β Using Partials and traditional assertions/mocks
|
|
4321
|
+
<a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a> βββ TestTemperatureSensor.c
|
|
4322
|
+
<a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a> βββ TestHumiditySensor.c
|
|
4323
|
+
<a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a> βββ TestLightSensor.c
|
|
4324
|
+
<a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a> βββ TestSoilMoisture.c
|
|
4325
|
+
<a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a> βββ TestAlertManager.c
|
|
4326
|
+
<a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a> βββ TestEventQueue.c
|
|
4327
|
+
<a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a> βββ TestForestMonitor.c
|
|
4328
|
+
<a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a> βββ TestSensorHal.c
|
|
4329
|
+
<a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a> βββ TestUartDriver.c
|
|
4330
|
+
<a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a> βββ TestRainGauge.c
|
|
4331
|
+
<a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a> βββ TestCalibration.c
|
|
4314
4332
|
</code></pre></div>
|
|
4315
4333
|
<hr />
|
|
4316
4334
|
<h2 id="partials-patterns-used">Partials Patterns Used</h2>
|
|
@@ -4362,8 +4380,47 @@ Ceedling's Partials feature alongside traditional mock-based testing.</p>
|
|
|
4362
4380
|
<td>TestCalibration.c</td>
|
|
4363
4381
|
<td><code>TEST_PARTIAL_PRIVATE_MODULE_AT</code> β two same-named modules</td>
|
|
4364
4382
|
</tr>
|
|
4383
|
+
<tr>
|
|
4384
|
+
<td>TestRainGauge.c</td>
|
|
4385
|
+
<td><code>TEST_PARTIAL_PUBLIC_MODULE</code> + a subtracted, stubbed function</td>
|
|
4386
|
+
</tr>
|
|
4387
|
+
</tbody>
|
|
4388
|
+
</table>
|
|
4389
|
+
<hr />
|
|
4390
|
+
<h2 id="what-a-partial-carries">What a Partial Carries</h2>
|
|
4391
|
+
<p>A Partial brings along what its selected functions rely on. <code>TestRainGauge.c</code>
|
|
4392
|
+
selects RainGauge's public functions and subtracts one of them. Those
|
|
4393
|
+
functions rely on code the test does not select, so the Partial carries it.
|
|
4394
|
+
Run the test with <code>--verbosity=debug</code> to see each carried item and why.</p>
|
|
4395
|
+
<table>
|
|
4396
|
+
<thead>
|
|
4397
|
+
<tr>
|
|
4398
|
+
<th>Carried item</th>
|
|
4399
|
+
<th>Why the Partial needs it</th>
|
|
4400
|
+
</tr>
|
|
4401
|
+
</thead>
|
|
4402
|
+
<tbody>
|
|
4403
|
+
<tr>
|
|
4404
|
+
<td><code>RainGauge_TipsToMicrometers()</code></td>
|
|
4405
|
+
<td><code>RainGauge.h</code> defines this <code>static inline</code> helper, and <code>RainGauge_Update()</code> calls it</td>
|
|
4406
|
+
</tr>
|
|
4407
|
+
<tr>
|
|
4408
|
+
<td><code>extern inline</code> prototype of <code>ForestUnits_MicrometersToTenthsMm()</code></td>
|
|
4409
|
+
<td><code>ForestUnits.h</code> defines the function C99 <code>inline</code>. The prototype makes the Partial hold its external definition</td>
|
|
4410
|
+
</tr>
|
|
4411
|
+
<tr>
|
|
4412
|
+
<td>Prototype of <code>RainGauge_ReportStorm()</code></td>
|
|
4413
|
+
<td>The test subtracts this function and defines a stub. <code>RainGauge_Update()</code> calls the stub</td>
|
|
4414
|
+
</tr>
|
|
4415
|
+
<tr>
|
|
4416
|
+
<td>Weak definition of <code>g_rain_tip_count</code></td>
|
|
4417
|
+
<td><code>RainGauge.h</code> declares the counter <code>extern</code>. Its real definition in <code>RainTipIsr.c</code>, which the test links, takes precedence</td>
|
|
4418
|
+
</tr>
|
|
4365
4419
|
</tbody>
|
|
4366
4420
|
</table>
|
|
4421
|
+
<p>Each carried item keeps its original spelling. A <code>#line</code> directive ahead of
|
|
4422
|
+
each points back to its original file and line. Coverage of the carried
|
|
4423
|
+
helper therefore counts toward <code>RainGauge.h</code>.</p>
|
|
4367
4424
|
<hr />
|
|
4368
4425
|
<h2 id="running-the-tests">Running the Tests</h2>
|
|
4369
4426
|
<p>Run all tests:</p>
|
|
@@ -4449,7 +4506,7 @@ Ceedling's Partials feature alongside traditional mock-based testing.</p>
|
|
|
4449
4506
|
<script id="__config" type="application/json">{"annotate": null, "base": "../../..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
|
|
4450
4507
|
|
|
4451
4508
|
|
|
4452
|
-
<script src="../../../assets/javascripts/bundle.
|
|
4509
|
+
<script src="../../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
|
4453
4510
|
|
|
4454
4511
|
|
|
4455
4512
|
</body>
|
|
@@ -51,7 +51,7 @@ DEFAULT_BULLSEYE_LINKER_TOOL = {
|
|
|
51
51
|
}
|
|
52
52
|
|
|
53
53
|
DEFAULT_BULLSEYE_FIXTURE_TOOL = {
|
|
54
|
-
:executable => '${1}'.freeze,
|
|
54
|
+
:executable => '"${1}"'.freeze, # Test executable, quoted as a path
|
|
55
55
|
:name => 'default_bullseye_fixture'.freeze,
|
|
56
56
|
:optional => false.freeze,
|
|
57
57
|
:arguments => [].freeze
|
|
@@ -41,7 +41,7 @@ DEFAULT_GCOV_LINKER_TOOL = {
|
|
|
41
41
|
}
|
|
42
42
|
|
|
43
43
|
DEFAULT_GCOV_FIXTURE_TOOL = {
|
|
44
|
-
:executable => '${1}'.freeze,
|
|
44
|
+
:executable => '"${1}"'.freeze, # Test executable, quoted as a path
|
|
45
45
|
:name => 'default_gcov_fixture'.freeze,
|
|
46
46
|
:optional => false.freeze,
|
|
47
47
|
:arguments => [].freeze
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
|
|
22
22
|
|
|
23
23
|
<link rel="icon" href="../assets/images/favicon.png">
|
|
24
|
-
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.
|
|
24
|
+
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
|
|
25
25
|
|
|
26
26
|
|
|
27
27
|
|
|
@@ -4800,7 +4800,7 @@ per line within your test file.</p>
|
|
|
4800
4800
|
<script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
|
|
4801
4801
|
|
|
4802
4802
|
|
|
4803
|
-
<script src="../assets/javascripts/bundle.
|
|
4803
|
+
<script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
|
4804
4804
|
|
|
4805
4805
|
|
|
4806
4806
|
</body>
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
|
|
22
22
|
|
|
23
23
|
<link rel="icon" href="../assets/images/favicon.png">
|
|
24
|
-
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.
|
|
24
|
+
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
|
|
25
25
|
|
|
26
26
|
|
|
27
27
|
|
|
@@ -1334,6 +1334,17 @@
|
|
|
1334
1334
|
</span>
|
|
1335
1335
|
</a>
|
|
1336
1336
|
|
|
1337
|
+
</li>
|
|
1338
|
+
|
|
1339
|
+
<li class="md-nav__item">
|
|
1340
|
+
<a href="#test-names-build-output" class="md-nav__link">
|
|
1341
|
+
<span class="md-ellipsis">
|
|
1342
|
+
|
|
1343
|
+
Test names & build output
|
|
1344
|
+
|
|
1345
|
+
</span>
|
|
1346
|
+
</a>
|
|
1347
|
+
|
|
1337
1348
|
</li>
|
|
1338
1349
|
|
|
1339
1350
|
<li class="md-nav__item">
|
|
@@ -4705,6 +4716,17 @@
|
|
|
4705
4716
|
</span>
|
|
4706
4717
|
</a>
|
|
4707
4718
|
|
|
4719
|
+
</li>
|
|
4720
|
+
|
|
4721
|
+
<li class="md-nav__item">
|
|
4722
|
+
<a href="#test-names-build-output" class="md-nav__link">
|
|
4723
|
+
<span class="md-ellipsis">
|
|
4724
|
+
|
|
4725
|
+
Test names & build output
|
|
4726
|
+
|
|
4727
|
+
</span>
|
|
4728
|
+
</a>
|
|
4729
|
+
|
|
4708
4730
|
</li>
|
|
4709
4731
|
|
|
4710
4732
|
<li class="md-nav__item">
|
|
@@ -5043,30 +5065,44 @@ Any directory structure will do. Tests can be held in subdirectories
|
|
|
5043
5065
|
within source directories, or tests and source directories
|
|
5044
5066
|
can be wholly separated at the top of your projectβs directory
|
|
5045
5067
|
tree.</p>
|
|
5068
|
+
<div class="admonition warning">
|
|
5069
|
+
<p class="admonition-title">Windows path lengths</p>
|
|
5070
|
+
<p>Ceedling mirrors your source paths in its build paths. In some cases build
|
|
5071
|
+
paths can exceed Windowsβ classic 260-character limit. Without special
|
|
5072
|
+
handling, a path that long can cause build failure with mysterious βNo
|
|
5073
|
+
such file or directoryβ or other errors rather than a clear length error.
|
|
5074
|
+
Ceedling intervenes by reporting each build path that nears or passes the
|
|
5075
|
+
limit to aid troublehsooting.</p>
|
|
5076
|
+
<p>If your Windows host has long paths enabled or you can enable it, see
|
|
5077
|
+
<a href="../configuration/reference/project.html#win_path_limit"><code>:project</code> β³ <code>:win_path_limit</code></a>
|
|
5078
|
+
for more options.</p>
|
|
5079
|
+
</div>
|
|
5046
5080
|
<h2 id="distinguishing-same-named-files">Distinguishing same-named files</h2>
|
|
5047
5081
|
<h3 id="header-source-files">Header / source files</h3>
|
|
5048
5082
|
<p>Ceedling distinguishes files by their full relative path, not just their
|
|
5049
5083
|
filename. A project may have, for example, both <code>src/drivers/uart.c</code> and
|
|
5050
5084
|
<code>src/sensors/uart.c</code> without one hiding or colliding with the other.</p>
|
|
5051
|
-
<p>Distinguishing files is mostly an issue in test builds.
|
|
5052
|
-
|
|
5053
|
-
|
|
5054
|
-
|
|
5055
|
-
|
|
5056
|
-
<code>:paths</code>
|
|
5057
|
-
<a href="build-directives.html#test_include_path"><code>TEST_INCLUDE_PATH()</code></a>
|
|
5058
|
-
a test file. When
|
|
5059
|
-
|
|
5060
|
-
|
|
5085
|
+
<p>Distinguishing files is mostly an issue in test builds. Ceedling finds a
|
|
5086
|
+
header named by an <code>#include</code> the way your compiler does. It joins each of the
|
|
5087
|
+
testβs search paths, in order, with the path the <code>#include</code> names, and the
|
|
5088
|
+
first file that exists wins. A search path therefore reaches headers in the
|
|
5089
|
+
directories below it, as in <code>#include "drivers/uart.h"</code> with <code>src/</code> as a search
|
|
5090
|
+
path. Search paths are ordered per your project configuration (<code>:paths</code>) plus
|
|
5091
|
+
any use of <a href="build-directives.html#test_include_path"><code>TEST_INCLUDE_PATH()</code></a>
|
|
5092
|
+
directives in a test file. When more than one search path holds the header,
|
|
5093
|
+
Ceedling uses the first but logs an informational notice naming the others, so
|
|
5094
|
+
the choice is not silent.</p>
|
|
5095
|
+
<p>A source file a test needs resolves by its trailing path against the file
|
|
5096
|
+
collection, which is ordered by the same <code>:paths</code> configuration.</p>
|
|
5061
5097
|
<p>If Ceedling uses the wrong match for lack of path information, your test build
|
|
5062
5098
|
fails downstream with an ordinary compilation error indirectly revealing the
|
|
5063
5099
|
issue. Add enough path at the point of reference to select the file you actually
|
|
5064
5100
|
meant.</p>
|
|
5065
5101
|
<ul>
|
|
5066
5102
|
<li>Use paths in <code>#include</code> directives in your test files to distinguish header
|
|
5067
|
-
files of the same name
|
|
5068
|
-
|
|
5069
|
-
and/or <code>#include "foo/bar/mock_file.h"</code>.</li>
|
|
5103
|
+
files of the same name. A mock is distinguished by the same path as the
|
|
5104
|
+
header it is generated from, below one of your search paths. Examples:
|
|
5105
|
+
<code>#include "foo/bar/file.h"</code> and/or <code>#include "foo/bar/mock_file.h"</code>.</li>
|
|
5070
5106
|
<li>Use the <a href="build-directives.html"><code>TEST_SOURCE_FILE()</code> build directive macro</a>
|
|
5071
5107
|
to provide a path to distinguish source files of the same name to be
|
|
5072
5108
|
compiled and linked with a test executable.</li>
|
|
@@ -5119,6 +5155,14 @@ and function declarations.</p>
|
|
|
5119
5155
|
<li>The <a href="build-directives.html#test_include_path"><code>TEST_INCLUDE_PATH(...)</code></a> build directive
|
|
5120
5156
|
macro. This is only available within test files.</li>
|
|
5121
5157
|
</ol>
|
|
5158
|
+
<p>A header whose own directory no search path lists needs no search path of its
|
|
5159
|
+
own, as is usual for one that
|
|
5160
|
+
<a href="../configuration/reference/files.html#files-include"><code>:files</code> β³ <code>:include</code></a> adds.
|
|
5161
|
+
When a testβs <code>#include</code> names such a header, Ceedling adds the directory that
|
|
5162
|
+
<code>#include</code> implies to the testβs search paths. A bare name for a header outside
|
|
5163
|
+
the working directory is the exception, as
|
|
5164
|
+
<a href="../configuration/reference/files.html#files-include"><code>:files</code> β³ <code>:include</code></a>
|
|
5165
|
+
explains.</p>
|
|
5122
5166
|
<p>In testing contexts, you have three options for assembling the core of
|
|
5123
5167
|
the search path list used by Ceedling for test builds:</p>
|
|
5124
5168
|
<ol>
|
|
@@ -5146,6 +5190,8 @@ it is assembled from a variety of sources. In order:</p>
|
|
|
5146
5190
|
<li>Internal paths for CMockβs C code (if respective feature enabled)</li>
|
|
5147
5191
|
<li><code>:paths</code> β³ <code>:test_toolchain_include</code> list from your project
|
|
5148
5192
|
configuration</li>
|
|
5193
|
+
<li>Directories the testβs <code>#include</code>s imply for headers whose own directories
|
|
5194
|
+
no search path lists, such as headers <code>:files</code> β³ <code>:include</code> adds</li>
|
|
5149
5195
|
</ol>
|
|
5150
5196
|
<p>The paths lists above are documented in detail in the discussion of
|
|
5151
5197
|
project configuration.</p>
|
|
@@ -5240,6 +5286,58 @@ of its own. Whether yours does depends on your toolchain.</p>
|
|
|
5240
5286
|
<p>Before 1.2.0, Ceedling wrote no manifest. With a toolchain that embeds none,
|
|
5241
5287
|
test files with these words in their names could not be run on Windows without
|
|
5242
5288
|
administrator privileges.</p>
|
|
5289
|
+
<h3 id="test-names-build-output">Test names & build output</h3>
|
|
5290
|
+
<p>Ceedling names each test by its path from your projectβs root, without its
|
|
5291
|
+
file extension. <code>test/unit/test_calc.c</code> is named <code>test/unit/test_calc</code>. Every
|
|
5292
|
+
test gets its own build output, even when test files share a filename.</p>
|
|
5293
|
+
<p>A testβs name is its path, so one testβs build directory could lie inside anotherβs.
|
|
5294
|
+
<code>test/test_calc.c</code> and <code>test/test_calc/test_io.c</code> would build into
|
|
5295
|
+
<code>build/test/out/test/test_calc/</code> and a folder within it, and the two testsβ objects
|
|
5296
|
+
and mocks would mix. Each build directory that holds files of every test, such as
|
|
5297
|
+
<code>build/test/out/</code> or <code>build/test/mocks/</code>, therefore gives each test a directory of
|
|
5298
|
+
its own: the testβs name followed by <code>_t_</code>. The marker closes every testβs name, so
|
|
5299
|
+
no testβs directory can hold anotherβs. Ceedling renames a folder of your own called
|
|
5300
|
+
<code>_t_</code> in these paths, as the last paragraph below explains, so the marker always ends
|
|
5301
|
+
a name. <code>test/test_calc</code> builds to <code>build/test/out/test/test_calc/_t_/</code>.</p>
|
|
5302
|
+
<p>The name places a testβs output beneath each build directory:</p>
|
|
5303
|
+
<ul>
|
|
5304
|
+
<li>Executable: <code>build/test/out/test/unit/test_calc/_t_/</code></li>
|
|
5305
|
+
<li>Mocks: <code>build/test/mocks/test/unit/test_calc/_t_/</code></li>
|
|
5306
|
+
<li>Results: <code>build/test/results/test/unit/test_calc.pass</code></li>
|
|
5307
|
+
<li>Logs from plugins and backtraces, such as
|
|
5308
|
+
<code>build/artifacts/valgrind/test/unit/test_calc.log</code> or
|
|
5309
|
+
<code>build/logs/test/test/unit/test_calc/<test case>.gdb.log</code></li>
|
|
5310
|
+
</ul>
|
|
5311
|
+
<p>Within a testβs directory, each object sits at its sourceβs own path from your
|
|
5312
|
+
projectβs root, so same-named sources never share a path. <code>src/drivers/uart.c</code>
|
|
5313
|
+
compiles to <code>build/test/out/test/unit/test_calc/_t_/src/drivers/uart.o</code>. Preprocessed
|
|
5314
|
+
files and dependency files follow the same layout, and a release build places its
|
|
5315
|
+
objects the same way below <code>build/release/out/</code>. Mocks sit below their testβs own
|
|
5316
|
+
mock directory, and runners and Unity, CMock, and CException objects sit directly in
|
|
5317
|
+
the testβs directory.</p>
|
|
5318
|
+
<p>A long <code>:paths</code> root gives way to a short name in build paths. A root far outside
|
|
5319
|
+
your project, such as a vendorβs include directory, or one nested deep inside it,
|
|
5320
|
+
is written as its own directory name and 8 hexadecimal digits, and everything below
|
|
5321
|
+
the root keeps its path. With <code>../../../Keil_v5/ARM/CMSIS/Include</code> among your
|
|
5322
|
+
<code>:paths</code>, a preprocessed copy of <code>Include/cmsis_os2.h</code> lands at
|
|
5323
|
+
<code>build/test/preprocess/files/<test>/_t_/directives_only/raw/_Include_3F2A91C0/cmsis_os2.h</code>.
|
|
5324
|
+
A root is shortened only when its short name is shorter than its own path, so roots
|
|
5325
|
+
such as <code>src/</code> and <code>test/</code> are unchanged. <code>build/build_roots.yml</code> lists each shortened
|
|
5326
|
+
root and its short name, and <code>--verbosity=debug</code> logs them. Test names never change.</p>
|
|
5327
|
+
<p>A test or source outside your project, and outside every shortened root, keeps its
|
|
5328
|
+
whole path. Each <code>..</code> becomes <code>_up_</code>, so <code>../shared/test/test_io.c</code> is named
|
|
5329
|
+
<code>_up_/shared/test/test_io</code>. A path
|
|
5330
|
+
with no relative form, such as one on another Windows drive, sits beneath <code>_abs_</code>,
|
|
5331
|
+
and a file of the running Ceedling installation outside your project, such as a
|
|
5332
|
+
pluginβs source, beneath <code>_ceedling_</code>. None of these reaches outside the build
|
|
5333
|
+
directory. A directory of your project that is itself named like one of these, or like a
|
|
5334
|
+
shortened root, gains a leading <code>_</code> (e.g. <code>__up_/</code>), so it never shares a name with
|
|
5335
|
+
a path outside your project. In a test build, a directory named <code>_t_</code> gains one too,
|
|
5336
|
+
so it never ends a testβs name. A release build places it as it is.</p>
|
|
5337
|
+
<p>Two tests share a name only if their paths differ in extension alone (e.g.
|
|
5338
|
+
<code>test_a.c</code> and <code>test_a.cpp</code>). A build that includes either test stops with an
|
|
5339
|
+
error naming both files. Two sources that would build to one file stop a build the
|
|
5340
|
+
same way.</p>
|
|
5243
5341
|
<h3 id="source-mock-files-to-compile-and-link">Source & mock files to compile and link</h3>
|
|
5244
5342
|
<p>Ceedling knows what files to compile and link into each individual
|
|
5245
5343
|
test executable by way of the <code>#include</code> list contained in each
|
|
@@ -5767,7 +5865,7 @@ much simpler exit code convention than Unity: <code>0</code> = π while <code>
|
|
|
5767
5865
|
<script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
|
|
5768
5866
|
|
|
5769
5867
|
|
|
5770
|
-
<script src="../assets/javascripts/bundle.
|
|
5868
|
+
<script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
|
5771
5869
|
|
|
5772
5870
|
|
|
5773
5871
|
</body>
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
|
|
22
22
|
|
|
23
23
|
<link rel="icon" href="../assets/images/favicon.png">
|
|
24
|
-
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.
|
|
24
|
+
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
|
|
25
25
|
|
|
26
26
|
|
|
27
27
|
|
|
@@ -4731,7 +4731,7 @@ if you wish to use it in your project.</p>
|
|
|
4731
4731
|
<script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
|
|
4732
4732
|
|
|
4733
4733
|
|
|
4734
|
-
<script src="../assets/javascripts/bundle.
|
|
4734
|
+
<script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
|
4735
4735
|
|
|
4736
4736
|
|
|
4737
4737
|
</body>
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
|
|
22
22
|
|
|
23
23
|
<link rel="icon" href="../assets/images/favicon.png">
|
|
24
|
-
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.
|
|
24
|
+
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
|
|
25
25
|
|
|
26
26
|
|
|
27
27
|
|
|
@@ -4410,7 +4410,7 @@ quite enough β adding source files, handling include paths, and more.</p>
|
|
|
4410
4410
|
<script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
|
|
4411
4411
|
|
|
4412
4412
|
|
|
4413
|
-
<script src="../assets/javascripts/bundle.
|
|
4413
|
+
<script src="../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
|
4414
4414
|
|
|
4415
4415
|
|
|
4416
4416
|
</body>
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
|
|
22
22
|
|
|
23
23
|
<link rel="icon" href="../../assets/images/favicon.png">
|
|
24
|
-
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.
|
|
24
|
+
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.2">
|
|
25
25
|
|
|
26
26
|
|
|
27
27
|
|
|
@@ -1463,6 +1463,17 @@
|
|
|
1463
1463
|
</span>
|
|
1464
1464
|
</a>
|
|
1465
1465
|
|
|
1466
|
+
</li>
|
|
1467
|
+
|
|
1468
|
+
<li class="md-nav__item">
|
|
1469
|
+
<a href="#variable-type-names" class="md-nav__link">
|
|
1470
|
+
<span class="md-ellipsis">
|
|
1471
|
+
|
|
1472
|
+
Variable type names
|
|
1473
|
+
|
|
1474
|
+
</span>
|
|
1475
|
+
</a>
|
|
1476
|
+
|
|
1466
1477
|
</li>
|
|
1467
1478
|
|
|
1468
1479
|
</ul>
|
|
@@ -4380,6 +4391,17 @@
|
|
|
4380
4391
|
</span>
|
|
4381
4392
|
</a>
|
|
4382
4393
|
|
|
4394
|
+
</li>
|
|
4395
|
+
|
|
4396
|
+
<li class="md-nav__item">
|
|
4397
|
+
<a href="#variable-type-names" class="md-nav__link">
|
|
4398
|
+
<span class="md-ellipsis">
|
|
4399
|
+
|
|
4400
|
+
Variable type names
|
|
4401
|
+
|
|
4402
|
+
</span>
|
|
4403
|
+
</a>
|
|
4404
|
+
|
|
4383
4405
|
</li>
|
|
4384
4406
|
|
|
4385
4407
|
</ul>
|
|
@@ -4497,8 +4519,9 @@ directive macros:</p>
|
|
|
4497
4519
|
<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="cp">#include</span><span class="w"> </span><span class="cpf">"unity.h"</span>
|
|
4498
4520
|
<a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="cp">#include</span><span class="w"> </span><span class="cpf">"ceedling.h"</span><span class="w"> </span><span class="c1">// Required -- defines all Partial directive macros</span>
|
|
4499
4521
|
</code></pre></div>
|
|
4500
|
-
<p><code>ceedling.h</code> defines the <code>TEST_PARTIAL_*</code>, <code>MOCK_PARTIAL_*</code>, <code>*_CONFIG</code>,
|
|
4501
|
-
<code>PARTIAL_LOCAL_VAR()</code>
|
|
4522
|
+
<p><code>ceedling.h</code> defines the <code>TEST_PARTIAL_*</code>, <code>MOCK_PARTIAL_*</code>, <code>*_CONFIG</code>,
|
|
4523
|
+
<code>PARTIAL_LOCAL_VAR()</code>, <code>PARTIAL_TYPE()</code> and <code>PARTIAL_LOCAL_TYPE()</code> macros.
|
|
4524
|
+
Without this include, the macros are undefined.</p>
|
|
4502
4525
|
<h2 id="partials-macro-categories">Partials macro categories</h2>
|
|
4503
4526
|
<p>See the <a href="../../reference/partials-macros.html">Partials Macros Reference</a> for the complete listing.</p>
|
|
4504
4527
|
<h3 id="module-selection"><a href="../../reference/partials-macros.html#module-selection-macros">Module selection</a></h3>
|
|
@@ -4519,6 +4542,10 @@ and can be accessed directly in your test cases.</p>
|
|
|
4519
4542
|
<p><code>PARTIAL_LOCAL_VAR(function_name, variable_name)</code></p>
|
|
4520
4543
|
<p>Accesses a function-scoped <code>static</code> variable that Ceedling has promoted to
|
|
4521
4544
|
module scope in a generated Partial.</p>
|
|
4545
|
+
<h3 id="variable-type-names"><a href="../../reference/partials-macros.html#variable-type-names">Variable type names</a></h3>
|
|
4546
|
+
<p><code>PARTIAL_TYPE(module, variable)</code> / <code>PARTIAL_LOCAL_TYPE(module, function, variable)</code></p>
|
|
4547
|
+
<p>Name the type a Partial gives a variable declared together with its type, as in
|
|
4548
|
+
<code>static struct { int count; } s_ctx;</code>.</p>
|
|
4522
4549
|
<p><br/><br/></p>
|
|
4523
4550
|
|
|
4524
4551
|
|
|
@@ -4590,7 +4617,7 @@ module scope in a generated Partial.</p>
|
|
|
4590
4617
|
<script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.tabs", "navigation.sections", "navigation.top", "navigation.indexes", "navigation.path", "search.suggest", "search.highlight", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
|
|
4591
4618
|
|
|
4592
4619
|
|
|
4593
|
-
<script src="../../assets/javascripts/bundle.
|
|
4620
|
+
<script src="../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
|
4594
4621
|
|
|
4595
4622
|
|
|
4596
4623
|
</body>
|