ceedling 1.1.10 → 1.2.1

data/mkdocs.prerelease.yml

@@ -0,0 +1,42 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+# mkdocs uses a simple overwrite merge -- must rewrite entire sections to make small changes.
+INHERIT: mkdocs.yml
+
+# Material theme configuration
+theme:
+  name: material
+  favicon: assets/images/favicon.png
+  custom_dir: docs/overrides  # Project template overrides (outdated-version/prerelease banners)
+  palette:
+    - scheme: default
+      primary: green
+      accent: deep_purple
+  features:
+    - navigation.tabs        # Top-level nav rendered as tabs
+    - navigation.sections    # Sections rendered as groups in left sidebar
+    - navigation.top         # Back-to-top button
+    - navigation.indexes     # Section index pages (first item in section = section landing page)
+    - navigation.path        # Breadcrumb trail below page title
+    - navigation.instant     # Instant navigation with page content swaps (without page reloads)
+    - search.suggest         # Autocomplete suggestions in search
+    - search.highlight       # Highlight search terms on result pages
+    - content.code.copy      # Copy button on code blocks
+    - content.code.annotate  # Inline annotation support in code blocks
+
+# Extra site configuration
+extra:
+  generator: false  # Suppress "Made with Material for MkDocs" footer text
+  version:
+    provider: mike  # Versioned documentation deployment via mike
+    default: latest
+  prerelease: true  # Swaps the outdated-version banner for a prerelease notice (docs/overrides/main.html)
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/sponsors/ThrowTheSwitch
+      name: Sponsor ThrowTheSwitch on GitHub

data/mkdocs.yml

@@ -8,7 +8,7 @@
 # Site metadata
 site_name: Ceedling
 site_description: Test-Centered Build System for C
-site_url: https://throwtheswitch.github.io/Ceedling/
+site_url: https://docs.throwtheswitch.org/Ceedling/
 repo_url: https://github.com/ThrowTheSwitch/Ceedling
 repo_name: ThrowTheSwitch/Ceedling
 
@@ -26,6 +26,7 @@ copyright: >-
 theme:
   name: material
   favicon: assets/images/favicon.png
+  custom_dir: docs/overrides  # Project template overrides (outdated-version/prerelease banners)
   palette:
     - scheme: default
       primary: green
@@ -102,6 +103,7 @@ nav:
     - Quick Start: getting-started/quick-start.md
     - Installation: getting-started/installation.md
     - Command Line: getting-started/command-line.md
+    - Builds: getting-started/builds.md
     - Example Projects:
       - getting-started/example-projects/index.md
       - Temp Sensor: getting-started/example-projects/temp-sensor.md
@@ -173,7 +175,10 @@ nav:
       - Advanced & Troubleshooting: plugins/gcov/troubleshooting.md
     - Cppcheck (Static Analysis): plugins/cppcheck.md
     - Valgrind (Memory Analysis): plugins/valgrind.md
-    - Bullseye (Coverage): plugins/bullseye.md
+    - Sanitize (ASan, UBSan & Leaks): plugins/sanitize.md
+    - Bullseye (Coverage):
+      - plugins/bullseye/index.md
+      - Licensing: plugins/bullseye/licensing.md
     - FFF (Fake Functions): plugins/fff.md
     - Command Hooks: plugins/command-hooks.md
     - Compile Commands JSON DB: plugins/compile-commands-json-db.md
@@ -190,12 +195,15 @@ nav:
     - Coverage Reporting: reference/gcov-plugin.md
     - Global Collections: reference/global-collections.md
   - Releases:
+    - project/index.md
     - History Documents: project/release-history.md
+    - Software Bill of Materials: project/sbom.md
     - Upgrading: project/upgrade.md
   - Help: help.md
   - Development:
     - development/index.md
     - Development Workflow: development/workflow.md
+    - Branching & Releases: development/releases.md
     - Plugin Development:
       - development/plugins/index.md
       - Configuration Plugin: development/plugins/configuration.md

data/plugins/bullseye/bullseye.rake

@@ -12,112 +12,55 @@ directory(BULLSEYE_DEPENDENCIES_PATH)
 
 CLEAN.include(File.join(BULLSEYE_BUILD_OUTPUT_PATH, '*'))
 CLEAN.include(File.join(BULLSEYE_RESULTS_PATH, '*'))
+CLEAN.include(File.join(BULLSEYE_ARTIFACTS_PATH, '**/*'))
 CLEAN.include(File.join(BULLSEYE_DEPENDENCIES_PATH, '*'))
+CLEAN.include(BULLSEYE_COVFILE_PATH)
 
 CLOBBER.include(File.join(BULLSEYE_BUILD_PATH, '**/*'))
-PLUGINS_BULLSEYE_LIB_PATH = 'C:\\tools\\BullseyeCoverage\\lib' if not defined?(PLUGINS_BULLSEYE_LIB_PATH)
-
-rule(/#{BULLSEYE_BUILD_OUTPUT_PATH}\/#{'.+\\'+EXTENSION_OBJECT}$/ => [
-       proc do |task_name|
-         @ceedling[:file_finder].find_build_input_file(filepath: task_name, context: BULLSEYE_SYM)
-       end
-     ]) do |object|
-
-  if File.basename(object.source) =~ /^(#{PROJECT_TEST_FILE_PREFIX}|#{CMOCK_MOCK_PREFIX}|#{BULLSEYE_IGNORE_SOURCES.join('|')})/i
-    @ceedling[:generator].generate_object_file(
-      TOOLS_BULLSEYE_COMPILER,
-      OPERATION_COMPILE_SYM,
-      BULLSEYE_SYM,
-      object.source,
-      object.name,
-      @ceedling[:file_path_utils].form_test_build_list_filepath(object.name)
-    )
-  else
-    @ceedling[BULLSEYE_SYM].generate_coverage_object_file(object.source, object.name)
-  end
-
-end
-
-rule(/#{BULLSEYE_BUILD_OUTPUT_PATH}\/#{'.+\\'+EXTENSION_EXECUTABLE}$/) do |bin_file|
-  lib_args = @ceedling[:test_invoker].convert_libraries_to_arguments()
-  lib_paths = @ceedling[:test_invoker].get_library_paths_to_arguments()
-  @ceedling[:generator].generate_executable_file(
-    TOOLS_BULLSEYE_LINKER,
-    BULLSEYE_SYM,
-    bin_file.prerequisites,
-    bin_file.name,
-    @ceedling[:file_path_utils].form_test_build_map_filepath(bin_file.name),
-    lib_args,
-    lib_paths
-  )
-end
-
-rule(/#{BULLSEYE_RESULTS_PATH}\/#{'.+\\'+EXTENSION_TESTPASS}$/ => [
-       proc do |task_name|
-         @ceedling[:file_path_utils].form_test_executable_filepath(task_name)
-       end
-     ]) do |test_result|
-  @ceedling[:generator].generate_test_results(TOOLS_BULLSEYE_FIXTURE, BULLSEYE_SYM, test_result.source, test_result.name)
-end
+CLOBBER.include(BULLSEYE_COVFILE_PATH)
 
-rule(/#{BULLSEYE_DEPENDENCIES_PATH}\/#{'.+\\'+EXTENSION_DEPENDENCIES}$/ => [
-       proc do |task_name|
-         @ceedling[:file_finder].find_build_input_file(filepath: task_name, context: BULLSEYE_SYM)
-       end
-     ]) do |dep|
-  @ceedling[:generator].generate_dependencies_file(
-    TOOLS_TEST_DEPENDENCIES_GENERATOR,
-    BULLSEYE_SYM,
-    dep.source,
-    File.join(BULLSEYE_BUILD_OUTPUT_PATH, File.basename(dep.source).ext(EXTENSION_OBJECT) ),
-    dep.name
-  )
-end
-
-task :directories => [BULLSEYE_BUILD_OUTPUT_PATH, BULLSEYE_RESULTS_PATH, BULLSEYE_DEPENDENCIES_PATH, BULLSEYE_ARTIFACTS_PATH]
+task directories: [BULLSEYE_BUILD_OUTPUT_PATH, BULLSEYE_RESULTS_PATH, BULLSEYE_DEPENDENCIES_PATH, BULLSEYE_ARTIFACTS_PATH]
 
+# No object compilation, linking, test execution, or dependency-file Rake rules are
+# defined here. Ceedling's core build pipeline already compiles and links every test
+# build for any context passed to `setup_and_invoke`; `Bullseye`'s `pre_compile_execute`/
+# `pre_link_execute` hooks (see `lib/bullseye.rb`) swap in Bullseye's own tools and
+# coverage defines for the `bullseye:` context as that pipeline runs.
 namespace BULLSEYE_SYM do
 
-  TOOL_COLLECTION_BULLSEYE_TASKS = {
-    :context        => BULLSEYE_SYM,
-    :test_compiler  => TOOLS_BULLSEYE_COMPILER,
-    :test_assembler => TOOLS_TEST_ASSEMBLER,
-    :test_linker    => TOOLS_BULLSEYE_LINKER,
-    :test_fixture   => TOOLS_BULLSEYE_FIXTURE
-  }
-
-  task source_coverage: COLLECTION_ALL_SOURCE.pathmap("#{BULLSEYE_BUILD_OUTPUT_PATH}/%n#{@ceedling[:configurator].extension_object}")
-
   desc 'Run code coverage for all tests'
   task all: [:prepare] do
-    @ceedling[:configurator].replace_flattened_config(@ceedling[BULLSEYE_SYM].config)
-    @ceedling[BULLSEYE_SYM].enableBullseye(true)
-    @ceedling[:test_invoker].setup_and_invoke(COLLECTION_ALL_TESTS, TOOL_COLLECTION_BULLSEYE_TASKS)
-    @ceedling[:configurator].restore_config
+    # Run tests with coverage
+    @ceedling[:test_invoker].setup_and_invoke( tests:COLLECTION_ALL_TESTS, context:BULLSEYE_SYM, options:TOOL_COLLECTION_BULLSEYE_TASKS )
+
+    # Optionally compile untested sources with coverage for complete source coverage results in the final report.
+    # This comes after the tests because it depends on the accrued knowledge of which source files have associated tests.
+    @ceedling[:bullseye].process_untested_sources( sources:COLLECTION_ALL_SOURCE )
   end
 
-  desc "Run single test w/ coverage ([*] real test or source file name, no path)."
+  desc 'Run single test w/ coverage ([*] test or source file name, with optional path).'
   task :* do
-    message = "\nOops! '#{BULLSEYE_ROOT_NAME}:*' isn't a real task. " +
-              "Use a real test or source file name (no path) in place of the wildcard.\n" +
-              "Example: rake #{BULLSEYE_ROOT_NAME}:foo.c\n\n"
+    message = "Oops! '#{BULLSEYE_ROOT_NAME}:*' isn't a real task. " \
+              "Use a real test or source file name in place of the wildcard, " \
+              "adding as much of its path as needed to identify one file among any same-named tests.\n" \
+              "Example: `ceedling #{BULLSEYE_ROOT_NAME}:foo.c` or `ceedling #{BULLSEYE_ROOT_NAME}:unit/foo.c`"
 
-    @ceedling[:loginator].log( message )
+    @ceedling[:loginator].log( message, Verbosity::ERRORS )
   end
 
   desc 'Run tests by matching regular expression pattern.'
   task :pattern, [:regex] => [:prepare] do |_t, args|
     matches = []
 
+    # Compile the user's pattern once rather than once per test in the collection
+    pattern = Regexp.new( args.regex )
+
     COLLECTION_ALL_TESTS.each do |test|
-      matches << test if test =~ /#{args.regex}/
+      matches << test if test.match?( pattern )
     end
 
     if !matches.empty?
-      @ceedling[:configurator].replace_flattened_config(@ceedling[BULLSEYE_SYM].config)
-      @ceedling[BULLSEYE_SYM].enableBullseye(true)
-      @ceedling[:test_invoker].setup_and_invoke(matches, { force_run: false }.merge(TOOL_COLLECTION_BULLSEYE_TASKS))
-      @ceedling[:configurator].restore_config
+      @ceedling[:test_invoker].setup_and_invoke( tests:matches, context:BULLSEYE_SYM, options:{ force_run: false }.merge(TOOL_COLLECTION_BULLSEYE_TASKS) )
     else
       @ceedling[:loginator].log("\nFound no tests matching pattern /#{args.regex}/.")
     end
@@ -132,49 +75,66 @@ namespace BULLSEYE_SYM do
     end
 
     if !matches.empty?
-      @ceedling[:configurator].replace_flattened_config(@ceedling[BULLSEYE_SYM].config)
-      @ceedling[BULLSEYE_SYM].enableBullseye(true)
-      @ceedling[:test_invoker].setup_and_invoke(matches, { force_run: false }.merge(TOOL_COLLECTION_BULLSEYE_TASKS))
-      @ceedling[:configurator].restore_config
+      @ceedling[:test_invoker].setup_and_invoke( tests:matches, context:BULLSEYE_SYM, options:{ force_run: false }.merge(TOOL_COLLECTION_BULLSEYE_TASKS) )
     else
-      @ceedling[:loginator].log("\nFound no tests including the given path or path component.")
+      @ceedling[:loginator].log( 'Found no tests including the given path or path component', Verbosity::ERRORS )
     end
   end
 
-  desc 'Run code coverage for changed files'
-  task delta: [:prepare] do
-    @ceedling[:configurator].replace_flattened_config(@ceedling[BULLSEYE_SYM].config)
-    @ceedling[BULLSEYE_SYM].enableBullseye(true)
-    @ceedling[:test_invoker].setup_and_invoke(COLLECTION_ALL_TESTS, {:force_run => false}.merge(TOOL_COLLECTION_BULLSEYE_TASKS))
-    @ceedling[:configurator].restore_config
-  end
-
   # Use a rule to increase efficiency for large projects
-  rule(/^#{BULLSEYE_TASK_ROOT}\S+$/ => [ # Bullseye test tasks by regex
-      proc do |task_name|
-        # Yield clean test name => Strip the task string, remove Rake test task prefix, and remove any code file extension
-        test = task_name.strip().sub(/^#{BULLSEYE_TASK_ROOT}/, '').chomp( EXTENSION_SOURCE )
-
-        # Ensure the test name begins with a test name prefix
-        test = PROJECT_TEST_FILE_PREFIX + test if not (test.start_with?( PROJECT_TEST_FILE_PREFIX ))
+  rule(/^#{BULLSEYE_TASK_ROOT}\S+$/ => [ # bullseye test tasks by regex
+     proc do |task_name|
+        # Any directory typed ahead of the name is kept. See TestTaskName.
+        test = TestTaskName.test_name( task_name, root: BULLSEYE_TASK_ROOT )
 
         # Provide the filepath for the target test task back to the Rake task
         @ceedling[:file_finder].find_test_file_from_name( test )
-      end
-  ]) do |test|
+     end
+   ]) do |test|
     @ceedling[:rake_wrapper][:prepare].invoke
-    @ceedling[BULLSEYE_SYM].enableBullseye(true)
-    @ceedling[:test_invoker].setup_and_invoke( [test.source], TOOL_COLLECTION_BULLSEYE_TASKS )
+    @ceedling[:test_invoker].setup_and_invoke( tests:[test.source], context:BULLSEYE_SYM, options:TOOL_COLLECTION_BULLSEYE_TASKS )
+  end
+
+  # Only defined when :untested_sources is ':compile' — lets a user iterate on getting
+  # untested-source coverage compilation working without paying for a full bullseye:
+  # test suite run each time.
+  if @ceedling[BULLSEYE_SYM].untested_sources_compile_enabled?
+    desc 'Compile all untested source files with coverage'
+    task :untested_sources => [:prepare] do
+      # sources_only: true — populate the tested-sources mapping (which sources each test
+      # references) without compiling, linking, or executing any test.
+      @ceedling[:test_invoker].setup_and_invoke(
+        tests: COLLECTION_ALL_TESTS,
+        context: BULLSEYE_SYM,
+        options: { sources_only: true }
+      )
+      @ceedling[:bullseye].process_untested_sources( sources: COLLECTION_ALL_SOURCE, guidance: false )
+    end
+  end
+
+  desc 'Open Bullseye code coverage browser'
+  task :browser do
+    command = @ceedling[:tool_executor].build_command_line( TOOLS_BULLSEYE_BROWSER, [] )
+    @ceedling[:tool_executor].exec( command )
+  end
+
+  desc 'Report Bullseye license status'
+  task :license do
+    @ceedling[:bullseye].report_license_status()
   end
 
 end
 
-namespace UTILS_SYM do
+# If bullseye config enables dedicated report generation task, create the task
+if not @ceedling[BULLSEYE_SYM].automatic_reporting_enabled?
+namespace BULLSEYE_REPORT_NAMESPACE_SYM do
 
-  desc "Open Bullseye code coverage browser"
+  desc "Generate coverage reports (Note: a #{BULLSEYE_SYM}: task must be executed first)"
   task BULLSEYE_SYM do
-    command = @ceedling[:tool_executor].build_command_line( TOOLS_BULLSEYE_BROWSER, [] )
-    @ceedling[:tool_executor].exec( command )
+    @ceedling[:bullseye].generate_html_report()
+    # Does nothing unless :xml_report names a format
+    @ceedling[:bullseye].generate_xml_report()
   end
 
 end
+end

data/plugins/bullseye/config/defaults.yml

@@ -6,61 +6,19 @@
 # =========================================================================
 
 ---
-
-:bullseye:
-  :auto_license: TRUE
 :plugins:
-  :bullseye_lib_path: []
-:paths:
-  :bullseye_toolchain_include: []
+  :test_build_contexts:
+    - :bullseye   # Its :defines and :flags work as :test's do, matchers included
 
-# TODO: Restore :tools once Bullseye plugin has been updated for Ceedling >= 1.0.0
-# :tools:
-#   :bullseye_instrumentation:
-#     :executable: covc
-#     :optional: true
-#     :arguments:
-#       - '--file $': ENVIRONMENT_COVFILE
-#       - -q
-#       - ${1}
-#   :bullseye_compiler:
-#     :executable: gcc
-#     :arguments:
-#       - -g
-#       - -I"$": COLLECTION_PATHS_TEST_SUPPORT_SOURCE_INCLUDE_VENDOR
-#       - -I"$": COLLECTION_PATHS_BULLSEYE_TOOLCHAIN_INCLUDE
-#       - -D$: COLLECTION_DEFINES_TEST_AND_VENDOR
-#       - -DBULLSEYE_COMPILER
-#       - -c "${1}"
-#       - -o "${2}"
-#   :bullseye_linker:
-#     :executable: gcc
-#     :arguments:
-#       - ${1}
-#       - -o ${2}
-#       - -L$: PLUGINS_BULLSEYE_LIB_PATH
-#       - -lcov
-#   :bullseye_fixture:
-#     :executable: ${1}
-#   :bullseye_report_covsrc:
-#     :executable: covsrc
-#     :optional: true
-#     :arguments:
-#       - '--file $': ENVIRONMENT_COVFILE
-#       - -q
-#       - -w140
-#   :bullseye_report_covfn:
-#     :executable: covfn
-#     :optional: true
-#     :arguments:
-#       - '--file $': ENVIRONMENT_COVFILE
-#       - --width 120
-#       - --no-source
-#       - '"${1}"'
-#   :bullseye_browser:
-#     :executable: CoverageBrowser
-#     :optional: TRUE
-#     :arguments:
-#       - '"$"': ENVIRONMENT_COVFILE
+:bullseye:
+  :summaries: TRUE               # Enable covsrc totals banner + per-source covfn dump to console after tests
+  :report_task: FALSE            # Disable dedicated report generation task (this enables automatic report generation)
+  :untested_sources: :list       # :ignore (skip entirely), :list (log filepaths not in report), :compile (compile all for 0% coverage)
+  :branch_detail: :none          # Annotated source listing of uncovered branches. :none, :uncovered (covbr --uncover), :all (covbr --all)
+  :xml_report: :none             # Machine-readable coverage report. :none, :native (Bullseye schema), :cobertura (CI-friendly)
+  :fail_under:                   # Fail the build below these coverage percentages. 0 disables the check.
+    :functions: 0
+    :branches: 0
+  :license_manager_file:         # Path to a Bullseye floating-license manager file (sets COVLM); irrelevant for node-locked/unlimited licenses
 
 ...

data/plugins/bullseye/config/defaults_bullseye.rb

@@ -0,0 +1,182 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+# `covc` wraps the entire compiler invocation (Bullseye's "Direct covc Invocation"
+# integration method): `covc [options] compiler args...`, where everything before
+# the compiler name is parsed as a covc option, not passed through. Ceedling always
+# inserts per-file/per-test flags (search paths, defines, matcher-based `:flags`
+# entries) immediately after a tool's `:executable`, ahead of its `:arguments`, so
+# `-q` and `gcc` are folded into `:executable` itself here rather than left as
+# leading `:arguments` — that keeps every Ceedling-injected flag positioned after
+# the wrapped compiler's name, in the compiler-args section covc passes through,
+# instead of being misread as an unrecognized covc option.
+#
+# No `--file`/`-f` is passed — covc and every other Bullseye tool here default to
+# the `COVFILE` environment variable, which the plugin sets via its
+# `Plugin#environment` mechanism.
+DEFAULT_BULLSEYE_COMPILER_TOOL = {
+  :executable => "#{FilePathUtils.os_executable_ext('covc')} -q #{FilePathUtils.os_executable_ext('gcc')}".freeze,
+  :name => 'default_bullseye_compiler'.freeze,
+  :optional => false.freeze,
+  :arguments => [
+    "-g".freeze,
+    "-I\"${5}\"".freeze, # Per-test executable search paths
+    "-D\"${6}\"".freeze, # Per-test executable defines
+    "-DBULLSEYE_COMPILER".freeze,
+    "-c \"${1}\"".freeze,
+    "-o \"${2}\"".freeze,
+    "-MMD".freeze,
+    "-MF \"${4}\"".freeze,
+    ].freeze
+  }
+
+# `covc` wraps the entire linker invocation too — Bullseye's runtime auto-links
+# its coverage library on the link step, so no manual -lcov/-L<path> is needed.
+# `:executable` folds in `-q gcc` for the same reason as the compiler tool above.
+DEFAULT_BULLSEYE_LINKER_TOOL = {
+  :executable => "#{FilePathUtils.os_executable_ext('covc')} -q #{FilePathUtils.os_executable_ext('gcc')}".freeze,
+  :name => 'default_bullseye_linker'.freeze,
+  :optional => false.freeze,
+  :arguments => [
+    "-g".freeze,
+    "${1}".freeze,
+    "${5}".freeze,
+    "-o \"${2}\"".freeze,
+    "${4}".freeze,
+    ].freeze
+  }
+
+DEFAULT_BULLSEYE_FIXTURE_TOOL = {
+  :executable => '${1}'.freeze,
+  :name => 'default_bullseye_fixture'.freeze,
+  :optional => false.freeze,
+  :arguments => [].freeze
+  }
+
+# Whole-COVFILE totals report. Only the totals are consumed. The plugin parses them
+# and renders its own console summary, so this output is never shown to the user.
+# `--csv` yields a quoted "Total" row with discrete percentage fields. Parsing that is
+# stable against changes to the column widths and alignment of the human-readable
+# report. No `-w` width is set because width is meaningless for CSV.
+DEFAULT_BULLSEYE_REPORT_COVSRC_TOOL = {
+  :executable => FilePathUtils.os_executable_ext('covsrc').freeze,
+  :name => 'default_bullseye_report_covsrc'.freeze,
+  :optional => true.freeze,
+  :arguments => [
+    "-q".freeze,
+    "--csv".freeze,
+    ].freeze
+  }
+
+# Per-source function-level coverage dump, printed to console after a bullseye: task run
+DEFAULT_BULLSEYE_REPORT_COVFN_TOOL = {
+  :executable => FilePathUtils.os_executable_ext('covfn').freeze,
+  :name => 'default_bullseye_report_covfn'.freeze,
+  :optional => true.freeze,
+  :arguments => [
+    "--width 120".freeze,
+    "--no-source".freeze,
+    "\"${1}\"".freeze,
+    ].freeze
+  }
+
+# Annotated source listing showing which individual conditions and decisions went
+# uncovered. covsrc and covfn report branch coverage only as a percentage. This is the
+# only console report that identifies the specific branches behind that number.
+# `${1}` carries the mode flag chosen by :bullseye ↳ :branch_detail.
+# Invoked once against the whole coverage file. covbr honors covselect's persisted
+# exclusions on its own, so no region arguments are needed.
+DEFAULT_BULLSEYE_REPORT_COVBR_TOOL = {
+  :executable => FilePathUtils.os_executable_ext('covbr').freeze,
+  :name => 'default_bullseye_report_covbr'.freeze,
+  :optional => true.freeze,
+  :arguments => [
+    "-q".freeze,
+    "--width 120".freeze,
+    "${1}".freeze, # Mode flag
+    ].freeze
+  }
+
+# Machine-readable coverage report for CI tooling. covxml emits Bullseye's own XML
+# schema by default. `--cobertura` switches it to Cobertura format for the many CI
+# dashboards that already read that. `${1}` carries the format flag chosen by
+# :bullseye ↳ :xml_report and is empty for the native format.
+DEFAULT_BULLSEYE_REPORT_COVXML_TOOL = {
+  :executable => FilePathUtils.os_executable_ext('covxml').freeze,
+  :name => 'default_bullseye_report_covxml'.freeze,
+  :optional => true.freeze,
+  :arguments => [
+    "-q".freeze,
+    "${1}".freeze,        # Format flag
+    "-o \"${2}\"".freeze, # Output filepath
+    ].freeze
+  }
+
+# Reports Bullseye license utilization for the `bullseye:license` task.
+# No `-q` or `--no-banner` is passed. covlmgr prints the license number and expiry
+# date in its banner, which is the most useful part of the diagnostic.
+DEFAULT_BULLSEYE_LICENSE_STATUS_TOOL = {
+  :executable => FilePathUtils.os_executable_ext('covlmgr').freeze,
+  :name => 'default_bullseye_license_status'.freeze,
+  :optional => true.freeze,
+  :arguments => [
+    "--status".freeze,
+    ].freeze
+  }
+
+# Generates a full interactive HTML coverage report. `covhtml` takes a single
+# positional output-directory argument; no --file is needed (defaults to COVFILE).
+DEFAULT_BULLSEYE_REPORT_COVHTML_TOOL = {
+  :executable => FilePathUtils.os_executable_ext('covhtml').freeze,
+  :name => 'default_bullseye_report_covhtml'.freeze,
+  :optional => true.freeze,
+  :arguments => [
+    "-q".freeze,
+    "\"${1}\"".freeze, # Output directory
+    ].freeze
+  }
+
+# Applies report-time exclusions (framework/test sources) to the COVFILE's
+# selection settings, independent of the coverage data itself. `--add '!pattern'`
+# registers an exclusion; patterns support recursive `**/` and mid-filename `*` globs
+# (e.g. `!**/test_*.c` excludes nested test sources regardless of directory depth,
+# given BULLSEYE_COVFILE_PATH sits at project root — see bullseye_constants.rb).
+DEFAULT_BULLSEYE_COVSELECT_TOOL = {
+  :executable => FilePathUtils.os_executable_ext('covselect').freeze,
+  :name => 'default_bullseye_covselect'.freeze,
+  :optional => true.freeze,
+  :arguments => [
+    "-q".freeze,
+    "--add".freeze,
+    "\"${1}\"".freeze, # Exclusion pattern
+    ].freeze
+  }
+
+# GUI coverage browser — relies on the COVFILE environment variable like every
+# other Bullseye tool here; not a coverage-generation or reporting tool itself.
+DEFAULT_BULLSEYE_BROWSER_TOOL = {
+  :executable => FilePathUtils.os_executable_ext('CoverageBrowser').freeze,
+  :name => 'default_bullseye_browser'.freeze,
+  :optional => true.freeze,
+  :arguments => [].freeze
+  }
+
+def get_default_config
+  return :tools => {
+    :bullseye_compiler       => DEFAULT_BULLSEYE_COMPILER_TOOL,
+    :bullseye_linker         => DEFAULT_BULLSEYE_LINKER_TOOL,
+    :bullseye_fixture        => DEFAULT_BULLSEYE_FIXTURE_TOOL,
+    :bullseye_report_covsrc  => DEFAULT_BULLSEYE_REPORT_COVSRC_TOOL,
+    :bullseye_report_covfn   => DEFAULT_BULLSEYE_REPORT_COVFN_TOOL,
+    :bullseye_report_covbr   => DEFAULT_BULLSEYE_REPORT_COVBR_TOOL,
+    :bullseye_report_covxml  => DEFAULT_BULLSEYE_REPORT_COVXML_TOOL,
+    :bullseye_report_covhtml => DEFAULT_BULLSEYE_REPORT_COVHTML_TOOL,
+    :bullseye_covselect      => DEFAULT_BULLSEYE_COVSELECT_TOOL,
+    :bullseye_license_status => DEFAULT_BULLSEYE_LICENSE_STATUS_TOOL,
+    :bullseye_browser        => DEFAULT_BULLSEYE_BROWSER_TOOL,
+  }
+end