gloo-lang 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eaf0cc0e5ed992c2a11536a38506170a840099823bacd260b0e2bf6e4384dd14
-  data.tar.gz: c07498a7140679627f936db05d0d71b69c2853e4e87fe504cf7182ac47eb38f2
+  metadata.gz: b2fef4d21ce7b2ba45d4598fa24282c703581bbe1e40ea07f8e8063bf66a4b1b
+  data.tar.gz: dbd1b3b25f998023baa7c93044618f33bdca46de5ff068b2efd2093d156c5393
 SHA512:
-  metadata.gz: 5667685e248cd7fba038d9913c766ab3bfe899a7333d07977b517168eacf6d6b5843cb7a8d4e750dd02e94f7faf2c5921775cce2920ad6ac59913ba89bc9b9ee
-  data.tar.gz: 425a61000ca83a501a656e01c241e927a7de3d909058d1760266a5d026128e103ea69d412443d2a1a78a5247412799bbf68a6ee0ddbe55bfc5eddbc9595220e0
+  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/lib/VERSION

@@ -1 +1 @@
-1.0.2
+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,7 +52,6 @@ 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'
@@ -107,8 +106,6 @@ 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
@@ -217,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
       # ---------------------------------------------------------------------

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gloo-lang
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - Eric Crane
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-03-30 00:00:00.000000000 Z
+date: 2022-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -192,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
@@ -207,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
@@ -249,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
@@ -360,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
@@ -372,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 (1.0.1)
-      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, >= 5.14.2)
-  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

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

@@ -1,33 +0,0 @@
-ERROR
-
-  DESCRIPTION
-    Gloo has a special 'error' variable that's not part of the normal
-    object heap.  The error will be empty most of the time, but
-    if a command results in an error, this variable will hold the
-    error message until the next command is executed.  The error
-    is a string and can be accessed by simply referring to the
-    path-name 'error'.
-
-  EXAMPLE
-    To see the last error:
-
-      > show error
-
-    To run a command that generates an error:
-
-      > put 3 into
-      'put' must include 'into' target
-
-    Then, showing the error
-
-      > show error
-      'put' must include 'into' target
-
-    But, as mentioned, the next command will clear out the last error.
-    If you need to keep track of the result of a command, you should
-    put the error into another object.
-
-      > create err as string
-      > put 3 into
-      > put error into err
-      

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

@@ -1,21 +0,0 @@
-EVENTS
-
-  DESCRIPTION
-    Scripts can be written to be triggered by events.  The current list is as
-    follows, but it is expected that the list of events will grow.
-
-      on_load - run when a script loads
-      on_unload - run when an object receives an unload message
-
-      TODO:  add event types.
-
-  EXAMPLE
-    Show a message when a file is loaded:
-
-      start [container] :
-        on_load [script] : show "Welcome back!" (white)
-
-    Show a message when a file unloaded:
-
-      done [container] :
-        on_unload [script] : show "See ya soon!" (white)

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

@@ -1,57 +0,0 @@
-GLOO SYSTEM OBJECTS
-
-  DESCRIPTION
-    The gloo system objects are virtual objects.  That is that they
-    can be accessed like other objects.  But the values are set by
-    the system.  The values cannot be updated.  The other difference
-    is that the virtual objects do not show up in the object heap.
-
-  ACCESS
-    The gloo objects can be accessed through the 'gloo' root level
-    virtual object designation.  There is also a shortcut for the virtual
-    object path:  '$'.  For example, to see the current user:
-
-      > show gloo.user
-
-    Or:
-
-      > show $.user
-
-    Some objects include an '_' to separate words.  As an alternative,
-    a '.' can be used instead.  The following commands are treated as
-    identical:
-
-      > show gloo.working_dir
-      > show gloo.working.dir
-      > show $.working_dir
-      > show $.working.dir
-
-  OBJECTS
-
-    IDENTITY
-    gloo.hostname         # Get the system hostname.
-    gloo.user             # Get the logged in User.
-
-    SPECIAL CHARS
-    gloo.line             # A carriage return (line feed) character.
-
-    FILE SYSTEM
-    gloo.user_home        # Get the user's home directory.
-    gloo.working_dir      # Get the working directory.
-    gloo.gloo_home        # Get the gloo home directory
-    gloo.gloo_config      # Get the gloo configuration directory
-    gloo.gloo_projects    # Get the gloo projects directory
-    gloo.gloo_log         # Get the gloo logging directory
-
-    SCREEN
-    gloo.screen_lines     # Get the number of lines on screen.
-    gloo.screen_cols      # Get the number of columns on screen.
-
-    PLATFORM
-    gloo.platform_cpu       # Get the platform CPU
-    gloo.platform_os        # Get the platform Operating System
-    gloo.platform_version   # Get the platform version
-    gloo.platform_windows?  # Is the platform Windows?
-    gloo.platform_unix?     # Is the platform Unix?
-    gloo.platform_linux?    # Is the platform Linux?
-    gloo.platform_mac?      # Is the platform Mac?

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

@@ -1,30 +0,0 @@
-HERE
-
-  DESCRIPTION
-    Gloo scripts can use relative referencing to access objects
-    without specifying the full path.  This relative referencing is
-    referred to with the 'here' operator: ^
-
-  EXAMPLE
-    In the following script, the here reference is used several times:
-
-      #
-      # Use here reference.
-      #
-      here [can] :
-        s [str] : local string
-      	on_load [script] : show ^.s
-        a [can] :
-          s [str] : A string
-          b [can] :
-            s [str] : B string
-            on_load [script] :
-              show ^.s
-              show ^^.s
-
-    A single use of '^' means: refer to an object at the same level
-    as the running script.  It tells the interpreter to 'look here'
-    for the object.
-
-    Use of two ^^ here references means to go up a level, and
-    so forth.

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

@@ -1,23 +0,0 @@
-IT
-
-  DESCRIPTION
-    'It' is a special virtual object.  'It' contains the value of
-    the last expression or command run.  Not all commands result in
-    a change to the value of it.
-
-  EXAMPLE
-    Get the value of an expression and store it somewhere for later use:
-
-      #
-      # Example of usage of 'it'.
-      #
-      it_example [can] :
-        result [int] :
-        on_load [script] :
-          show 3 + 4
-          put it into ^.result
-          show ^.result
-
-    Running this script will show 7 twice.  The first time will be the
-    result of the addition.  The second time will be showing the
-    result object.

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

@@ -1,16 +0,0 @@
-OPERATORS
-
-  DESCRIPTION
-    These are the gloo operators:
-
-      +   addition
-      -   subtraction
-      *   multiplication
-      /   division
-
-  EXAMPLE
-    Here are some examples of expression usage:
-
-      > show 2 + 5
-      > put 12 / 3 into x
-      > show 23 * 3 - 6