ceedling 0.9.0 → 1.0.1

data/lib/ceedling/tool_executor_helper.rb

@@ -0,0 +1,107 @@
+# =========================================================================
+#   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' # for Verbosity enumeration & $stderr redirect enumeration
+
+##
+# Helper functions for the tool executor
+class ToolExecutorHelper
+
+  constructor :loginator, :system_utils, :system_wrapper, :verbosinator
+
+  ##
+  # Modifies an executables path based on platform.
+  # ==== Attributes
+  #
+  # * _executable_:  The executable's path.
+  #
+  def osify_path_separators(executable)
+    return executable.gsub(/\//, '\\') if (@system_wrapper.windows?)
+    return executable
+  end
+
+  ##
+  # Returns the stderr redirect append based on the config.
+  # ==== Attributes
+  #
+  # * _tool_config_:  A hash containing config information.
+  #
+  def stderr_redirect_cmdline_append(tool_config)
+    return nil if (tool_config.nil? || tool_config[:stderr_redirect].nil?)
+
+    config_redirect = tool_config[:stderr_redirect]
+    redirect        = StdErrRedirect::NONE
+
+    if (config_redirect == StdErrRedirect::AUTO)
+       if (@system_wrapper.windows?)
+         redirect = StdErrRedirect::WIN
+       elsif (@system_utils.tcsh_shell?)
+         redirect = StdErrRedirect::TCSH
+       else
+         redirect = StdErrRedirect::UNIX
+       end
+    end
+
+    case redirect
+      when StdErrRedirect::NONE then nil
+      when StdErrRedirect::WIN  then '2>&1'
+      when StdErrRedirect::UNIX then '2>&1'
+      when StdErrRedirect::TCSH then '|&'
+      else redirect.to_s
+    end
+  end
+
+  ##
+  # Logs tool execution results
+  # ==== Attributes
+  #
+  # * _command_str_:  The command ran.
+  # * _shell_results_:  The outputs of the command including exit code and output.
+  #
+  def log_results(command_str, shell_result)
+    # No logging unless we're at least at Obnoxious
+    return if !@verbosinator.should_output?( Verbosity::OBNOXIOUS )
+
+    output =      "> Shell executed command:\n"
+    output +=     "`#{command_str}`\n"
+
+    if !shell_result.empty?
+      # Detailed debug logging
+      if @verbosinator.should_output?( Verbosity::DEBUG )
+        output +=   "> With $stdout: "
+        output += shell_result[:stdout].empty? ? "<empty>\n" : "\n#{shell_result[:stdout].strip()}\n"
+
+        output +=   "> With $stderr: "
+        output += shell_result[:stderr].empty? ? "<empty>\n" : "\n#{shell_result[:stderr].strip()}\n"
+
+        output +=   "> And terminated with status: #{shell_result[:status]}\n"
+
+        @loginator.log( '', Verbosity::DEBUG )
+        @loginator.log( output, Verbosity::DEBUG )
+        @loginator.log( '', Verbosity::DEBUG )
+
+        return # Bail out
+      end
+
+      # Slightly less verbose obnoxious logging
+      if !shell_result[:output].empty?
+        output += "> Produced output: "
+        output += shell_result[:output].strip().empty? ? "<empty>\n" : "\n#{shell_result[:output].strip()}\n"
+      end
+
+      if !shell_result[:exit_code].nil?
+        output += "> And terminated with exit code: [#{shell_result[:exit_code]}]\n"
+      else
+        output += "> And exited prematurely\n"      
+      end
+    end
+
+    @loginator.log( '', Verbosity::OBNOXIOUS )
+    @loginator.log( output, Verbosity::OBNOXIOUS )
+    @loginator.log( '', Verbosity::OBNOXIOUS )
+  end
+end

data/lib/ceedling/tool_validator.rb

@@ -0,0 +1,149 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+require 'rake' # For ext()
+require 'ceedling/constants'
+require 'ceedling/tool_executor'    # For argument replacement pattern
+require 'ceedling/file_path_utils'  # For glob handling class methods
+
+
+class ToolValidator
+  
+  constructor :file_wrapper, :loginator, :system_wrapper, :reportinator
+
+  def validate(tool:, name:nil, extension:EXTENSION_EXECUTABLE, respect_optional:false, boom:false)
+    # Redefine name with name inside tool hash if it's not provided
+    # If the name is provided it's likely the formatted key path into the configuration file
+    name = tool[:name] if name.nil? or name.empty?
+
+    valid = true
+
+    valid &= validate_executable( tool:tool, name:name, extension:extension, respect_optional:respect_optional, boom:boom )
+    valid &= validate_stderr_redirect( tool:tool, name:name, boom:boom )
+
+    return valid
+  end
+
+  ### Private ###
+
+  private
+
+  def validate_executable(tool:, name:, extension:, respect_optional:, boom:)
+    exists = false
+    error = ''
+
+    # Get unfrozen copy so we can modify for our processing
+    executable = tool[:executable].dup()
+
+    # Handle a missing :executable
+    if (executable.nil? or executable.empty?)
+      error = "Tool #{name} is missing :executable in its configuration."
+      if !boom
+        @loginator.log( error, Verbosity::ERRORS )
+        return false 
+      end
+
+      raise CeedlingException.new(error)
+    end
+
+    # If tool is optional and we're respecting that, don't bother to check if executable is legit
+    return true if tool[:optional] and respect_optional
+
+    # Skip everything if we've got an argument replacement pattern or Ruby string replacement in :executable
+    # (Allow executable to be validated by shell at run time)
+    return true if (executable =~ PATTERNS::TOOL_EXECUTOR_ARGUMENT_REPLACEMENT)
+    return true if (executable =~ PATTERNS::RUBY_STRING_REPLACEMENT)
+
+    # Extract the executable (including optional filepath) apart from any additional arguments
+    # Be mindful of legal quote enclosures (e.g. `"Code Cruncher" foo bar`)
+    executable.strip!
+    if (matched = executable.match(/^"(.+)"/))
+      # If the regex matched, extract contents of match group within parens
+      executable = matched[1]
+    else
+      # Otherwise grab first token before arguments
+      executable = executable.split(' ')[0]
+    end
+
+    # If no path included, verify file exists in system search paths
+    if (not executable.include?('/'))      
+
+      # Iterate over search paths
+      @system_wrapper.search_paths.each do |path|
+        # File exists as named
+        if (@file_wrapper.exist?( File.join(path, executable)) )
+          exists = true
+          break
+        # File exists with executable file extension
+        elsif (@file_wrapper.exist?( (File.join(path, executable)).ext( extension ) ))
+          exists = true
+          break
+        # We're on Windows and file exists with .exe file extension
+        elsif (@system_wrapper.windows? and @file_wrapper.exist?( (File.join(path, executable)).ext( EXTENSION_WIN_EXE ) ))
+          exists = true
+          break
+        end
+      end
+
+      # Construct end of error message
+      error = "does not exist in system search paths" if not exists
+      
+    # If there is a path included, check that explicit filepath exists
+    else
+      if @file_wrapper.exist?( executable )
+        exists = true
+      else
+        # Construct end of error message
+        error = "does not exist on disk" if not exists
+      end      
+    end
+
+    if !exists
+      error = "#{name} ↳ :executable => `#{executable}` " + error
+    end
+
+    # Raise exception if executable can't be found and boom is set
+    if !exists and boom
+      raise CeedlingException.new( error )
+    end
+
+    # Otherwise, log error
+    if !exists
+      @loginator.log( error, Verbosity::ERRORS )
+    end
+
+    return exists
+  end
+  
+  def validate_stderr_redirect(tool:, name:, boom:)
+    error = ''
+    redirect = tool[:stderr_redirect]
+
+    # If no redirect set at all, it's cool
+    return if redirect.nil?
+
+    # Otherwise, process the redirect that's been set
+    if redirect.class == Symbol
+      if not StdErrRedirect.constants.map{|constant| constant.to_s}.include?( redirect.to_s.upcase )
+        options = StdErrRedirect.constants.map{|constant| ':' + constant.to_s.downcase}.join(', ')
+        error = "#{name} ↳ :stderr_redirect => :#{redirect} is not a recognized option {#{options}}"
+
+        # Raise exception if requested
+        raise CeedlingException.new( error ) if boom
+
+        # Otherwise log error
+        @loginator.log( error, Verbosity::ERRORS )
+        return false
+      end    
+    elsif redirect.class != String
+      raise CeedlingException.new( "#{name} ↳ :stderr_redirect is neither a recognized value nor custom string" )
+    end
+
+    return true
+  end
+  
+end

data/lib/ceedling/verbosinator.rb

@@ -0,0 +1,22 @@
+# =========================================================================
+#   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'
+
+class Verbosinator
+
+  def should_output?(level)
+    # Rely on global constant created at early stages of command line processing
+
+    if !defined?(PROJECT_VERBOSITY)
+      return (level <= Verbosity::NORMAL)
+    end
+
+    return (level <= PROJECT_VERBOSITY)
+  end
+
+end

data/lib/ceedling/yaml_wrapper.rb

@@ -0,0 +1,37 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+require 'yaml'
+require 'erb'
+
+
+class YamlWrapper
+
+  def load(filepath)
+    source = ERB.new(File.read(filepath)).result
+    begin
+      return YAML.load(source, aliases: true)
+    rescue ArgumentError
+      return YAML.load(source)
+    end
+  end
+
+  def load_string(source)
+    begin
+      return YAML.load(source, aliases: true)
+    rescue ArgumentError
+      return YAML.load(source)
+    end
+  end
+
+  def dump(filepath, structure)
+    File.open(filepath, 'w') do |output|
+      YAML.dump(structure, output)
+    end
+  end
+
+end

data/lib/ceedling.rb

@@ -1,6 +1,14 @@
-require "ceedling/version"
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+# This file exists solely for `require 'ceedling'` and any backwards compatibility.
+# All path loading and related is handled from bin/ceedling.
+# There is no shareable, library-worth code in lib/.
 
-# @private
 module Ceedling
-  NEW_PROJECT_DIR = "new_project_template"
-end
+  # Emtpy
+end

data/lib/version.rb

@@ -0,0 +1,24 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+##
+## version.rb is run as:
+##  1. An executable script for a Ceedling tag used in the release build process
+##     `ruby Ceedling/lib/version.rb`
+##  2. As a code module of constants consumed by Ruby's gem building process
+##
+
+module Ceedling
+  module Version
+    # Convenience constants for gem building, etc.
+    GEM = '1.0.1'
+    TAG = GEM
+
+    # If run as a script print Ceedling's version to $stdout
+    puts( TAG ) if (__FILE__ == $0)
+  end
+end

data/license.txt

@@ -0,0 +1,24 @@
+The MIT License (MIT)
+
+Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/plugins/beep/README.md

@@ -0,0 +1,133 @@
+# Ceedling Plugin: Beep
+
+Hear a useful beep at the end of a build.
+
+# Plugin Overview
+
+Are you getting too distracted surfing the internet, chatting with coworkers, or swordfighting while a long build runs? A friendly beep will let you know
+it's time to pay attention again.
+
+# Setup
+
+To use this plugin, it must be enabled:
+
+```yaml
+:plugins:
+  :enabled:
+    - beep
+```
+
+# Configuration
+
+Beep includes a default configuration. By just enabling the plugin, the simplest cross-platform sound mechanism (`:bell` below) is automatically enabled for both
+build completion and build error events.
+
+If you would like to customize your beeps, the following explains your options.
+
+## Events
+
+When this plugin is enabled, a beep is sounded when:
+
+* A test build or release build finish successfully.
+* An error condition breaks a build.
+
+To change the default sound for each event, define `:on_done` and `:on_error` beneath a top-level `:beep` entry in your configuration file. See example below.
+
+## Sound options
+
+The following options are fixed. At present, this plugin does not expose customization settings.
+
+* `:bell`
+
+  `:bell` is the simplest and most widely available option for beeping. This option simply `echo`s the unprintable [ASCII bell character][ascii-bel-character] to a command terminal. This option is generally available on all platforms, including Windows.
+
+  [ascii-bel-character]: https://en.wikipedia.org/wiki/Bell_character
+
+* `:tput`
+
+  [`tput`][tput] is a command line utility widely availble among Unix derivatives, including Linux and macOS. The `tput` utility uses the terminfo database to make the values of terminal-dependent capabilities (including the [ASCII bell character][ascii-bel-character]) and terminal information available to the shell.
+
+  If the `echo`-based method used by the `:bell` option is not successful, `:tput` is a good backup option (except on Windows).
+
+  [tput]: https://linux.die.net/man/1/tput
+
+* `:beep`
+
+  [`beep`][beep] is an old but widely available Linux package for tone generation using the PC speaker.
+
+  `beep` requires isntallation and the possibility of a complementary kernel module.
+
+  The original audio device in a PC before sound cards was a simple and limited speaker directly wired to a motherboard. Rarely, modern systems still have this device. More commonly, its functions are routed to a default mode of modern audio hardware. `beep` may not work on modern Linux systems. If it is a viable option, this utility is typically dependent on a PC speaker kernel module and related configuration.
+
+  [beep]: https://linux.die.net/man/1/beep
+
+* `:speaker_test`
+
+  [`speaker-test`][speaker-test] is a Linux package commonly available for tone generation using a system's audio features.
+
+  `speaker-test` requires installation as well as audio subsystem configuration.
+
+  _Note:_ `speaker-test` typically mandates a 4 second minimum run, even if the configured sound plays for less than this minimum. Options to limit `speaker-test`'s minimum time are likely possible but would require combining advanced Ceedling features.
+
+  [speaker-test]: https://linux.die.net/man/1/speaker-test
+
+* `:say`
+
+  macOS includes a built-in text-to-speech command line application, [`say`][say]. When Ceedling is running on macOS and this beep option is selected, Ceedling events will be verbally announced.
+
+  [say]: https://ss64.com/mac/say.html
+
+## Adding arguments to a beep tool
+
+Each of the sound options above map to a command line tool that Ceedling executes.
+
+The `:beep`, `:speaker_test`, and `:say` tools can accept additional command line arguments to modify their behavior and sound ouput.
+
+The `:speaker_test` tool is preconfigured with its `-t`, `-f`, and `-l` arguments to generate a 1 second 1000 Hz sine wave. Any additional arguments added through configuration will follow these (and could conflict).
+
+To add additional arguments, a feature of Ceedling's project file handling allows you to merge a partial tool definition with tools already fully defined.
+
+```yaml
+:tools_beep_<sound option>: # Fill in <sound option> as from the list above
+  :arguments:
+    - ...                   # Add any aguments as a list of strings
+```
+
+## Example beep configurations in YAML
+
+Enabling the plugin and event handlers with beep tool selections:
+
+```yaml
+:plugins:
+  :enabled:
+    - beep
+
+# The following is the default configuration.
+# It is shown for completeness, but it need not be duplicated in your project file 
+# if the default settings work for you.
+:beep:
+  :on_done: :bell
+  :on_error: :bell
+```
+
+Adding an argument to a beep tool:
+
+```yaml
+:plugins:
+  :enabled:
+    - beep
+
+:beep:
+  :on_done: :say # Choose the macOS `say` tool for build done events
+                 # `:bell` remains the default for :on_error:
+
+:tools_beep_say:
+  :arguments:
+    - -v daniel  # Change `say` command line to use Daniel voice
+
+```
+
+# Notes
+
+* Some terminal emulators intercept and/or silence beeps. Remote terminal sessions can add further complication. Be sure to check relevant configuration options to accomplish what you want.
+

data/plugins/beep/config/defaults.yml

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

data/plugins/beep/config/defaults_beep.rb

@@ -0,0 +1,67 @@
+# =========================================================================
+#   Ceedling - Test-Centered Build System for C
+#   ThrowTheSwitch.org
+#   Copyright (c) 2010-25 Mike Karlesky, Mark VanderVoord, & Greg Williams
+#   SPDX-License-Identifier: MIT
+# =========================================================================
+
+# Most generic beep option across all platforms -- echo the ASCII bell character
+DEFAULT_BEEP_BELL_TOOL = {
+  :executable => 'echo'.freeze,                     # Using `echo` shell command / command line application
+  :optional => true.freeze,
+  :name => 'default_beep_bell'.freeze,
+  :arguments => [
+    *('-n'.freeze unless SystemWrapper.windows?),   # No trailing newline for Unix-style echo (argument omitted on Windows)
+    "\x07".freeze                                   # Unprintable ASCII bell character, escaped in Ruby string
+    ].freeze
+  }
+
+# Terminal put the bell character on Unix-derived platforms
+DEFAULT_BEEP_TPUT_TOOL = {
+  :executable => 'tput'.freeze,                     # `tput` command line application
+  :optional => true.freeze,
+  :name => 'default_beep_tput'.freeze,
+  :arguments => [
+    "bel".freeze                                    # `tput` argument for bell character (named 'bel' in ASCII standard)
+    ].freeze
+  }
+
+# Old but widely available `beep` tone generator package for Unix-derived platforms (not macOS) 
+DEFAULT_BEEP_BEEP_TOOL = {
+  :executable => 'beep'.freeze,                     # `beep` command line application
+  :optional => true.freeze,
+  :name => 'default_beep_beep'.freeze,
+  :arguments => [].freeze                           # Default beep (no arguments)
+  }
+  
+# Widely available tone generator package for Unix-derived platforms (not macOS)
+DEFAULT_BEEP_SPEAKER_TEST_TOOL = {
+  :executable => 'speaker-test'.freeze,             # `speaker-test` command line application
+  :optional => true.freeze,
+  :name => 'default_beep_speaker_test'.freeze,
+  :arguments => [                                   # 1000 hz sine wave frequency
+    '-t sine'.freeze,
+    '-f 1000'.freeze,
+    '-l 1'.freeze
+    ].freeze
+  }
+
+# macOS text-to-speech tool
+DEFAULT_BEEP_SAY_TOOL = {
+  :executable => 'say'.freeze,                      # macOS `say` command line application
+  :optional => true.freeze,
+  :name => 'default_beep_say'.freeze,
+  :arguments => [
+    "\"${1}\""                                      # Replacement argument for text
+    ].freeze
+  }
+
+def get_default_config
+  return :tools => {
+    :beep_bell => DEFAULT_BEEP_BELL_TOOL,
+    :beep_tput => DEFAULT_BEEP_TPUT_TOOL,
+    :beep_beep => DEFAULT_BEEP_BEEP_TOOL,
+    :beep_speaker_test => DEFAULT_BEEP_SPEAKER_TEST_TOOL,
+    :beep_say => DEFAULT_BEEP_SAY_TOOL
+  }
+end

data/plugins/beep/lib/beep.rb

@@ -0,0 +1,85 @@
+# =========================================================================
+#   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/plugin'
+require 'ceedling/exceptions'
+
+BEEP_ROOT_NAME = 'beep'.freeze
+BEEP_SYM       = BEEP_ROOT_NAME.to_sym
+
+class Beep < Plugin
+  
+  # `Plugin` setup()
+  def setup
+    # Get non-flattenified project configuration
+    project_config = @ceedling[:setupinator].config_hash
+    
+    # Get beep configuration hash
+    beep_config = project_config[BEEP_SYM]
+
+    # Get tools hash
+    tools = project_config[:tools]
+
+    # Lookup and capture the selected beep tools
+    @tools = {
+      :beep_on_done => tools["beep_#{beep_config[:on_done]}".to_sym],
+      :beep_on_error => tools["beep_#{beep_config[:on_error]}".to_sym]
+    }
+    
+    # Ensure configuration option is an actual tool
+    if @tools[:beep_on_done].nil?
+      error = "Option :#{beep_config[:on_done]} for :beep ↳ :on_done plugin configuration does not map to a tool."
+      raise CeedlingException.new( error )
+    end
+    
+    # Ensure configuration option is an actual tool
+    if @tools[:beep_on_error].nil?
+      error = "Option :#{beep_config[:on_done]} for :beep ↳ :on_error plugin configuration does not map to a tool."
+      raise CeedlingException.new( error )
+    end
+
+    # Validate the selected beep tools
+    # Do not validate the `:bell` tool as it relies on `echo` that could be a shell feature rather than executable
+    @ceedling[:tool_validator].validate(
+      tool: @tools[:beep_on_done],
+      boom: true
+    ) if tools[:on_done] != :bell
+
+    @ceedling[:tool_validator].validate(
+      tool: @tools[:beep_on_error],
+      boom: true
+    ) if tools[:on_error] != :bell
+  end
+
+  # `Plugin` build step hook  
+  def post_build
+    command = @ceedling[:tool_executor].build_command_line(
+      @tools[:beep_on_done],
+      [],
+      # Only used by tools with `${1}` replacement argument
+      'ceedling build done'
+    )
+
+
+    # Verbosity is enabled to allow shell output (primarily for sake of the bell character)
+    @ceedling[:system_wrapper].shell_system( command: command[:line], verbose: true )
+  end
+  
+  # `Plugin` build step hook
+  def post_error
+    command = @ceedling[:tool_executor].build_command_line(
+      @tools[:beep_on_error],
+      [],
+      # Only used by tools with `${1}` replacement argument
+      'ceedling build error'
+    )
+
+    # Verbosity is enabled to allow shell output (primarily for sake of the bell character)
+    @ceedling[:system_wrapper].shell_system( command: command[:line], verbose: true )
+  end
+  
+end