gloo-cli 1.3 → 1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 055e863c3b9b427534255896f83ccbd28166c854ab083f8383342e76f787cb9d
-  data.tar.gz: 914842fb1db12ed70efa03a48bd37c4074a431d7e03a5c001bb8ebddeddbf026
+  metadata.gz: 2a167c3410e526f3dec9aa9f07c430eefd8cd031c07820bd44afa9fccd90673e
+  data.tar.gz: 9addba3dafc9ce19639752a608051c58b9d0d521bf4105bfa5ed8272e92146cc
 SHA512:
-  metadata.gz: bfa17e62d1e8e47477c7653ec2031e1886c651f5366a376ff8edd612d66efae74c4dfe19645f33ecb18ba458c293701fe28df26b2b4435999493fbe48d314daf
-  data.tar.gz: 168d7997ac6136ee3d1a2cf2313276ae79ffb43fb14cc3a0ecb5f65cf92a9f3b7f968347e8f9ef25d6e04deeec68ecc4f3dfdddf7e1184aafc68940bc0edbd4d
+  metadata.gz: 266e4236bf6f3abd8d5baf20859262eacb7b109da6cce66789587d6d17e4b4b9aed2e7e70d5ebd4a69868868c8fa2636cbb5c68d1265668eb15dff63121c08f5
+  data.tar.gz: 4e47277e9afaf8b01a9cd00312d2ba8bd9b9457705db97acccc8ef323ff09a260aabe6668fdd235c4684d4bdfca48421c3ba32def50343c5f270c8c70987633a

data/lib/command.rb

@@ -8,6 +8,7 @@ class Command < Gloo::Core::Obj
 
   KEYWORD = 'command'.freeze
   KEYWORD_SHORT = 'command'.freeze
+  NAME = 'name'.freeze
   DESCRIPTION = 'description'.freeze
   ACTION = 'action'.freeze
   DYNAMIC = 'dynamic'.freeze
@@ -16,6 +17,7 @@ class Command < Gloo::Core::Obj
   CONTEXT = 'context'.freeze
   OPTIONS = 'options'.freeze
   OPTIONS_KEY = 'options_key'.freeze
+  ON_ERROR = 'on_error'.freeze
 
   #
   # The name of the object type.
@@ -105,14 +107,29 @@ class Command < Gloo::Core::Obj
     Gloo::Exec::Dispatch.message( @engine, 'run', o )
   end
 
+  #
+  # Run the action script with context.
+  #
   def run_action_with_context( context )
     o = find_child ACTION
     return unless o
 
     ctx = find_child CONTEXT
     ctx.set_value( context ) if ctx
-    
+
+    Gloo::Exec::Dispatch.message( @engine, 'run', o )
+  end
+
+  #
+  # Run the on_error script if one exists.
+  # Returns true if the script was found and run, false otherwise.
+  #
+  def run_on_error
+    o = find_child ON_ERROR
+    return false unless o
+
     Gloo::Exec::Dispatch.message( @engine, 'run', o )
+    return true
   end
 
 

data/lib/shell.rb

@@ -11,6 +11,11 @@ class Shell < Gloo::Core::Obj
   PROMPT = 'prompt'.freeze
   DEFAULT_ACTION = 'default_action'.freeze
   INCLUDE_QUIT = 'include_quit'.freeze
+  ON_ERROR = 'on_error'.freeze
+  ON_UNKNOWN_CMD = 'on_unknown_command'.freeze
+  ON_EMPTY_CMD = 'on_empty_command'.freeze
+  BEFORE_ACTION = 'before_action'.freeze
+  AFTER_ACTION = 'after_action'.freeze
 
   #
   # The name of the object type.
@@ -93,6 +98,8 @@ class Shell < Gloo::Core::Obj
   
   #
   # Start the shell.
+  # If CLI args were passed, execute that command once and return.
+  # Otherwise, enter the interactive REPL.
   #
   def msg_start
     runner = get_runner
@@ -100,7 +107,12 @@ class Shell < Gloo::Core::Obj
     # add_test_commands
     add_quit_command
 
-    runner.start
+    cmd_tokens = @engine.args.files
+    if cmd_tokens.any?
+      runner.execute_once( cmd_tokens )
+    else
+      runner.start
+    end
   end
 
   #
@@ -127,6 +139,62 @@ class Shell < Gloo::Core::Obj
     @runner.set_context( key, value )
   end
 
+  #
+  # Run the on_error script if one exists.
+  # Returns true if the script was found and run, false otherwise.
+  #
+  def run_on_error
+    o = find_child ON_ERROR
+    return false unless o
+
+    Gloo::Exec::Dispatch.message( @engine, 'run', o )
+    return true
+  end
+
+  #
+  # Run the on_unknown_cmd script if one exists.
+  # Returns true if the script was found and run, false otherwise.
+  #
+  def run_on_unknown_cmd
+    o = find_child ON_UNKNOWN_CMD
+    return false unless o
+
+    Gloo::Exec::Dispatch.message( @engine, 'run', o )
+    return true
+  end
+
+  #
+  # Run the on_empty_command script if one exists.
+  # Returns true if the script was found and run, false otherwise.
+  #
+  def run_on_empty_cmd
+    o = find_child ON_EMPTY_CMD
+    return false unless o
+
+    Gloo::Exec::Dispatch.message( @engine, 'run', o )
+    return true
+  end
+
+  #
+  # Run the before_action script if one exists.
+  #
+  def run_before_action
+    o = find_child BEFORE_ACTION
+    return unless o
+
+    Gloo::Exec::Dispatch.message( @engine, 'run', o )
+  end
+
+  #
+  # Run the after_action script if one exists.
+  #
+  def run_after_action
+    o = find_child AFTER_ACTION
+    return unless o
+
+    Gloo::Exec::Dispatch.message( @engine, 'run', o )
+  end
+
 
   # ---------------------------------------------------------------------
   #    Commands
@@ -145,48 +213,4 @@ class Shell < Gloo::Core::Obj
     })
   end
 
-  # def add_test_commands
-  #   @runner.add_command_node({
-  #     name: "add",
-  #     description: "add a project",
-  #     method: "cmd_add"
-  #   })
-
-  #   @runner.add_command_node({
-  #     name: "show",
-  #     description: "show a resource",
-  #     children: [
-  #       {
-  #         name: "project",
-  #         description: "show a project",
-  #         dynamic: true,
-  #         source: "projects"
-  #       },
-  #       {
-  #         name: "task",
-  #         description: "show a task",
-  #         dynamic: true,
-  #         source: "tasks"
-  #       }
-  #     ]
-  #   })
-
-  #   @runner.add_command_node({
-  #     name: "list",
-  #     description: "list resources",
-  #     children: [
-  #       {
-  #         name: "projects",
-  #         description: "list projects",
-  #         method: "cmd_projects"
-  #       },
-  #       {
-  #         name: "tasks",
-  #         description: "list tasks",
-  #         method: "cmd_tasks"
-  #       }
-  #     ]
-  #   })
-  # end
-
 end

data/lib/shell_runner.rb

@@ -9,6 +9,8 @@ require "readline"
 class ShellRunner
 
   DEFAULT_PROMPT = " -> "
+  UNKNOWN_COMMAND = "Unknown command".freeze
+  
   # 
   # Initialize the shell runner
   # 
@@ -48,9 +50,23 @@ class ShellRunner
     return p ? p + ' ' : DEFAULT_PROMPT
   end
 
-  # 
+  #
+  # Handle an empty command — run on_empty_command if defined, otherwise do nothing.
+  #
+  def handle_empty_command
+    @obj.run_on_empty_cmd
+  end
+
+  #
+  # Handle an unknown command — run on_unknown_cmd if defined, otherwise show default message.
+  #
+  def handle_unknown_command
+    @obj.run_on_unknown_cmd || puts( UNKNOWN_COMMAND )
+  end
+
+  #
   # Quit the shell.
-  # 
+  #
   def cmd_quit( obj, context )
     puts "Quitting…"
     context.done = true
@@ -67,15 +83,21 @@ class ShellRunner
     end
   end
 
-  def cmd_obj_action_with_context( cmd_node, parent_node = nil )    
+  #
+  # Run an action on an object with context.
+  #
+  def cmd_obj_action_with_context( cmd_node, parent_node = nil )
     if parent_node
       pn = Gloo::Core::Pn.new( @engine, parent_node.obj )
       command = pn.resolve
       if command
-        command.run_action_with_context( cmd_node.name )
+        begin
+          command.run_action_with_context( cmd_node.name )
+        rescue => e
+          command.run_on_error || @obj.run_on_error
+        end
       end
     end
-
   end
 
 
@@ -162,7 +184,22 @@ class ShellRunner
   #    REPL
   # ---------------------------------------------------------------------
 
-  # 
+  #
+  # Execute a single command from the given tokens and return.
+  # Used when a command is passed directly from the CLI.
+  #
+  def execute_once( tokens )
+    result = traverse( @root, tokens )
+    if result[:node]
+      @obj.run_before_action
+      execute_command( result[:node], tokens, result[:parent] )
+      @obj.run_after_action
+    else
+      handle_unknown_command
+    end
+  end
+
+  #
   # Traverse the command tree to find the matching node
   # 
   # @param node [CommandNode] The current node
@@ -228,14 +265,19 @@ class ShellRunner
 
     while ( ! @context.done && (line = Readline.readline(prompt, true)) )
       tokens = line.strip.split(" ")
-      next if tokens.empty?
+      if tokens.empty?
+        handle_empty_command
+        next
+      end
 
       result = traverse( @root, tokens )
 
       if result[:node]
+        @obj.run_before_action
         execute_command( result[:node], tokens, result[:parent] )
+        @obj.run_after_action
       else
-        puts "Unknown command"
+        handle_unknown_command
       end
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gloo-cli
 version: !ruby/object:Gem::Version
-  version: '1.3'
+  version: '1.5'
 platform: ruby
 authors:
 - Eric Crane
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-01 00:00:00.000000000 Z
+date: 2026-06-09 00:00:00.000000000 Z
 dependencies: []
 description: Adds CLI support to Gloo.
 email: