ceedling 1.0.1 → 1.1.0

data/assets/tests_with_encoding/test/test_unicoder_partial.c

@@ -0,0 +1,17 @@
+/* =========================================================================
+ * Partials Test — © 2024 Ünïcödé Corp. Tous droits réservés.
+ * Tests unicoder module directly via Ceedling Partials (no mock).
+ * unicoder.c is compiled into this test build as a partial module,
+ * exercising Ceedling's encoding-safe partial source preprocessing path.
+ * ========================================================================= */
+
+#include "unity.h"
+#include "ceedling.h"
+
+#include TEST_PARTIAL_ALL_MODULE(unicoder)
+
+/* Verify that the real unicoder_greet() returns the expected value — no mock. */
+void test_unicoder_greet_is_five_via_partials(void)
+{
+    TEST_ASSERT_EQUAL(5, unicoder_greet());
+}

data/assets/tests_with_fallback_conditionals/src/conditional_module.c

@@ -0,0 +1,18 @@
+/* =========================================================================
+ * Conditional Module implementation — © 2024 résumé.
+ * ========================================================================= */
+
+#include "conditional_module.h"
+
+/* Include optional dependency only when feature enabled — naïve guard. */
+#ifdef CONDITIONAL_FEATURE
+#include "optional_dep.h"
+#endif
+
+void ConditionalModule_Init(void)
+{
+  /* Call optional dep only when feature active — Ünïcödé-safe comment. */
+#ifdef CONDITIONAL_FEATURE
+  OptionalDep_DoWork();
+#endif
+}

data/assets/tests_with_fallback_conditionals/src/conditional_module.h

@@ -0,0 +1,13 @@
+/* =========================================================================
+ * Conditional Module — © 2024 résumé functionality.
+ * This file intentionally contains non-ASCII UTF-8 characters in comments
+ * to exercise encoding-safe fallback preprocessing near #ifdef directives.
+ * ========================================================================= */
+
+#ifndef CONDITIONAL_MODULE_H
+#define CONDITIONAL_MODULE_H
+
+/* Module init — Ünïcödé safe. */
+void ConditionalModule_Init(void);
+
+#endif /* CONDITIONAL_MODULE_H */

data/assets/tests_with_fallback_conditionals/src/optional_dep.h

@@ -0,0 +1,12 @@
+/* =========================================================================
+ * Optional Dependency — Ünïcödé comment © 2024.
+ * This header is only included when CONDITIONAL_FEATURE is defined.
+ * ========================================================================= */
+
+#ifndef OPTIONAL_DEP_H
+#define OPTIONAL_DEP_H
+
+/* Do the optional work — naïve implementation. */
+void OptionalDep_DoWork(void);
+
+#endif /* OPTIONAL_DEP_H */

data/assets/tests_with_fallback_conditionals/test/test_conditionals.c

@@ -0,0 +1,49 @@
+/* =========================================================================
+ * Test: Conditional Module — © 2024 résumé testing.
+ * Uses Ceedling Partials to test conditional_module directly via its
+ * source file. The #ifdef CONDITIONAL_FEATURE guards in conditional_module.c
+ * control what code appears in the partial implementation: with the feature
+ * active, ConditionalModule_Init() calls OptionalDep_DoWork(); without it,
+ * the function is a no-op. The test mirrors this condition to include the
+ * mock and select the appropriate test case.
+ * ========================================================================= */
+
+#include "unity.h"
+#include "ceedling.h"
+
+/* Include mock only when feature active — mock needed because the partial
+ * implementation calls OptionalDep_DoWork() inside #ifdef CONDITIONAL_FEATURE.
+ * Ünïcödé comment © */
+#ifdef CONDITIONAL_FEATURE
+#include "mock_optional_dep.h"
+#endif
+
+/* Pull in the partial implementation of conditional_module */
+#include TEST_PARTIAL_ALL_MODULE(conditional_module)
+
+void setUp(void)
+{
+}
+
+void tearDown(void)
+{
+}
+
+/* Test with feature enabled: partial includes OptionalDep_DoWork() call — naïve test. */
+#ifdef CONDITIONAL_FEATURE
+void test_init_calls_optional_dep(void)
+{
+  OptionalDep_DoWork_Expect();
+  ConditionalModule_Init();
+}
+#endif
+
+/* Test without feature: partial excludes the optional dep call; init is a no-op. */
+#ifndef CONDITIONAL_FEATURE
+void test_init_succeeds_without_feature(void)
+{
+  ConditionalModule_Init();
+  /* No mock interaction expected — partial contains no OptionalDep_DoWork() call. */
+  TEST_PASS_MESSAGE("Init succeeded without optional feature");
+}
+#endif

data/assets/tests_with_preprocessing/src/adc_hardwareA.c

@@ -1,7 +1,7 @@
 /* =========================================================================
     Ceedling - Test-Centered Build System for C
     ThrowTheSwitch.org
-    Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
     SPDX-License-Identifier: MIT
 ========================================================================= */
 

data/assets/tests_with_preprocessing/src/adc_hardwareA.h

@@ -1,7 +1,7 @@
 /* =========================================================================
     Ceedling - Test-Centered Build System for C
     ThrowTheSwitch.org
-    Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
     SPDX-License-Identifier: MIT
 ========================================================================= */
 

data/assets/tests_with_preprocessing/src/adc_hardwareB.c

@@ -1,7 +1,7 @@
 /* =========================================================================
     Ceedling - Test-Centered Build System for C
     ThrowTheSwitch.org
-    Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
     SPDX-License-Identifier: MIT
 ========================================================================= */
 

data/assets/tests_with_preprocessing/src/adc_hardwareB.h

@@ -1,7 +1,7 @@
 /* =========================================================================
     Ceedling - Test-Centered Build System for C
     ThrowTheSwitch.org
-    Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
     SPDX-License-Identifier: MIT
 ========================================================================= */
 

data/assets/tests_with_preprocessing/src/adc_hardwareC.c

@@ -1,7 +1,7 @@
 /* =========================================================================
     Ceedling - Test-Centered Build System for C
     ThrowTheSwitch.org
-    Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
     SPDX-License-Identifier: MIT
 ========================================================================= */
 

data/assets/tests_with_preprocessing/src/adc_hardwareC.h

@@ -1,7 +1,7 @@
 /* =========================================================================
     Ceedling - Test-Centered Build System for C
     ThrowTheSwitch.org
-    Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
     SPDX-License-Identifier: MIT
 ========================================================================= */
 

data/assets/tests_with_preprocessing/src/adc_hardware_configuratorA.h

@@ -1,7 +1,7 @@
 /* =========================================================================
     Ceedling - Test-Centered Build System for C
     ThrowTheSwitch.org
-    Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
     SPDX-License-Identifier: MIT
 ========================================================================= */
 

data/assets/tests_with_preprocessing/src/adc_hardware_configuratorB.h

@@ -1,7 +1,7 @@
 /* =========================================================================
     Ceedling - Test-Centered Build System for C
     ThrowTheSwitch.org
-    Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
     SPDX-License-Identifier: MIT
 ========================================================================= */
 

data/assets/tests_with_preprocessing/src/adc_hardware_configuratorC.h

@@ -1,7 +1,7 @@
 /* =========================================================================
     Ceedling - Test-Centered Build System for C
     ThrowTheSwitch.org
-    Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
     SPDX-License-Identifier: MIT
 ========================================================================= */
 

data/assets/tests_with_preprocessing/test/test_adc_hardwareA.c

@@ -1,7 +1,7 @@
 /* =========================================================================
     Ceedling - Test-Centered Build System for C
     ThrowTheSwitch.org
-    Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
     SPDX-License-Identifier: MIT
 ========================================================================= */
 

data/assets/tests_with_preprocessing/test/test_adc_hardwareB.c

@@ -1,7 +1,7 @@
 /* =========================================================================
     Ceedling - Test-Centered Build System for C
     ThrowTheSwitch.org
-    Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
     SPDX-License-Identifier: MIT
 ========================================================================= */
 

data/assets/tests_with_preprocessing/test/test_adc_hardwareC.c

@@ -1,7 +1,7 @@
 /* =========================================================================
     Ceedling - Test-Centered Build System for C
     ThrowTheSwitch.org
-    Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
     SPDX-License-Identifier: MIT
 ========================================================================= */
 

data/assets/uncovered_example_file.c

@@ -1,7 +1,7 @@
 /* =========================================================================
     Ceedling - Test-Centered Build System for C
     ThrowTheSwitch.org
-    Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+    Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
     SPDX-License-Identifier: MIT
 ========================================================================= */
 

data/bin/actions_wrapper.rb

@@ -1,7 +1,7 @@
 # =========================================================================
 #   Ceedling - Test-Centered Build System for C
 #   ThrowTheSwitch.org
-#   Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
 #   SPDX-License-Identifier: MIT
 # =========================================================================
 

data/bin/app_cfg.rb

@@ -1,7 +1,7 @@
 # =========================================================================
 #   Ceedling - Test-Centered Build System for C
 #   ThrowTheSwitch.org
-#   Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
 #   SPDX-License-Identifier: MIT
 # =========================================================================
 

data/bin/ceedling

@@ -21,8 +21,11 @@ CEEDLING_APPCFG = CeedlingAppConfig.new()
 # Add load paths for `require 'ceedling/*'` statements in bin/ code
 $LOAD_PATH.unshift( CEEDLING_APPCFG[:ceedling_lib_base_path] )
 
-require 'constructor'  # Assumed installed via Ceedling gem dependencies
+# Assumed installed via Ceedling gem dependencies
+require 'constructor'
+# Commonly needed modules
 require 'ceedling/constants'
+require 'ceedling/array_patches' # intersect?() + overlap?()
 
 # Centralized exception handler for:
 #  1. Bootloader (bin/)
@@ -56,8 +59,14 @@ begin
   #  4. Perform object construction + dependency injection from bin/objects.yml
   #  5. Remove all paths added to $LOAD_PATH
   #     (Main application will restore certain paths -- possibly updated by :which_ceedling)
-  $LOAD_PATH.unshift( 
+  $LOAD_PATH.unshift(
+    # lib/ceedling for base of any require statements
     CEEDLING_APPCFG[:ceedling_lib_path],
+    # Add lib/ceedling/config to load configuration handling utils
+    File.join( CEEDLING_APPCFG[:ceedling_lib_path], 'config' ),
+    # Add lib/ceedling/rake_app to load Rake application handling code
+    File.join( CEEDLING_APPCFG[:ceedling_lib_path], 'rake_app' ),
+    # DIY vendored path
     diy_vendor_path
   )
 
@@ -71,9 +80,12 @@ begin
   # This prevents double instantiation and preserves object state in handoff
   handoff_objects = {}
   handoff = [
+    :rake_task_registry,
+    :reportinator,
     :loginator,
     :file_wrapper,
     :yaml_wrapper,
+    :ruby_expandinator,
     :config_walkinator,
     :system_wrapper,
     :verbosinator
@@ -88,7 +100,6 @@ begin
   require 'cli'
   
   # Remove all load paths we've relied on (main application will set up load paths again)
-  $LOAD_PATH.delete( ceedling_bin_path )
   $LOAD_PATH.delete( CEEDLING_APPCFG[:ceedling_lib_path] )
   $LOAD_PATH.delete( diy_vendor_path )
 

data/bin/cli.rb

@@ -1,7 +1,7 @@
 # =========================================================================
 #   Ceedling - Test-Centered Build System for C
 #   ThrowTheSwitch.org
-#   Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   Copyright (c) 2010-26 Mike Karlesky, Mark VanderVoord, & Greg Williams
 #   SPDX-License-Identifier: MIT
 # =========================================================================
 
@@ -116,7 +116,6 @@ end
 module CeedlingTasks
 
   VERBOSITY_NORMAL = 'normal'
-  VERBOSITY_DEBUG = 'debug'
 
   DOC_LOCAL_FLAG = "Install Ceedling plus supporting tools to vendor/"
 
@@ -124,19 +123,28 @@ module CeedlingTasks
 
   DOC_PROJECT_FLAG = "Loads the filepath as your base project configuration"
 
-  DOC_MIXIN_FLAG = "Merges the configuration mixin by name or filepath."
+  DOC_MIXIN_FLAG = "Merges the configuration mixin by name, filepath, or inline YAML (= sigil)."
 
-  LONGDOC_LOCAL_FLAG = "`--local` copies Ceedling and its dependencies to a vendor/ 
-    subdirectory in the root of the project. It also installs a 
-    platform-appropriate executable script `ceedling` at the root of the 
+  DOC_RUBY_REPLACEMENT_FLAG = "Enables inline Ruby string expansion (\#{...}) in project configuration"
+
+  LONGDOC_LOCAL_FLAG = "`--local` copies Ceedling and its dependencies to a vendor/
+    subdirectory in the root of the project. It also installs a
+    platform-appropriate executable script `ceedling` at the root of the
     project."
 
-  LONGDOC_MIXIN_FLAG = "`--mixin` merges the specified configuration mixin. This 
-    flag may be repeated for multiple mixins. A simple mixin name initiates a 
-    lookup from within mixin load paths in your project file and among built-in 
-    mixins. A filepath and/or filename (with extension) will instead merge the 
-    specified YAML file. See documentation for complete details.
-    \x5> --mixin my_compiler --mixin my/path/mixin.yml"
+  LONGDOC_MIXIN_FLAG = "`--mixin` merges the specified configuration mixin. This
+    flag may be repeated for multiple mixins and is processed left-to-right
+    (rightmost is final merge).
+    Three forms are accepted:
+    \x5 1. A simple name for a lookup within configured mixin load paths.
+    \x5 2. A filepath (with extension or path separator) loads and merges the
+    specified YAML file.
+    \x5 3. Inline YAML merged directly (denoted by `=` sigil prefix).
+    See documentation for complete details.
+    \x5> --mixin my_compiler --mixin my/path/mixin.yml --mixin \"=defines: {release: ['MY_SYMBOL']}\""
+
+  LONGDOC_RUBY_REPLACEMENT_FLAG = "`--ruby-replacement` enables inline Ruby code expansion
+    (`\#{...}`) in project configuration values. Disabled by default for security."
 
   # Intentionally disallowed Linux/Unix/Windows filename characters to minimize the chance
   # of mistakenly filtering various string-base flags missing a parmeter
@@ -170,22 +178,25 @@ module CeedlingTasks
     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
     method_option :mixin, :type => :string, :default => [], :repeatable => true, :aliases => ['-m'], :desc => DOC_MIXIN_FLAG
+    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(
       <<-LONGDESC
-      `ceedling help` provides summary help for all available application commands 
+      `ceedling help` provides summary help for all available application commands
       and build tasks.
 
       COMMAND is optional and will produce detailed help for a specific application command --
       not a build or plugin task, however.
 
-      `ceedling help` also lists the available build operations from loading your 
-      project configuration. Optionally, a project filepath and/or mixins may be 
+      `ceedling help` also lists the available build operations from loading your
+      project configuration. Optionally, a project filepath and/or mixins may be
       provided to load a different project configuration than the default.
 
       Notes on Optional Flags:
 
       • #{LONGDOC_MIXIN_FLAG}
+
+      • #{LONGDOC_RUBY_REPLACEMENT_FLAG}
       LONGDESC
     ) )
     def help(command=nil)
@@ -201,14 +212,13 @@ module CeedlingTasks
       _options[:mixin] = []
       options[:mixin].each {|mixin| _options[:mixin] << mixin.dup() }
 
-      _options[:verbosity] = options[:debug] ? VERBOSITY_DEBUG : nil
-
+      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : Verbosity::ERRORS
       # 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
 
-
-    desc "new NAME [DEST]", "Create a new project structure at optional DEST path"
+ 
+    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"
@@ -219,10 +229,8 @@ module CeedlingTasks
       <<-LONGDESC
       `ceedling new` creates a new project structure.
 
-      NAME is required and will be the containing directory for the new project.
-
-      DEST is an optional directory path for the new project (e.g. <DEST>/<name>).
-      The default is your working directory. Nonexistent paths will be created.
+      DEST is an optional root path for the new project (e.g. <DEST>/project.yml).
+      The default is your working directory. Non-existent paths will be created.
 
       Notes on Optional Flags:
 
@@ -232,16 +240,16 @@ module CeedlingTasks
       new project.
       LONGDESC
     ) )
-    def new(name, dest=nil)
+    def new(dest=nil)
       require 'version' # lib/version.rb for TAG constant
 
       # Get unfrozen copies so we can add / modify
       _options = options.dup()
       _dest = dest.dup() if !dest.nil?
 
-      _options[:verbosity] = options[:debug] ? VERBOSITY_DEBUG : nil
+      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : Verbosity::ERRORS
 
-      @handler.new_project( ENV, @app_cfg, Ceedling::Version::TAG, _options, name, _dest )
+      @handler.new_project( ENV, @app_cfg, Ceedling::Version::TAG, _options, _dest )
     end
 
     desc "upgrade PATH", "Upgrade vendored installation of Ceedling for a project at PATH"
@@ -283,7 +291,7 @@ module CeedlingTasks
       _options[:project] = options[:project].dup()
       _path = path.dup()
 
-      _options[:verbosity] = options[:debug] ? VERBOSITY_DEBUG : nil
+      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : Verbosity::ERRORS
 
       @handler.upgrade_project( ENV, @app_cfg, _options, _path )
     end
@@ -304,6 +312,7 @@ 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 :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
     long_desc( CEEDLING_HANDOFF_OBJECTS[:loginator].sanitize(
@@ -315,18 +324,20 @@ module CeedlingTasks
       \x5    > ceedling build test:all
 
       TASKS are zero or more build operations created from your project configuration.
-      If no tasks are provided, built-in default tasks or your :project ↳ 
+      If no tasks are provided, built-in default tasks or your :project ↳
       :default_tasks will be executed.
 
       Notes on Optional Flags:
 
       • #{LONGDOC_MIXIN_FLAG}
 
-      • `--test-case` and its inverse `--exclude-test-case` set test case name 
+      • `--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.
 
       • `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.
+
+      • #{LONGDOC_RUBY_REPLACEMENT_FLAG}
       LONGDESC
     ) )
     def build(*tasks)
@@ -365,7 +376,7 @@ module CeedlingTasks
       _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[:verbosity] = Verbosity::DEBUG if options[:debug]
       _options[:logfile] = options[:logfile].dup()
 
       @handler.build( env:ENV, app_cfg:@app_cfg, options:_options, tasks:tasks )
@@ -377,6 +388,7 @@ module CeedlingTasks
                   :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 :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(
       <<-LONGDESC
@@ -385,8 +397,8 @@ module CeedlingTasks
 
       FILEPATH is a required path to a destination YAML file. 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. 
+      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.
       The following example will produce config.yml containing ':test_compiler: {...}'.
       \x5> ceedling dumpconfig my/path/config.yml tools test_compiler
 
@@ -394,9 +406,11 @@ module CeedlingTasks
 
       • #{LONGDOC_MIXIN_FLAG}
 
-      • `--app` loads various settings, merges defaults, loads plugin config changes, and validates 
-      the configuration. Disabling it dumps project config after any mixins but before any 
+      • `--app` loads various settings, merges defaults, loads plugin config changes, and validates
+      the configuration. Disabling it dumps project config after any mixins but before any
       application manipulations.
+
+      • #{LONGDOC_RUBY_REPLACEMENT_FLAG}
       LONGDESC
     ) )
     def dumpconfig(filepath, *sections)
@@ -413,16 +427,57 @@ module CeedlingTasks
       options[:mixin].each {|mixin| _options[:mixin] << mixin.dup() }
       _filepath = filepath.dup()
 
-      _options[:verbosity] = options[:debug] ? VERBOSITY_DEBUG : nil
+      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : Verbosity::ERRORS
 
       @handler.dumpconfig( ENV, @app_cfg, _options, _filepath, sections )
     end
 
 
+    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
+    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(
+      <<-LONGDESC
+      `ceedling check` loads and processes your project configuration with full
+      logging — the same loading, merging, manipulation, and validation a real
+      build would perform — but executes no build tasks and writes no files.
+
+      Use `check` to confirm a configuration is well-formed and to see all startup
+      logging, including which project file and Mixins were loaded and in what order.
+
+      Notes on Optional Flags:
+
+      • #{LONGDOC_MIXIN_FLAG}
+
+      • #{LONGDOC_RUBY_REPLACEMENT_FLAG}
+      LONGDESC
+    ) )
+    def check()
+      @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
+      _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
+
+      @handler.check( ENV, @app_cfg, _options )
+    end
+
+
     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
     method_option :mixin, :type => :string, :default => [], :repeatable => true, :aliases => ['-m'], :desc => DOC_MIXIN_FLAG
+    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(
       <<-LONGDESC
@@ -431,6 +486,8 @@ module CeedlingTasks
       Notes on Optional Flags:
 
       • #{LONGDOC_MIXIN_FLAG}
+
+      • #{LONGDOC_RUBY_REPLACEMENT_FLAG}
       LONGDESC
     ) )
     def environment()
@@ -446,7 +503,7 @@ module CeedlingTasks
       _options[:mixin] = []
       options[:mixin].each {|mixin| _options[:mixin] << mixin.dup() }
 
-      _options[:verbosity] = options[:debug] ? VERBOSITY_DEBUG : nil
+      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : Verbosity::ERRORS
 
       @handler.environment( ENV, @app_cfg, _options )
     end
@@ -466,7 +523,7 @@ module CeedlingTasks
       # Get unfrozen copies so we can add / modify
       _options = options.dup()
 
-      _options[:verbosity] = options[:debug] ? VERBOSITY_DEBUG : nil
+      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : nil
 
       @handler.list_examples( ENV, @app_cfg, _options )
     end
@@ -501,12 +558,27 @@ module CeedlingTasks
       _options = options.dup()
       _dest = dest.dup() if !dest.nil?
 
-      _options[:verbosity] = options[:debug] ? VERBOSITY_DEBUG : nil
+      _options[:verbosity] = options[:debug] ? Verbosity::DEBUG : nil
 
       @handler.create_example( ENV, @app_cfg, _options, name, _dest )
     end
 
 
+    desc "docs [DEST]", "Export documentation at optional destination (default is current directory)"
+    long_desc( CEEDLING_HANDOFF_OBJECTS[:loginator].sanitize(
+      <<-LONGDESC
+      `ceedling docs` exports the Ceedling documentation bundle to the filesystem.
+
+      DEST is an optional destination path (e.g. <DEST>/).
+      The default is your working directory. A nonexistent path will be created.
+      LONGDESC
+    ) )
+    def docs(dest=nil)
+      _dest = dest.dup() if !dest.nil?
+      @handler.docs( @app_cfg, _dest )
+    end
+
+
     desc "version", "Display version details of Ceedling components"
     long_desc( CEEDLING_HANDOFF_OBJECTS[:loginator].sanitize(
       <<-LONGDESC