mysh 0.1.16 → 0.1.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 456fdf1833320032c9452e13eeb0c140d84f69e6
-  data.tar.gz: 0590da7cd17f06fe1b428b47026b054f30fce371
+  metadata.gz: d3c002087bb9289b3a21c696dbec4cf5eb0c2aad
+  data.tar.gz: 89e63a29c1c26f4f84372cfa34995e820c3cf726
 SHA512:
-  metadata.gz: d72558e9e315c03ba978cda6ef40cbbfe113bcc995933b2e76ad5744bc22aa5fa50dfa9958d82e65e333293c03f2ff0a1dba5100e5ed1c8edb047a3a0949ee14
-  data.tar.gz: 18d160168fd6aec07cb6b6064f1a0adad97018214ab14dd24592e7c95bc629039a7460889f9c46217fc57c7eafa28b323832df9439c9fe20784356e4dd95b75e
+  metadata.gz: eab8e85ede1899c6d87a457141a7664421fb9171e5175b5b3c82ac9181d4ce6838db03fe3c9f4334bbf61c9ca190524cfeddf859edefdd70c8171d65d296822a
+  data.tar.gz: 0a8e2f49879875648bf8435e9011c4188f4f05802b95a20a6045e95b6f5583b33b9cf1f526579f91c90d33871c387ff6796eccf154635710d3a3ad26a04b5130

data/README.md

@@ -19,7 +19,7 @@ Since that name was available, it would seem that no one had yet written a
 shell program at this level of narcissism.
 
 The mysh is available as both a stand-alone CLI program and for use as a
-command shell within Ruby applications and Rails web sites.
+command shell within Ruby applications and (eventually) Rails web sites.
 
 See the original article at:
 (http://www.blackbytes.info/2016/07/writing-a-shell-in-ruby/)
@@ -75,8 +75,6 @@ A few noteworthy methods exist that facilitate use of Ruby expressions:
 reset      Reset the execution environment to the default state.
 result     Returns the result of the previous expression.
 x.lineage  Get the class lineage of the object x.
-vls "mask" List modules with version info. The optional mask string value is
-           used to filter for modules containing that string.
 ```
 
 The Ruby expression execution environment has direct access to many advanced
@@ -127,15 +125,18 @@ Internal commands are recognized by name and are executed by mysh directly.
 The following set of commands are supported:
 
 ```
-!         Display the mysh command history.
-?         Display help information for mysh.
-cd <dir>  Change directory to the optional <dir> parameter
-          and then display the current working directory.
-exit      Exit mysh.
-help      Display help information for mysh.
-history   Display the mysh command history.
-pwd       Display the current working directory.
-quit      Exit mysh.
+!            Display the mysh command history.
+? <topic>    Display help information for mysh with an optional topic.
+cd <dir>     Change directory to the optional <dir> parameter and then display
+             the current working directory.
+exit         Exit mysh.
+help <topic> Display help information for mysh with an optional topic.
+history      Display the mysh command history.
+pwd          Display the current working directory.
+quit         Exit mysh.
+show <file>  Display a text file with optional embedded handlebars.
+vls <mask>   Display the loaded modules, matching the optional mask, that have
+             version info.
 ```
 Of note is the command "help help" which provides a list of available topics.
 
@@ -238,7 +239,13 @@ module Mysh
   end
 end
 ```
+#### Add Method Return Values
+Both the add and add_alias methods return the newly created action instance.
+This may be useful, for example, if it is desired to add singleton methods to
+the action in order to extend functionality.
 
+Note that when an action is aliased, none of the singleton methods are copied
+across and these will have to be regenerated in the new action object.
 
 ## Contributing
 

data/lib/mysh.rb

@@ -1,6 +1,6 @@
 # coding: utf-8
 
-# mysh -- MY SHell -- a Ruby/Rails inspired command shell.
+# mysh -- MY SHell -- a Ruby/Rails inspired command line shell.
 
 require 'English'
 require 'mini_readline'

data/lib/mysh/expression.rb

@@ -34,24 +34,16 @@ module Mysh
       ExecHost.exec_binding = binding
     end
 
-    #Process an expression.
-    def execute(str)
-      if str.start_with?('=')
-        do_execute(str)
-        :expression
-      end
-    end
-
-    private
-
     #Do the actual work of executing an expression.
-    def do_execute(str)
+    def execute(str)
       self.result = exec_binding.eval(str[1..-1])
       send(result ? :pp : :puts, result)
     rescue Interrupt, StandardError, ScriptError => err
       puts "#{err.class.to_s}: #{err}"
     end
 
+    private
+
     #Get the execute binding.
     def exec_binding
       self.class.exec_binding
@@ -73,8 +65,8 @@ module Mysh
       nil
     end
 
-    #A proxy for instance_eval.
-    def instance_eval(str)
+    #Evaluate the string in the my shell context.
+    def mysh_eval(str)
       exec_binding.eval(str)
     end
   end

data/lib/mysh/expression/lineage.rb

@@ -1,6 +1,6 @@
 # coding: utf-8
 
-#Object monkey patch for the mysh lineage command.
+#Object monkey patch for the mysh lineage method.
 class Object
 
   #Get the lineage of this object.
@@ -11,7 +11,7 @@ class Object
 
 end
 
-#Class monkey patch for the mysh lineage command.
+#Class monkey patch for the mysh lineage method.
 class Class
 
   #Get the lineage of this class.

data/lib/mysh/internal.rb

@@ -7,5 +7,5 @@ require_relative 'internal/manage'
 require_relative 'internal/format'
 require_relative 'internal/decorate'
 
-#Load up the internal commands!
+#Load up the internal actions!
 Dir[Mysh::Action::ACTIONS_PATH + '*.rb'].each {|file| require file }

data/lib/mysh/internal/action.rb

@@ -5,30 +5,43 @@ module Mysh
 
   #The mysh internal action class.
   class Action
-    #The name of the command.
+    #The name of the action.
     attr_reader :name
 
-    #The description of the command.
+    #The description of the action.
     attr_reader :description
 
-    #The action of the command.
+    #The action of the action.
     attr_reader :action
 
-    #Setup an internal command
+    #Setup an internal action.
     def initialize(name, description, &action)
       @name, @description, @action = name, description.in_array, action
+      @exec_binding = mysh_binding
     end
 
-    #Execute the command.
+    #Execute the action.
     def execute(args)
       instance_exec(args, &@action)
     end
 
-    #Get information about the command.
+    #Get information about the action.
     def action_info
       [@name].concat(@description)
     end
 
+    private
+
+    #Create a binding for mysh to execute expressions in.
+    def mysh_binding
+      binding
+    end
+
+    #Evaluate the string in the my shell context.
+    def mysh_eval(str)
+      @exec_binding.eval(str)
+    end
+
   end
 
 end

data/lib/mysh/internal/action_pool.rb

@@ -6,9 +6,12 @@ module Mysh
   #* A managed hash of mysh actions.
   class ActionPool
 
+    #The name of this action pool.
+    attr_reader :pool_name
+
     #Create a new action pool
-    def initialize(&default_action)
-      @pool = {}
+    def initialize(pool_name, &default_action)
+      @pool_name, @pool = pool_name, {}
 
       if default_action
         @pool.default = Action.new("", "", &default_action)
@@ -24,27 +27,28 @@ module Mysh
     def add(name, description, &action)
       split_name = name.split[0] || ""
 
+      if @pool.has_key?(split_name)
+        fail "Add error: Action #{split_name.inspect} already exists in #{pool_name}."
+      end
+
       @pool[split_name] = Action.new(name, description, &action)
     end
 
     #Add an alias for an existing action.
     def add_alias(new_name, old_name)
-      unless (action = @pool[old_name])
-        fail "Error adding alias #{new_name} for #{old_name}"
+      unless (action = @pool[old_name.split[0]])
+        fail "Alias error: Action #{old_name.inspect} not found in #{pool_name}"
       end
 
-      split_name = new_name.split[0]
-
-      @pool[split_name] =
-        Action.new(new_name, action.description, &action.action)
+      add(new_name, action.description, &action.action)
     end
 
     #Get information on all actions.
     def actions_info
       @pool
         .values
-        .map  {|action| action.action_info }
-        .sort {|first, second| first[0] <=> second[0] }
+        .map  {|action| action.action_info}
+        .sort {|first, second| first[0] <=> second[0]}
     end
 
   end

data/lib/mysh/internal/actions/actions_path.rb

@@ -1,9 +1,9 @@
 # coding: utf-8
 
-#* internal/actions/actions_path.rb -- A convenient hook to the command folder.
+#* internal/actions/actions_path.rb -- A convenient hook to the actions folder.
 module Mysh
 
-  #* internal/actions/actions_path.rb -- A convenient hook to the command folder.
+  #* internal/actions/actions_path.rb -- A convenient hook to the actions folder.
   class Action
 
     #Capture this folder's name.

data/lib/mysh/internal/actions/gls.rb

@@ -0,0 +1,19 @@
+# coding: utf-8
+
+#* internal/actions/gls.rb -- The mysh gem ls command.
+module Mysh
+
+  #* internal/actions/gls.rb -- The mysh gem ls command.
+  class Action
+
+    desc = 'Display the loaded ruby gems.'
+
+    COMMANDS.add('gls <mask>', desc) do |args|
+      puts Gem.loaded_specs.keys.sort.join(" ")
+      puts
+    end
+
+  end
+
+end
+

data/lib/mysh/internal/actions/help.rb

@@ -7,24 +7,24 @@ module Mysh
   class Action
 
     # Help topics
-    HELP = ActionPool.new do |args|
+    HELP = ActionPool.new("HELP") do |args|
       puts "No help found for #{args[0].inspect}."
     end
 
     HELP.add("", "General help on mysh.") do |args|
-      show_handlebar_file(ACTIONS_PATH + 'help.txt')
+      show_handlebar_file(ACTIONS_PATH + 'help/help.txt')
     end
 
     HELP.add("math", "Help on mysh math functions.") do |args|
-      show_handlebar_file(ACTIONS_PATH + 'help_math.txt')
+      show_handlebar_file(ACTIONS_PATH + 'help/help_math.txt')
     end
 
     HELP.add("=", "Help on mysh ruby expressions.") do |args|
-      show_handlebar_file(ACTIONS_PATH + 'help_expr.txt')
+      show_handlebar_file(ACTIONS_PATH + 'help/help_expr.txt')
     end
 
     HELP.add("help", "Help on mysh help.") do |args|
-      show_handlebar_file(ACTIONS_PATH + 'help_help.txt')
+      show_handlebar_file(ACTIONS_PATH + 'help/help_help.txt')
     end
 
     HELP.add_alias('?', 'help')
@@ -42,3 +42,6 @@ module Mysh
 
 end
 
+#Load up the extra help actions!
+Dir[Mysh::Action::ACTIONS_PATH + 'help/*.rb'].each {|file| require file }
+

data/lib/mysh/internal/actions/{help.txt → help/help.txt}

@@ -1,4 +1,4 @@
-mysh (MY ruby SHell) version: {{ Mysh::VERSION }}
+mysh version: {{ Mysh::VERSION }}
 
 The mysh is a shell program inspired by the Ruby programming language in the
 same way the csh was inspired by the "C" programming language.
@@ -11,7 +11,7 @@ In mysh, commands fall into one of three broad categories. There are:
 2) Internal mysh commands are processed within mysh itself. The following set
    of commands are supported:
 
-{{ format_items(Mysh::COMMANDS.actions_info).join("\n") }}
+{{ Mysh::COMMANDS.actions_info.mysh_bulletize.join("\n") }}
 
 3) All other commands are executed by the system using the standard shell or
    the appropriate ruby interpreter. If the command has a '.rb' extension, it

data/lib/mysh/internal/actions/{help_expr.txt → help/help_expr.txt}

@@ -16,11 +16,10 @@ string parameters.
 
 A few special methods exist:
 
-=reset      Reset the execution environment to the default state.
-=result     Returns the result of the previous expression.
-=x.lineage  Get the class lineage of the object x.
-=vls "mask" List modules with version info. The optional mask string value is
-            used to filter for modules containing that string.
+reset      Reset the execution environment to the default state.
+result     Returns the result of the previous expression.
+x.lineage  Get the class lineage of the object or class x.
+
 
 Also included are a number of math methods. See '? math' for more on these.
 

data/lib/mysh/internal/actions/{help_help.txt → help/help_help.txt}

@@ -5,5 +5,5 @@ or an optional specified topic.
 
 The available help topics are:
 
-{{ format_items(HELP.actions_info).join("\n") }}
+{{ HELP.actions_info.mysh_bulletize.join("\n") }}
 

data/lib/mysh/internal/actions/show.rb

@@ -0,0 +1,27 @@
+# coding: utf-8
+
+#* internal/actions/show.rb -- The mysh show command.
+module Mysh
+
+  #* internal/actions/show.rb -- The mysh show command.
+  class Action
+
+    # The base help command.
+    desc = 'Display a text file with optional embedded handlebars.'
+
+    COMMANDS.add('show <file>', desc) do |args|
+      file_name = args.shift
+
+      @exec_binding = binding
+
+      if file_name
+        show_handlebar_file(file_name)
+      else
+        puts "Error: A text file must be specified."
+      end
+    end
+
+  end
+
+end
+

data/lib/mysh/internal/actions/vls.rb

@@ -0,0 +1,22 @@
+# coding: utf-8
+
+#* internal/actions/vls.rb -- The mysh module version ls command.
+module Mysh
+
+  #* internal/actions/vls.rb -- The mysh module version ls command.
+  class Action
+
+    desc = 'Display the loaded modules, matching the optional mask, ' +
+           'that have version info.'
+
+    COMMANDS.add('vls <mask>', desc) do |args|
+      mask = args.shift || /./
+
+      puts VersionLS.vls(mask).mysh_bulletize.join("\n")
+      puts
+    end
+
+  end
+
+end
+

data/lib/mysh/internal/format.rb

@@ -1,24 +1,19 @@
 # coding: utf-8
 
-require_relative 'format/bullets'
-
-#The mysh internal command class level report formatting.
-class Object
-
-  private
+#* internal/format.rb - Some formatting facilities for mysh.
+module Mysh
 
-  #Display an array of items.
-  def display_items(items)
-    items.puts_mysh_bullets
-    puts
-  end
+  #Assume an 80 column working area for formatting.
+  PAGE_WIDTH = 80
 
-  #Format an array of items.
-  #<br>Endemic Code Smells
-  #* :reek:FeatureEnvy :reek:UtilityFunction
-  def format_items(items)
-    items.mysh_bulletize
-  end
+  #Assume an in infinite page length for formatting.
+  PAGE_LENGTH = false
 
 end
 
+require_relative 'format/bullets'
+require_relative 'format/columns'
+require_relative 'format/array'
+require_relative 'format/string'
+require_relative 'format/object'
+

data/lib/mysh/internal/format/array.rb

@@ -0,0 +1,56 @@
+# coding: utf-8
+
+#* internal/format/array.rb - Support for displaying an array formatted neatly.
+class Array
+
+  # Columns ========================================================
+
+  #Print out the array with efficient columns.
+  def puts_mysh_columns(page_width  = Mysh::PAGE_WIDTH)
+
+    puts format_mysh_columns(page_width)
+  end
+
+  #Convert the array to strings with efficient columns.
+  #<br>Returns
+  #* An array of pages, that is, arrays of strings.
+  def format_mysh_columns(page_width = Mysh::PAGE_WIDTH)
+    builder = Mysh::ColumnizedPage.new(Mysh::PAGE_LENGTH, page_width)
+
+    self.each {|item| builder.add(item)}
+
+    builder.render
+  end
+
+  alias :format_description :format_mysh_columns
+
+  #Get the widest element of an array.
+  #<br>Returns
+  #* The width of the widest string in the array.
+  def mysh_column_width
+    (self.max_by {|item| item.length}).length
+  end
+
+
+  # Bullets ========================================================
+
+  #Print out the array as bullet points.
+  def puts_mysh_bullets
+    puts mysh_bulletize
+  end
+
+  #Convert the array to strings with bullet points.
+  #<br>
+  #* An array of strings
+  def mysh_bulletize(page_width = Mysh::PAGE_WIDTH)
+    builder = Mysh::BulletPoints.new(page_width)
+
+    self.each do |pair|
+      builder.add(*pair)
+    end
+
+    builder.render
+  end
+
+end
+

data/lib/mysh/internal/format/bullets.rb

@@ -6,33 +6,21 @@ module Mysh
   #A class to display data in bullet points.
   class BulletPoints
 
-    #Assume an 80 column working area.
-    PAGE_WIDTH = 80
-
     #Prepare a blank slate.
-    def initialize
+    def initialize(page_width)
+      @page_width  = page_width
       @bullet_data = []
     end
 
-    #Add an item to this page.
-    #<br>Endemic Code Smells
-    #* :reek:FeatureEnvy  :reek:TooManyStatements
-    def add(raw_bullet = "*", *raw_item)
-
-      if raw_item.empty?
-        bullet = ["*"]
-        items = raw_bullet.in_array
-      else
-        bullet = [raw_bullet]
-        items = raw_item.in_array
-      end
-
-      items.each_index do |index|
-        @bullet_data << [(bullet[index] || "").to_s, items[index].to_s]
+    #Add items to these bullet points.
+    def add(bullet, *items)
+      items.each do |item|
+        @bullet_data << [bullet.to_s, item]
+        bullet = ""
       end
     end
 
-    #Render the page as an array of strings.
+    #Render the bullet points as an array of strings.
     def render
       @key_length, results = get_key_length, []
 
@@ -46,68 +34,24 @@ module Mysh
 
     private
 
-    #How large is the largest bullet?
+    #Allowing for a trailing space, how large is the largest bullet?
     def get_key_length
-      (@bullet_data.max_by {|line| line[0].length})[0].length
+      (@bullet_data.max_by {|line| line[0].length})[0].length + 1
     end
 
     #Render one bullet point.
-    #<br>Endemic Code Smells
-    #* :reek:DuplicateMethodCall :reek:TooManyStatements
     def render_bullet(key, item)
-      result, pass_one = [], true
-      input  = item.split(' ').each
-      temp   = key.ljust(len = @key_length)
+      result = []
 
-      loop do
-        word = ' ' + input.next
-
-        while len >= PAGE_WIDTH
-          result << temp.slice!(0, PAGE_WIDTH - 1)
-          temp = blank_key + ' ' + temp
-          len  = temp.length
-        end
-
-        if ((len += word.length) >= PAGE_WIDTH) && !pass_one
-          result << temp
-          temp = blank_key + word
-          len  = temp.length
-        else
-          temp << word
-          pass_one = false
-        end
+      item.format_description(@page_width - @key_length - 1).each do |desc_line|
+        result << key.ljust(@key_length) + desc_line
+        key = ""
       end
 
-      result << temp
-    end
-
-    #Generate a blank bullet key
-    def blank_key
-      ' ' * @key_length
+      result
     end
 
   end
 
 end
 
-#Bullet point support in the Array class.
-class Array
-  #Print out the array as bullet points.
-  def puts_mysh_bullets
-    puts mysh_bulletize
-  end
-
-  #Convert the array to strings with bullet points.
-  #<br>
-  #* An array of arrays of strings
-  def mysh_bulletize
-    builder = Mysh::BulletPoints.new
-
-    self.each do |pair|
-      builder.add(*pair)
-    end
-
-    builder.render
-  end
-end
-

data/lib/mysh/internal/format/columns.rb

@@ -0,0 +1,122 @@
+# coding: utf-8
+
+#* internal/format/bullets.rb - Print out data in neat columns.
+module Mysh
+
+  #A class to display data in columns.
+  class ColumnizedPage
+    #Prepare a blank page.
+    def initialize(page_length, page_width)
+      @page_length, @page_width = page_length, page_width
+      @page_data = []
+    end
+
+    #Add an item to this page.
+    #<br>Returns
+    #* The number if items that did not fit in the page.
+    def add(raw_item)
+      item = raw_item.to_s
+      fail "Item too large to fit." unless item.length < @page_width
+
+      if (column = find_next_column)
+        @page_data[column] << item
+      else
+        @page_data << [item]
+      end
+
+      adjust_configuration
+    end
+
+    #Render the page as an array of strings.
+    def render
+      results, column_widths = [], get_column_widths
+
+      rows.times { |row_index| results << render_row(row_index, column_widths)}
+
+      @page_data.clear
+      results
+    end
+
+    private
+
+    #Get the widths of all columns
+    def get_column_widths
+      @page_data.map {|column| column.mysh_column_width}
+    end
+
+    #Render a single row of data.
+    def render_row(row_index, widths)
+      @page_data.each_with_index.map do |column, index|
+        column[row_index].to_s.ljust(widths[index])
+      end.join(" ")
+    end
+
+    #Make sure the page fits within its boundaries.
+    #<br>Returns
+    #* The number if items that did not fit in the page.
+    def adjust_configuration
+      while total_width >= @page_width
+        return @page_data.pop.length if rows == @page_length
+        add_a_row
+      end
+
+      0
+    end
+
+    #Add a row to the page, moving items as needed.
+    def add_a_row
+      target = rows + 1
+      pool, @page_data = @page_data.flatten, []
+
+      until pool.empty?
+        @page_data << pool.shift(target)
+      end
+    end
+
+    #Compute the total width of all of the columns.
+    #<br>Returns
+    #* The sum of the widths of the widest items of each column plus a space
+    #  between each of those columns.
+    def total_width
+      if empty?
+        0
+      else
+        #The starting point, @page_data.length-1, represents the spaces needed
+        #between the columns. So N columns means N-1 spaces.
+        @page_data.inject(@page_data.length-1) do |sum, column|
+          sum + column.mysh_column_width
+        end
+      end
+    end
+
+    #Does the data fit on the page?
+    def fits?
+      total_width < @page_width
+    end
+
+    #How many rows are currently in this page?
+    def rows
+      empty? ? 0 : @page_data[0].length
+    end
+
+    #Is this page empty?
+    def empty?
+      @page_data.empty?
+    end
+
+    #Which column will receive the next item?
+    #<br>Returns
+    #* The index of the first non-filled column or nil if none found.
+    def find_next_column
+      (1...(@page_data.length)).each do |index|
+        if @page_data[index].length < @page_data[index-1].length
+          return index
+        end
+      end
+
+      nil
+    end
+  end
+
+end
+

data/lib/mysh/internal/format/object.rb

@@ -0,0 +1,13 @@
+# coding: utf-8
+
+#* internal/format/object.rb - Support for displaying data formatted neatly.
+class Object
+
+  #Create a bullet point description from this object.
+  def format_description(max_width)
+    self.to_s.format_description(max_width)
+  end
+
+end
+
+

data/lib/mysh/internal/format/string.rb

@@ -0,0 +1,46 @@
+# coding: utf-8
+
+#* internal/format/string.rb - Support for displaying data formatted neatly.
+class String
+
+  #Create a bullet point description from this string.
+  def format_description(max_width)
+    do_format_description(split(' ').each, max_width)
+  end
+
+  #Do the formatting legwork.
+  def do_format_description(input, max_width)
+    result, build = [], ""
+
+    loop do
+      build = build.split_if_over(input.next, max_width, result)
+                   .split_if_huge(max_width, result)
+    end
+
+    result << build
+  end
+
+  #Split if adding a word goes over a little.
+  def split_if_over(word, max_width, buffer)
+    word.prepend(" ") unless self.empty?
+    word_len = word.length
+
+    if (length + word_len) >= max_width && word_len < max_width
+      buffer << self
+      word.lstrip
+    else
+      self + word
+    end
+
+  end
+
+  #Split up a overlong blob of text.
+  def split_if_huge(max_width, buffer)
+    while length >= max_width
+      buffer << slice!(0, max_width)
+    end
+
+    self
+  end
+end
+

data/lib/mysh/internal/manage.rb

@@ -3,8 +3,8 @@
 #* internal/manage.rb -- Manage mysh internal commands.
 module Mysh
 
-  #Set up the command library hash.
-  COMMANDS = ActionPool.new
+  #Set up the command action pool.
+  COMMANDS = ActionPool.new("COMMANDS")
 
   #Parse a command string for use by commands.
   def self.parse_command(str)
@@ -13,19 +13,19 @@ module Mysh
     [COMMANDS[result.shift], result]
   end
 
-  #Execute an internal command
+  #Execute the action of an internal command.
   def self.execute(str)
     unless str[0] == ' '
-      command, args = parse_command(str.chomp)
+      action, args = parse_command(str.chomp)
 
-      if (command)
-        command.execute(args)
+      if (action)
+        action.execute(args)
         :internal
       end
     end
   end
 
-  #Try to execute the string as an internal command.
+  #Try to execute the string as an internal action.
   def self.try_execute_internal_command(str)
     execute(str)
   end

data/lib/mysh/user_input/handlebars.rb

@@ -35,7 +35,7 @@ class Object
     str.gsub(/{{.*?}}/m) do |match|
       code   = match[2...-2]
       silent = code.end_with?("#")
-      result = instance_eval(code)
+      result = mysh_eval(code)
 
       (result unless silent).to_s
     end

data/lib/mysh/version.rb

@@ -2,8 +2,8 @@
 
 module Mysh
   #The version string of MY SHell.
-  VERSION = "0.1.16"
+  VERSION = "0.1.17"
 
   #A brief summary of this gem.
-  SUMMARY = "mysh -- a Ruby inspired command shell."
+  SUMMARY = "mysh -- a Ruby inspired command line shell."
 end

data/samples/show.txt

@@ -0,0 +1,11 @@
+This is a sample show file.
+
+{{ a = 5 #}}a = {{ a.to_s }}
+Args = {{ args.inspect }}
+
+{{ count = 100 #}}
+
+{{ [["Numbers", Array.new(count){|i| (i+1)} ],
+    ["Squares", Array.new(count){|i| (i+1)*(i+1)} ],
+    ["Cubes",   Array.new(count){|i| (i+1)*(i+1)*(i+1)} ]].mysh_bulletize.join("\n") }}
+

data/tests/my_shell_tests.rb

@@ -11,10 +11,23 @@ class MyShellTester < Minitest::Test
   #Track mini-test progress.
   include MinitestVisible
 
+  #Evaluate the string in a mysh context.
+  def mysh_eval(str)
+    @mysh_binding ||= binding
+
+    @mysh_binding.eval(str)
+  end
+
   def test_that_module_entities_exists
+    assert_equal(String, Mysh::VERSION.class)
+
     assert_equal(Module, Mysh.class)
     assert_equal(Class,  Mysh::Action.class)
+    assert_equal(Class,  Mysh::ActionPool.class)
     assert_equal(Class,  Mysh::ExecHost.class)
+
+    assert_equal(Mysh::ActionPool, Mysh::COMMANDS.class)
+    assert_equal(Mysh::ActionPool, Mysh::Action::HELP.class)
   end
 
   def test_for_internal_commands
@@ -44,4 +57,57 @@ class MyShellTester < Minitest::Test
     assert_equal("{{A}}", eval_handlebars("{{ '{'+'{A}'+'}' }}"))
   end
 
+  def test_command_parsing
+    assert_equal([], Mysh.parse_args(""))
+
+    assert_equal(["1", "2", "3"], Mysh.parse_args("1 2 3"))
+
+    assert_equal(["1", "Trump", "loses", "election", "3"],
+                 Mysh.parse_args("1 Trump loses election 3"))
+
+    assert_equal(["1", "Trump loses election", "3"],
+                 Mysh.parse_args('1 "Trump loses election" 3'))
+
+  end
+
+  def test_the_lineage_method
+    assert_equal("String instance < String < Object < BasicObject",
+                 "Hello".lineage)
+
+    assert_equal("Fixnum instance < Fixnum < Integer < Numeric < Object < BasicObject",
+                 (4).lineage)
+  end
+
+  def test_some_formatting
+    result =
+      ["1 5 9  13 17 21 25 29 33 37 41 45 49 53 57 61 65 69 73 77 81 85 89 93 97 ",
+       "2 6 10 14 18 22 26 30 34 38 42 46 50 54 58 62 66 70 74 78 82 86 90 94 98 ",
+       "3 7 11 15 19 23 27 31 35 39 43 47 51 55 59 63 67 71 75 79 83 87 91 95 99 ",
+       "4 8 12 16 20 24 28 32 36 40 44 48 52 56 60 64 68 72 76 80 84 88 92 96 100"]
+
+    assert_equal(result, (1..100).to_a.format_mysh_columns)
+
+    data =
+      [["key_largo", "/long_folder_name_one/long_folder_name_two/long_folder_name_three/fine_descriptive_name"],
+       ["key_west",  "Semper ubi sub ubi. Semper ubi sub ubi. Semper ubi sub ubi. Semper ubi sub ubi. "],
+       ["counting",  Array.new(100) {|i| i} ],
+       ["pie", Math::PI]
+      ]
+
+    result =
+      ["key_largo /long_folder_name_one/long_folder_name_two/long_folder_name_three/fin",
+       "          e_descriptive_name",
+       "key_west  Semper ubi sub ubi. Semper ubi sub ubi. Semper ubi sub ubi. Semper",
+       "          ubi sub ubi.",
+       "counting  0 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95",
+       "          1 6 11 16 21 26 31 36 41 46 51 56 61 66 71 76 81 86 91 96",
+       "          2 7 12 17 22 27 32 37 42 47 52 57 62 67 72 77 82 87 92 97",
+       "          3 8 13 18 23 28 33 38 43 48 53 58 63 68 73 78 83 88 93 98",
+       "          4 9 14 19 24 29 34 39 44 49 54 59 64 69 74 79 84 89 94 99",
+       "pie       3.141592653589793"
+      ]
+
+    assert_equal(result, data.mysh_bulletize)
+  end
+
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mysh
 version: !ruby/object:Gem::Version
-  version: 0.1.16
+  version: 0.1.17
 platform: ruby
 authors:
 - Peter Camilleri
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-07 00:00:00.000000000 Z
+date: 2016-10-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -160,15 +160,22 @@ files:
 - lib/mysh/internal/actions/actions_path.rb
 - lib/mysh/internal/actions/cd.rb
 - lib/mysh/internal/actions/exit.rb
+- lib/mysh/internal/actions/gls.rb
 - lib/mysh/internal/actions/help.rb
-- lib/mysh/internal/actions/help.txt
-- lib/mysh/internal/actions/help_expr.txt
-- lib/mysh/internal/actions/help_help.txt
-- lib/mysh/internal/actions/help_math.txt
+- lib/mysh/internal/actions/help/help.txt
+- lib/mysh/internal/actions/help/help_expr.txt
+- lib/mysh/internal/actions/help/help_help.txt
+- lib/mysh/internal/actions/help/help_math.txt
 - lib/mysh/internal/actions/history.rb
+- lib/mysh/internal/actions/show.rb
+- lib/mysh/internal/actions/vls.rb
 - lib/mysh/internal/decorate.rb
 - lib/mysh/internal/format.rb
+- lib/mysh/internal/format/array.rb
 - lib/mysh/internal/format/bullets.rb
+- lib/mysh/internal/format/columns.rb
+- lib/mysh/internal/format/object.rb
+- lib/mysh/internal/format/string.rb
 - lib/mysh/internal/manage.rb
 - lib/mysh/user_input.rb
 - lib/mysh/user_input/handlebars.rb
@@ -179,7 +186,8 @@ files:
 - mysh.reek
 - rakefile.rb
 - reek.txt
-- test.rb
+- samples/show.txt
+- samples/test.rb
 - tests/my_shell_tests.rb
 homepage: http://teuthida-technologies.com/
 licenses:
@@ -204,6 +212,6 @@ rubyforge_project:
 rubygems_version: 2.2.3
 signing_key: 
 specification_version: 4
-summary: mysh -- a Ruby inspired command shell.
+summary: mysh -- a Ruby inspired command line shell.
 test_files: []
 has_rdoc: