gloo-lang 0.9.2 → 0.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8cf5f126ee8c3c4198d6532c443098e3e7943473ea6fe79d70b01bc01b997253
-  data.tar.gz: e57eae5fcc2d910d576092c740d8c6d0907ef01ecbfd85443cc6277ce26429c3
+  metadata.gz: a97b50f311067cb36399d283816c85ab0ca4756ffbd1e9c90c06776be38cf5fa
+  data.tar.gz: c5bdb27db5edcb57fab3ec8bd0e50a4a2e6a2cd7f6c1b46001741da96c5b68c6
 SHA512:
-  metadata.gz: 10eb7ea0801448637295f4edabdf8a7d5255d4f484ef96d418c5f821116f422f2ad4129a0589cac0b23b9a53309cd683193a1a5a20a88f56c63ab2c542b682e6
-  data.tar.gz: 19d9f88b7ddf70ef89bc5a722e55f268d84cc8d4bbdaa95e429bd56a4a2d4ba9150a2e93b323876c129d51fd99a23b02df360a52d1461e207f4b8c2414b44459
+  metadata.gz: bc547e429ebe3ee5cc948d7647ef6a5226fa4d499adb467b832a276d1d9b83fb2f3ad56f91d1bc2033df46c3241f02257e05ea02369ad41f90a74897bbeab105
+  data.tar.gz: c415a1953ceb79b38e6b445cecf566547fa5d1fcac4cd6b8b93f980dcdf087d4ecb4ed31b317b8cb2354c560905329e3e9e9473691b19dc68fe8fa1a2af6bdd6

data/lib/VERSION

@@ -1 +1 @@
-0.9.2
+0.9.3

data/lib/dependencies.rb

@@ -11,8 +11,8 @@ files = []
 #
 # We want to start with these to avoid dependency errors later on.
 #
-# files << File.join( path, 'gloo_lang', 'core', 'baseo.rb' )
-# files << File.join( path, 'gloo_lang', 'core', 'obj.rb' )
+files << File.join( path, 'gloo_lang', 'core', 'baseo.rb' )
+files << File.join( path, 'gloo_lang', 'core', 'obj.rb' )
 
 root = File.join( path, 'gloo_lang', '**/*.rb' )
 Dir.glob( root ).each do |ruby_file|

data/lib/gloo-lang.rb

@@ -9,13 +9,9 @@ path = File.dirname( File.absolute_path( __FILE__ ) )
 require File.join( path, 'dependencies.rb' )
 
 module GlooLang
-
-  ERROR_MSG = 'Error:  the gloo_lang gem is not runnable!'.freeze
-  puts ERROR_MSG
-
   # def self.run
   #   params = []
   #   ( params << '--cli' ) if ARGV.count.zero?
-  #   Gloo::App::Engine.new( params ).start
+  #   GlooLang::App::Engine.new( params ).start
   # end
 end

data/lib/gloo_lang/app/args.rb

@@ -0,0 +1,112 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2019 Eric Crane.  All rights reserved.
+#
+# Arguments (parameters) used to specify functionality.
+# These might have come from the CLI or as parameters
+# in the constructor.
+#
+require 'active_support'
+require 'colorize'
+
+module GlooLang
+  module App
+    class Args
+
+      QUIET = 'quiet'.freeze
+      GLOO_ENV = 'GLOO_ENV'.freeze
+
+      attr_reader :switches, :files
+
+      #
+      # Create arguments and setup.
+      #
+      def initialize( params = [] )
+        @switches = []
+        @files = []
+
+        params.each { |o| process_one_arg( o ) }
+        ARGV.each { |o| process_one_arg( o ) }
+      end
+
+      #
+      # Was the --quiet arg passed?
+      #
+      def quiet?
+        return @switches.include?( QUIET )
+      end
+
+      #
+      # Is the version switch set?
+      #
+      def version?
+        @switches.include?( GlooLang::App::Mode::VERSION.to_s )
+      end
+
+      #
+      # Is the help switch set?
+      #
+      def help?
+        @switches.include?( GlooLang::App::Mode::HELP.to_s )
+      end
+
+      #
+      # Is the cli switch set?
+      #
+      def cli?
+        @switches.include?( GlooLang::App::Mode::CLI.to_s )
+      end
+
+      #
+      # Is the embed switch set?
+      #
+      def embed?
+        @switches.include?( GlooLang::App::Mode::EMBED.to_s )
+      end
+
+      #
+      # Detect the mode to be run in.
+      # Start by seeing if a mode is specified.
+      # Then look for the presence of files.
+      # Then finally use the default: embedded mode.
+      #
+      def detect_mode
+        mode = if ENV[ GLOO_ENV ] == GlooLang::App::Mode::TEST.to_s
+                 Mode::TEST
+               elsif version?
+                 Mode::VERSION
+               elsif help?
+                 Mode::HELP
+               elsif cli?
+                 Mode::CLI
+               elsif embed?
+                 Mode::EMBED
+               elsif @files.count.positive?
+                 Mode::SCRIPT
+               else
+                 Mode.default_mode
+               end
+        $log.debug "running in #{mode} mode"
+
+        return mode
+      end
+
+      # ---------------------------------------------------------------------
+      #    Private
+      # ---------------------------------------------------------------------
+
+      private
+
+      #
+      # Process one argument or parameter.
+      #
+      def process_one_arg( arg )
+        if arg.start_with? '--'
+          switches << arg[ 2..-1 ]
+        else
+          files << arg
+        end
+      end
+
+    end
+  end
+end

data/lib/gloo_lang/app/engine.rb

@@ -0,0 +1,230 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2019 Eric Crane.  All rights reserved.
+#
+# The Gloo Script Engine.
+# The Engine aggregates all the elements needed to run gloo.
+# The Engine runs the main event loop and delegates processing
+# to the relevant element.
+#
+
+require 'tty-prompt'
+require 'tty-cursor'
+require 'colorize'
+
+module GlooLang
+  module App
+    class Engine
+
+      attr_reader :args, :mode, :running,
+                  :dictionary, :parser, :heap, :factory
+      attr_accessor :last_cmd, :persist_man, :event_manager,
+                    :exec_env, :help, :converter
+
+      #
+      # Set up the engine with basic elements.
+      #
+      def initialize( params = [] )
+        $engine = self
+        @args = Args.new( params )
+        $settings = Settings.new( ENV[ 'GLOO_ENV' ] )
+        $log = Log.new( @args.quiet? )
+        $prompt = TTY::Prompt.new
+        $log.debug 'engine intialized...'
+      end
+
+      #
+      # Start the engine.
+      # Load object and verb definitions and setup engine elements.
+      #
+      def start
+        $log.debug 'starting the engine...'
+        $log.debug Info.display_title
+        @mode = @args.detect_mode
+        @running = true
+
+        @dictionary = GlooLang::Core::Dictionary.instance
+        @dictionary.init
+        @parser = GlooLang::Core::Parser.new
+        @heap = GlooLang::Core::Heap.new
+        @factory = GlooLang::Core::Factory.new
+        @persist_man = GlooLang::Persist::PersistMan.new
+        @event_manager = GlooLang::Core::EventManager.new
+
+        @exec_env = GlooLang::Exec::ExecEnv.new
+        @help = GlooLang::App::Help.new
+        @converter = GlooLang::Convert::Converter.new
+
+        $log.debug 'the engine has started'
+        run_mode
+      end
+
+      # ---------------------------------------------------------------------
+      #    Run
+      # ---------------------------------------------------------------------
+
+      #
+      # Run gloo in the selected mode.
+      #
+      def run_mode
+        $log.debug "running gloo in #{@mode} mode"
+
+        if @mode == Mode::VERSION
+          run_version
+        elsif @mode == Mode::HELP
+          show_help_and_quit
+        elsif @mode == Mode::SCRIPT
+          run_files
+        else
+          run
+        end
+      end
+
+      #
+      # Run files specified on the CLI.
+      # Then quit.
+      #
+      def run_files
+        @args.files.each { |f| @persist_man.load( f ) }
+        quit
+      end
+
+      #
+      # Run in interactive mode.
+      #
+      def run
+        # Open default file(s)
+        self.open_start_file
+
+        # TODO: open any files specifed in args
+
+        unless @mode == Mode::SCRIPT || @args.quiet?
+          @cursor = TTY::Cursor
+          self.loop
+        end
+
+        quit
+      end
+
+      #
+      # Get the setting for the start_with file and open it.
+      #
+      def open_start_file
+        name = $settings.start_with
+        @persist_man.load( name ) if name
+      end
+
+      #
+      # Prompt for the next command.
+      #
+      def prompt_cmd
+        @last_cmd = $prompt.ask( default_prompt )
+      end
+
+      #
+      # Get the default prompt text.
+      #
+      def default_prompt
+        dt = DateTime.now
+        d = dt.strftime( '%Y.%m.%d' )
+        t = dt.strftime( '%I:%M:%S' )
+        return "#{'gloo'.blue} #{d.yellow} #{t.white} >"
+      end
+
+      #
+      # Is the last command entered blank?
+      #
+      def last_cmd_blank?
+        return true if @last_cmd.nil?
+        return true if @last_cmd.strip.empty?
+
+        return false
+      end
+
+      #
+      # Prompt, Get input, process.
+      #
+      def loop
+        while @running
+          prompt_cmd
+          process_cmd
+        end
+      end
+
+      #
+      # Process the command.
+      #
+      def process_cmd
+        if last_cmd_blank?
+          clear_screen
+          return
+        end
+
+        @parser.run @last_cmd
+      end
+
+      #
+      # Request the engine to stop running.
+      #
+      def stop_running
+        @running = false
+      end
+
+      #
+      # Do any clean up and quit.
+      #
+      def quit
+        $log.debug 'quitting...'
+      end
+
+      # ---------------------------------------------------------------------
+      #    Helpers
+      # ---------------------------------------------------------------------
+
+      #
+      # Show the version information and then quit.
+      #
+      def run_version
+        puts Info.display_title unless @args.quiet?
+        quit
+      end
+
+      #
+      # Show the help information and then quit.
+      #
+      def show_help_and_quit
+        @help.show_app_help
+        quit
+      end
+
+      #
+      # Clear the screen.
+      #
+      def clear_screen
+        @cursor ||= TTY::Cursor
+        print @cursor.clear_screen
+        print @cursor.move_to( 0, 0 )
+      end
+
+      # ---------------------------------------------------------------------
+      #    Error Handling
+      # ---------------------------------------------------------------------
+
+      #
+      # Did the last command result in an error?
+      #
+      def error?
+        return !@heap.error.value.nil?
+      end
+
+      #
+      # Report an error.
+      # Write it to the log and set the heap error value.
+      #
+      def err( msg )
+        $log.error msg
+        self.heap.error.set_to msg
+      end
+
+    end
+  end
+end

data/lib/gloo_lang/app/help.rb

@@ -0,0 +1,156 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2019 Eric Crane.  All rights reserved.
+#
+# Help system.
+#
+
+require 'tty-markdown'
+require 'tty-pager'
+
+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
+        @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
+        if topic_is_md?( topic )
+          show_markdown_data( data, page )
+        else
+          show_text_data( data, page )
+        end
+      end
+
+      #
+      # Show a help topic.
+      #
+      def show_topic( topic )
+        return if $engine.args.quiet?
+
+        data = self.get_topic_data( topic )
+        if topic_is_md?( topic )
+          show_markdown_data data
+        else
+          show_text_data data
+        end
+      end
+
+      #
+      # Show the markdown data.
+      #
+      def show_text_data( data, page = false )
+        if page
+          pager = TTY::Pager.new
+          pager.page( data )
+        else
+          puts data.white
+          puts
+        end
+      end
+
+      #
+      # Show the markdown data.
+      #
+      def show_markdown_data( data, page = false )
+        md = TTY::Markdown.parse data
+
+        if page
+          pager = TTY::Pager.new
+          pager.page( md )
+        else
+          puts md
+          puts
+        end
+      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 = {}
+        $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
+
+        $log.debug "Found #{@topics.count} help files"
+      end
+
+    end
+  end
+end

data/lib/gloo_lang/app/log.rb

@@ -0,0 +1,81 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2019 Eric Crane.  All rights reserved.
+#
+# Application Logging wrapper.
+#
+require 'active_support'
+require 'colorize'
+require 'colorized_string'
+
+module GlooLang
+  module App
+    class Log
+
+      attr_reader :logger, :quiet
+
+      #
+      # Set up a logger.
+      # If quiet is true, then message are written to the log
+      # but not to the console.
+      #
+      def initialize( quiet )
+        f = File.join( $settings.log_path, 'gloo.log' )
+        @logger = Logger.new( f )
+        @logger.level = Logger::DEBUG
+        @quiet = quiet
+      end
+
+      #
+      # Show a message unless we're in quite mode.
+      #
+      def show( msg )
+        puts msg unless @quiet
+      end
+
+      #
+      # Write a debug message to the log.
+      #
+      def debug( msg )
+        @logger.debug msg
+      end
+
+      #
+      # Write an information message to the log.
+      # Also write to the console unless quiet.
+      #
+      def info( msg )
+        @logger.info msg
+        puts msg.blue unless @quiet
+      end
+
+      #
+      # Write a warning message to the log.
+      # Also write to the console unless quiet.
+      #
+      def warn( msg )
+        @logger.warn msg
+        puts msg.yellow unless @quiet
+      end
+
+      #
+      # Write an error message to the log and set the error
+      # in the engine's data heap.
+      # Also write to the console unless quiet.
+      #
+      def error( msg, ex = nil, engine = nil )
+        engine&.heap&.error&.set_to msg
+        @logger.error msg
+        if ex
+          @logger.error ex.message
+          @logger.error ex.backtrace
+          puts msg.red unless @quiet
+          puts ex.message.red unless @quiet
+          puts ex.backtrace unless @quiet
+        else
+          puts msg.red unless @quiet
+        end
+      end
+
+    end
+  end
+end

data/lib/gloo_lang/app/mode.rb

@@ -0,0 +1,27 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2019 Eric Crane.  All rights reserved.
+#
+# Mode the Application is running in.
+#
+
+module GlooLang
+  module App
+    class Mode
+
+      EMBED = :embed      # Run as embedded script processor
+      CLI = :cli          # Run in interactive (CLI) mode
+      SCRIPT = :script    # Run a script
+      VERSION = :version  # Show version information
+      HELP = :help        # Show the help screen
+      TEST = :test        # Running in Unit Test mode.
+
+      #
+      # Get the default mode.
+      #
+      def self.default_mode
+        return EMBED
+      end
+
+    end
+  end
+end