gloo 0.5.3 → 0.7.1

data/lib/gloo/help/verbs/save.txt

@@ -0,0 +1,26 @@
+SAVE VERB
+  NAME: save
+  SHORTCUT: >
+
+  DESCRIPTION
+    Save a previously loaded object to .gloo file.  The path will be for the
+    root level object that was loaded earlier.
+
+  SYNTAX
+    save <path.to.object>
+
+  PARAMETERS
+    path.to.object - Name of the object file that is to be saved.
+
+  RESULT
+    The file is updated with the latest object state.
+
+  ERRORS
+    None
+
+  EXAMPLE
+
+    > save my_obj
+
+  SEE ALSO
+    load

data/lib/gloo/help/verbs/show.txt

@@ -0,0 +1,30 @@
+SHOW VERB
+  NAME: show
+  SHORTCUT: =
+
+  DESCRIPTION
+    Show an object's value.
+
+  SYNTAX
+    show <path.to.object>
+
+  PARAMETERS
+    path.to.object - The object that we want to see.
+
+  RESULT
+    The object's value is shown.
+    <it> will contain the object's value.
+
+  ERRORS
+    None
+
+  EXAMPLE
+
+    > show "me"
+    > show "hello " "world"
+    > show 132 * 23
+
+    > create x : "boo"
+    > show x
+
+  SEE ALSO

data/lib/gloo/help/verbs/tell.txt

@@ -0,0 +1,34 @@
+TELL VERB
+  NAME: tell
+  SHORTCUT: ->
+
+  DESCRIPTION
+    Send a message to an object.
+    Ask the object to perform an action.
+
+  SYNTAX
+    tell <path.to.object> to <message>
+
+  PARAMETERS
+    path.to.object - The object that we want to see.
+    message - The message to send.
+
+  RESULT
+    The result depends on the message that is sent.
+
+  ERRORS
+    Missing message!
+      - No message was specified, or the 'to' keyword is missing.
+
+    Object was not found
+      - The target of the message was not found.
+
+  EXAMPLE
+
+    > tell an.obj to unload
+    > tell the.script to run
+    > tell my.str to up
+    > tell the.container to count
+    
+  SEE ALSO
+    run

data/lib/gloo/help/verbs/unless.txt

@@ -0,0 +1,38 @@
+UNLESS VERB
+  NAME: unless
+  SHORTCUT: if!
+
+  DESCRIPTION
+    Unless an expression is true, do something.
+    This is the opposite of the if verb.
+
+  SYNTAX
+    unless <true> do <command>
+
+  PARAMETERS
+    true - Does the expression evaluate to true?
+    command - Execute command if the expression is not true.
+
+  RESULT
+    Unchanged if the expression is true.
+    If not true, then the result will be based on the command
+    specified after the 'do' keyword.
+
+  ERRORS
+    Missing Expression!
+      - No expression is provided as parameter to the verb.
+
+    Other errors depend on the command that is run.
+
+  EXAMPLE
+
+    unless [container] :
+      x [bool] : true
+      false_msg [string] : It is NOT true!
+      on_load [script] :
+        unless unless.x do show "first time: " + unless.false_msg
+        put false into unless.x
+        unless unless.x do show "second time: " +  unless.false_msg
+
+  SEE ALSO
+    if

data/lib/gloo/help/verbs/version.txt

@@ -0,0 +1,32 @@
+VERSION VERB
+  NAME: version
+  SHORTCUT: v
+
+  DESCRIPTION
+    Show the application version information.
+
+    This is the same as showing the version by running gloo
+    with the --version command line parameter.
+
+  SYNTAX
+    version
+
+  PARAMETERS
+    None
+
+  RESULT
+    None
+
+  ERRORS
+    None
+
+  EXAMPLE
+
+    > version
+    > v
+
+    This is the same as running this from the command line:
+
+    > gloo --version
+
+  SEE ALSO

data/lib/gloo/help/verbs/wait.txt

@@ -0,0 +1,29 @@
+WAIT VERB
+  NAME: wait
+  SHORTCUT: w
+
+  DESCRIPTION
+    Wait for the given number of seconds.
+
+  SYNTAX
+    wait <seconds>
+
+  PARAMETERS
+    seconds - The number of seconds.
+      If no value is given, we'll wait for 1 second.
+
+  RESULT
+    None
+
+  ERRORS
+    None
+
+  EXAMPLE
+
+    > wait
+    > wait 3
+
+    > create x as int : 10
+    > wait x
+
+  SEE ALSO

data/lib/gloo/objs/basic/alias.rb

@@ -73,39 +73,6 @@ module Gloo
         return ln.resolve
       end
 
-      # ---------------------------------------------------------------------
-      #    Help
-      # ---------------------------------------------------------------------
-
-      #
-      # Get help for this object type.
-      #
-      def self.help
-        return <<~TEXT
-          ALIAS OBJECT TYPE
-            NAME: alias
-            SHORTCUT: ln
-
-          DESCRIPTION
-            A pointer to another object.
-            Normal path-name references will refere to the aliased object.
-            To refer to the alias itself, add an * at the end of the path-name.
-            This is neeed, for example, to set the value of the alias.
-            The value of the alias is merely the path-name of the
-            referenced object.
-
-          CHILDREN
-            None
-
-          MESSAGES
-            The alias will reflect the mesages of the object to which
-            it points.
-            The alias itself can receive the following message:
-            resolve - Check to see if the object referenced exists.
-                  Sets it to true or false.
-        TEXT
-      end
-
     end
   end
 end

data/lib/gloo/objs/basic/boolean.rb

@@ -84,7 +84,9 @@ module Gloo
         return super + %w[not true false]
       end
 
+      #
       # Set the value to the opposite of what it is.
+      #
       def msg_not
         v = !value
         set_value v
@@ -92,47 +94,24 @@ module Gloo
         return v
       end
 
+      #
       # Set the value to true.
+      #
       def msg_true
         set_value true
         $engine.heap.it.set_to true
         return true
       end
 
+      #
       # Set the value to false.
+      #
       def msg_false
         set_value false
         $engine.heap.it.set_to false
         return false
       end
 
-      # ---------------------------------------------------------------------
-      #    Help
-      # ---------------------------------------------------------------------
-
-      #
-      # Get help for this object type.
-      #
-      def self.help
-        return <<~TEXT
-          BOOLEAN OBJECT TYPE
-            NAME: boolean
-            SHORTCUT: bool
-
-          DESCRIPTION
-            A boolean value.
-            Value will be either true or false.
-
-          CHILDREN
-            None
-
-          MESSAGES
-            not - Set the boolean to the opposite of what it is now.
-            true - Set the boolean to true.
-            false - Set the boolean to false.
-        TEXT
-      end
-
     end
   end
 end

data/lib/gloo/objs/basic/container.rb

@@ -71,39 +71,6 @@ module Gloo
         puts "\n  #{rendered}\n\n"
       end
 
-      # ---------------------------------------------------------------------
-      #    Help
-      # ---------------------------------------------------------------------
-
-      #
-      # Get help for this object type.
-      #
-      def self.help
-        return <<~TEXT
-          CONTAINER OBJECT TYPE
-            NAME: container
-            SHORTCUT: can
-
-          DESCRIPTION
-            A container of other objects.
-            A container is similar to a folder in a file system.
-            It can contain any number of objects including other containers.
-            The container structure provides direct access to any object
-            within it through the object.object.object path-name structure.
-
-          CHILDREN
-            None by default.  But any container can have any number of
-            objects added to it.
-
-          MESSAGES
-            count - Count the number of children objects in the container.
-                    The result is put in <it>.
-            delete_children - Delete all children objects from the container.
-            show_key_value_tbl - Show a table with key (name) and values
-              for all children in the container.
-        TEXT
-      end
-
     end
   end
 end

data/lib/gloo/objs/basic/decimal.rb

@@ -35,7 +35,7 @@ module Gloo
         end
 
         unless new_value.is_a? Numeric
-          self.value = $engine.convert( new_value, 'Decimal', 0.0 )
+          self.value = $engine.converter.convert( new_value, 'Decimal', 0.0 )
           return
         end
 
@@ -59,38 +59,18 @@ module Gloo
       # round to the precision given.
       #
       def msg_round
-        i = value + 1
+        data = 0
+        if @params&.token_count&.positive?
+          expr = Gloo::Expr::Expression.new( @params.tokens )
+          data = expr.evaluate.to_i
+        end
+
+        i = self.value.round( data )
         set_value i
         $engine.heap.it.set_to i
         return i
       end
 
-      # ---------------------------------------------------------------------
-      #    Help
-      # ---------------------------------------------------------------------
-
-      #
-      # Get help for this object type.
-      #
-      def self.help
-        return <<~TEXT
-          DECIMAL OBJECT TYPE
-            NAME: decimal
-            SHORTCUT: num
-
-          DESCRIPTION
-            A decimal (numeric) value.
-
-          CHILDREN
-            None
-
-          MESSAGES
-            round - Round to the nearest whole value.
-              If an optional parameter is included, round to the
-              precision specified.
-        TEXT
-      end
-
     end
   end
 end

data/lib/gloo/objs/basic/integer.rb

@@ -30,7 +30,7 @@ module Gloo
       #
       def set_value( new_value )
         unless new_value.is_a? Numeric
-          self.value = $engine.convert( new_value, 'Integer', 0 )
+          self.value = $engine.converter.convert( new_value, 'Integer', 0 )
           return
         end
 
@@ -48,7 +48,9 @@ module Gloo
         return super + %w[inc dec]
       end
 
+      #
       # Increment the integer
+      #
       def msg_inc
         i = value + 1
         set_value i
@@ -56,7 +58,9 @@ module Gloo
         return i
       end
 
+      #
       # Decrement the integer
+      #
       def msg_dec
         i = value - 1
         set_value i
@@ -64,31 +68,6 @@ module Gloo
         return i
       end
 
-      # ---------------------------------------------------------------------
-      #    Help
-      # ---------------------------------------------------------------------
-
-      #
-      # Get help for this object type.
-      #
-      def self.help
-        return <<~TEXT
-          INTEGER OBJECT TYPE
-            NAME: integer
-            SHORTCUT: int
-
-          DESCRIPTION
-            An integer (numeric) value.
-
-          CHILDREN
-            None
-
-          MESSAGES
-            inc - Increment the integer value by 1.
-            dec - Decrement the integer value by 1.
-        TEXT
-      end
-
     end
   end
 end