easycoder 250102.1__tar.gz → 250103.2__tar.gz

{easycoder-250102.1 → easycoder-250103.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: easycoder
-Version: 250102.1
+Version: 250103.2
 Summary: Rapid scripting in English
 Keywords: compiler,scripting,prototyping,programming,coding,python,low code,hypertalk,computer language,learn to code
 Author-email: Graham Trott <gtanyware@gmail.com>

{easycoder-250102.1 → easycoder-250103.2}/doc/core/README.md

@@ -10,7 +10,7 @@ There are three primary components to the language:
 
 The core keywords are:
 
-[add](keywords/add.md) [append](keywords/append.md) [assert](keywords/assert.md) [begin](keywords/begin.md) [clear](keywords/clear.md) [close](keywords/close.md) [create](keywords/create.md) [debug](keywords/debug.md) [decrement](keywords/decrement.md) [delete](keywords/delete.md) [divide](keywords/divide.md) [exit](keywords/exit.md) [file](keywords/file.md) [fork](keywords/fork.md) [get](keywords/get.md) [go](keywords/go.md) [gosub](keywords/gosub.md) [if](keywords/if.md) [import](keywords/import.md) [increment](keywords/increment.md) [index](keywords/index.md) [init](keywords/init.md) [input](keywords/input.md) [multiply](keywords/multiply.md) [negate](keywords/negate.md) [open](keywords/open.md) [pop](keywords/pop.md) [post](keywords/post.md) [print](keywords/print.md) [push](keywords/push.md) [put](keywords/put.md) [read](keywords/read.md) [replace](keywords/replace.md) [return](keywords/return.md) [script](keywords/script.md) [set](keywords/set.md) [split](keywords/split.md) [stack](keywords/stack.md) [stop](keywords/stop.md) [system](keywords/system.md) [take](keywords/take.md) [toggle](keywords/toggle.md) [truncate](keywords/truncate.md) [variable](keywords/variable.md) [wait](keywords/wait.md) [while](keywords/while.md) [write](keywords/write.md)
+[add](keywords/add.md) [append](keywords/append.md) [assert](keywords/assert.md) [begin](keywords/begin.md) [clear](keywords/clear.md) [close](keywords/close.md) [create](keywords/create.md) [debug](keywords/debug.md) [decrement](keywords/decrement.md) [delete](keywords/delete.md) [divide](keywords/divide.md) [exit](keywords/exit.md) [file](keywords/file.md) [fork](keywords/fork.md) [get](keywords/get.md) [go](keywords/go.md) [gosub](keywords/gosub.md) [if](keywords/if.md) [import](keywords/import.md) [increment](keywords/increment.md) [index](keywords/index.md) [init](keywords/init.md) [input](keywords/input.md) [load](keywords/load.md) [multiply](keywords/multiply.md) [negate](keywords/negate.md) [open](keywords/open.md) [pop](keywords/pop.md) [post](keywords/post.md) [print](keywords/print.md) [push](keywords/push.md) [put](keywords/put.md) [read](keywords/read.md) [replace](keywords/replace.md) [return](keywords/return.md) [save](keywords/save.md) [script](keywords/script.md) [set](keywords/set.md) [split](keywords/split.md) [stack](keywords/stack.md) [stop](keywords/stop.md) [system](keywords/system.md) [take](keywords/take.md) [toggle](keywords/toggle.md) [truncate](keywords/truncate.md) [variable](keywords/variable.md) [wait](keywords/wait.md) [while](keywords/while.md) [write](keywords/write.md)
 
 The core values are:
 
@@ -18,4 +18,6 @@ The core values are:
 
 The core conditions are:
 
+[boolean](conditions/boolean.md) [empty](conditions/empty.md) [ends](conditions/ends.md) [even](conditions/even.md) [exists](conditions/exists.md) [greater](conditions/greater.md) [has property](conditions/hasProperty.md) [includes](conditions/includes.md) [is](conditions/is.md) [less](conditions/less.md) [list](conditions/list.md) [numeric](conditions/numeric.md) [none](conditions/none.md) [not](conditions/not.md) [object](conditions/object.md) [odd](conditions/odd.md) [starts](conditions/starts.md) [string](conditions/string.md) 
+
 [Back](../README.md)

easycoder-250103.2/doc/core/conditions/boolean.md

@@ -0,0 +1,16 @@
+# boolean
+
+## Syntax:
+`{value} is [not] boolean`
+
+## Examples:
+`if MyVariable is boolean stop`  
+``if `true` is boolean stop` ``
+
+## Description:
+Tests if the given value is boolean. The inclusion of `[not]` negates the test.
+
+Next: [empty](empty.md)  
+Prev: [string](string.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/empty.md

@@ -0,0 +1,15 @@
+# empty
+
+## Syntax:
+`{value} is [not] empty`
+
+## Examples:
+`if MyVariable is empty stop`
+
+## Description:
+Tests if the given value is an empty string. The inclusion of `[not]` negates the test.
+
+Next: [ends](ends.md)  
+Prev: [boolean](boolean.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/ends.md

@@ -0,0 +1,15 @@
+# ends
+
+## Syntax:
+`{value} ends with {text}`
+
+## Examples:
+``if MyVariable ends with `#` stop` ``
+
+## Description:
+Tests if the given value ends with a given string.
+
+Next: [even](even.md)  
+Prev: [empty](empty.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/even.md

@@ -0,0 +1,15 @@
+# even
+
+## Syntax:
+`{value} ends with {text}`
+
+## Examples:
+``if MyVariable ends with `#` stop` ``
+
+## Description:
+Tests if the given number is even. The inclusion of `[not]` negates the test, or you can use [odd](odd.md).
+
+Next: [exists](exists.md)  
+Prev: [ends](ends.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/exists.md

@@ -0,0 +1,15 @@
+# exists
+
+## Syntax:
+`{file path} exists`
+
+## Examples:
+`if MyFile exists stop`
+
+## Description:
+Tests if the named file exists.
+
+Next: [greater](greater.md)  
+Prev: [even](even.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/greater.md

@@ -0,0 +1,16 @@
+# greater
+
+## Syntax:
+`{value} is [not] greater than {other value}`
+
+## Examples:
+`if 10 is greater than 5 stop`  
+`if Value is not greater than 100 stop`
+
+## Description:
+Tests if the value is greater than the second value. The inclusion of `[not]` negates the test.
+
+Next: [has property](hasProperty.md)  
+Prev: [exists](exists.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/hasProperty.md

@@ -0,0 +1,15 @@
+# has property
+
+## Syntax:
+`{value} has property {property}`
+
+## Examples:
+``if Users has property `Andrew` stop` ``
+
+## Description:
+Tests if the value - usually a variable - has the named property as one of its attributes.
+
+Next: [includes](includes.md)  
+Prev: [greater](greater.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/includes.md

@@ -0,0 +1,15 @@
+# includes
+
+## Syntax:
+`{value} includes {element}`
+
+## Examples:
+``if Animals includes `cat` stop` ``
+
+## Description:
+Tests if the array - usually a variable - has the named element as one of its members.
+
+Next: [is](is.md)  
+Prev: [has property](hasProperty.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/is.md

@@ -0,0 +1,15 @@
+# is
+
+## Syntax:
+`{value} is {second value}`
+
+## Examples:
+``if Animal is `cat` stop` ``
+
+## Description:
+Tests if the value is identical to the second value.
+
+Next: [less](less.md)  
+Prev: [includes](includes.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/less.md

@@ -0,0 +1,16 @@
+# less
+
+## Syntax:
+`{value} is [not] less than {other value}`
+
+## Examples:
+`if 10 is less than 5 stop`  
+`if Value is not less than 100 stop`
+
+## Description:
+Tests if the value is less than the second value. The inclusion of `[not]` negates the test.
+
+Next: [list](less.md)  
+Prev: [is](is.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/list.md

@@ -0,0 +1,15 @@
+# list
+
+## Syntax:
+`{value} is [not] list`
+
+## Examples:
+`if MyData is not list stop`
+
+## Description:
+Tests if the value is a list. The inclusion of `[not]` negates the test.
+
+Next: [numeric](numeric.md)  
+Prev: [less](less.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/none.md

@@ -0,0 +1,15 @@
+# none
+
+## Syntax:
+`{value} is [not] none`
+
+## Examples:
+`if MyData is not none stop`
+
+## Description:
+Tests if the value has the Python value `None`. The inclusion of `[not]` negates the test.
+
+Next: [not](not.md)  
+Prev: [numeric](list.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/not.md

@@ -0,0 +1,15 @@
+# not
+
+## Syntax:
+`{value} is not {second value}`
+
+## Examples:
+`if Value is not 100 stop`
+
+## Description:
+Tests if the value is not the same as the second value.
+
+Next: [object](obect.md)  
+Prev: [none](none.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/numeric.md

@@ -0,0 +1,15 @@
+# numeric
+
+## Syntax:
+`{value} is [not] numeric`
+
+## Examples:
+`if MyData is not numeric stop`
+
+## Description:
+Tests if the value is a numeric value. The inclusion of `[not]` negates the test.
+
+Next: [none](none.md)  
+Prev: [list](list.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/object.md

@@ -0,0 +1,15 @@
+# object
+
+## Syntax:
+`{value} is [not] object`
+
+## Examples:
+`if Value is object stop`
+
+## Description:
+Tests if the value is an object. The inclusion of `[not]` negates the test.
+
+Next: [odd](odd.md)  
+Prev: [not](not.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/odd.md

@@ -0,0 +1,15 @@
+# odd
+
+## Syntax:
+`{value} is [not] odd`
+
+## Examples:
+`if Value is odd stop`
+
+## Description:
+Tests if the value is an odd number. The inclusion of `[not]` negates the test, or you can use [even](even.md).
+
+Next: [starts](starts.md)  
+Prev: [object](object.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/starts.md

@@ -0,0 +1,15 @@
+# starts
+
+## Syntax:
+`{value} starts with {text}`
+
+## Examples:
+``if Value starts with `!` stop` ``
+
+## Description:
+Tests if the value starts with the given text.
+
+Next: [string](string.md)  
+Prev: [odd](odd.md)
+
+[Back](../../README.md)

easycoder-250103.2/doc/core/conditions/string.md

@@ -0,0 +1,15 @@
+# string
+
+## Syntax:
+`{value} is [not] string`
+
+## Examples:
+`if Value is string stop`
+
+## Description:
+Tests if the value is a text string.
+
+Next: [boolean](boolean.md)  
+Prev: [starts](starts.md)
+
+[Back](../../README.md)

{easycoder-250102.1 → easycoder-250103.2}/doc/core/keywords/input.md

@@ -9,7 +9,7 @@
 ## Description:
 `input` lets the user provide data from the keyboard, with an optional prompt string.
 
-Next: [multiply](multiply.md)  
+Next: [load](load.md)  
 Prev: [init](init.md)
 
 [Back](../../README.md)

easycoder-250103.2/doc/core/keywords/load.md

@@ -0,0 +1,16 @@
+# load
+
+## Syntax:
+`load {variable} from {path}`
+
+## Examples:
+``load Data from `mydata.txt` ``  
+`load Data from Path`
+
+## Description:
+Loads the contents of a file into a variable. See also [save](save.md).
+
+Next: [multiply](multiply.md)  
+Prev: [init](init.md)
+
+[Back](../../README.md)

{easycoder-250102.1 → easycoder-250103.2}/doc/core/keywords/multiply.md

@@ -11,6 +11,6 @@
 Multiplies a numeric variable by a numeric value or multiplies one value by another and puts the result into a variable. See elsewhere in this documentation for an explanation of what is meant by a value. If you multiply a variable it must already hold a numeric value, and if you assign a variable to hold the result of a multiplication it will lose whatever value it previously held. 
 
 Next: [negate](negate.md)  
-Prev: [input](input.md)
+Prev: [load](load.md)
 
 [Back](../../README.md)

{easycoder-250102.1 → easycoder-250103.2}/doc/core/keywords/return.md

@@ -8,7 +8,7 @@
 ## Description:
 Return from a subroutine. See [gosub](gosub.md).
 
-Next: [script](script.md)  
+Next: [save](save.md)  
 Prev: [replace](replace.md)
 
 [Back](../../README.md)

easycoder-250103.2/doc/core/keywords/save.md

@@ -0,0 +1,16 @@
+# save
+
+## Syntax:
+`save {value} to {filename}`
+
+## Examples:
+``save Data to `mydata.txt` ``  
+`save Data to FileName`
+
+## Description:
+Saves data to a file. See also [load](load.md).
+
+Next: [set](set.md)  
+Prev: [return](return.md)
+
+[Back](../../README.md)

{easycoder-250102.1 → easycoder-250103.2}/doc/core/keywords/script.md

@@ -9,6 +9,6 @@
 Provides a name for the script. Note that `name` is literal text, not a script variable.
 
 Next: [set](set.md)  
-Prev: [return](return.md)
+Prev: [save](save.md)
 
 [Back](../../README.md)

{easycoder-250102.1 → easycoder-250103.2}/easycoder/__init__.py

@@ -10,4 +10,4 @@ from .ec_program import *
 from .ec_timestamp import *
 from .ec_value import *
 
-__version__ = "250102.1"
+__version__ = "250103.2"

{easycoder-250102.1 → easycoder-250103.2}/easycoder/ec_core.py

@@ -646,6 +646,28 @@ class Core(Handler):
         self.putSymbolValue(symbolRecord, value)
         return self.nextPC()
 
+    # Load a variable from a file
+    def k_load(self, command):
+        if self.nextIsSymbol():
+            command['target'] = self.getToken()
+            if self.nextIs('from'):
+                command['file'] = self.nextValue()
+                self.add(command)
+                return True
+        return False
+
+    def r_load(self, command):
+        target = self.getVariable(command['target'])
+        file = self.getRuntimeValue(command['file'])
+        f = open(file, 'r')
+        content = f.read()
+        f.close()
+        value = {}
+        value['type'] = 'text'
+        value['content'] = content
+        self.putSymbolValue(target, value)
+        return self.nextPC()
+
     # Arithmetic multiply
     # multiply {variable} by {value}[ giving {variable}]}
     def k_multiply(self, command):
@@ -1021,6 +1043,23 @@ class Core(Handler):
         self.program.name = self.nextToken()
         return True
 
+    # Save a value to a file
+    def k_save(self, command):
+        command['content'] = self.nextValue()
+        if self.nextIs('to'):
+            command['file'] = self.nextValue()
+            self.add(command)
+            return True
+        return False
+
+    def r_save(self, command):
+        content = self.getRuntimeValue(command['content'])
+        file = self.getRuntimeValue(command['file'])
+        f = open(file, 'w')
+        f.write(content)
+        f.close()
+        return self.nextPC()
+
     # Set a value
     # set {variable}
     # set the elements of {variable} to {value}
@@ -2021,19 +2060,12 @@ class Core(Handler):
         value['content'] = json.dumps(item)
         return value
 
+    # This is used by the expression evaluator to get the value of a symbol
     def v_symbol(self, symbolRecord):
         result = {}
         if symbolRecord['keyword'] == 'variable':
             symbolValue = self.getSymbolValue(symbolRecord)
             return symbolValue
-            # if symbolValue == None:
-            #     return None
-            # result['type'] = symbolValue['type']
-            # content = symbolValue['content']
-            # if content == None:
-            #     return ''
-            # result['content'] = content
-            # return result
         else:
             return None
 
@@ -2211,20 +2243,59 @@ class Core(Handler):
                 return True if condition.negate else False
         return False
 
-    def c_numeric(self, condition):
-        comparison = type(self.getRuntimeValue(condition.value1)) is int
+    def c_empty(self, condition):
+        value = self.getRuntimeValue(condition.value1)
+        if value == None:
+            comparison = True
+        else:
+            comparison = len(value) == 0
         return not comparison if condition.negate else comparison
 
-    def c_string(self, condition):
-        comparison = type(self.getRuntimeValue(condition.value1)) is str
-        return not comparison if condition.negate else comparison
+    def c_ends(self, condition):
+        value1 = self.getRuntimeValue(condition.value1)
+        value2 = self.getRuntimeValue(condition.value2)
+        return value1.endswith(value2)
+
+    def c_even(self, condition):
+        return self.getRuntimeValue(condition.value1) % 2 == 0
+
+    def c_exists(self, condition):
+        path = self.getRuntimeValue(condition.path)
+        return os.path.exists(path)
+
+    def c_greater(self, condition):
+        comparison = self.program.compare(condition.value1, condition.value2)
+        return comparison <= 0 if condition.negate else comparison > 0
+
+    def c_hasProperty(self, condition):
+        value = self.getRuntimeValue(condition.value1)
+        prop = self.getRuntimeValue(condition.property)
+        try:
+            value[prop]
+            hasProp = True
+        except:
+            hasProp = False
+        return hasProp
+
+    def c_includes(self, condition):
+        value1 = self.getRuntimeValue(condition.value1)
+        value2 = self.getRuntimeValue(condition.value2)
+        return value2 in value1
+
+    def c_is(self, condition):
+        comparison = self.program.compare(condition.value1, condition.value2)
+        return comparison != 0 if condition.negate else comparison == 0
+
+    def c_less(self, condition):
+        comparison = self.program.compare(condition.value1, condition.value2)
+        return comparison >= 0 if condition.negate else comparison < 0
 
     def c_list(self, condition):
         comparison = type(self.getRuntimeValue(condition.value1)) is list
         return not comparison if condition.negate else comparison
 
-    def c_object(self, condition):
-        comparison = type(self.getRuntimeValue(condition.value1)) is dict
+    def c_numeric(self, condition):
+        comparison = type(self.getRuntimeValue(condition.value1)) is int
         return not comparison if condition.negate else comparison
 
     def c_none(self, condition):
@@ -2234,58 +2305,19 @@ class Core(Handler):
     def c_not(self, condition):
         return not self.getRuntimeValue(condition.value1)
 
-    def c_even(self, condition):
-        return self.getRuntimeValue(condition.value1) % 2 == 0
+    def c_object(self, condition):
+        comparison = type(self.getRuntimeValue(condition.value1)) is dict
+        return not comparison if condition.negate else comparison
 
     def c_odd(self, condition):
         return self.getRuntimeValue(condition.value1) % 2 == 1
 
-    def c_is(self, condition):
-        comparison = self.program.compare(condition.value1, condition.value2)
-        return comparison != 0 if condition.negate else comparison == 0
-
-    def c_greater(self, condition):
-        comparison = self.program.compare(condition.value1, condition.value2)
-        return comparison <= 0 if condition.negate else comparison > 0
-
-    def c_less(self, condition):
-        comparison = self.program.compare(condition.value1, condition.value2)
-        return comparison >= 0 if condition.negate else comparison < 0
-
     def c_starts(self, condition):
         value1 = self.getRuntimeValue(condition.value1)
         value2 = self.getRuntimeValue(condition.value2)
         return value1.startswith(value2)
 
-    def c_ends(self, condition):
-        value1 = self.getRuntimeValue(condition.value1)
-        value2 = self.getRuntimeValue(condition.value2)
-        return value1.endswith(value2)
-
-    def c_includes(self, condition):
-        value1 = self.getRuntimeValue(condition.value1)
-        value2 = self.getRuntimeValue(condition.value2)
-        return value2 in value1
-
-    def c_empty(self, condition):
-        value = self.getRuntimeValue(condition.value1)
-        if value == None:
-            comparison = True
-        else:
-            comparison = len(value) == 0
+    def c_string(self, condition):
+        comparison = type(self.getRuntimeValue(condition.value1)) is str
         return not comparison if condition.negate else comparison
-
-    def c_exists(self, condition):
-        path = self.getRuntimeValue(condition.path)
-        return os.path.exists(path)
-
-    def c_hasProperty(self, condition):
-        value = self.getRuntimeValue(condition.value1)
-        prop = self.getRuntimeValue(condition.property)
-        try:
-            value[prop]
-            hasProp = True
-        except:
-            hasProp = False
-        return hasProp
 # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

{easycoder-250102.1 → easycoder-250103.2}/json/graphics-demo.json

@@ -19,9 +19,9 @@
         "GreenCircle": {
             "type": "ellipse",
             "left": "10w",
-            "bottom": "10h",
+            "bottom": "40w",
             "width": "80w",
-            "height": "80h",
+            "height": "80w",
             "fill": "green",
             "id": "greencircle"
         }

{easycoder-250102.1 → easycoder-250103.2}/scripts/graphics-demo.ecg

@@ -6,7 +6,6 @@
     ellipse RedEllipse
     ellipse GreenCircle
     image Image
-    file File
     variable Spec
     variable UpDown
     variable Steps
@@ -26,9 +25,7 @@
     create window title `Learning Kivy` at 300 300 size 640 480 fill color 255 255 200
     run graphics
 
-    open File `json/graphics-demo.json`
-    read Spec from File
-    close File
+    load Spec from `json/graphics-demo.json`
     render Spec
 
     attach BlueRect to `bluerect`