gloo 2.5.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a7a9a2289b2ecb245cf9c689bfc693acc1f45c183ab4569e42d290436d88600
-  data.tar.gz: 2b8ba9e7c0e89c84d6cf129c6dc549c3655af88f0e140bf18a082b0fe94d4392
+  metadata.gz: 85917a19626e03193559e9e779a77f9a50e42083729824d27f8651d629af9b8d
+  data.tar.gz: 5d1cdc8947f63a756dcaee08c59751a104c6c202771a7de6edbb5fcfbebb9fcb
 SHA512:
-  metadata.gz: 9d6364f481d93ae3f4d2434eb3fc13f611ddb567caf071743a17a0e10e5afb3bbf4091d8c7ee4bb37566e9a77bc61dac88f81076706bd20460e3ecdda9f3c445
-  data.tar.gz: 95bd30fc3ba446f660b178fc756642070deca1d6d035d1576f6faea3788bf568bfbb1e37065191158ab4086d06c29437659e3eeaffaa0338740c1ad1d11d4150
+  metadata.gz: 991ab79d39d1c9606f4a72b18ac99cc6ab32b6924f7af9e17bd707ad6d32970d7c6f0a994b33152905cfe460c9035fbd19c10a0b522e35ffecc38625a663ca50
+  data.tar.gz: 725741071414ff857311f243e930bb393a3c04e46017bb154c500e96831bead87d7ee5f750ed830291d0657a9f1a5a4e877879fa3705adea28bc93f549e2b4db

data/README.md

@@ -1,43 +1,24 @@
 # Gloo
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/gloo`. To experiment with that code, run `bin/console` for an interactive prompt.
+Gloo is a scripting language built on ruby.
 
-TODO: Delete this and the text above, and describe your gem
 
 ## Installation
 
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'gloo'
-```
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
+Install gloo like this:
 
     $ gem install gloo
 
-## Usage
 
-TODO: Write usage instructions here
-
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+## Usage
 
-## Contributing
+Run gloo:
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/gloo. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+    $ gloo
 
-## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+## Documentation
 
-## Code of Conduct
+See documentation here:
 
-Everyone interacting in the OutlineScript project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/gloo/blob/master/CODE_OF_CONDUCT.md).
+    https://gloo.ecrane.us/doc

data/bin/run

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+# 
+#   Run Gloo (this gem) but not as a gem (app), just referencing source code.
+# 
+#   From the root of the project, run Gloo with:
+# 
+#       > bin/run
+# 
+
+ruby ./lib/run.rb

data/gloo.gemspec

@@ -41,4 +41,5 @@ Gem::Specification.new do |spec|
   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'
 end

data/lib/VERSION

@@ -1 +1 @@
-2.5.0
+3.0.0

data/lib/VERSION_NOTES

@@ -1,3 +1,18 @@
+3.0.0 - 2023.12.27
+ - Adds events: on_quit, on_save, on_unload, on_reload
+ - More robust JSON object
+ - Adds Postgres connectivity
+ - Adds log verb and error log file
+ - More options in gloo CLI menus
+    - q! - quit app (and gloo)
+    - update so a quit cmd from gloo script works in menu
+    - show breadcrumb of menu hierarchy
+    - : cmd - use colon or some other symbol to run a gloo command from a menu
+       - Maybe : with no command to drop out of menus to gloo?
+    - qq - Quit to top menu
+ - Option to run in --app mode
+
+
 2.5.0 - 2023.06.28
  - Catch run time exceptions and show in error log.
 

data/lib/gloo/app/args.rb

@@ -14,7 +14,7 @@ module Gloo
       QUIET = 'quiet'.freeze
       GLOO_ENV = 'GLOO_ENV'.freeze
 
-      attr_reader :switches, :files
+      attr_reader :switches, :files, :app_path
 
       #
       # Create arguments and setup.
@@ -23,6 +23,7 @@ module Gloo
         @engine = engine
         @switches = []
         @files = []
+        @app_path = nil
 
         params.each { |o| process_one_arg( o ) }
         ARGV.each { |o| process_one_arg( o ) }
@@ -35,6 +36,34 @@ module Gloo
         return @switches.include?( QUIET )
       end
 
+      #
+      # Is the app switch set?
+      #
+      def app?
+        @switches.include?( Gloo::App::Mode::APP.to_s )
+      end
+
+      # 
+      # Make sure that if we are running in App mode
+      # that the app path has been set and is a valid path.
+      # 
+      def verify_app_mode
+        return true unless app?
+
+        if @app_path.nil?
+          @engine.log.error "App Path required to run in App mode."
+          return false
+        end
+
+        unless File.directory? @app_path
+          @engine.log.error "'#{@app_path}' is not a valid directory."
+          return false
+        end
+
+        @engine.log.info "App root directory: '#{@app_path}'."
+        return true
+      end
+
       #
       # Is the version switch set?
       #
@@ -72,6 +101,8 @@ module Gloo
       def detect_mode
         mode = if ENV[ GLOO_ENV ] == Gloo::App::Mode::TEST.to_s
                  Mode::TEST
+               elsif app?
+                 Mode::APP
                elsif version?
                  Mode::VERSION
                elsif help?
@@ -85,6 +116,8 @@ module Gloo
                else
                  Mode.default_mode
                end
+
+        mode = Mode::CLI unless verify_app_mode
         @engine.log.debug "running in #{mode} mode"
 
         return mode
@@ -102,6 +135,8 @@ module Gloo
       def process_one_arg( arg )
         if arg.start_with? '--'
           switches << arg[ 2..-1 ]
+        elsif app? && ( @app_path.nil? )
+          @app_path = arg
         else
           files << arg
         end

data/lib/gloo/app/engine.rb

@@ -110,6 +110,9 @@ module Gloo
           run_files
         elsif @mode == Mode::EMBED
           run_keep_alive
+        elsif @mode == Mode::APP
+          @settings.override_project_path @args.app_path
+          run
         else
           run
         end
@@ -187,7 +190,9 @@ module Gloo
       #
       # Process the command.
       #
-      def process_cmd
+      def process_cmd cmd=nil
+        @last_cmd = cmd if cmd
+        
         if last_cmd_blank?
           @platform.clear_screen
           return
@@ -211,6 +216,9 @@ module Gloo
       # Do any clean up and quit.
       #
       def quit
+        @log.debug 'triggering on_quit events...'
+        @event_manager.on_quit
+
         @log.debug 'quitting...'
       end
 

data/lib/gloo/app/log.rb

@@ -11,6 +11,15 @@ module Gloo
   module App
     class Log
 
+      DEBUG = 'debug'.freeze
+      INFO = 'info'.freeze
+      WARN = 'warn'.freeze
+      ERROR = 'error'.freeze
+      LEVELS = [ DEBUG, INFO, WARN, ERROR ].freeze
+
+      LOG_FILE = 'gloo.log'.freeze
+      ERROR_FILE = 'error.log'.freeze
+
       attr_accessor :quiet
       attr_reader :logger
 
@@ -28,7 +37,7 @@ module Gloo
         @quite = quiet
         @debug = engine.settings.debug
 
-        create_logger
+        create_loggers
 
         debug 'log intialized...'
       end
@@ -36,10 +45,26 @@ module Gloo
       #
       # Create the default [file] logger.
       #
-      def create_logger
-        f = File.join( @engine.settings.log_path, 'gloo.log' )
+      def create_loggers
+        f = File.join( @engine.settings.log_path, LOG_FILE )
         @logger = Logger.new( f )
         @logger.level = Logger::DEBUG
+
+        err = File.join( @engine.settings.log_path, ERROR_FILE )
+        @error = Logger.new( err )
+        @error.level = Logger::WARN
+      end
+
+      # ---------------------------------------------------------------------
+      #    Static Helpers
+      # ---------------------------------------------------------------------
+
+      # 
+      # Does the given str represent a logging level?
+      # 
+      def self.is_level? str
+        return false unless str.is_a? String
+        return LEVELS.include? str.strip.downcase
       end
 
       # ---------------------------------------------------------------------
@@ -57,6 +82,21 @@ module Gloo
       #    Logging functions
       # ---------------------------------------------------------------------
 
+      # 
+      # Write to the specified level.
+      # 
+      def write( msg, level )
+        if level == DEBUG
+          debug msg
+        elsif level == INFO
+          info msg
+        elsif level == WARN
+          warn msg
+        elsif level == ERROR
+          error msg
+        end
+      end
+
       #
       # Write a debug message to the log.
       #
@@ -66,7 +106,6 @@ module Gloo
         @logger.debug msg
       end
 
-
       #
       # Write an information message to the log.
       # Also write to the console unless quiet.
@@ -82,6 +121,7 @@ module Gloo
       #
       def warn( msg )
         @logger.warn msg
+        @error.warn msg
         puts msg.yellow unless @quiet
       end
 
@@ -93,9 +133,10 @@ module Gloo
       def error( msg, ex = nil, engine = nil )
         engine&.heap&.error&.set_to msg
         @logger.error msg
+        @error.error msg
         if ex
-          @logger.error ex.message
-          @logger.error ex.backtrace
+          @error.error ex.message
+          @error.error ex.backtrace
           puts msg.red unless @quiet
           puts ex.message.red unless @quiet
           puts ex.backtrace unless @quiet
@@ -120,7 +161,7 @@ module Gloo
       # Restore the logger after deserialization.
       #
       def restore_after_deserialization
-        create_logger
+        create_loggers
       end
 
     end

data/lib/gloo/app/mode.rb

@@ -9,6 +9,7 @@ module Gloo
     class Mode
 
       EMBED = :embed      # Run as embedded script processor
+      APP = :app          # Running in APP mode.
       CLI = :cli          # Run in interactive (CLI) mode
       SCRIPT = :script    # Run a script
       VERSION = :version  # Show version information

data/lib/gloo/app/settings.rb

@@ -84,6 +84,19 @@ module Gloo
         return 7
       end
 
+      # ---------------------------------------------------------------------
+      #    Functions
+      # ---------------------------------------------------------------------
+
+      # 
+      # Running in app mode, so overriding the root project path.
+      # 
+      def override_project_path path
+        @engine.log.debug "Root project path is #{path}"
+
+        @project_path = path
+      end
+
       # ---------------------------------------------------------------------
       #    Private
       # ---------------------------------------------------------------------

data/lib/gloo/core/event_manager.rb

@@ -40,6 +40,38 @@ module Gloo
         arr.each { |o| Gloo::Exec::Dispatch.message( @engine, 'run', o ) }
       end
 
+      #
+      # Run on_reload scripts in the object that will be reloaded.
+      #
+      def on_reload( obj )
+        return unless obj
+
+        @engine.log.debug 'on_reload event'
+        arr = Gloo::Core::ObjFinder.by_name( @engine, 'on_reload', obj )
+        arr.each { |o| Gloo::Exec::Dispatch.message( @engine, 'run', o ) }
+      end
+
+      #
+      # Run on_save scripts in the object that is being saved.
+      #
+      def on_save( obj )
+        return unless obj
+
+        @engine.log.debug 'on_save event'
+        arr = Gloo::Core::ObjFinder.by_name( @engine, 'on_save', obj )
+        arr.each { |o| Gloo::Exec::Dispatch.message( @engine, 'run', o ) }
+      end
+
+      #
+      # Run on_quit scripts in any open objets.
+      # If no obj is given the script will be run in root.
+      #
+      def on_quit
+        @engine.log.debug 'on_quit event'
+        arr = Gloo::Core::ObjFinder.by_name( @engine, 'on_quit' )
+        arr.each { |o| Gloo::Exec::Dispatch.message( @engine, 'run', o ) }
+      end
+
     end
   end
 end

data/lib/gloo/core/obj.rb

@@ -284,8 +284,6 @@ module Gloo
           return
         end
 
-        @engine.event_manager.on_unload self
-        @engine.heap.unload self
         @engine.persist_man.unload self
       end
 

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

@@ -23,6 +23,8 @@ module Gloo
       TITLE_COLOR = 'bright_cyan'.freeze
       QUIT_ITEM_NAME = 'q'.freeze
 
+      @@menu_stack = []
+
       #
       # The name of the object type.
       #
@@ -53,6 +55,8 @@ module Gloo
       # Should we keep looping or should we stop?
       #
       def loop?
+        return false unless @engine.running
+
         o = find_child LOOP
         return false unless o
 
@@ -106,6 +110,14 @@ module Gloo
         return o ? true : false
       end
 
+      #
+      # Get the Menu's Title.
+      #
+      def title
+        obj = find_child TITLE
+        return obj.value
+      end
+
       # ---------------------------------------------------------------------
       #    Children
       # ---------------------------------------------------------------------
@@ -132,6 +144,69 @@ module Gloo
         fac.create_script DEFAULT, '', self
       end
 
+      # ---------------------------------------------------------------------
+      #    Menu Stack
+      # ---------------------------------------------------------------------
+
+      # 
+      # Show the bread-crumbs for the menu stack.
+      # 
+      def show_menu_stack
+        if @@menu_stack.count < 2
+          puts '...'
+        else
+          msg = ''
+          @@menu_stack[0..-2].each do |menu|
+            msg << ' | ' unless msg.blank?
+            msg << menu.title
+          end
+          msg << ' | ... '
+          puts msg
+        end
+      end
+
+      # 
+      # Add a menu to the stack.
+      # 
+      def push_menu obj
+        @@menu_stack << obj
+      end
+
+      # 
+      # Pop a menu from the stack.
+      # If the last item isn't the given menu,
+      # it won't be popped.
+      # 
+      def pop_menu menu
+        if @@menu_stack[-1] == menu
+          @@menu_stack.pop
+        end
+      end
+
+      # 
+      # Quit all menus and drop into gloo.
+      # 
+      def pop_to_top_level_menu
+        @engine.log.debug 'Quitting to top level menu'
+        while @@menu_stack.count > 1
+          menu = @@menu_stack.pop
+          o = menu.find_child LOOP
+          o.set_value( false ) if o
+        end
+      end
+
+      # 
+      # Quit all menus and drop into gloo.
+      # 
+      def quit_all_menus
+        @engine.log.debug 'Dropping into Gloo'
+        @@menu_stack.each do |menu|
+          o = menu.find_child LOOP
+          o.set_value( false ) if o
+        end
+        @engine.loop
+      end
+
       # ---------------------------------------------------------------------
       #    Messages
       # ---------------------------------------------------------------------
@@ -148,6 +223,7 @@ module Gloo
       #
       def msg_run
         lazy_add_children
+        push_menu self
         run_default
         loop do
           begin_menu
@@ -162,6 +238,7 @@ module Gloo
           cmd ? run_command( cmd ) : run_default
           break unless loop?
         end
+        pop_menu self
       end
 
       # ---------------------------------------------------------------------
@@ -238,9 +315,8 @@ module Gloo
       # There is a title, so show it.
       # 
       def run_default_title
-        obj = find_child TITLE
-        title = obj.value
         @engine.platform&.clear_screen
+        show_menu_stack
         Banner.show_banner( title, TITLE_STYLE, TITLE_COLOR )
       end
 
@@ -248,22 +324,38 @@ module Gloo
       # Run the selected command.
       #
       def run_command( cmd )
+        @engine.log.debug "Menu Command: #{cmd}"
         obj = find_cmd cmd
 
-        unless obj
+        if obj
+          script = obj.do_script
+          return unless script
+  
+          s = Gloo::Exec::Script.new( @engine, script )
+          s.run
+        else
           if cmd == '?'
             show_options
+          elsif cmd == 'q!'
+            @engine.log.info 'Quitting Gloo'
+            @engine.stop_running
+          elsif cmd == 'qq'
+            pop_to_top_level_menu
+          elsif cmd.starts_with? ':'
+            gloo_cmd = cmd[1..-1].strip
+            if gloo_cmd.blank?
+              quit_all_menus
+            else
+              @engine.log.debug "Running Gloo command: #{gloo_cmd}"
+              @engine.process_cmd gloo_cmd
+            end
           else
-            puts "#{cmd} is not a valid option"
+            msg = "#{cmd} is not a valid option"
+            @engine.log.warn msg
           end
           return
         end
 
-        script = obj.do_script
-        return unless script
-
-        s = Gloo::Exec::Script.new( @engine, script )
-        s.run
       end
 
     end

data/lib/gloo/objs/data/pg.rb

@@ -0,0 +1,208 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2023 Eric Crane.  All rights reserved.
+#
+# A Postgres database connection.
+#
+#   https://rubygems.org/gems/pg/versions/0.18.4
+#   https://github.com/ged/ruby-pg
+#   
+require 'pg'
+
+module Gloo
+  module Objs
+    class Pg < Gloo::Core::Obj
+
+      KEYWORD = 'postgres'.freeze
+      KEYWORD_SHORT = 'pg'.freeze
+
+      HOST = 'host'.freeze
+      DB = 'database'.freeze
+      USER = 'username'.freeze
+      PASSWD = 'password'.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
+
+      # ---------------------------------------------------------------------
+      #    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 HOST, nil, self
+        fac.create_string DB, nil, self
+        fac.create_string USER, nil, self
+        fac.create_string PASSWD, nil, self
+      end
+
+      # ---------------------------------------------------------------------
+      #    Messages
+      # ---------------------------------------------------------------------
+
+      #
+      # Get a list of message names that this object receives.
+      #
+      def self.messages
+        return super + [ 'verify' ]
+      end
+
+      #
+      # SSH to the host and execute the command, then update result.
+      #
+      def msg_verify
+        return unless connects?
+
+        @engine.heap.it.set_to true
+      end
+
+      # ---------------------------------------------------------------------
+      #    DB functions (all database connections)
+      # ---------------------------------------------------------------------
+
+      #
+      # Open a connection and execute the SQL statement.
+      # Return the resulting data.
+      #
+      def query( sql, params = nil )
+        heads = []
+        data = []
+        client = pg_conn
+
+        if params
+          param_arr =  []
+          params.each do |p|
+            param_arr << { :value => p, :type => 0, :format => 0 }
+          end
+          rs = client.exec_params( sql, params )
+        else
+          rs = client.exec( sql )
+        end
+
+        if rs && ( rs.count > 0 )
+          rs[0].each do |name, val|
+            heads << name
+          end
+          rs.each_with_index do |row, index|
+            arr = []
+            row.each do |name, val|
+              arr << val
+            end
+            data << arr
+          end
+        end
+
+        return [ heads, data ]
+      end
+
+      # ---------------------------------------------------------------------
+      #    Private functions
+      # ---------------------------------------------------------------------
+
+      private
+
+      #
+      # Get the host from the child object.
+      # Returns nil if there is none.
+      #
+      def host_value
+        o = find_child HOST
+        return nil unless o
+
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o.value
+      end
+
+      #
+      # Get the Database name from the child object.
+      # Returns nil if there is none.
+      #
+      def db_value
+        o = find_child DB
+        return nil unless o
+
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o.value
+      end
+
+      #
+      # Get the Username from the child object.
+      # Returns nil if there is none.
+      #
+      def user_value
+        o = find_child USER
+        return nil unless o
+
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o.value
+      end
+
+      #
+      # Get the Password name from the child object.
+      # Returns nil if there is none.
+      #
+      def passwd_value
+        o = find_child PASSWD
+        return nil unless o
+
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o.value
+      end
+
+      #
+      # Try the connection and make sure it works.
+      # Returns true if we can establish a connection.
+      #
+      def connects?
+        begin
+          result = pg_conn.exec( "SELECT NOW()" )
+        rescue => e
+          @engine.err e.message
+          @engine.heap.it.set_to false
+          return false
+        end
+        return true
+      end
+
+      # 
+      # Get the PG connection.
+      # 
+      def pg_conn
+        if host_value
+          conn = PG.connect(
+            host_value, 5432, '', '', 
+            db_value, 
+            user_value, 
+            passwd_value )
+        else
+          conn = PG.connect( dbname: db_value )
+        end
+      end
+
+    end
+  end
+end

data/lib/gloo/objs/web/json.rb

@@ -56,15 +56,15 @@ module Gloo
       # Get a list of message names that this object receives.
       #
       def self.messages
-        return super + %w[get parse pretty]
+        return super + %w[get set parse pretty]
       end
 
       #
       # Make the JSON pretty.
       #
       def msg_pretty
-        pretty = JSON.pretty_generate( self.value )
-        puts pretty
+        json = JSON.parse( self.value )
+        pretty = JSON.pretty_generate( json )
         set_value pretty
       end
 
@@ -79,12 +79,37 @@ module Gloo
         end
         return unless data
 
-        h = JSON.parse( self.value )
-        field = h[ data ]
+        field = Gloo::Objs::Json.get_value_in_json self.value, data
         @engine.heap.it.set_to field
         return field
       end
 
+      #
+      # Convert the target object to JSON and set the value of
+      # this JSON to that value.
+      #
+      def msg_set
+        if @params&.token_count&.positive?
+          pn = Gloo::Core::Pn.new( @engine, @params.tokens.first )
+          unless pn&.exists?
+            @engine.err 'Source path for objects does not exist'
+            return
+          end
+        else
+          @engine.err 'Source path for objects is required'
+          return
+        end
+        parent = pn.resolve
+
+        h = convert_obj_to_hash( parent )
+        json = JSON.parse( h.to_json )
+        json = JSON.pretty_generate( json )
+
+        set_value json
+        @engine.heap.it.set_to json
+        return json
+      end
+
       #
       # Parse the JSON data and put it in objects.
       # The additional parameter is the path to the destination
@@ -104,19 +129,40 @@ module Gloo
         parent = pn.resolve
 
         json = JSON.parse( self.value )
-        self.handle_json( json, parent )
+        self.handle_json_to_obj( json, parent )
+      end
+
+      # ---------------------------------------------------------------------
+      #    JSON Helper functions
+      # ---------------------------------------------------------------------
+
+      # 
+      # Convert the object to a hash of name and values.
+      # 
+      def convert_obj_to_hash( obj )
+        h = {}
+
+        if obj.child_count > 0
+          obj.children.each do |child|
+            h = h.merge( convert_obj_to_hash( child ) )
+          end
+        else
+          h[ obj.name ] = obj.value
+        end
+
+        return h
       end
 
       #
       # Handle JSON, creating objects and setting values.
       # Note that this is a recursive function.
       #
-      def handle_json( json, parent )
+      def handle_json_to_obj( json, parent )
         if json.class == Hash
           json.each do |k, v|
-            if v.class == Array
+            if ( v.class == Array ) || ( v.class == Hash )
               o = parent.find_add_child( k, 'can' )
-              handle_json( v, o )
+              handle_json_to_obj( v, o )
             else
               o = parent.find_add_child( k, 'untyped' )
               o.set_value v
@@ -125,11 +171,22 @@ module Gloo
         elsif json.class == Array
           json.each_with_index do |o, index|
             child = parent.find_add_child( index.to_s, 'can' )
-            handle_json( o, child )
+            handle_json_to_obj( o, child )
           end
         end
       end
 
+      # 
+      # Parse the JSON data and look for the value within it.
+      # 
+      def self.get_value_in_json( json, path_to_value )
+        data = JSON.parse( json )
+        path_to_value.split( '.' ).each do |segment|
+          data = data[ segment ]
+        end
+        return data
+      end
+
     end
   end
 end

data/lib/gloo/persist/persist_man.rb

@@ -42,6 +42,9 @@ module Gloo
         ref = Gloo::Core::Pn.new( @engine, name )
         obj = ref.resolve
 
+        # Send an on_save event
+        @engine.event_manager.on_save obj
+
         fs = find_file_storage( obj )
         fs.save
       end
@@ -62,11 +65,21 @@ module Gloo
         end
       end
 
+      # 
+      # Unload all loaded objects.
+      # 
+      def unload_all
+        objs = self.maps.map { |fs| fs.obj }
+        objs.each { |o| o.msg_unload }
+      end
+
       # 
       # The given object is unloading.
       # Do any necessary clean up here.
       # 
       def unload( obj )
+        @engine.event_manager.on_unload obj
+        @engine.heap.unload obj
         @maps.each_with_index do |o, i|
           if o.obj.pn === obj.pn
             @maps.delete_at( i )
@@ -82,6 +95,7 @@ module Gloo
         return unless @maps
         
         @maps.each do |fs|
+          @engine.event_manager.on_reload fs.obj
           @engine.heap.unload fs.obj
           fs.load
         end
@@ -94,6 +108,7 @@ module Gloo
         fs = find_file_storage( obj )
         return unless fs
 
+        @engine.event_manager.on_reload obj
         @engine.heap.unload obj
         fs.load
       end

data/lib/gloo/verbs/log.rb

@@ -0,0 +1,69 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2023 Eric Crane.  All rights reserved.
+#
+# Write to the standard (or error) gloo log.
+#
+
+module Gloo
+  module Verbs
+    class Log < Gloo::Core::Verb
+
+      KEYWORD = 'log'.freeze
+      KEYWORD_SHORT = 'log'.freeze
+
+      #
+      # Run the verb.
+      #
+      def run
+        if @tokens.token_count > 1
+          expr = Gloo::Expr::Expression.new( @engine, @tokens.params )
+          result = expr.evaluate
+          level = log_level_specified( result )
+          @engine.log.write result, level
+          @engine.heap.it.set_to result
+        else
+          @engine.log.debug ''
+        end
+      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
+
+      #
+      # Get the formatted string.
+      #
+      def log_level_specified( str )
+        if @params&.token_count&.positive?
+          if Gloo::App::Log.is_level? @params.tokens.first
+            return @params.tokens.first
+          end
+
+          expr = Gloo::Expr::Expression.new( @engine, @params.tokens )
+          level = expr.evaluate
+          return level if Gloo::App::Log.is_level? level
+        end
+
+        # Lastly, it's just debug
+        return Gloo::App::Log::LEVELS[0]
+      end
+
+    end
+  end
+end

data/lib/gloo/verbs/unload.rb

@@ -17,8 +17,7 @@ module Gloo
       def run
         return unless @engine.persist_man.maps
         
-        objs = @engine.persist_man.maps.map { |fs| fs.obj }
-        objs.each { |o| o.msg_unload }
+        @engine.persist_man.unload_all
       end
 
       #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gloo
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Eric Crane
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-06-28 00:00:00.000000000 Z
+date: 2023-12-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -264,6 +264,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.1.4
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.5.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.5.4
 description: A scripting languge to keep it all together.
 email:
 - eric.crane@mac.com
@@ -285,6 +299,7 @@ files:
 - README.md
 - Rakefile
 - bin/console
+- bin/run
 - bin/setup
 - exe/gloo
 - exe/o
@@ -361,6 +376,7 @@ files:
 - lib/gloo/objs/ctrl/repeat.rb
 - lib/gloo/objs/data/markdown.rb
 - lib/gloo/objs/data/mysql.rb
+- lib/gloo/objs/data/pg.rb
 - lib/gloo/objs/data/query.rb
 - lib/gloo/objs/data/query_result.rb
 - lib/gloo/objs/data/sqlite.rb
@@ -404,6 +420,7 @@ files:
 - lib/gloo/verbs/if.rb
 - lib/gloo/verbs/list.rb
 - lib/gloo/verbs/load.rb
+- lib/gloo/verbs/log.rb
 - lib/gloo/verbs/move.rb
 - lib/gloo/verbs/put.rb
 - lib/gloo/verbs/quit.rb