ceedling 0.31.0 → 1.0.0

data/lib/ceedling/defaults.rb

@@ -1,26 +1,29 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
 require 'ceedling/constants'
 require 'ceedling/system_wrapper'
 require 'ceedling/file_path_utils'
 
-#this should be defined already, but not always during system specs
-CEEDLING_VENDOR = File.expand_path(File.dirname(__FILE__) + '/../../vendor') unless defined? CEEDLING_VENDOR
+# Assign a default value for system testing where CEEDLING_APPCFG may not be present
+# TODO: Create code config & test structure that does not internalize a test path like this
+CEEDLING_VENDOR = defined?( CEEDLING_APPCFG ) ? CEEDLING_APPCFG[:ceedling_vendor_path] : File.expand_path( File.dirname(__FILE__) + '/../../vendor' )
+
 CEEDLING_PLUGINS = [] unless defined? CEEDLING_PLUGINS
 
 DEFAULT_TEST_COMPILER_TOOL = {
-  :executable => ENV['CC'].nil? ? FilePathUtils.os_executable_ext('gcc').freeze : ENV['CC'].split[0],
+  :executable => FilePathUtils.os_executable_ext('gcc').freeze,
   :name => 'default_test_compiler'.freeze,
-  :stderr_redirect => StdErrRedirect::NONE.freeze,
-  :background_exec => BackgroundExec::NONE.freeze,
   :optional => false.freeze,
   :arguments => [
-    ENV['CC'].nil? ? "" : ENV['CC'].split[1..-1],
-    ENV['CPPFLAGS'].nil? ? "" : ENV['CPPFLAGS'].split,
-    {"-I\"$\"" => 'COLLECTION_PATHS_TEST_SUPPORT_SOURCE_INCLUDE_VENDOR'}.freeze,
-    {"-I\"$\"" => 'COLLECTION_PATHS_TEST_TOOLCHAIN_INCLUDE'}.freeze,
-    {"-D$" => 'COLLECTION_DEFINES_TEST_AND_VENDOR'}.freeze,
-    "-DGNU_COMPILER".freeze,
+    "-I\"${5}\"".freeze, # Per-test executable search paths
+    "-D\"${6}\"".freeze, # Per-test executable defines
+    "-DGNU_COMPILER".freeze, # OSX clang
     "-g".freeze,
-    ENV['CFLAGS'].nil? ? "" : ENV['CFLAGS'].split,
     "-c \"${1}\"".freeze,
     "-o \"${2}\"".freeze,
     # gcc's list file output options are complex; no use of ${3} parameter in default config
@@ -29,95 +32,110 @@ DEFAULT_TEST_COMPILER_TOOL = {
     ].freeze
   }
 
+DEFAULT_TEST_ASSEMBLER_TOOL = {
+  :executable => FilePathUtils.os_executable_ext('as').freeze,
+  :name => 'default_test_assembler'.freeze,
+  :optional => false.freeze,
+  :arguments => [
+    "-I\"${3}\"".freeze, # Search paths
+    # Any defines (${4}) are not included since GNU assembler ignores them
+    "\"${1}\"".freeze,
+    "-o \"${2}\"".freeze,
+    ].freeze
+  }
+
 DEFAULT_TEST_LINKER_TOOL = {
-  :executable => ENV['CCLD'].nil? ? FilePathUtils.os_executable_ext('gcc').freeze : ENV['CCLD'].split[0],
+  :executable => FilePathUtils.os_executable_ext('gcc').freeze,
   :name => 'default_test_linker'.freeze,
-  :stderr_redirect => StdErrRedirect::NONE.freeze,
-  :background_exec => BackgroundExec::NONE.freeze,
   :optional => false.freeze,
   :arguments => [
-    ENV['CCLD'].nil? ? "" : ENV['CCLD'].split[1..-1],
-    ENV['CFLAGS'].nil? ? "" : ENV['CFLAGS'].split,
-    ENV['LDFLAGS'].nil? ? "" : ENV['LDFLAGS'].split,
-    "\"${1}\"".freeze,
+    "${1}".freeze,
     "${5}".freeze,
     "-o \"${2}\"".freeze,
     "".freeze,
     "${4}".freeze,
-    ENV['LDLIBS'].nil? ? "" : ENV['LDLIBS'].split
     ].freeze
   }
 
 DEFAULT_TEST_FIXTURE_TOOL = {
-  :executable => '${1}'.freeze,
+  :executable => '${1}'.freeze, # Unity test runner executable
   :name => 'default_test_fixture'.freeze,
-  :stderr_redirect => StdErrRedirect::AUTO.freeze,
-  :background_exec => BackgroundExec::NONE.freeze,
   :optional => false.freeze,
   :arguments => [].freeze
   }
 
-DEFAULT_TEST_INCLUDES_PREPROCESSOR_TOOL = {
-  :executable => ENV['CC'].nil? ? FilePathUtils.os_executable_ext('gcc').freeze : ENV['CC'].split[0],
-  :name => 'default_test_includes_preprocessor'.freeze,
-  :stderr_redirect => StdErrRedirect::NONE.freeze,
-  :background_exec => BackgroundExec::NONE.freeze,
+DEFAULT_TEST_FIXTURE_SIMPLE_BACKTRACE_TOOL = {
+  :executable => '${1}'.freeze, # Unity test runner executable
+  :name => 'default_test_fixture_simple_backtrace'.freeze,
   :optional => false.freeze,
   :arguments => [
-    ENV['CC'].nil? ? "" : ENV['CC'].split[1..-1],
-    ENV['CPPFLAGS'].nil? ? "" : ENV['CPPFLAGS'].split,
-    '-E'.freeze, # OSX clang
-    '-MM'.freeze,
-    '-MG'.freeze,
-    # avoid some possibility of deep system lib header file complications by omitting vendor paths
-    # if cpp is run on *nix system, escape spaces in paths; if cpp on windows just use the paths collection as is
-    # {"-I\"$\"" => "{SystemWrapper.windows? ? COLLECTION_PATHS_TEST_SUPPORT_SOURCE_INCLUDE : COLLECTION_PATHS_TEST_SUPPORT_SOURCE_INCLUDE.map{|path| path.gsub(\/ \/, \'\\\\ \') }}"}.freeze,
-    {"-I\"$\"" => 'COLLECTION_PATHS_TEST_SUPPORT_SOURCE_INCLUDE_VENDOR'}.freeze,
-    {"-I\"$\"" => 'COLLECTION_PATHS_TEST_TOOLCHAIN_INCLUDE'}.freeze,
-    {"-D$" => 'COLLECTION_DEFINES_TEST_AND_VENDOR'}.freeze,
-    {"-D$" => 'DEFINES_TEST_PREPROCESS'}.freeze,
+    '-n ${2}'.freeze # Exact test case name matching flag
+    ].freeze
+  }
+
+DEFAULT_TEST_SHALLOW_INCLUDES_PREPROCESSOR_TOOL = {
+  :executable => FilePathUtils.os_executable_ext('gcc').freeze,
+  :name => 'default_test_shallow_includes_preprocessor'.freeze,
+  :optional => false.freeze,
+  :arguments => [
+    '-E'.freeze,             # Run only through preprocessor stage with its output
+    '-MM'.freeze,            # Output make rule + suppress header files found in system header directories
+    '-MG'.freeze,            # Assume missing header files are generated files (do not discard)
+    '-MP'.freeze,            # Create make "phony" rules for each include dependency
+    "-D\"${2}\"".freeze,     # Per-test executable defines
     "-DGNU_COMPILER".freeze, # OSX clang
-    # '-nostdinc'.freeze, # disabled temporarily due to stdio access violations on OSX
+    '-nostdinc'.freeze,      # Ignore standard include paths
+    "-x c".freeze,           # Force C language
     "\"${1}\"".freeze
     ].freeze
   }
 
-DEFAULT_TEST_FILE_PREPROCESSOR_TOOL = {
-  :executable => ENV['CC'].nil? ? FilePathUtils.os_executable_ext('gcc').freeze : ENV['CC'].split[0],
-  :name => 'default_test_file_preprocessor'.freeze,
-  :stderr_redirect => StdErrRedirect::NONE.freeze,
-  :background_exec => BackgroundExec::NONE.freeze,
+DEFAULT_TEST_NESTED_INCLUDES_PREPROCESSOR_TOOL = {
+  :executable => FilePathUtils.os_executable_ext('gcc').freeze,
+  :name => 'default_test_nested_includes_preprocessor'.freeze,
+  :optional => false.freeze,
+  :arguments => [
+    '-E'.freeze,             # Run only through preprocessor stage with its output
+    '-MM'.freeze,            # Output make rule + suppress header files found in system header directories
+    '-MG'.freeze,            # Assume missing header files are generated files (do not discard)
+    '-H'.freeze,             # Also output #include list with depth
+    "-I\"${2}\"".freeze,     # Per-test executable search paths
+    "-D\"${3}\"".freeze,     # Per-test executable defines
+    "-DGNU_COMPILER".freeze, # OSX clang
+    '-nostdinc'.freeze,      # Ignore standard include paths
+    "-x c".freeze,           # Force C language
+    "\"${1}\"".freeze
+    ].freeze
+  }
+
+DEFAULT_TEST_FILE_FULL_PREPROCESSOR_TOOL = {
+  :executable => FilePathUtils.os_executable_ext('gcc').freeze,
+  :name => 'default_test_file_full_preprocessor'.freeze,
   :optional => false.freeze,
   :arguments => [
-    ENV['CC'].nil? ? "" : ENV['CC'].split[1..-1],
-    ENV['CPPFLAGS'].nil? ? "" : ENV['CPPFLAGS'].split,
     '-E'.freeze,
-    {"-I\"$\"" => 'COLLECTION_PATHS_TEST_SUPPORT_SOURCE_INCLUDE_VENDOR'}.freeze,
-    {"-I\"$\"" => 'COLLECTION_PATHS_TEST_TOOLCHAIN_INCLUDE'}.freeze,
-    {"-D$" => 'COLLECTION_DEFINES_TEST_AND_VENDOR'}.freeze,
-    {"-D$" => 'DEFINES_TEST_PREPROCESS'}.freeze,
-    "-DGNU_COMPILER".freeze,
+    "-I\"${4}\"".freeze, # Per-test executable search paths
+    "-D\"${3}\"".freeze, # Per-test executable defines
+    "-DGNU_COMPILER".freeze, # OSX clang
     # '-nostdinc'.freeze, # disabled temporarily due to stdio access violations on OSX
+    "-x c".freeze,           # Force C language
     "\"${1}\"".freeze,
     "-o \"${2}\"".freeze
     ].freeze
   }
 
-DEFAULT_TEST_FILE_PREPROCESSOR_DIRECTIVES_TOOL = {
+DEFAULT_TEST_FILE_DIRECTIVES_ONLY_PREPROCESSOR_TOOL = {
   :executable => FilePathUtils.os_executable_ext('gcc').freeze,
-  :name => 'default_test_file_preprocessor_directives'.freeze,
-  :stderr_redirect => StdErrRedirect::NONE.freeze,
-  :background_exec => BackgroundExec::NONE.freeze,
+  :name => 'default_test_file_directives_only_preprocessor'.freeze,
   :optional => false.freeze,
   :arguments => [
     '-E'.freeze,
-    {"-I\"$\"" => 'COLLECTION_PATHS_TEST_SUPPORT_SOURCE_INCLUDE_VENDOR'}.freeze,
-    {"-I\"$\"" => 'COLLECTION_PATHS_TEST_TOOLCHAIN_INCLUDE'}.freeze,
-    {"-D$" => 'COLLECTION_DEFINES_TEST_AND_VENDOR'}.freeze,
-    {"-D$" => 'DEFINES_TEST_PREPROCESS'}.freeze,
-    "-DGNU_COMPILER".freeze,
-    '-fdirectives-only'.freeze,
+    "-I\"${4}\"".freeze, # Per-test executable search paths
+    "-D\"${3}\"".freeze, # Per-test executable defines
+    "-DGNU_COMPILER".freeze, # OSX clang
     # '-nostdinc'.freeze, # disabled temporarily due to stdio access violations on OSX
+    "-x c".freeze,           # Force C language
+    "-fdirectives-only",     # Only preprocess directives
     "\"${1}\"".freeze,
     "-o \"${2}\"".freeze
     ].freeze
@@ -131,39 +149,30 @@ else
 end
 
 DEFAULT_TEST_DEPENDENCIES_GENERATOR_TOOL = {
-  :executable => ENV['CC'].nil? ? FilePathUtils.os_executable_ext('gcc').freeze : ENV['CC'].split[0],
+  :executable => FilePathUtils.os_executable_ext('gcc').freeze,
   :name => 'default_test_dependencies_generator'.freeze,
-  :stderr_redirect => StdErrRedirect::NONE.freeze,
-  :background_exec => BackgroundExec::NONE.freeze,
   :optional => false.freeze,
   :arguments => [
-    ENV['CC'].nil? ? "" : ENV['CC'].split[1..-1],
-    ENV['CPPFLAGS'].nil? ? "" : ENV['CPPFLAGS'].split,
     '-E'.freeze,
-    {"-I\"$\"" => 'COLLECTION_PATHS_TEST_SUPPORT_SOURCE_INCLUDE_VENDOR'}.freeze,
-    {"-I\"$\"" => 'COLLECTION_PATHS_TEST_TOOLCHAIN_INCLUDE'}.freeze,
-    {"-D$" => 'COLLECTION_DEFINES_TEST_AND_VENDOR'}.freeze,
-    {"-D$" => 'DEFINES_TEST_PREPROCESS'}.freeze,
+    "-I\"${5}\"".freeze, # Per-test executable search paths
+    "-D\"${4}\"".freeze, # Per-test executable defines
     "-DGNU_COMPILER".freeze,
     "-MT \"${3}\"".freeze,
     '-MM'.freeze,
     MD_FLAG.freeze,
     '-MG'.freeze,
     "-MF \"${2}\"".freeze,
+    "-x c".freeze, # Force C language
     "-c \"${1}\"".freeze,
     # '-nostdinc'.freeze,
     ].freeze
   }
 
 DEFAULT_RELEASE_DEPENDENCIES_GENERATOR_TOOL = {
-  :executable => ENV['CC'].nil? ? FilePathUtils.os_executable_ext('gcc').freeze : ENV['CC'].split[0],
+  :executable => FilePathUtils.os_executable_ext('gcc').freeze,
   :name => 'default_release_dependencies_generator'.freeze,
-  :stderr_redirect => StdErrRedirect::NONE.freeze,
-  :background_exec => BackgroundExec::NONE.freeze,
   :optional => false.freeze,
   :arguments => [
-    ENV['CC'].nil? ? "" : ENV['CC'].split[1..-1],
-    ENV['CPPFLAGS'].nil? ? "" : ENV['CPPFLAGS'].split,
     '-E'.freeze,
     {"-I\"$\"" => 'COLLECTION_PATHS_SOURCE_INCLUDE_VENDOR'}.freeze,
     {"-I\"$\"" => 'COLLECTION_PATHS_RELEASE_TOOLCHAIN_INCLUDE'}.freeze,
@@ -175,26 +184,20 @@ DEFAULT_RELEASE_DEPENDENCIES_GENERATOR_TOOL = {
     MD_FLAG.freeze,
     '-MG'.freeze,
     "-MF \"${2}\"".freeze,
+    "-x c".freeze, # Force C language
     "-c \"${1}\"".freeze,
     # '-nostdinc'.freeze,
     ].freeze
   }
 
-
 DEFAULT_RELEASE_COMPILER_TOOL = {
-  :executable => ENV['CC'].nil? ? FilePathUtils.os_executable_ext('gcc').freeze : ENV['CC'].split[0],
+  :executable => FilePathUtils.os_executable_ext('gcc').freeze,
   :name => 'default_release_compiler'.freeze,
-  :stderr_redirect => StdErrRedirect::NONE.freeze,
-  :background_exec => BackgroundExec::NONE.freeze,
   :optional => false.freeze,
   :arguments => [
-    ENV['CC'].nil? ? "" : ENV['CC'].split[1..-1],
-    ENV['CPPFLAGS'].nil? ? "" : ENV['CPPFLAGS'].split,
-    {"-I\"$\"" => 'COLLECTION_PATHS_SOURCE_INCLUDE_VENDOR'}.freeze,
-    {"-I\"$\"" => 'COLLECTION_PATHS_RELEASE_TOOLCHAIN_INCLUDE'}.freeze,
-    {"-D$" => 'COLLECTION_DEFINES_RELEASE_AND_VENDOR'}.freeze,
+    "-I\"${5}\"".freeze, # Search paths
+    "-D\"${6}\"".freeze, # Defines
     "-DGNU_COMPILER".freeze,
-    ENV['CFLAGS'].nil? ? "" : ENV['CFLAGS'].split,
     "-c \"${1}\"".freeze,
     "-o \"${2}\"".freeze,
     # gcc's list file output options are complex; no use of ${3} parameter in default config
@@ -204,53 +207,72 @@ DEFAULT_RELEASE_COMPILER_TOOL = {
   }
 
 DEFAULT_RELEASE_ASSEMBLER_TOOL = {
-  :executable => ENV['AS'].nil? ? FilePathUtils.os_executable_ext('as').freeze : ENV['AS'].split[0],
+  :executable => FilePathUtils.os_executable_ext('as').freeze,
   :name => 'default_release_assembler'.freeze,
-  :stderr_redirect => StdErrRedirect::NONE.freeze,
-  :background_exec => BackgroundExec::NONE.freeze,
   :optional => false.freeze,
   :arguments => [
-    ENV['AS'].nil? ? "" : ENV['AS'].split[1..-1],
-    ENV['ASFLAGS'].nil? ? "" : ENV['ASFLAGS'].split,
-    {"-I\"$\"" => 'COLLECTION_PATHS_SOURCE_AND_INCLUDE'}.freeze,
+    "-I\"${3}\"".freeze, # Search paths
+    "-D\"${4}\"".freeze, # Defines (FYI--allowed with GNU assembler but ignored)
     "\"${1}\"".freeze,
     "-o \"${2}\"".freeze,
     ].freeze
   }
 
 DEFAULT_RELEASE_LINKER_TOOL = {
-  :executable => ENV['CCLD'].nil? ? FilePathUtils.os_executable_ext('gcc').freeze : ENV['CCLD'].split[0],
+  :executable => FilePathUtils.os_executable_ext('gcc').freeze,
   :name => 'default_release_linker'.freeze,
-  :stderr_redirect => StdErrRedirect::NONE.freeze,
-  :background_exec => BackgroundExec::NONE.freeze,
   :optional => false.freeze,
   :arguments => [
-    ENV['CCLD'].nil? ? "" : ENV['CCLD'].split[1..-1],
-    ENV['CFLAGS'].nil? ? "" : ENV['CFLAGS'].split,
-    ENV['LDFLAGS'].nil? ? "" : ENV['LDFLAGS'].split,
     "\"${1}\"".freeze,
     "${5}".freeze,
     "-o \"${2}\"".freeze,
     "".freeze,
     "${4}".freeze,
-    ENV['LDLIBS'].nil? ? "" : ENV['LDLIBS'].split
     ].freeze
   }
 
+DEFAULT_TEST_BACKTRACE_GDB_TOOL = {
+  :executable => FilePathUtils.os_executable_ext('gdb').freeze,
+  :name => 'default_test_backtrace_gdb'.freeze,
+  :optional => false.freeze,
+  :arguments => [
+    '-q'.freeze,
+    '--batch'.freeze,
+    '--eval-command run'.freeze,
+    "--command \"${1}\"".freeze, # Debug script file to run
+    '--args'.freeze,
+    '${2}'.freeze,               # Test executable
+    '-n ${3}'.freeze             # Exact test case name matching flag
+    ].freeze
+  }
 
 DEFAULT_TOOLS_TEST = {
   :tools => {
     :test_compiler => DEFAULT_TEST_COMPILER_TOOL,
     :test_linker   => DEFAULT_TEST_LINKER_TOOL,
     :test_fixture  => DEFAULT_TEST_FIXTURE_TOOL,
+    :test_fixture_simple_backtrace => DEFAULT_TEST_FIXTURE_SIMPLE_BACKTRACE_TOOL
+    }
+  }
+
+DEFAULT_TOOLS_TEST_GDB_BACKTRACE = {
+  :tools => {
+    :test_backtrace_gdb => DEFAULT_TEST_BACKTRACE_GDB_TOOL
+    }
+  }
+
+DEFAULT_TOOLS_TEST_ASSEMBLER = {
+  :tools => {
+    :test_assembler => DEFAULT_TEST_ASSEMBLER_TOOL,
     }
   }
 
 DEFAULT_TOOLS_TEST_PREPROCESSORS = {
   :tools => {
-    :test_includes_preprocessor => DEFAULT_TEST_INCLUDES_PREPROCESSOR_TOOL,
-    :test_file_preprocessor     => DEFAULT_TEST_FILE_PREPROCESSOR_TOOL,
-    :test_file_preprocessor_directives => DEFAULT_TEST_FILE_PREPROCESSOR_DIRECTIVES_TOOL,
+    :test_shallow_includes_preprocessor      => DEFAULT_TEST_SHALLOW_INCLUDES_PREPROCESSOR_TOOL,
+    :test_nested_includes_preprocessor       => DEFAULT_TEST_NESTED_INCLUDES_PREPROCESSOR_TOOL,
+    :test_file_full_preprocessor             => DEFAULT_TEST_FILE_FULL_PREPROCESSOR_TOOL,
+    :test_file_directives_only_preprocessor  => DEFAULT_TEST_FILE_DIRECTIVES_ONLY_PREPROCESSOR_TOOL,
     }
   }
 
@@ -260,7 +282,6 @@ DEFAULT_TOOLS_TEST_DEPENDENCIES = {
     }
   }
 
-
 DEFAULT_TOOLS_RELEASE = {
   :tools => {
     :release_compiler => DEFAULT_RELEASE_COMPILER_TOOL,
@@ -283,129 +304,141 @@ DEFAULT_TOOLS_RELEASE_DEPENDENCIES = {
 
 DEFAULT_RELEASE_TARGET_NAME = 'project'
 
-DEFAULT_CEEDLING_CONFIG = {
-    :project => {
-      # :build_root must be set by user
-      :use_exceptions => true,
-      :use_mocks => true,
-      :compile_threads => 1,
-      :test_threads => 1,
-      :use_test_preprocessor => false,
-      :use_preprocessor_directives => false,
-      :use_deep_dependencies => false,
-      :generate_deep_dependencies => true, # only applicable if use_deep_dependencies is true
-      :test_file_prefix => 'test_',
-      :options_paths => [],
-      :release_build => false,
+DEFAULT_CEEDLING_PROJECT_CONFIG = {
+  :project => {
+    # :build_root must be set by user
+    :use_mocks => false,
+    :use_exceptions => false,
+    :compile_threads => 1,
+    :test_threads => 1,
+    :use_test_preprocessor => :none,
+    :use_deep_preprocessor => :none,
+    :test_file_prefix => 'test_',
+    :release_build => false,
+    :use_backtrace => :simple
     },
 
-    :release_build => {
-      # :output is set while building configuration -- allows smart default system-dependent file extension handling
-      :use_assembly => false,
-      :artifacts => [],
+  :release_build => {
+    # :output is set while building configuration -- allows smart default system-dependent file extension handling
+    :use_assembly => false,
+    :artifacts => []
     },
 
-    :paths => {
-      :test => [],   # must be populated by user
-      :source => [], # must be populated by user
-      :support => [],
-      :include => [],
-      :libraries => [],
-      :test_toolchain_include => [],
-      :release_toolchain_include => [],
+  :test_build => {
+    :use_assembly => false
     },
 
-    :files => {
-      :test => [],
-      :source => [],
-      :assembly => [],
-      :support => [],
-      :include => [],
+  # Unlike other top-level entries, :environment is an array (of hashes) to preserve order
+  :environment => [],
+
+  :paths => {
+    :test => [],    # Must be populated by user
+    :source => [],  # Should be populated by user but TEST_INCLUDE_PATH() could be used exclusively instead
+    :support => [],
+    :include => [], # Must be populated by user
+    :libraries => [],
+    :test_toolchain_include => [],
+    :release_toolchain_include => [],
     },
 
-    # unlike other top-level entries, environment's value is an array to preserve order
-    :environment => [
-      # when evaluated, this provides wider text field for rake task comments
-      {:rake_columns => '120'},
-    ],
-
-    :defines => {
-      :test => [],
-      :test_preprocess => [],
-      :release => [],
-      :release_preprocess => [],
-      :use_test_definition => false,
+  :files => {
+    :test => [],
+    :source => [],
+    :assembly => [],
+    :support => [],
+    :include => [],
     },
 
-    :libraries => {
-      :flag => '-l${1}',
-      :path_flag => '-L ${1}',
-      :test => [],
-      :test_preprocess => [],
-      :release => [],
-      :release_preprocess => [],
+  :defines => {
+    :use_test_definition => false,
+    :test => [],   # List of symbols or matcher hashes with test executables as keys
+    # :preprocess is identical to :test but lacks a default here as missing vs. empty values have additional meaning
+    :release => [] # List of symbols only
     },
 
-    :flags => {},
-
-    :extension => {
-      :header => '.h',
-      :source => '.c',
-      :assembly => '.s',
-      :object => '.o',
-      :libraries => ['.a','.so'],
-      :executable => ( SystemWrapper.windows? ? EXTENSION_WIN_EXE : EXTENSION_NONWIN_EXE ),
-      :map => '.map',
-      :list => '.lst',
-      :testpass => '.pass',
-      :testfail => '.fail',
-      :dependencies => '.d',
+  :flags => {
+    # Test & release flags are validated for presence--empty flags causes an error
+    # :test => {},   # hash/sub-hash of operations containing lists of flags or matcher hashes with test executables as keys
+    # :release => {} # hash/sub-hashes of operations containing lists of flags
     },
 
-    :unity => {
-      :vendor_path => CEEDLING_VENDOR,
-      :defines => []
+  :libraries => {
+    :flag => '-l${1}',
+    :path_flag => '-L ${1}',
+    :test => [],
+    :release => []
     },
 
-    :cmock => {
-      :vendor_path => CEEDLING_VENDOR,
-      :defines => [],
-      :includes => []
+  :extension => {
+    :header => '.h',
+    :source => '.c',
+    :assembly => '.s',
+    :object => '.o',
+    :libraries => ['.a','.so'],
+    :executable => ( SystemWrapper.windows? ? EXTENSION_WIN_EXE : EXTENSION_NONWIN_EXE ),
+    :map => '.map',
+    :list => '.lst',
+    :testpass => '.pass',
+    :testfail => '.fail',
+    :dependencies => '.d',
+    :yaml => '.yml'
     },
 
-    :cexception => {
-      :vendor_path => CEEDLING_VENDOR,
-      :defines => []
+  :unity => {
+    :defines => [],
+    :use_param_tests => false
     },
 
-    :test_runner => {
-      :includes => [],
-      :file_suffix => '_runner',
+  :cmock => {
+    :includes => [],
+    :defines => [],
+    :plugins => [],
+    :unity_helper_path => [],
+    # Yes, we're duplicating these defaults in CMock, but it's because:
+    #  (A) We always need CMOCK_MOCK_PREFIX in Ceedling's environment
+    #  (B) Test runner generator uses these same configuration values
+    :mock_prefix => 'Mock',
+    :mock_suffix => '',
+    # CMock's default duplicated here.
+    # We need a value present so preprocessing logic can safely reference it.
+    :treat_inlines => :exclude,
+    # Just because strict ordering is the way to go
+    :enforce_strict_ordering => true
     },
 
-    # all tools populated while building up config structure
-    :tools => {},
+  :cexception => {
+    :defines => []
+   },
 
-    # empty argument lists for default tools
-    # (these can be overridden in project file to add arguments to tools without totally redefining tools)
-    :test_compiler => { :arguments => [] },
-    :test_linker   => { :arguments => [] },
-    :test_fixture  => {
-      :arguments => [],
-      :link_objects => [], # compiled object files to always be linked in (e.g. cmock.o if using mocks)
+  :test_runner => {
+    :cmdline_args => false,
+    :includes => [],
+    :defines => [],
+    :file_suffix => '_runner',
     },
-    :test_includes_preprocessor  => { :arguments => [] },
-    :test_file_preprocessor      => { :arguments => [] },
-    :test_file_preprocessor_directives => { :arguments => [] },
-    :test_dependencies_generator => { :arguments => [] },
-    :release_compiler  => { :arguments => [] },
-    :release_linker    => { :arguments => [] },
-    :release_assembler => { :arguments => [] },
-    :release_dependencies_generator => { :arguments => [] },
-
-    :plugins => {
-      :load_paths => CEEDLING_PLUGINS,
-      :enabled => [],
+
+  # All tools populated while building up config / defaults structure
+  :tools => {},
+
+  }.freeze
+
+
+CEEDLING_RUNTIME_CONFIG = {
+  :unity => {
+    :vendor_path => CEEDLING_VENDOR
+    },
+
+  :cmock => {
+    :vendor_path => CEEDLING_VENDOR
+    },
+
+  :cexception => {
+    :vendor_path => CEEDLING_VENDOR
+    },
+
+  :plugins => {
+    :load_paths => [],
+    :enabled => CEEDLING_PLUGINS,
     }
   }.freeze
 
@@ -421,7 +454,7 @@ DEFAULT_TESTS_RESULTS_REPORT_TEMPLATE = %q{
 <%=@ceedling[:plugin_reportinator].generate_banner(header_prepend + 'TEST OUTPUT')%>
 %   hash[:results][:stdout].each do |string|
 %     string[:collection].each do |item|
-<%=string[:source][:path]%><%=File::SEPARATOR%><%=string[:source][:file]%>: "<%=item%>"
+<%=string[:source][:file]%>: "<%=item%>"
 %     end
 %   end
 
@@ -430,7 +463,7 @@ DEFAULT_TESTS_RESULTS_REPORT_TEMPLATE = %q{
 <%=@ceedling[:plugin_reportinator].generate_banner(header_prepend + 'IGNORED TEST SUMMARY')%>
 %   hash[:results][:ignores].each do |ignore|
 %     ignore[:collection].each do |item|
-<%=ignore[:source][:path]%><%=File::SEPARATOR%><%=ignore[:source][:file]%>:<%=item[:line]%>:<%=item[:test]%>
+<%=ignore[:source][:file]%>:<%=item[:line]%>:<%=item[:test]%>
 % if (item[:message].length > 0)
 : "<%=item[:message]%>"
 % else
@@ -444,7 +477,7 @@ DEFAULT_TESTS_RESULTS_REPORT_TEMPLATE = %q{
 <%=@ceedling[:plugin_reportinator].generate_banner(header_prepend + 'FAILED TEST SUMMARY')%>
 %   hash[:results][:failures].each do |failure|
 %     failure[:collection].each do |item|
-<%=failure[:source][:path]%><%=File::SEPARATOR%><%=failure[:source][:file]%>:<%=item[:line]%>:<%=item[:test]%>
+<%=failure[:source][:file]%>:<%=item[:line]%>:<%=item[:test]%>
 % if (item[:message].length > 0)
 : "<%=item[:message]%>"
 % else