ceedling 1.1.9 → 1.2.0

data/bin/cli.rb

@@ -7,6 +7,7 @@
 
 require 'thor'
 require 'ceedling/constants' # From Ceedling application
+require 'cli_options_transform'
 
 ##
 ## Command Line Handling
@@ -151,7 +152,6 @@ module CeedlingTasks
   CLI_MISSING_PARAMETER_DEFAULT = "/<>\\||*"
 
   class CLI < Thor
-    include Thor::Actions
     extend PermissiveCLI
 
     # Ensure we bail out with non-zero exit code if the command line is wrong
@@ -174,6 +174,7 @@ module CeedlingTasks
     end
 
 
+    # simplecov:disable line
     # Override Thor help to list Rake tasks as well
     desc "help [COMMAND]", "Describe available commands and list build operations"
     method_option :project, :type => :string, :default => nil, :lazy_default => CLI_MISSING_PARAMETER_DEFAULT, :aliases => ['-p'], :desc => DOC_PROJECT_FLAG
@@ -206,22 +207,23 @@ module CeedlingTasks
         "--project is missing a required filepath parameter"
       )
 
-      # Get unfrozen copies so we can add / modify
+      # Get an unfrozen copy so we can add / modify
       _options = options.dup()
-      _options[:project] = options[:project].dup() if !options[:project].nil?
-      _options[:mixin] = []
-      options[:mixin].each {|mixin| _options[:mixin] << mixin.dup() }
 
-      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : Verbosity::ERRORS
+      _options[:verbosity] = Verbosity::ERRORS
+      CliOptionsTransform.apply_debug_flag( _options )
       # Call application help with block to execute Thor's built-in help in the help logic
       @handler.app_help( ENV, @app_cfg, _options, command ) { |command| super(command) }
     end
+    # simplecov:enable line
+
 
- 
+    # simplecov:disable line
     desc "new [DEST]", "Create a new project structure at optional DEST path (default is current directory)"
     method_option :local, :type => :boolean, :default => false, :desc => DOC_LOCAL_FLAG
     method_option :docs, :type => :boolean, :default => false, :desc => DOC_DOCS_FLAG
     method_option :configs, :type => :boolean, :default => true, :desc => "Install starter project file in project root"
+    method_option :ceedling_yml, :type => :boolean, :default => false, :desc => "Name the starter project file ceedling.yml instead of project.yml"
     method_option :force, :type => :boolean, :default => false, :desc => "Ignore any existing project and recreate destination"
     method_option :debug, :type => :boolean, :default => false, :hide => true
     method_option :gitsupport, :type => :boolean, :default => false, :desc => "Create .gitignore / .gitkeep files for convenience"
@@ -243,15 +245,17 @@ module CeedlingTasks
     def new(dest=nil)
       require 'version' # lib/version.rb for TAG constant
 
-      # Get unfrozen copies so we can add / modify
+      # Get an unfrozen copy so we can add / modify
       _options = options.dup()
-      _dest = dest.dup() if !dest.nil?
 
-      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : Verbosity::ERRORS
+      _options[:verbosity] = Verbosity::ERRORS
+      CliOptionsTransform.apply_debug_flag( _options )
 
-      @handler.new_project( ENV, @app_cfg, Ceedling::Version::TAG, _options, _dest )
+      @handler.new_project( ENV, @app_cfg, Ceedling::Version::TAG, _options, dest )
     end
+    # simplecov:enable line
 
+    # simplecov:disable line
     desc "upgrade PATH", "Upgrade vendored installation of Ceedling for a project at PATH"
     method_option :project, :type => :string, :default => DEFAULT_PROJECT_FILENAME, :lazy_default => CLI_MISSING_PARAMETER_DEFAULT, :desc => "Project filename"
     method_option :debug, :type => :boolean, :default => false, :hide => true
@@ -286,17 +290,18 @@ module CeedlingTasks
         "--project is missing a required filename parameter"
       )
 
-      # Get unfrozen copies so we can add / modify
+      # Get an unfrozen copy so we can add / modify
       _options = options.dup()
-      _options[:project] = options[:project].dup()
-      _path = path.dup()
 
-      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : Verbosity::ERRORS
+      _options[:verbosity] = Verbosity::ERRORS
+      CliOptionsTransform.apply_debug_flag( _options )
 
-      @handler.upgrade_project( ENV, @app_cfg, _options, _path )
+      @handler.upgrade_project( ENV, @app_cfg, _options, path )
     end
+    # simplecov:enable line
 
 
+    # simplecov:disable line
     desc "build [TASKS...]", "Run build tasks (`build` keyword not required)"
     method_option :project, :type => :string, :default => nil, :lazy_default => CLI_MISSING_PARAMETER_DEFAULT, :aliases => ['-p'], :desc => DOC_PROJECT_FLAG
     method_option :mixin, :type => :string, :default => [], :repeatable => true, :aliases => ['-m'], :desc => DOC_MIXIN_FLAG
@@ -312,6 +317,8 @@ module CeedlingTasks
                   :desc => "Filter for individual unit test names"
     method_option :exclude_test_case, :type => :string, :default => '', :lazy_default => CLI_MISSING_PARAMETER_DEFAULT,
                   :desc => "Prevent matched unit test names from running"
+    method_option :force_test_rerun, :type => :boolean, :default => false,
+                  :desc => "Run test executables and report fresh results even if unchanged"
     method_option :ruby_replacement, :type => :boolean, :default => false, :desc => DOC_RUBY_REPLACEMENT_FLAG
     # Include for consistency with other commands (override --verbosity)
     method_option :debug, :type => :boolean, :default => false, :hide => true
@@ -334,6 +341,11 @@ module CeedlingTasks
       • `--test-case` and its inverse `--exclude-test-case` set test case name
       matchers to run only a subset of the unit test suite. See docs for full details.
 
+      • `--force-test-rerun` runs test executables and reports fresh results
+      even when nothing changed since the last build. A test build with
+      `:unity` ↳ `:shuffle_tests` enabled does this automatically, since a
+      shuffled run order is only meaningful if the executable actually runs.
+
       • `If --log and --logfile are both specified, --logfile will set the log file path.
       If --no-log and --logfile are both specified, no logging will occur.
 
@@ -371,23 +383,22 @@ module CeedlingTasks
         "--exclude-test-case is missing a required test case name parameter"
       )
 
-      # Get unfrozen copies so we can add / modify
+      # Get an unfrozen copy so we can add / modify
       _options = options.dup()
-      _options[:project] = options[:project].dup() if !options[:project].nil?
-      _options[:mixin] = []
-      options[:mixin].each {|mixin| _options[:mixin] << mixin.dup() }
-      _options[:verbosity] = Verbosity::DEBUG if options[:debug]
-      _options[:logfile] = options[:logfile].dup()
+      CliOptionsTransform.apply_debug_flag( _options )
 
       @handler.build( env:ENV, app_cfg:@app_cfg, options:_options, tasks:tasks )
     end
+    # simplecov:enable line
 
 
-    desc "dumpconfig FILEPATH [SECTIONS...]", "Process project configuration and write final config to a YAML file"
+    # simplecov:disable line
+    desc "dumpconfig [FILEPATH] [SECTIONS...]", "Process project configuration and write final config to a YAML file"
     method_option :project, :type => :string, :default => nil, :lazy_default => CLI_MISSING_PARAMETER_DEFAULT, :aliases => ['-p'],
                   :desc => DOC_PROJECT_FLAG
     method_option :mixin, :type => :string, :default => [], :repeatable => true, :aliases => ['-m'], :desc => DOC_MIXIN_FLAG
     method_option :app, :type => :boolean, :default => true, :desc => "Runs Ceedling application and its config manipulations"
+    method_option :stdout, :type => :boolean, :default => false, :desc => "Write YAML to standard output instead of FILEPATH, for consuming tools"
     method_option :ruby_replacement, :type => :boolean, :default => false, :desc => DOC_RUBY_REPLACEMENT_FLAG
     method_option :debug, :type => :boolean, :default => false, :hide => true
     long_desc( CEEDLING_HANDOFF_OBJECTS[:loginator].sanitize(
@@ -395,7 +406,8 @@ module CeedlingTasks
       `ceedling dumpconfig` loads your project configuration, including all manipulations & merges,
       and writes the final config to a YAML file.
 
-      FILEPATH is a required path to a destination YAML file. A nonexistent path will be created.
+      FILEPATH is a required path to a destination YAML file unless `--stdout` is set. A
+      nonexistent path will be created.
 
       SECTIONS is an optional config “path” that extracts a portion of a configuration. The
       top-level YAML container will be the path’s last element.
@@ -410,29 +422,42 @@ module CeedlingTasks
       the configuration. Disabling it dumps project config after any mixins but before any
       application manipulations.
 
+      • `--stdout` writes the YAML directly to standard output instead of FILEPATH -- handy for a
+      consuming tool that wants Ceedling's resolved configuration without a temp file. Omit FILEPATH
+      when using this flag; any positional arguments given are treated as SECTIONS instead.
+      \x5> ceedling dumpconfig --stdout tools test_compiler
+
       • #{LONGDOC_RUBY_REPLACEMENT_FLAG}
       LONGDESC
     ) )
-    def dumpconfig(filepath, *sections)
+    def dumpconfig(filepath = nil, *sections)
       @handler.validate_string_param(
         options[:project],
         CLI_MISSING_PARAMETER_DEFAULT,
         "--project is missing a required filepath parameter"
       )
 
-      # Get unfrozen copies so we can add / modify
+      if options[:stdout]
+        # No destination-file slot to occupy in stdout mode -- every positional
+        # argument given is a section path element instead.
+        sections = [filepath, *sections].compact
+        filepath = nil
+      elsif filepath.nil?
+        raise Thor::Error.new("FILEPATH is a required parameter unless --stdout is set")
+      end
+
+      # Get an unfrozen copy so we can add / modify
       _options = options.dup()
-      _options[:project] = options[:project].dup() if !options[:project].nil?
-      _options[:mixin] = []
-      options[:mixin].each {|mixin| _options[:mixin] << mixin.dup() }
-      _filepath = filepath.dup()
 
-      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : Verbosity::ERRORS
+      _options[:verbosity] = Verbosity::ERRORS
+      CliOptionsTransform.apply_debug_flag( _options )
 
-      @handler.dumpconfig( ENV, @app_cfg, _options, _filepath, sections )
+      @handler.dumpconfig( ENV, @app_cfg, _options, filepath, sections )
     end
+    # simplecov:enable line
 
 
+    # simplecov:disable line
     desc "check", "Process project configuration with full logging"
     method_option :project, :type => :string, :default => nil, :lazy_default => CLI_MISSING_PARAMETER_DEFAULT, :aliases => ['-p'], :desc => DOC_PROJECT_FLAG
     method_option :mixin, :type => :string, :default => [], :repeatable => true, :aliases => ['-m'], :desc => DOC_MIXIN_FLAG
@@ -461,18 +486,18 @@ module CeedlingTasks
         "--project is missing a required filepath parameter"
       )
 
-      # Get unfrozen copies so we can add / modify
+      # Get an unfrozen copy so we can add / modify
       _options = options.dup()
-      _options[:project] = options[:project].dup() if !options[:project].nil?
-      _options[:mixin] = []
-      options[:mixin].each {|mixin| _options[:mixin] << mixin.dup() }
 
-      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : Verbosity::NORMAL
+      _options[:verbosity] = Verbosity::NORMAL
+      CliOptionsTransform.apply_debug_flag( _options )
 
       @handler.check( ENV, @app_cfg, _options )
     end
+    # simplecov:enable line
 
 
+    # simplecov:disable line
     desc "environment", "List all configured environment variable names with values."
     method_option :project, :type => :string, :default => nil, :lazy_default => CLI_MISSING_PARAMETER_DEFAULT, :aliases => ['-p'],
                   :desc => DOC_PROJECT_FLAG
@@ -497,18 +522,18 @@ module CeedlingTasks
         "--project is missing a required filepath parameter"
       )
 
-      # Get unfrozen copies so we can add / modify
+      # Get an unfrozen copy so we can add / modify
       _options = options.dup()
-      _options[:project] = options[:project].dup() if !options[:project].nil?
-      _options[:mixin] = []
-      options[:mixin].each {|mixin| _options[:mixin] << mixin.dup() }
 
-      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : Verbosity::ERRORS
+      _options[:verbosity] = Verbosity::ERRORS
+      CliOptionsTransform.apply_debug_flag( _options )
 
       @handler.environment( ENV, @app_cfg, _options )
     end
+    # simplecov:enable line
 
 
+    # simplecov:disable line
     desc "examples", "List available example projects"
     method_option :debug, :type => :boolean, :default => false, :hide => true
     long_desc( CEEDLING_HANDOFF_OBJECTS[:loginator].sanitize(
@@ -523,12 +548,14 @@ module CeedlingTasks
       # Get unfrozen copies so we can add / modify
       _options = options.dup()
 
-      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : nil
+      CliOptionsTransform.apply_debug_flag( _options )
 
       @handler.list_examples( ENV, @app_cfg, _options )
     end
+    # simplecov:enable line
 
 
+    # simplecov:disable line
     desc "example NAME [DEST]", "Create named example project in optional DEST path"
     method_option :local, :type => :boolean, :default => false, :desc => DOC_LOCAL_FLAG
     method_option :docs, :type => :boolean, :default => false, :desc => DOC_DOCS_FLAG
@@ -554,16 +581,17 @@ module CeedlingTasks
       LONGDESC
     ) )
     def example(name, dest=nil)
-      # Get unfrozen copies so we can add / modify
+      # Get an unfrozen copy so we can add / modify
       _options = options.dup()
-      _dest = dest.dup() if !dest.nil?
 
-      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : nil
+      CliOptionsTransform.apply_debug_flag( _options )
 
-      @handler.create_example( ENV, @app_cfg, _options, name, _dest )
+      @handler.create_example( ENV, @app_cfg, _options, name, dest )
     end
+    # simplecov:enable line
 
 
+    # simplecov:disable line
     desc "docs [DEST]", "Export documentation at optional destination (default is current directory)"
     long_desc( CEEDLING_HANDOFF_OBJECTS[:loginator].sanitize(
       <<-LONGDESC
@@ -577,8 +605,10 @@ module CeedlingTasks
       _dest = dest.dup() if !dest.nil?
       @handler.docs( @app_cfg, _dest )
     end
+    # simplecov:enable line
 
 
+    # simplecov:disable line
     desc "version", "Display version details of Ceedling components"
     long_desc( CEEDLING_HANDOFF_OBJECTS[:loginator].sanitize(
       <<-LONGDESC
@@ -609,6 +639,7 @@ module CeedlingTasks
     def version()
       @handler.version( ENV, @app_cfg )
     end
+    # simplecov:enable line
 
   end
 end

data/bin/cli_handler.rb

@@ -9,25 +9,25 @@ require 'thor'
 require 'mixins' # Built-in Mixins
 require 'ceedling/constants' # From Ceedling application
 require 'ceedling/rake_app/rake_task_registry' # From Ceedling application
-require 'versionator' # Outisde DIY context
+require 'versionator' # Outside DIY context
 
 class CliHandler
 
   DOCS_SUBDIR = 'docs'
 
-  constructor :configinator, :projectinator, :cli_helper, :path_validator, :rake_task_registry, :actions_wrapper, :loginator
+  constructor :composinator, :projectinator, :cli_helper, :path_validator, :rake_task_registry, :actionator, :loginator
 
   # Override to prevent exception handling from walking & stringifying the object variables.
   # Object variables are lengthy and produce a flood of output.
   def inspect
-    return this.class.name
+    return self.class.name
   end
 
 
   def setup()
     # Aliases
     @helper = @cli_helper
-    @actions = @actions_wrapper
+    @actions = @actionator
     @registry = @rake_task_registry
   end
 
@@ -47,18 +47,15 @@ class CliHandler
     # If help requested for a command, show it and skip listing build tasks
     if !command.nil?
       # Block handler
-      thor_help.call( command ) if block_given?
+      yield( command ) if block_given?
       return
     end
 
     # Display Thor-generated help listing
-    thor_help.call( command ) if block_given?
-
-    # If it was help for a specific command, we're done
-    return if !command.nil?
+    yield( command ) if block_given?
 
     # If project configuration is available, also display Rake tasks
-    @path_validator.standardize_paths( options[:project], *@helper.process_mixin_filepaths(options[:mixin]) )
+    options[:project], options[:mixin] = standardize_project_and_mixins( options[:project], options[:mixin] )
     if @projectinator.config_available?( filepath:options[:project], env:env )
       list_rake_tasks(
         env:env,
@@ -91,13 +88,15 @@ class CliHandler
   def new_project(env, app_cfg, ceedling_tag, options, dest)
     @helper.set_verbosity( options[:verbosity] )
 
-    @path_validator.standardize_paths( dest )
+    dest = @path_validator.standardize_paths( dest ).first
 
     # If destination is nil, assume it's the working directory
     dest ||= '.'
 
-    # Check for existing project (unless --force)
-    if @helper.project_exists?( dest, :|, DEFAULT_PROJECT_FILENAME, 'src', 'test' )
+    # Check for existing project (unless --force) -- #1250: either default project
+    # filename counts, so `ceedling new` doesn't silently overwrite an existing
+    # ceedling.yml-based project just because it's looking for project.yml.
+    if @helper.project_exists?( dest, :|, DEFAULT_PROJECT_FILENAME, ALTERNATE_PROJECT_FILENAME, 'src', 'test' )
       msg = "It appears a project already exists at \"#{dest}/\"! Use --force to destroy it and create a new project."
       raise msg
     end unless options[:force]
@@ -105,34 +104,34 @@ class CliHandler
     # Update app_cfg paths (ignore return values)
     @helper.which_ceedling?( env:env, app_cfg:app_cfg )
 
-    # Thor Actions for project tasks use paths in relation to this path
-    ActionsWrapper.source_root( app_cfg[:ceedling_root_path] )
+    # Source paths for project tasks resolve in relation to this path
+    @actions.source_root = app_cfg[:ceedling_root_path]
 
     # Blow away any existing directories and contents if --force
-    @actions.remove_dir( dest ) if options[:force]
+    @actions.remove_directory( dest ) if options[:force]
 
     # Create blank directory structure
     ['.', 'src', 'test', 'test/support'].each do |path|
-      @actions._empty_directory( File.join( dest, path) )
+      @actions.make_directory( File.join( dest, path) )
     end
 
     # Vendor the tools and install command line helper scripts
     @helper.vendor_tools( app_cfg[:ceedling_root_path], dest ) if options[:local]
 
     # Copy / set up project file
-    @helper.create_project_file( dest, options[:local], ceedling_tag ) if options[:configs]
+    @helper.create_project_file( dest, options[:local], ceedling_tag, ceedling_yml: options[:ceedling_yml] ) if options[:configs]
     
     # Copy in documentation
     @helper.copy_docs( app_cfg[:ceedling_root_path], File.join( dest, DOCS_SUBDIR ) ) if options[:docs]
 
     # Copy Git Ignore file 
     if options[:gitsupport]
-      @actions._copy_file(
-        File.join( 'assets', 'default_gitignore' ),
+      @actions.copy_file(
+        File.join( 'assets', 'features', 'default_gitignore' ),
         File.join( dest, '.gitignore' ),
-        :force => true
+        force: true
       )
-      @actions._touch_file( File.join( dest, 'test/support', '.gitkeep') )
+      @actions.touch_file( File.join( dest, 'test/support', '.gitkeep') )
     end
     
     @loginator.console( "\nNew project created at #{File.absolute_path(dest)}/\n", LogLabels::TITLE )
@@ -142,7 +141,7 @@ class CliHandler
   def upgrade_project(env, app_cfg, options, path)
     @helper.set_verbosity( options[:verbosity] )
 
-    @path_validator.standardize_paths( path, options[:project] )
+    path, options[:project] = @path_validator.standardize_paths( path, options[:project] )
 
     # Check for existing project
     if !@helper.project_exists?( path, :&, options[:project], 'vendor/ceedling/lib/version.rb' )
@@ -156,19 +155,19 @@ class CliHandler
       @loginator.console( msg, LogLabels::NOTICE )
     end
 
-    # Thor Actions for project tasks use paths in relation to this path
-    ActionsWrapper.source_root( app_cfg[:ceedling_root_path] )
+    # Source paths for project tasks resolve in relation to this path
+    @actions.source_root = app_cfg[:ceedling_root_path]
 
     # Recreate vendored tools
     vendor_path = File.join( path, 'vendor', 'ceedling' )
-    @actions.remove_dir( vendor_path )
+    @actions.remove_directory( vendor_path )
     @helper.vendor_tools( app_cfg[:ceedling_root_path], path )
 
     # Recreate documentation if we find docs/ subdirectory
     docs_path = File.join( path, 'docs' )
     founds_docs = @helper.project_exists?( path, :&, File.join( 'docs', 'CeedlingPacket.md' ) )
     if founds_docs
-      @actions.remove_dir( docs_path )
+      @actions.remove_directory( docs_path )
       @helper.copy_docs( app_cfg[:ceedling_root_path], File.join( path, DOCS_SUBDIR ) )
     end
 
@@ -183,9 +182,10 @@ class CliHandler
     @helper.set_verbosity( _verbosity, override: false )
     @helper.set_ruby_replacement( options[:ruby_replacement] )
 
-    @path_validator.standardize_paths( options[:project], options[:logfile], *@helper.process_mixin_filepaths(options[:mixin]) )
+    options[:project], options[:mixin] = standardize_project_and_mixins( options[:project], options[:mixin] )
+    options[:logfile] = @path_validator.standardize_paths( options[:logfile] ).first
 
-    _, config = @configinator.loadinate( builtin_mixins:BUILTIN_MIXINS, builtin_load_paths:BUILTIN_MIXIN_LOAD_PATHS, filepath:options[:project], mixins:options[:mixin], env:env )
+    _, config = @composinator.loadinate( builtin_load_paths:BUILTIN_MIXIN_LOAD_PATHS, filepath:options[:project], mixins:options[:mixin], env:env )
 
     @cli_helper.log_project_name( config )
 
@@ -194,7 +194,7 @@ class CliHandler
     # after all .rake files are loaded with constants fully resolved.
     @helper.build_rake_task_registry( config:config )
 
-    default_tasks = @configinator.default_tasks( config:config, default_tasks:app_cfg[:default_tasks] )
+    default_tasks = @composinator.default_tasks( config:config, default_tasks:app_cfg[:default_tasks] )
 
     @helper.process_testcase_filters(
       config: config,
@@ -204,6 +204,12 @@ class CliHandler
       default_tasks: default_tasks
     )
 
+    @helper.process_force_test_rerun(
+      force_test_rerun: options[:force_test_rerun],
+      tasks: tasks,
+      default_tasks: default_tasks
+    )
+
     logging_path = @helper.process_logging_path( config )
     log_filepath = @helper.process_log_filepath( logging_path, options[:log], options[:logfile] )
 
@@ -215,6 +221,7 @@ class CliHandler
     app_cfg.set_log_filepath( log_filepath )
     app_cfg.set_include_test_case( options[:test_case] )
     app_cfg.set_exclude_test_case( options[:exclude_test_case] )
+    app_cfg.set_force_test_rerun( options[:force_test_rerun] )
 
     # Set graceful_exit from command line & configuration options
     app_cfg.set_tests_graceful_fail(
@@ -275,17 +282,23 @@ class CliHandler
     @helper.set_verbosity( options[:verbosity] )
     @helper.set_ruby_replacement( options[:ruby_replacement] )
 
-    @path_validator.standardize_paths( filepath, options[:project], *@helper.process_mixin_filepaths(options[:mixin]) )
+    filepath = @path_validator.standardize_paths( filepath ).first
+    options[:project], options[:mixin] = standardize_project_and_mixins( options[:project], options[:mixin] )
 
-    _, config = @configinator.loadinate( builtin_mixins:BUILTIN_MIXINS, builtin_load_paths:BUILTIN_MIXIN_LOAD_PATHS, filepath:options[:project], mixins:options[:mixin], env:env )
+    _, config = @composinator.loadinate( builtin_load_paths:BUILTIN_MIXIN_LOAD_PATHS, filepath:options[:project], mixins:options[:mixin], env:env )
 
-    @cli_helper.console_project_name( config )
+    # A nil filepath means --stdout was set -- the YAML itself is the only thing
+    # that may reach stdout in that case, for a consuming tool to parse cleanly,
+    # so every banner/notice below is skipped rather than interleaved into it.
+    stdout_mode = filepath.nil?
+
+    @cli_helper.console_project_name( config ) unless stdout_mode
 
     # Exception handling to ensure we dump the configuration regardless of config validation errors
     begin
       # If enabled, process the configuration through Ceedling automatic settings, defaults, plugins, etc.
       if options[:app]
-        default_tasks = @configinator.default_tasks( config:config, default_tasks:app_cfg[:default_tasks] )
+        default_tasks = @composinator.default_tasks( config:config, default_tasks:app_cfg[:default_tasks] )
 
         # Save references
         app_cfg.set_project_config( config )
@@ -293,18 +306,18 @@ class CliHandler
 
         _, path = @helper.which_ceedling?( env:env, config:config, app_cfg:app_cfg )
 
-        config = @helper.load_ceedling( 
+        config = @helper.load_ceedling(
           config: config,
           rakefile_path: path,
           default_tasks: default_tasks
         )
       else
-        @loginator.console( " > Skipped loading Ceedling application" )
+        @loginator.console( " > Skipped loading Ceedling application" ) unless stdout_mode
       end
     ensure
       @helper.dump_yaml( config, filepath, sections )
 
-      @loginator.console( "\nDumped project configuration to #{filepath}\n", LogLabels::TITLE )      
+      @loginator.console( "\nDumped project configuration to #{filepath}\n", LogLabels::TITLE ) unless stdout_mode
     end
   end
 
@@ -314,13 +327,13 @@ class CliHandler
     @helper.set_verbosity( options[:verbosity] )
     @helper.set_ruby_replacement( options[:ruby_replacement] )
 
-    @path_validator.standardize_paths( options[:project], *@helper.process_mixin_filepaths(options[:mixin]) )
+    options[:project], options[:mixin] = standardize_project_and_mixins( options[:project], options[:mixin] )
 
-    _, config = @configinator.loadinate( builtin_mixins:BUILTIN_MIXINS, builtin_load_paths:BUILTIN_MIXIN_LOAD_PATHS, filepath:options[:project], mixins:options[:mixin], env:env )
+    _, config = @composinator.loadinate( builtin_load_paths:BUILTIN_MIXIN_LOAD_PATHS, filepath:options[:project], mixins:options[:mixin], env:env )
 
     @cli_helper.log_project_name( config )
 
-    default_tasks = @configinator.default_tasks( config:config, default_tasks:app_cfg[:default_tasks] )
+    default_tasks = @composinator.default_tasks( config:config, default_tasks:app_cfg[:default_tasks] )
 
     # Save references; explicitly disable log file output
     app_cfg.set_project_config( config )
@@ -345,9 +358,9 @@ class CliHandler
     @helper.set_verbosity( options[:verbosity] )
     @helper.set_ruby_replacement( options[:ruby_replacement] )
 
-    @path_validator.standardize_paths( options[:project], *@helper.process_mixin_filepaths(options[:mixin]) )
+    options[:project], options[:mixin] = standardize_project_and_mixins( options[:project], options[:mixin] )
 
-    _, config = @configinator.loadinate( builtin_mixins:BUILTIN_MIXINS, builtin_load_paths:BUILTIN_MIXIN_LOAD_PATHS, filepath:options[:project], mixins:options[:mixin], env:env )
+    _, config = @composinator.loadinate( builtin_load_paths:BUILTIN_MIXIN_LOAD_PATHS, filepath:options[:project], mixins:options[:mixin], env:env )
 
     @cli_helper.console_project_name( config )
 
@@ -372,10 +385,10 @@ class CliHandler
     end
 
     # Process environment created by configuration
-    config[:environment].each do |env|
-      env.each_key do |key|
+    config[:environment].each do |section|
+      section.each_key do |key|
         name = key.to_s.upcase
-        env_list << "#{name}: \"#{env[key]}\""
+        env_list << "#{name}: \"#{section[key]}\""
       end
     end
 
@@ -424,7 +437,7 @@ class CliHandler
   def create_example(env, app_cfg, options, name, dest)
     @helper.set_verbosity( options[:verbosity] )
 
-    @path_validator.standardize_paths( dest )
+    dest = @path_validator.standardize_paths( dest ).first
 
     # Process which_ceedling for app_cfg modifications but ignore return values
     @helper.which_ceedling?( env:env, app_cfg:app_cfg )
@@ -445,14 +458,14 @@ class CliHandler
     dest_project  = File.join( dest, DEFAULT_PROJECT_FILENAME )
     dest_readme   = File.join( dest, 'README.md' )
 
-    # Thor Actions for project tasks use paths in relation to this path
-    ActionsWrapper.source_root( app_cfg[:ceedling_root_path] )
+    # Source paths for project tasks resolve in relation to this path
+    @actions.source_root = app_cfg[:ceedling_root_path]
 
-    @actions._directory( "examples/#{name}/src", dest_src, :force => true )
-    @actions._directory( "examples/#{name}/test", dest_test, :force => true )
-    @actions._directory( "examples/#{name}/mixin", dest_mixin, :force => true )
-    @actions._copy_file( "examples/#{name}/#{DEFAULT_PROJECT_FILENAME}", dest_project, :force => true )
-    @actions._copy_file( "examples/#{name}/README.md", dest_readme, :force => true )
+    @actions.copy_directory( "examples/#{name}/src", dest_src, force: true )
+    @actions.copy_directory( "examples/#{name}/test", dest_test, force: true )
+    @actions.copy_directory( "examples/#{name}/mixin", dest_mixin, force: true )
+    @actions.copy_file( "examples/#{name}/#{DEFAULT_PROJECT_FILENAME}", dest_project, force: true )
+    @actions.copy_file( "examples/#{name}/README.md", dest_readme, force: true )
 
     # Vendor the tools and install command line helper scripts
     @helper.vendor_tools( app_cfg[:ceedling_root_path], dest ) if options[:local]
@@ -473,8 +486,8 @@ class CliHandler
 
 
   def docs(app_cfg, dest)
-    # Thor Actions file operations require an anchored source root
-    ActionsWrapper.source_root( app_cfg[:ceedling_root_path] )
+    # File operations require an anchored source root
+    @actions.source_root = app_cfg[:ceedling_root_path]
 
     # Default to current working directory when no destination is given
     dest ||= '.'
@@ -547,10 +560,29 @@ class CliHandler
 
   private
 
+  # Standardizes a project filepath and a mixins list together. PathValidator's
+  # standardize_paths() returns new values rather than updating its arguments in
+  # place, so the mixins list can't just be passed through it directly -- inline
+  # YAML mixin entries aren't filepaths at all and must be left untouched, and
+  # only the filepath/name entries come back out standardized.
+  #
+  # Entries are matched by value. standardize_paths() is a pure mapping, so two
+  # equal inputs always produce equal outputs and a repeated mixin value gets the
+  # same replacement either way.
+  def standardize_project_and_mixins(project, mixins)
+    _project = @path_validator.standardize_paths( project ).first
+
+    file_mixins = @helper.process_mixin_filepaths( mixins )
+    standardized = @path_validator.standardize_paths( *file_mixins )
+    replacements = file_mixins.zip( standardized ).to_h
+    _mixins = mixins.map {|m| replacements.fetch( m, m ) }
+
+    return _project, _mixins
+  end
+
   def list_rake_tasks(env:, app_cfg:, filepath:nil, mixins:[], silent:false)
     _, config = 
-      @configinator.loadinate(
-        builtin_mixins:BUILTIN_MIXINS,
+      @composinator.loadinate(
         builtin_load_paths:BUILTIN_MIXIN_LOAD_PATHS,
         filepath: filepath,
         mixins: mixins,