gloo 0.3.0 → 0.5.3

data/lib/gloo/objs/cli/confirm.rb

@@ -7,45 +7,46 @@
 module Gloo
   module Objs
     class Confirm < Gloo::Core::Obj
-      
-      KEYWORD = 'confirm'
-      KEYWORD_SHORT = 'confirm'
-      PROMPT = 'prompt'
-      RESULT = 'result'
 
-      # 
+      KEYWORD = 'confirm'.freeze
+      KEYWORD_SHORT = 'confirm'.freeze
+      PROMPT = 'prompt'.freeze
+      RESULT = 'result'.freeze
+
+      #
       # The name of the object type.
-      # 
+      #
       def self.typename
         return KEYWORD
       end
 
-      # 
+      #
       # The short name of the object type.
-      # 
+      #
       def self.short_typename
         return KEYWORD_SHORT
       end
-      
-      # 
+
+      #
       # Get the URI from the child object.
       # Returns nil if there is none.
-      # 
-      def get_prompt
+      #
+      def prompt_value
         o = find_child PROMPT
         return nil unless o
+
         return o.value
       end
-      
-      # 
+
+      #
       # Set the result of the system call.
-      # 
-      def set_result data
+      #
+      def set_result( data )
         r = find_child RESULT
         return nil unless r
+
         r.set_value data
       end
-            
 
       # ---------------------------------------------------------------------
       #    Children
@@ -57,36 +58,69 @@ module Gloo
       def add_children_on_create?
         return true
       end
-      
+
       # Add children to this object.
-      # This is used by containers to add children needed 
+      # This is used by containers to add children needed
       # for default configurations.
       def add_default_children
         fac = $engine.factory
-        fac.create "prompt", "string", "> ", self
-        fac.create "result", "boolean", nil, self
+        fac.create( { :name => 'prompt',
+                      :type => 'string',
+                      :value => '> ',
+                      :parent => self } )
+        fac.create( { :name => 'result',
+                      :type => 'boolean',
+                      :value => nil,
+                      :parent => self } )
       end
 
-      
       # ---------------------------------------------------------------------
       #    Messages
       # ---------------------------------------------------------------------
 
-      # 
+      #
       # Get a list of message names that this object receives.
-      # 
+      #
       def self.messages
-        return super + [ "run" ]
+        return super + [ 'run' ]
       end
-      
+
       # Run the system command.
       def msg_run
-        prompt = get_prompt
+        prompt = prompt_value
         return unless prompt
+
         result = $prompt.yes?( prompt )
         set_result result
       end
-      
+
+      # ---------------------------------------------------------------------
+      #    Help
+      # ---------------------------------------------------------------------
+
+      #
+      # Get help for this object type.
+      #
+      def self.help
+        return <<~TEXT
+          CONFIRM OBJECT TYPE
+            NAME: confirm
+            SHORTCUT: confirm
+
+          DESCRIPTION
+            CLI confirmation prompt.
+
+          CHILDREN
+            prompt - string - '> '
+              The confirmation prompt.
+            result - boolean - none
+              The result of the prompt.
+
+          MESSAGES
+            run - Prompt the user and then set the result.
+        TEXT
+      end
+
     end
   end
 end

data/lib/gloo/objs/cli/menu.rb

@@ -0,0 +1,236 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2020 Eric Crane.  All rights reserved.
+#
+# A CLI menu.
+# The menu contains a collection of menu items, a prompt
+# and an option to loop until done.
+#
+
+module Gloo
+  module Objs
+    class Menu < Gloo::Core::Obj
+
+      KEYWORD = 'menu'.freeze
+      KEYWORD_SHORT = 'menu'.freeze
+      PROMPT = 'prompt'.freeze
+      ITEMS = 'items'.freeze
+      LOOP = 'loop'.freeze
+      HIDE_ITEMS = 'hide_items'.freeze
+      BEFORE_MENU = 'before_menu'.freeze
+      DEFAULT = 'default'.freeze
+
+      #
+      # The name of the object type.
+      #
+      def self.typename
+        return KEYWORD
+      end
+
+      #
+      # The short name of the object type.
+      #
+      def self.short_typename
+        return KEYWORD_SHORT
+      end
+
+      #
+      # Get the value of the prompt child object.
+      # Returns nil if there is none.
+      #
+      def prompt_value
+        o = find_child PROMPT
+        return '' unless o
+
+        return o.value
+      end
+
+      #
+      # Get the value of the loop child object.
+      # Should we keep looping or should we stop?
+      #
+      def loop?
+        o = find_child LOOP
+        return false unless o
+
+        return o.value
+      end
+
+      # ---------------------------------------------------------------------
+      #    Children
+      # ---------------------------------------------------------------------
+
+      # Does this object have children to add when an object
+      # is created in interactive mode?
+      # This does not apply during obj load, etc.
+      def add_children_on_create?
+        return true
+      end
+
+      # Add children to this object.
+      # This is used by containers to add children needed
+      # for default configurations.
+      def add_default_children
+        fac = $engine.factory
+        fac.create_string PROMPT, '> ', self
+        fac.create_can ITEMS, self
+        fac.create_bool LOOP, true, self
+        fac.create_script DEFAULT, '', self
+      end
+
+      # ---------------------------------------------------------------------
+      #    Messages
+      # ---------------------------------------------------------------------
+
+      #
+      # Get a list of message names that this object receives.
+      #
+      def self.messages
+        return super + [ 'run' ]
+      end
+
+      #
+      # Show the menu options, and prompt for user input.
+      #
+      def msg_run
+        loop do
+          begin_menu
+          if prompt_value.empty?
+            dt = DateTime.now
+            d = dt.strftime( '%Y.%m.%d' )
+            t = dt.strftime( '%I:%M:%S' )
+            cmd = $prompt.ask( "#{d.yellow} #{t.white} >" )
+          else
+            cmd = $prompt.ask( prompt_value )
+          end
+          cmd ? run_command( cmd ) : run_default
+          break unless loop?
+        end
+      end
+
+      # ---------------------------------------------------------------------
+      #    Menu actions
+      # ---------------------------------------------------------------------
+
+      #
+      # Begin the menu execution.
+      # Run the before menu script if there is one,
+      # then show options unless we are hiding them by default.
+      #
+      def begin_menu
+        run_before_menu
+
+        # Check to see if we should show items at all.
+        o = find_child HIDE_ITEMS
+        return if o && o.value == true
+
+        show_options
+      end
+
+      #
+      # If there is a before menu script, run it now.
+      #
+      def run_before_menu
+        o = find_child BEFORE_MENU
+        return unless o
+
+        Gloo::Exec::Dispatch.message 'run', o
+      end
+
+      #
+      # Show the list of menu options.
+      #
+      def show_options
+        o = find_child ITEMS
+        return unless o
+
+        o.children.each do |mitem|
+          mitem = Gloo::Objs::Alias.resolve_alias( mitem )
+          puts "  #{mitem.shortcut_value} - #{mitem.description_value}"
+        end
+      end
+
+      #
+      # Find the command matching user input.
+      #
+      def find_cmd( cmd )
+        o = find_child ITEMS
+        return nil unless o
+
+        o.children.each do |mitem|
+          mitem = Gloo::Objs::Alias.resolve_alias( mitem )
+          return mitem if mitem.shortcut_value.downcase == cmd.downcase
+        end
+
+        return nil
+      end
+
+      #
+      # Run the default option.
+      #
+      def run_default
+        obj = find_child DEFAULT
+        return unless obj
+
+        s = Gloo::Core::Script.new obj
+        s.run
+      end
+
+      #
+      # Run the selected command.
+      #
+      def run_command( cmd )
+        obj = find_cmd cmd
+
+        unless obj
+          if cmd == '?'
+            show_options
+          else
+            puts "#{cmd} is not a valid option"
+          end
+          return
+        end
+
+        script = obj.do_script
+        return unless script
+
+        s = Gloo::Core::Script.new script
+        s.run
+      end
+
+      # ---------------------------------------------------------------------
+      #    Help
+      # ---------------------------------------------------------------------
+
+      #
+      # Get help for this object type.
+      #
+      def self.help
+        return <<~TEXT
+          MENU OBJECT TYPE
+            NAME: menu
+            SHORTCUT: menu
+
+          DESCRIPTION
+            A CLI menu.
+            This can be used for the main loop of a CLI application.
+
+          CHILDREN
+            prompt - string - '> '
+              The shortcut may be used to select the  menu item.
+            items - container
+              A textual description of the menu item action.
+            loop - boolean
+              The script that will be run if the menu item is selected.
+            default - script
+              Optional script element. Run this if no other option selected.
+
+          MESSAGES
+            run - Show the options and the the prompt.
+              Then run the script for the user's selection.
+              Optionally repeat as long as the loop child is true.
+        TEXT
+      end
+
+    end
+  end
+end

data/lib/gloo/objs/cli/menu_item.rb

@@ -0,0 +1,128 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2020 Eric Crane.  All rights reserved.
+#
+# A CLI menu item.  One element in a CLI menu.
+#
+
+module Gloo
+  module Objs
+    class MenuItem < Gloo::Core::Obj
+
+      KEYWORD = 'menu_item'.freeze
+      KEYWORD_SHORT = 'mitem'.freeze
+      SHORTCUT = 'shortcut'.freeze
+      DESCRIPTION = 'description'.freeze
+      DO = 'do'.freeze
+
+      #
+      # The name of the object type.
+      #
+      def self.typename
+        return KEYWORD
+      end
+
+      #
+      # The short name of the object type.
+      #
+      def self.short_typename
+        return KEYWORD_SHORT
+      end
+
+      #
+      # Get the value of the menu item shortcut.
+      # Returns nil if there is none.
+      #
+      def shortcut_value
+        o = find_child SHORTCUT
+        return self.name unless o
+
+        return o.value
+      end
+
+      #
+      # Get the action's description.
+      # Returns nil if there is none.
+      #
+      def description_value
+        o = find_child DESCRIPTION
+        return self.value unless o
+
+        return o.value
+      end
+
+      #
+      # Get the action's script.
+      # Returns nil if there is none.
+      #
+      def do_script
+        return find_child DO
+      end
+
+      # ---------------------------------------------------------------------
+      #    Children
+      # ---------------------------------------------------------------------
+
+      # Does this object have children to add when an object
+      # is created in interactive mode?
+      # This does not apply during obj load, etc.
+      def add_children_on_create?
+        return true
+      end
+
+      # Add children to this object.
+      # This is used by containers to add children needed
+      # for default configurations.
+      def add_default_children
+        fac = $engine.factory
+        fac.create_string SHORTCUT, '', self
+        fac.create_string DESCRIPTION, '', self
+        fac.create_script DO, '', self
+      end
+
+      # ---------------------------------------------------------------------
+      #    Messages
+      # ---------------------------------------------------------------------
+
+      #
+      # Get a list of message names that this object receives.
+      #
+      def self.messages
+        return super
+      end
+
+      # ---------------------------------------------------------------------
+      #    Help
+      # ---------------------------------------------------------------------
+
+      #
+      # Get help for this object type.
+      #
+      def self.help
+        return <<~TEXT
+          MENU_ITEM OBJECT TYPE
+            NAME: menu_item
+            SHORTCUT: mitem
+
+          DESCRIPTION
+            A CLI menu item.  One element in a CLI menu.
+
+          CHILDREN
+            shortcut - string
+              The shortcut may be used to select the  menu item.
+              The shortcut child is optional.  If it is not provided,
+              the name of the menu item will be used instead.
+            description - string
+              A textual description of the menu item action.
+              The description child is optional.  If it is not provided,
+              the value of the menu item will be used instead.
+            do - script
+              The script that will be run if the menu item is selected.
+
+          MESSAGES
+            None
+        TEXT
+      end
+
+    end
+  end
+end