gloo 4.6.1 → 5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83c998e950da4cdd0f74ce85512de237f9fd73bc9187fe55b49c6bb554e13bc1
-  data.tar.gz: 07e00df49aea7385673b27c5cb31cc6e5d4f926cebabe7f14d754a04e3eae949
+  metadata.gz: 124d817789d21c4e9899f12195b66ae06cb26a8cba150a03a3b97ec63a524160
+  data.tar.gz: 3694e28d17ff419835889026b25ef96bc7316e13cc3c8c51e42dcde215ccaca1
 SHA512:
-  metadata.gz: a0ed6794423d73bb4adaf913662cf28dd9095ea07b1885feb422384cd394acbafbd362da0b60d4384a04f44ca49b1a1c4a3a9d4f84f9caa8fb48b5bbf74e0380
-  data.tar.gz: 6cd54ec494fff41b92e9fb8788ae0e6c76b412ae2eba2a0ae8fe466ecfc45936743bf3d08d37e2a9cf02bf8d4905cc3ba8d60dd7d11d2fec7bbe8ac520c7861b
+  metadata.gz: 729f3041b377589a22186b4fbe42b9971e3376f4404a2b5f1bc21b312d92b490b90dc40edcf5e651ba41799371f4594c8c9c1a17170c1c36e2d2488972d3a8b8
+  data.tar.gz: 6e8162b00779c17012b2ac0177686a98928729a34e46390bf742df663c61266ae8024f5dfbd32a2c75a2db1949f766add6b218282620160ec59e325673569261

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2022 Eric Crane
+Copyright (c) 2026 Eric Crane
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/gloo.gemspec

@@ -27,27 +27,38 @@ Gem::Specification.new do |spec|
   spec.executables << 'o'
   spec.executables << 'gloo'
 
+  # 
+  # Development Dependencies
+  # 
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'minitest', '~> 5.1', '>= 5.14.2'
   spec.add_development_dependency "rake", '~> 13.0', '>= 13.0.1'
   spec.add_development_dependency 'concurrent-ruby', '1.3.4'
 
+  # Used by many objects
   spec.add_dependency "activesupport", '~> 6.1', ">= 6.1.5" 
+
+  # Used by date and time tools
   spec.add_dependency 'chronic', '~> 0.10', '>= 0.10.2'
 
+  # Used by json tools
+  spec.add_dependency 'json', '~> 2.1', '>= 2.1.0'
+
+  # Used by cipher string tool
+  spec.add_dependency 'openssl'
+
+  # Used by password generation
+  spec.add_dependency 'bcrypt', '~> 3.1.20'
+
+  # Used by gloo system
+  spec.add_dependency 'os', '~> 1.1', '>= 1.1.4'
+
+  # 
+  # App UI libs
+  # 
   spec.add_dependency 'colorize', '~> 1.1.0', '>= 1.1.0'
   spec.add_dependency 'inquirer'
   spec.add_dependency 'reline'  
   spec.add_dependency 'terminal-table'
-  
-  spec.add_dependency 'json', '~> 2.1', '>= 2.1.0'
-  spec.add_dependency 'openssl'
-  spec.add_dependency 'net-ssh', '~> 6.1', '>= 6.1.0'
-  spec.add_dependency 'mysql2', '~> 0.5', '>= 0.5.3'
-  spec.add_dependency 'sqlite3', '~> 1.4', '>= 1.4.2'
-  spec.add_dependency 'os', '~> 1.1', '>= 1.1.4'
-  # spec.add_dependency 'pg', '~> 1.5.4'
-  spec.add_dependency 'thin', '~> 1.8.2'
-  spec.add_dependency 'redcarpet', '~> 3.6.0'
-  spec.add_dependency 'bcrypt', '~> 3.1.20'
+
 end

data/lib/VERSION

@@ -1 +1 @@
-4.6.1
+5.0

data/lib/VERSION_NOTES

@@ -1,3 +1,15 @@
+5.0 - 2026.02.07
+ - Adds plugin systems for extensions and core libraries
+ - Adds exists? verb
+ - Updates help to show extensions and libraries
+ - Moves a number of objects into the new core libraries structure
+
+
+4.7.0 - 2026.01.18
+- Adds the Extension Manager.
+- Moves alert, beep, slack, teams out of gloo into extensions.
+
+
 4.6.1 - 2025.09.25
  - Adds container support to object to JSON conversion.
 

data/lib/gloo/app/engine.rb

@@ -13,7 +13,8 @@ module Gloo
 
       attr_reader :settings, :log, :running_app
       attr_reader :args, :mode, :running, :platform,
-                  :dictionary, :parser, :heap, :factory
+                  :dictionary, :parser, :heap, :factory,
+                  :ext_manager, :lib_manager
       attr_accessor :last_cmd, :persist_man, :event_manager,
                     :exec_env, :converter
 
@@ -50,6 +51,8 @@ module Gloo
         @factory = Gloo::Core::Factory.new( self )
         @persist_man = Gloo::Persist::PersistMan.new( self )
         @event_manager = Gloo::Core::EventManager.new( self )
+        @ext_manager = Gloo::Plugin::ExtManager.new( self )
+        @lib_manager = Gloo::Plugin::LibManager.new( self )
 
         @exec_env = Gloo::Exec::ExecEnv.new( self )
         @converter = Gloo::Convert::Converter.new( self )
@@ -58,6 +61,7 @@ module Gloo
         run_mode
       end
 
+
       # ---------------------------------------------------------------------
       #    Serialization
       # ---------------------------------------------------------------------
@@ -94,6 +98,7 @@ module Gloo
         @log.restore_after_deserialization
       end
 
+
       # ---------------------------------------------------------------------
       #    Run
       # ---------------------------------------------------------------------
@@ -227,6 +232,7 @@ module Gloo
         @log.info 'Gloo engine is quitting...'
       end
 
+
       # ---------------------------------------------------------------------
       #    Running app within gloo
       # ---------------------------------------------------------------------
@@ -267,6 +273,7 @@ module Gloo
         quit
       end
 
+      
       # ---------------------------------------------------------------------
       #    Error Handling
       # ---------------------------------------------------------------------

data/lib/gloo/app/running_app.rb

@@ -77,6 +77,19 @@ module Gloo
         return @db_clients[ obj.pn ]
       end
 
+
+      # ---------------------------------------------------------------------
+      #    Running app helpers
+      # ---------------------------------------------------------------------
+
+      #
+      # Create a table renderer if the web server core lib is loaded.
+      #
+      def create_table_renderer
+        # if exists 
+        return WebSvr::TableRenderer.new( @engine )
+      end
+
     end
   end
 end

data/lib/gloo/app/settings.rb

@@ -11,7 +11,7 @@ module Gloo
     class Settings
 
       attr_reader :user_root, :log_path,
-        :config_path, :project_path,
+        :config_path, :project_path, :ext_path,
         :start_with, :list_indent, :list_levels, :tmp_path,
         :debug_path, :debug
 
@@ -50,6 +50,7 @@ module Gloo
         puts "\n Application Paths:".blue
         puts '   User Root Path is here:  '.yellow + @user_root.white
         puts '   Projects Path:  '.yellow + @project_path.white
+        puts '   Extensions Path:  '.yellow + @ext_path.white
         puts '   Tmp Path:  '.yellow + @tmp_path.white
         puts '   Debug Path:  '.yellow + @debug_path.white
         puts "\n"
@@ -131,6 +132,9 @@ module Gloo
         @config_path = File.join( @user_root, 'config' )
         Dir.mkdir( @config_path ) unless File.exist?( @config_path )
 
+        @ext_path = File.join( @user_root, 'extensions' )
+        Dir.mkdir( @ext_path ) unless File.exist?( @ext_path )
+
         @tmp_path = File.join( @user_root, 'tmp' )
         Dir.mkdir( @tmp_path ) unless File.exist?( @tmp_path )
 

data/lib/gloo/core/dictionary.rb

@@ -138,6 +138,7 @@ module Gloo
         end
       end
 
+      
       # ---------------------------------------------------------------------
       #    Register after start up
       # ---------------------------------------------------------------------
@@ -178,6 +179,7 @@ module Gloo
         @keywords.delete( obj_class.short_typename )
       end
 
+
       # ---------------------------------------------------------------------
       #    Private
       # ---------------------------------------------------------------------
@@ -221,7 +223,12 @@ module Gloo
       # Add an object to the dictionary
       # 
       def add_object o
-        # @engine.log.debug o
+        # Make sure it hasn't already been registered
+        if ( @objs.key?(o.typename) || @objs.key?(o.short_typename) )
+          @engine.err "duplicate object type '#{o.typename}' or '#{o.short_typename}'"
+          return
+        end
+
         @objs[ o.typename ] = o
         @objs[ o.short_typename ] = o
         add_key o.typename
@@ -232,7 +239,13 @@ module Gloo
       # Add a verb to the dictionary
       # 
       def add_verb v
-        # @engine.log.debug v
+        # Make sure it hasn't already been registered
+        if ( verb?( v.keyword ) || verb?( v.keyword_shortcut ))
+          puts "duplicate verb keyword '#{v.keyword}' or '#{v.keyword_shortcut}'"
+          @engine.err "duplicate verb keyword '#{v.keyword}' or '#{v.keyword_shortcut}'"
+          return
+        end
+
         @verbs[ v.keyword ] = v
         @verbs[ v.keyword_shortcut ] = v
         # v.send( :new ).run

data/lib/gloo/objs/ctrl/each.rb

@@ -100,8 +100,8 @@ module Gloo
           EachLine.new( @engine, self ).run
         elsif EachFile.use_for?( self )
           EachFile.new( @engine, self ).run
-        elsif EachRepo.use_for?( self )
-          EachRepo.new( @engine, self ).run
+        # elsif EachRepo.use_for?( self )
+        #   EachRepo.new( @engine, self ).run
         else 
           @engine.err "Not set up to run each for that target."
         end

data/lib/gloo/plugin/base.rb

@@ -0,0 +1,19 @@
+# 
+# A Base class for extensions.
+# Used by extensions to register verbs and objects.
+# 
+module Gloo
+  module Plugin
+    class Base
+
+      # 
+      # Register verbs and objects.
+      # 
+      def register( callback )
+        raise NotImplementedError, "Extensions must implement register method"
+      end
+
+    end
+  end
+end
+  

data/lib/gloo/plugin/callback.rb

@@ -0,0 +1,33 @@
+# 
+# A mechanism for registering extension components.
+# 
+module Gloo
+  module Plugin
+    class Callback
+
+      # 
+      # Initialize the callback.
+      # 
+      def initialize( engine )
+        @engine = engine
+      end
+
+      # 
+      # Register a verb.
+      # 
+      def register_verb( verb_class )
+        @engine.log.debug "Registering verb: #{verb_class} from callbackup helper"
+        @engine.dictionary.register_verb_post_start( verb_class )
+      end
+
+      # 
+      # Register an object.
+      # 
+      def register_obj( object_class )
+        @engine.log.debug "Registering object: #{object_class} from callback helper"
+        @engine.dictionary.register_obj_post_start( object_class )
+      end
+      
+    end
+  end
+end

data/lib/gloo/plugin/ext_manager.rb

@@ -0,0 +1,90 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2026 Eric Crane.  All rights reserved.
+#
+# The Extension Manager.
+# Load extensions as needed and register their verbs and objects.
+#
+
+module Gloo
+  module Plugin
+    class ExtManager
+
+      # Constants for extension management
+      EXT_FILE = '_ext.rb'
+
+      #
+      # Set up the extension manager.
+      #
+      def initialize( engine )
+        @engine = engine
+        @extensions = {}
+        @engine.log.debug 'extension manager intialized...'
+      end
+
+      # 
+      # Get the loaded extensions.
+      #
+      def loaded_extensions
+        return @extensions
+      end
+
+      # 
+      # Get the start file for the extension.
+      # 
+      def ext_start_file name
+        root = @engine.settings.ext_path
+
+        unless File.exist?( root )
+          @engine.log.error "Extension directory does not exist: #{root}"
+          return nil
+        end
+        
+        f = File.join( root, name, name + EXT_FILE )
+        unless File.exist?( f )
+          @engine.log.error "Extension start file does not exist: #{f}"
+          return nil
+        end
+        
+        return f
+      end
+
+      # 
+      # Load the extension of the given name.
+      # The name will correspond with the name of a directory
+      # within the gloo extensions directory.
+      #
+      def load_ext( name )
+        @engine.log.debug "Loading extension: #{name}"
+        fn = ext_start_file name
+
+        unless fn
+          @engine.log.error "Extension start file not found for: #{name}"
+          return
+        end
+        
+        @extensions[name] = fn
+        register_extension name, fn
+        @engine.log.debug "Extension loaded: #{name}"
+      end
+
+      # 
+      # Give the extension a chance to register its verbs and objects.
+      # 
+      def register_extension( name, full_path )
+        require full_path
+
+        class_name = name.capitalize + "Ext"
+        @engine.log.debug "Looking for extension to register: #{class_name}"
+        begin
+          plugin_class = Object.const_get( class_name )
+          inst = plugin_class.new
+          ext_cb = Callback.new( @engine )
+          inst.register( ext_cb )
+        rescue NameError
+          @engine.log.error "Warning: Could not find class #{class_name} in file #{full_path}"
+        end
+      end
+
+    end
+  end
+end

data/lib/gloo/plugin/lib_manager.rb

@@ -0,0 +1,97 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2026 Eric Crane.  All rights reserved.
+#
+# The Library Manager.
+# Load libraries as needed and register their verbs and objects.
+#
+
+module Gloo
+  module Plugin
+    class LibManager
+
+      # Constants for library management
+      GEM_PREFIX = 'gloo-'
+      INIT_CLASS_SUFFIX = 'Init'
+
+      #
+      # Set up the library manager.
+      #
+      def initialize( engine )
+        @engine = engine
+        @libraries = {}
+        @engine.log.debug 'library manager intialized...'
+      end
+
+      # 
+      # Get the loaded libraries.
+      #
+      def loaded_libraries
+        return @libraries
+      end
+
+      # 
+      # Get the start file for the gem core library.
+      # 
+      def core_lib_name name
+        return GEM_PREFIX + name
+      end
+
+      # 
+      # Get the library initialization class name.
+      # 
+      def init_class_name name
+        return name.camelize + INIT_CLASS_SUFFIX
+      end
+
+      # 
+      # Load the library of the given name.
+      # The name will correspond with the name of a directory
+      # within the gloo libraries directory.
+      #
+      def load_lib( name )
+        @engine.log.debug "Loading core library: #{name}"
+        gem_name = core_lib_name name
+        
+        @libraries[name] = gem_name
+        register_library name, gem_name
+        @engine.log.debug "Core library loaded: #{name}"
+      end
+
+      # 
+      # Require a gem by name, installing it if it's not available.
+      #
+      def require_gem gem_name
+        @engine.log.debug "Going to require gem: #{gem_name}"
+        begin
+          gem gem_name
+        rescue Gem::LoadError
+          @engine.log.info "Gem not found, attempting to install: #{gem_name}"
+          system("gem install #{gem_name}")
+          Gem.clear_paths
+          gem gem_name
+        end
+
+        require gem_name
+      end
+
+      # 
+      # Give the library a chance to register its verbs and objects.
+      # 
+      def register_library( name, gem_name )
+        require_gem gem_name
+
+        class_name = init_class_name name
+        @engine.log.debug "Looking for library entry point class to register: #{class_name}"
+        begin
+          plugin_class = Object.const_get( class_name )
+          inst = plugin_class.new
+          lib_cb = Callback.new( @engine )
+          inst.register( lib_cb )
+        rescue NameError
+          @engine.log.error "Warning: Could not find class #{class_name}"
+        end
+      end
+
+    end
+  end
+end

data/lib/gloo/verbs/exists.rb

@@ -0,0 +1,75 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2026 Eric Crane.  All rights reserved.
+#
+# Check to see if a verb or object type has been defined (or loaded).
+#
+
+module Gloo
+  module Verbs
+    class Exists < Gloo::Core::Verb
+
+      KEYWORD = 'exists?'.freeze
+      KEYWORD_SHORT = 'exist'.freeze
+      VERB_TYPE = 'verb'.freeze
+      OBJ_TYPE = 'object'.freeze
+      ANY_TYPE = 'any'.freeze
+      MISSING_EXPR_ERR = 'Missing Expression!'.freeze
+      WRONG_NUM_ARGS_ERR = 'Wrong number of arguments! 2 or 3 expected.'.freeze
+
+      #
+      # Run the verb.
+      #
+      def run
+        if @tokens.token_count == 3
+          type = @tokens.second.strip.downcase
+          keyword = @tokens.last
+        elsif @tokens.token_count == 2
+          type = ANY_TYPE
+          keyword = @tokens.second
+        else
+          @engine.err WRONG_NUM_ARGS_ERR
+          return
+        end
+        
+        @engine.heap.it.set_to lookup_keyword(keyword, type)
+      end
+
+      #
+      # Get the Verb's keyword.
+      #
+      def self.keyword
+        return KEYWORD
+      end
+
+      #
+      # Get the Verb's keyword shortcut.
+      #
+      def self.keyword_shortcut
+        return KEYWORD_SHORT
+      end
+
+
+      # ---------------------------------------------------------------------
+      #    Private functions
+      # ---------------------------------------------------------------------
+
+      private
+
+      # 
+      # Lookup a keyword in the dictionary.
+      # 
+      def lookup_keyword( keyword, type )
+        if type == VERB_TYPE
+          return @engine.dictionary.verb?(keyword)
+        elsif type == OBJ_TYPE
+          return @engine.dictionary.obj?(keyword)
+        elsif type == ANY_TYPE
+          return @engine.dictionary.verb?(keyword) || @engine.dictionary.obj?(keyword)
+        end
+
+        return false
+      end
+
+    end
+  end
+end

data/lib/gloo/verbs/help.rb

@@ -22,7 +22,15 @@ module Gloo
         o: 'show_objs',
         obj: 'show_objs',
         object: 'show_objs',
-        objects: 'show_objs'
+        objects: 'show_objs',
+        e: 'show_ext',
+        ext: 'show_ext',
+        l: 'show_lib',
+        lib: 'show_lib',
+        library: 'show_lib',
+        libraries: 'show_lib',
+        extension: 'show_ext',
+        extensions: 'show_ext'
       }.freeze
 
       #
@@ -91,6 +99,8 @@ module Gloo
         data << " Help Options:\n"
         data << "   ? objects (obj, o) \n"
         data << "   ? verbs (v) \n"
+        data << "   ? ext (e) \n"
+        data << "   ? lib (l) \n"
         data << "   ? settings (s) \n"
         data << "\n For detailed documentation use the gloo website. \n"
         data << "\n     https://gloo.ecrane.us/doc/. \n\n"
@@ -181,6 +191,53 @@ module Gloo
         return str
       end
 
+      #
+      # List the extensions
+      #
+      def show_ext
+        data = "\n"
+        data << " Extensions\n".blue
+        data << "#{get_extensions}\n\n"
+        @engine.log.show data
+      end
+
+      #
+      # Get the text for the list of extensions.
+      #
+      def get_extensions
+        str = ''
+        exts = @engine.ext_manager.loaded_extensions.sort
+        exts.each do |name, ext|
+          str << "   #{name.white} \n"
+        end
+
+        return str
+      end
+
+      #
+      # List the libraries
+      #
+      def show_lib
+        data = "\n"
+        data << " Libraries\n".blue
+        data << "#{get_libraries}\n\n"
+        @engine.log.show data
+      end
+
+      #
+      # Get the text for the list of libraries.
+      #
+      def get_libraries
+        str = ''
+        libs = @engine.lib_manager.loaded_libraries.sort
+        libs.each do |name, lib|
+          str << "   #{name.white} \n"
+        end
+
+        return str
+      end
+
+
     end
   end
 end