gloo-cli 1.8 → 1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c20054e5d495fde4abf0d067fd09015b02af2de350075834b2f58914f54be0d1
-  data.tar.gz: e363c1996f92d4718b75ed1176ea640a4484efb08cc91737337f8fdd80e65ec0
+  metadata.gz: 16d9a2fde425817962361d58b380edd237a59dfa4d1eb5f207f60e99ec019c51
+  data.tar.gz: 6efaf972d566c21d6353e0da0cbb333b22726d27ebd39799d38281c8943e0c19
 SHA512:
-  metadata.gz: 90750e252eb055d6378177d2b22cdaac0eb57c1171128f341c37f40b603f7e5231a11cbe4463b9bf145d8a2fecc37a929ef7dcad788cfeee06772ee089e4ab47
-  data.tar.gz: 0d0ddc595fdd62f09ce591e7167df8542ee22eb3dbb97990ed5c3e556c99f52d360f935ae96489744feb906d02f1ba5e51ce32c44cc9d613c8f1722590edd1a9
+  metadata.gz: f979302be6f0c9d5a97d7bd2a7f9c1f77ba82033bb95ad2e3740bcf8d4ccb7ff6f7044eec02d5985cfa3bbcf321b9f768f2c11122b96fdde7960797d3c3fc309
+  data.tar.gz: 947e3b9edcfd87644751ab5fdba9248f149a19400069bd50e775b5fb45f1b57b15641bc701ea6764f532fa2ff25f9b20c928179ddec29510c88ebf73680488b9

data/lib/shell.rb

@@ -16,6 +16,7 @@ class Shell < Gloo::Core::Obj
   ON_EMPTY_CMD = 'on_empty_command'.freeze
   BEFORE_ACTION = 'before_action'.freeze
   AFTER_ACTION = 'after_action'.freeze
+  WITH_COMMAND = 'with_command'.freeze
 
   #
   # The name of the object type.
@@ -89,17 +90,37 @@ class Shell < Gloo::Core::Obj
     return super + [ 'start', 'stop' ]
   end
 
-  # 
+  #
   # Get the shell runner or initialize it if it doesn't exist.
+  # In App mode, any CLI parameter(s) after the app path become the
+  # runner's single command (see ShellRunner#single_command?) rather
+  # than files for gloo to load - @engine.args keeps those out of
+  # @engine.args.files for exactly this reason.
   #
   def get_runner
-    return @runner ||= ShellRunner.new( @engine, self )
+    set_with_command
+    return @runner ||= ShellRunner.new( @engine, self, command: @engine.args.command_tokens )
   end
-  
+
+  #
+  # If the app was invoked with a supplied command, record it on a
+  # with_command child (creating it if the script hasn't declared one
+  # itself), so scripts can tell a one-shot run from an interactive
+  # session - even before the shell starts (e.g. to skip a banner or
+  # menu). Left untouched (and uncreated) when no command was given.
+  #
+  def set_with_command
+    tokens = @engine.args.command_tokens
+    return if tokens.empty?
+
+    o = find_child( WITH_COMMAND ) || @engine.factory.create_string( WITH_COMMAND, '', self )
+    o.set_value( tokens.join( ' ' ) )
+  end
+
   #
   # Start the shell.
-  # If CLI args were passed, execute that command once and return.
-  # Otherwise, enter the interactive REPL.
+  # If the app was invoked with extra command-line arguments, execute
+  # that one command and return. Otherwise, enter the interactive REPL.
   #
   def msg_start
     runner = get_runner
@@ -107,12 +128,7 @@ class Shell < Gloo::Core::Obj
     # add_test_commands
     add_quit_command
 
-    cmd_tokens = @engine.args.files
-    if cmd_tokens.any?
-      runner.execute_once( cmd_tokens )
-    else
-      runner.start
-    end
+    runner.start
   end
 
   #
@@ -237,7 +253,11 @@ class Shell < Gloo::Core::Obj
         "on_unknown_command (script) — Optional. Run when the input doesn't match any known command; if absent, a default \"Unknown command\" message is shown instead.",
         'on_empty_command (script) — Optional. Run when the user submits an empty line.',
         'before_action (script) — Optional. Run before every command executes.',
-        'after_action (script) — Optional. Run after every command executes.'
+        'after_action (script) — Optional. Run after every command executes.',
+        'with_command (string) — Not present by default. Set (and created if the ' \
+          'script hasn\'t declared it) to the supplied command text whenever the app ' \
+          'was invoked with extra command-line arguments - check for it to tell a ' \
+          'one-shot run from an interactive session.'
       ],
       :messages => [
         'start — Start the shell. If the app was invoked with extra command-line arguments, execute that one command and return; otherwise enter the interactive REPL.',

data/lib/shell_runner.rb

@@ -11,14 +11,18 @@ class ShellRunner
   DEFAULT_PROMPT = " -> "
   UNKNOWN_COMMAND = "Unknown command".freeze
   
-  # 
+  #
   # Initialize the shell runner
-  # 
+  #
   # @param obj [Object] The shell obj.
-  # 
-  def initialize( engine, obj )
+  # @param opts [Hash] :command (Array<String>) - tokens for a single
+  #   command to run once, instead of entering the interactive REPL -
+  #   see #single_command?.
+  #
+  def initialize( engine, obj, opts = {} )
     @engine = engine
     @obj = obj
+    @command = opts[ :command ]
     @context = ShellContext.new
     @root = CommandNode.new( nil )
   end
@@ -27,12 +31,26 @@ class ShellRunner
   # ---------------------------------------------------------------------
   #    Shell, control, start and stop
   # ---------------------------------------------------------------------
-  
-  # 
-  # Start the shell.
-  # 
+
+  #
+  # Were command tokens supplied at construction? When true, #start
+  # runs that one command via #execute_once and returns instead of
+  # entering the REPL.
+  #
+  def single_command?
+    return !( @command.nil? || @command.empty? )
+  end
+
+  #
+  # Start the shell: run the single supplied command and return,
+  # or enter the interactive REPL if none was supplied.
+  #
   def start
-    repl
+    if single_command?
+      execute_once( @command )
+    else
+      repl
+    end
   end
 
   # 

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gloo-cli
 version: !ruby/object:Gem::Version
-  version: '1.8'
+  version: '1.9'
 platform: ruby
 authors:
 - Eric Crane
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-09-14 00:00:00.000000000 Z
 dependencies: []
 description: Adds CLI support to Gloo.
 email:
@@ -35,6 +36,7 @@ licenses:
 metadata:
   gloo.type: core-library
   documentation_uri: https://github.com/ecrane/gloo
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -49,7 +51,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.17
+rubygems_version: 3.5.16
+signing_key:
 specification_version: 4
 summary: Gloo core library. CLI support.
 test_files: []