gloo-lang 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 60aa43dd1dedbfb551e5e3a5df9e85faa850bde257385062faf364bc757c1f48
-  data.tar.gz: 153fc30d28490c8e55e16e4e9432e552344e31940627b40cc0b2b549c89fda95
+  metadata.gz: b2fef4d21ce7b2ba45d4598fa24282c703581bbe1e40ea07f8e8063bf66a4b1b
+  data.tar.gz: dbd1b3b25f998023baa7c93044618f33bdca46de5ff068b2efd2093d156c5393
 SHA512:
-  metadata.gz: 2f5cf337061911c08ba2c4b58be007008912c90387ddce1cd2007303dd6b70609b97b6aec8524a0d0a992010a70d3e6a393e8a931da8584a64fbcb8ecaf689ed
-  data.tar.gz: 460d792ef6934ded17ff3e6a60ccba9c422219b3e93ff353d4c631d5f4bfba19c373845eb58cf4cea82a26f4a401082318793aa2473dc9ac23b3ef81502254ff
+  metadata.gz: 9b859bb73c0b74b901ca5aaf2fba754c70d9b567c8725afa1ed20260f547b68264a9af8e96f391e94edd955a002de01417fbacc154f850309a2134b7f2d6ee81
+  data.tar.gz: b5cc88f9740a6766051579ea185b94b308f6628a61e13a1259871bd49350bb90acd9544ee47e3085c53daf33911ed312acc682373b244bd6b361e307b987be75

data/.gitignore

@@ -10,3 +10,4 @@
 *.log
 test/gloo/debug/*
 .DS_Store
+Gemfile.lock

data/.ruby-gemset

@@ -0,0 +1 @@
+gloo-gem

data/.ruby-version

@@ -0,0 +1 @@
+ruby-3.0.2

data/gloo-lang.gemspec

@@ -24,7 +24,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_development_dependency 'bundler', '~> 2.2.22'
-  spec.add_development_dependency 'minitest', '~> 5.1'
+  spec.add_development_dependency 'minitest', '~> 5.1', '>= 5.14.2'
   spec.add_development_dependency "rake", '~> 13.0', '>= 13.0.1'
 
   spec.add_dependency "activesupport", '~> 6.1', ">= 6.1.4.6"
@@ -33,6 +33,4 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'openssl', '~> 2.1', '>= 2.1.0'
   spec.add_dependency 'net-ssh', '~> 6.1', '>= 6.1.0'
   spec.add_dependency 'tty-platform', '~> 0.3', '>= 0.3.0'
-  # spec.add_dependency 'mysql2', '~> 0.5', '>= 0.5.3'
-  # spec.add_dependency 'sqlite3', '~> 1.4', '>= 1.4.2'
 end

data/lib/VERSION

@@ -1 +1 @@
-1.0.0
+1.1.0

data/lib/gloo_lang/app/engine.rb

@@ -15,7 +15,7 @@ module GlooLang
       attr_reader :args, :mode, :running, :platform,
                   :dictionary, :parser, :heap, :factory
       attr_accessor :last_cmd, :persist_man, :event_manager,
-                    :exec_env, :help, :converter
+                    :exec_env, :converter
 
       #
       # Set up the engine with basic elements.
@@ -52,13 +52,48 @@ module GlooLang
         @event_manager = GlooLang::Core::EventManager.new( self )
 
         @exec_env = GlooLang::Exec::ExecEnv.new( self )
-        @help = GlooLang::App::Help.new( self )
         @converter = GlooLang::Convert::Converter.new( self )
 
         @log.debug 'the engine has started'
         run_mode
       end
 
+      # ---------------------------------------------------------------------
+      #    Serialization
+      # ---------------------------------------------------------------------
+
+      #
+      # Prepare for serialization by removing any file references.
+      # Without this, the engine cannot be serialized.
+      #
+      def prep_serialize
+        @log.prep_serialize
+      end
+
+      #
+      # Get the serialized version of this Engine.
+      #
+      def serialize
+        prep_serialize
+        Marshal::dump( self )
+      end
+
+      #
+      # Deserialize the Engine data.
+      #
+      def self.deserialize data
+        e = Marshal::load( data )
+        e.restore_after_deserialization
+        return e
+      end
+
+      #
+      # Restore the engine after deserialization.
+      #
+      def restore_after_deserialization
+        @log.restore_after_deserialization
+      end
+
       # ---------------------------------------------------------------------
       #    Run
       # ---------------------------------------------------------------------
@@ -71,10 +106,10 @@ module GlooLang
 
         if @mode == Mode::VERSION
           run_version
-        elsif @mode == Mode::HELP
-          show_help_and_quit
         elsif @mode == Mode::SCRIPT
           run_files
+        elsif @mode == Mode::EMBED
+          run_keep_alive
         else
           run
         end
@@ -105,6 +140,14 @@ module GlooLang
         quit
       end
 
+      #
+      # Run in Embedded mode, which means we'll
+      # start the engine, but wait for external inputs.
+      #
+      def run_keep_alive
+        @log.debug 'Running in Embedded mode...'
+      end
+
       #
       # Get the setting for the start_with file and open it.
       #
@@ -171,14 +214,6 @@ module GlooLang
         quit
       end
 
-      #
-      # Show the help information and then quit.
-      #
-      def show_help_and_quit
-        @help.show_app_help
-        quit
-      end
-
       # ---------------------------------------------------------------------
       #    Error Handling
       # ---------------------------------------------------------------------

data/lib/gloo_lang/app/log.rb

@@ -12,6 +12,10 @@ module GlooLang
       attr_accessor :quiet
       attr_reader :logger
 
+      # ---------------------------------------------------------------------
+      #    Initialization
+      # ---------------------------------------------------------------------
+
       #
       # Set up a logger.
       # If quiet is true, then message are written to the log
@@ -19,14 +23,26 @@ module GlooLang
       #
       def initialize( engine, quiet=true )
         @engine = engine
-        f = File.join( @engine.settings.log_path, 'gloo.log' )
-        @logger = Logger.new( f )
-        @logger.level = Logger::DEBUG
         @quite = quiet
 
+        create_logger
+
         debug 'log intialized...'
       end
 
+      #
+      # Create the default [file] logger.
+      #
+      def create_logger
+        f = File.join( @engine.settings.log_path, 'gloo.log' )
+        @logger = Logger.new( f )
+        @logger.level = Logger::DEBUG
+      end
+
+      # ---------------------------------------------------------------------
+      #    Standard Output
+      # ---------------------------------------------------------------------
+
       #
       # Show a message unless we're in quite mode.
       #
@@ -34,6 +50,10 @@ module GlooLang
         puts msg unless @quiet
       end
 
+      # ---------------------------------------------------------------------
+      #    Logging functions
+      # ---------------------------------------------------------------------
+
       #
       # Write a debug message to the log.
       #
@@ -78,6 +98,25 @@ module GlooLang
         end
       end
 
+      # ---------------------------------------------------------------------
+      #    Serialization
+      # ---------------------------------------------------------------------
+
+      #
+      # Prepare for serialization by removing the file reference.
+      # Without this, the engine cannot be serialized.
+      #
+      def prep_serialize
+        @logger = nil
+      end
+
+      #
+      # Restore the logger after deserialization.
+      #
+      def restore_after_deserialization
+        create_logger
+      end
+
     end
   end
 end

data/lib/gloo_lang/core/heap.rb

@@ -23,10 +23,10 @@ module GlooLang
         @engine = engine
         @engine.log.debug 'object heap intialized...'
 
-        @root = GlooLang::Objs::Container.new( @engine)
+        @root = GlooLang::Objs::Container.new( @engine )
         @root.name = 'root'
 
-        @context = Pn.root engine
+        @context = Pn.root @engine
         @it = It.new
         @error = Error.new
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gloo-lang
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Eric Crane
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-03-25 00:00:00.000000000 Z
+date: 2022-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -31,6 +31,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.14.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -38,6 +41,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.14.2
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -186,9 +192,10 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".ruby-gemset"
+- ".ruby-version"
 - CODE_OF_CONDUCT.md
 - Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -201,7 +208,6 @@ files:
 - lib/gloo_lang/app/args.rb
 - lib/gloo_lang/app/engine.rb
 - lib/gloo_lang/app/engine_context.rb
-- lib/gloo_lang/app/help.rb
 - lib/gloo_lang/app/info.rb
 - lib/gloo_lang/app/log.rb
 - lib/gloo_lang/app/mode.rb
@@ -243,81 +249,6 @@ files:
 - lib/gloo_lang/expr/op_minus.rb
 - lib/gloo_lang/expr/op_mult.rb
 - lib/gloo_lang/expr/op_plus.rb
-- lib/gloo_lang/help/app/application.txt
-- lib/gloo_lang/help/app/configuration.txt
-- lib/gloo_lang/help/app/default_help.txt
-- lib/gloo_lang/help/app/logging.txt
-- lib/gloo_lang/help/core/color.txt
-- lib/gloo_lang/help/core/error.txt
-- lib/gloo_lang/help/core/events.txt
-- lib/gloo_lang/help/core/gloo_system.txt
-- lib/gloo_lang/help/core/here.txt
-- lib/gloo_lang/help/core/it.txt
-- lib/gloo_lang/help/core/ops.txt
-- lib/gloo_lang/help/core/pathname.txt
-- lib/gloo_lang/help/objs/basic/alias.txt
-- lib/gloo_lang/help/objs/basic/boolean.txt
-- lib/gloo_lang/help/objs/basic/container.txt
-- lib/gloo_lang/help/objs/basic/decimal.txt
-- lib/gloo_lang/help/objs/basic/integer.txt
-- lib/gloo_lang/help/objs/basic/script.txt
-- lib/gloo_lang/help/objs/basic/string.txt
-- lib/gloo_lang/help/objs/basic/text.txt
-- lib/gloo_lang/help/objs/basic/untyped.txt
-- lib/gloo_lang/help/objs/cli/banner.txt
-- lib/gloo_lang/help/objs/cli/bar.txt
-- lib/gloo_lang/help/objs/cli/colorize.txt
-- lib/gloo_lang/help/objs/cli/confirm.txt
-- lib/gloo_lang/help/objs/cli/menu.txt
-- lib/gloo_lang/help/objs/cli/menu_item.txt
-- lib/gloo_lang/help/objs/cli/pastel.txt
-- lib/gloo_lang/help/objs/cli/prompt.txt
-- lib/gloo_lang/help/objs/cli/select.txt
-- lib/gloo_lang/help/objs/ctrl/each.txt
-- lib/gloo_lang/help/objs/ctrl/repeat.txt
-- lib/gloo_lang/help/objs/data/markdown.txt
-- lib/gloo_lang/help/objs/data/mysql.txt
-- lib/gloo_lang/help/objs/data/query.txt
-- lib/gloo_lang/help/objs/data/sqlite.txt
-- lib/gloo_lang/help/objs/data/table.txt
-- lib/gloo_lang/help/objs/dev/git_repo.txt
-- lib/gloo_lang/help/objs/dev/stats.txt
-- lib/gloo_lang/help/objs/dt/date.txt
-- lib/gloo_lang/help/objs/dt/datetime.txt
-- lib/gloo_lang/help/objs/dt/time.txt
-- lib/gloo_lang/help/objs/ror/erb.txt
-- lib/gloo_lang/help/objs/ror/eval.txt
-- lib/gloo_lang/help/objs/snd/play.txt
-- lib/gloo_lang/help/objs/snd/say.txt
-- lib/gloo_lang/help/objs/system/file.txt
-- lib/gloo_lang/help/objs/system/ssh_exec.txt
-- lib/gloo_lang/help/objs/system/system.txt
-- lib/gloo_lang/help/objs/web/http_get.txt
-- lib/gloo_lang/help/objs/web/http_post.txt
-- lib/gloo_lang/help/objs/web/json.txt
-- lib/gloo_lang/help/objs/web/slack.txt
-- lib/gloo_lang/help/objs/web/teams.txt
-- lib/gloo_lang/help/objs/web/uri.txt
-- lib/gloo_lang/help/verbs/alert.txt
-- lib/gloo_lang/help/verbs/beep.txt
-- lib/gloo_lang/help/verbs/cls.txt
-- lib/gloo_lang/help/verbs/context.txt
-- lib/gloo_lang/help/verbs/create.txt
-- lib/gloo_lang/help/verbs/execute.txt
-- lib/gloo_lang/help/verbs/help.txt
-- lib/gloo_lang/help/verbs/if.txt
-- lib/gloo_lang/help/verbs/list.txt
-- lib/gloo_lang/help/verbs/load.txt
-- lib/gloo_lang/help/verbs/move.txt
-- lib/gloo_lang/help/verbs/put.txt
-- lib/gloo_lang/help/verbs/quit.txt
-- lib/gloo_lang/help/verbs/run.txt
-- lib/gloo_lang/help/verbs/save.txt
-- lib/gloo_lang/help/verbs/show.txt
-- lib/gloo_lang/help/verbs/tell.txt
-- lib/gloo_lang/help/verbs/unless.txt
-- lib/gloo_lang/help/verbs/version.txt
-- lib/gloo_lang/help/verbs/wait.txt
 - lib/gloo_lang/objs/basic/alias.rb
 - lib/gloo_lang/objs/basic/boolean.rb
 - lib/gloo_lang/objs/basic/container.rb
@@ -354,7 +285,6 @@ files:
 - lib/gloo_lang/verbs/context.rb
 - lib/gloo_lang/verbs/create.rb
 - lib/gloo_lang/verbs/execute.rb
-- lib/gloo_lang/verbs/help.rb
 - lib/gloo_lang/verbs/if.rb
 - lib/gloo_lang/verbs/list.rb
 - lib/gloo_lang/verbs/load.rb
@@ -366,7 +296,6 @@ files:
 - lib/gloo_lang/verbs/show.rb
 - lib/gloo_lang/verbs/tell.rb
 - lib/gloo_lang/verbs/unless.rb
-- lib/gloo_lang/verbs/version.rb
 - lib/gloo_lang/verbs/wait.rb
 homepage: http://github.com/ecrane/gloo_lang
 licenses:

data/Gemfile.lock

@@ -1,68 +0,0 @@
-PATH
-  remote: .
-  specs:
-    gloo-lang (0.9.11)
-      activesupport (~> 6.1, >= 6.1.4.6)
-      chronic (~> 0.10, >= 0.10.2)
-      json (~> 2.1, >= 2.1.0)
-      net-ssh (~> 6.1, >= 6.1.0)
-      openssl (~> 2.1, >= 2.1.0)
-      tty-platform (~> 0.3, >= 0.3.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    activesupport (6.1.5)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 1.6, < 2)
-      minitest (>= 5.1)
-      tzinfo (~> 2.0)
-      zeitwerk (~> 2.3)
-    ast (2.4.2)
-    chronic (0.10.2)
-    concurrent-ruby (1.1.10)
-    i18n (1.10.0)
-      concurrent-ruby (~> 1.0)
-    ipaddr (1.2.4)
-    json (2.6.1)
-    minitest (5.15.0)
-    net-ssh (6.1.0)
-    openssl (2.2.1)
-      ipaddr
-    parallel (1.21.0)
-    parser (3.1.1.0)
-      ast (~> 2.4.1)
-    rainbow (3.1.1)
-    rake (13.0.6)
-    regexp_parser (2.2.1)
-    rexml (3.2.5)
-    rubocop (1.25.1)
-      parallel (~> 1.10)
-      parser (>= 3.1.0.0)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml
-      rubocop-ast (>= 1.15.1, < 2.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.16.0)
-      parser (>= 3.1.1.0)
-    ruby-progressbar (1.11.0)
-    tty-platform (0.3.0)
-    tzinfo (2.0.4)
-      concurrent-ruby (~> 1.0)
-    unicode-display_width (2.1.0)
-    zeitwerk (2.5.4)
-
-PLATFORMS
-  x86_64-darwin-21
-
-DEPENDENCIES
-  bundler (~> 2.2.22)
-  gloo-lang!
-  minitest (~> 5.1)
-  rake (~> 13.0, >= 13.0.1)
-  rubocop
-
-BUNDLED WITH
-   2.2.22

data/lib/gloo_lang/app/help.rb

@@ -1,118 +0,0 @@
-# Author::    Eric Crane  (mailto:eric.crane@mac.com)
-# Copyright:: Copyright (c) 2019 Eric Crane.  All rights reserved.
-#
-# Help system.
-#
-
-module GlooLang
-  module App
-    class Help
-
-      APPLICATION = 'application'.freeze
-
-      attr_accessor :topics
-
-      #
-      # Set up the help system.
-      # We won't load help topics until we know we need them.
-      #
-      def initialize( engine )
-        @engine = engine
-        @topics = nil
-      end
-
-      #
-      # Show application help.
-      # This is the what is shown when help is run from the CLI.
-      #
-      def show_app_help
-        puts Info.display_title unless @engine.args.quiet?
-        self.show_topic APPLICATION
-      end
-
-      #
-      # Check to see if there is a topic by the given name.
-      #
-      def topic?( name )
-        lazy_load_index
-
-        return @topics.key?( name )
-      end
-
-      #
-      # Is the current topic Markdown?
-      #
-      def topic_is_md?( name )
-        lazy_load_index
-
-        topic_file = @topics[ name ]
-        return topic_file.end_with? '.md'
-      end
-
-      #
-      # Show a help topic, optionally paginaged.
-      # If the content of the help page fits on a single
-      # screen, it won't paginate.
-      #
-      def page_topic( topic )
-        return if @engine.args.quiet?
-
-        data = self.get_topic_data( topic )
-        page = data.lines.count > Settings.page_size( @engine )
-        @engine.platform.show( data, topic_is_md?( topic ), page )
-      end
-
-      #
-      # Show a help topic.
-      #
-      def show_topic( topic )
-        return if @engine.args.quiet?
-
-        data = self.get_topic_data( topic )
-        @engine.platform.show( data, topic_is_md?( topic ), false )
-      end
-
-      #
-      # Get topic data.
-      #
-      def get_topic_data( topic )
-        lazy_load_index
-
-        topic_file = @topics[ topic ]
-        return nil unless topic_file
-
-        File.read topic_file
-      end
-
-      #
-      # Lazy load topic index.
-      # We'll only load the index the first time a help topic
-      # is requested.  After that we'll use the cached index.
-      #
-      def lazy_load_index
-        return if @topics
-
-        @topics = {}
-        @engine.log.debug 'loading help file index...'
-
-        pn = File.dirname( File.absolute_path( __FILE__ ) )
-        pn = File.dirname( pn )
-
-        root = File.join( pn, 'help', '**/*.txt' )
-        Dir.glob( root ).each do |txt_file|
-          key = File.basename( txt_file, '.txt' )
-          @topics[ key ] = txt_file
-        end
-
-        root = File.join( pn, 'help', '**/*.md' )
-        Dir.glob( root ).each do |md_file|
-          key = File.basename( md_file, '.md' )
-          @topics[ key ] = md_file
-        end
-
-        @engine.log.debug "Found #{@topics.count} help files"
-      end
-
-    end
-  end
-end

data/lib/gloo_lang/help/app/application.txt

@@ -1,22 +0,0 @@
-GLOO APPLICATION
-
-  DESCRIPTION
-    Gloo scripting language.  A scripting language built on ruby.
-    More information coming soon.
-
-  SYNOPSIS
-    gloo [global option] [file]
-
-  GLOBAL OPTIONS
-    --cli        - Run in CLI mode
-                 - If no options are specified, this is the default.
-    --version    - Show application version
-    --help       - Show this help page
-
-  FILE
-    TODO: document running a gloo script
-      how to reference files by relative path in gloo folder
-      and also by absolute path
-
-  SEE ALSO
-    application, configuration

data/lib/gloo_lang/help/app/configuration.txt

@@ -1,7 +0,0 @@
-CONFIGURATION
-
-  DESCRIPTION
-    TODO: document the application configuration and settings
-
-  SEE ALSO
-    application, help

data/lib/gloo_lang/help/app/default_help.txt

@@ -1,14 +0,0 @@
-GLOO HELP
-
-  TODO:  write this article
-
-  LISTS
-    Show options for object and verb lists
-
-  DETAIL
-    How to get help detail for verbs and objects
-    How to see a help pages
-    How to see a list of help pages (topics)
-
-  SEE ALSO
-    application, configuration

data/lib/gloo_lang/help/app/logging.txt

@@ -1,16 +0,0 @@
-GLOO APPLICATION LOGGING
-
-  DESCRIPTION
-    Gloo writes to the gloo.log as well as to the console.
-    Debug messages are written to the log only, but other messages
-    are also written to the console unless the application is
-    running in quiet mode.
-
-  CONFIGURATION
-    The application logs folder is in the gloo folder.
-    When gloo is run, the gloo.log file will be written to.
-
-  TAIL
-    Example tail command to watch the gloo log:
-
-      tail -f ~/gloo/logs/gloo.log

data/lib/gloo_lang/help/core/color.txt

@@ -1,31 +0,0 @@
-COLOR
-
-  DESCRIPTION
-    The following colors can be used by the show verb to display
-    colored text:
-
-      red
-      blue
-      green
-      white
-      black
-      yellow
-
-    The color names are considered as virtual objects but may
-    also be referenced in variables.  See the example below.
-
-  EXAMPLE
-    Here are some examples of expression usage:
-
-      #
-      # Show multiple messages in color
-      #
-      colors [can] :
-        var [string] : red
-      	on_load [script] :
-      		show "red" (colors.var)
-      		show "blue" (blue)
-      		show "green" (green)
-
-  SEE ALSO
-    show