easycoder 241231.1__py2.py3-none-any.whl → 250103.1__py2.py3-none-any.whl

easycoder/__init__.py

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

easycoder/ec_core.py

@@ -1,4 +1,4 @@
-import json, math, hashlib, threading, os, subprocess, sys, requests, time, numbers
+import json, math, hashlib, threading, os, subprocess, sys, requests, time, numbers, base64
 from psutil import Process
 from datetime import datetime, timezone
 from random import randrange
@@ -10,6 +10,7 @@ class Core(Handler):
 
     def __init__(self, compiler):
         Handler.__init__(self, compiler)
+        self.encoding = 'utf-8'
 
     def getName(self):
         return 'core'
@@ -464,23 +465,6 @@ class Core(Handler):
         self.program.putSymbolValue(target, retval);
         return self.nextPC()
 
-    # Call a subroutine
-    def k_gosub(self, command):
-        if self.peek() == 'to':
-            self.nextToken()
-        command['gosub'] = self.nextToken()
-        self.add(command)
-        return True
-
-    def r_gosub(self, command):
-        label = command['gosub'] + ':'
-        address = self.symbols[label]
-        if address != None:
-            self.stack.append(self.nextPC())
-            return address
-        RuntimeError(self.program, f'There is no label "{label + ":"}"')
-        return None
-
     # Go to a label
     def k_go(self, command):
         if self.peek() == 'to':
@@ -506,6 +490,23 @@ class Core(Handler):
     def r_gotoPC(self, command):
         return command['goto']
 
+    # Call a subroutine
+    def k_gosub(self, command):
+        if self.peek() == 'to':
+            self.nextToken()
+        command['gosub'] = self.nextToken()
+        self.add(command)
+        return True
+
+    def r_gosub(self, command):
+        label = command['gosub'] + ':'
+        address = self.symbols[label]
+        if address != None:
+            self.stack.append(self.nextPC())
+            return address
+        RuntimeError(self.program, f'There is no label "{label + ":"}"')
+        return None
+
     # if <condition> <action> [else <action>]
     def k_if(self, command):
         command['condition'] = self.nextCondition()
@@ -1032,25 +1033,32 @@ class Core(Handler):
                 command['target'] = target['name']
                 self.add(command)
                 return True
+            return False
 
         token = self.getToken()
         if token == 'the':
             token = self.nextToken()
+        command['type'] = token
+
         if token == 'elements':
             self.nextToken()
             if self.peek() == 'of':
                 self.nextToken()
             if self.nextIsSymbol():
-                command['type'] = 'elements'
                 command['name'] = self.getToken()
                 if self.peek() == 'to':
                     self.nextToken()
                 command['elements'] = self.nextValue()
                 self.add(command)
                 return True
+            
+        elif token == 'encoding':
+            if self.nextIs('to'):
+                command['encoding'] = self.nextValue()
+                self.add(command)
+                return True
 
-        if token == 'property':
-            command['type'] = 'property'
+        elif token == 'property':
             command['name'] = self.nextValue()
             if self.nextIs('of'):
                 if self.nextIsSymbol():
@@ -1060,8 +1068,7 @@ class Core(Handler):
                         self.add(command)
                         return True
 
-        if token == 'element':
-            command['type'] = 'element'
+        elif token == 'element':
             command['index'] = self.nextValue()
             if self.nextIs('of'):
                 if self.nextIsSymbol():
@@ -1070,7 +1077,6 @@ class Core(Handler):
                         command['value'] = self.nextValue()
                         self.add(command)
                         return True
-
         return False
 
     def r_set(self, command):
@@ -1083,7 +1089,7 @@ class Core(Handler):
             self.putSymbolValue(target, val)
             return self.nextPC()
 
-        if cmdType == 'elements':
+        elif cmdType == 'elements':
             symbolRecord = self.getVariable(command['name'])
             elements = self.getRuntimeValue(command['elements'])
             currentElements = symbolRecord['elements']
@@ -1102,7 +1108,7 @@ class Core(Handler):
             symbolRecord['value'] = newValue
             return self.nextPC()
 
-        if cmdType == 'element':
+        elif cmdType == 'element':
             value = self.getRuntimeValue(command['value'])
             index = self.getRuntimeValue(command['index'])
             target = self.getVariable(command['target'])
@@ -1117,7 +1123,11 @@ class Core(Handler):
             self.putSymbolValue(target, val)
             return self.nextPC()
 
-        if cmdType == 'property':
+        elif cmdType == 'encoding':
+            self.encoding = self.getRuntimeValue(command['encoding'])
+            return self.nextPC()
+
+        elif cmdType == 'property':
             value = self.getRuntimeValue(command['value'])
             name = self.getRuntimeValue(command['name'])
             target = command['target']
@@ -1469,10 +1479,10 @@ class Core(Handler):
                 return value
             return None
 
-        if token in ['now', 'today', 'newline', 'break', 'empty']:
+        if token in ['now', 'today', 'newline', 'tab', 'empty']:
             return value
 
-        if token in ['date', 'encode', 'decode', 'stringify', 'json', 'lowercase', 'uppercase', 'hash', 'random', 'float', 'integer']:
+        if token in ['stringify', 'json', 'lowercase', 'uppercase', 'hash', 'random', 'float', 'integer', 'encode', 'decode']:
             value['content'] = self.nextValue()
             return value
 
@@ -1555,7 +1565,9 @@ class Core(Handler):
         if token == 'index':
             if self.nextIs('of'):
                 if self.nextIsSymbol():
+                    value['variable'] = self.getSymbolRecord()['name']
                     if self.peek() == 'in':
+                        value['value'] = None
                         value['type'] = 'indexOf'
                         if self.nextIsSymbol():
                             value['target'] = self.getSymbolRecord()['name']
@@ -1564,8 +1576,9 @@ class Core(Handler):
                         value['name'] = self.getToken()
                         return value
                 else:
-                    value['value1'] = self.getValue()
+                    value['value'] = self.getValue()
                     if self.nextIs('in'):
+                        value['variable'] = None
                         value['type'] = 'indexOf'
                         if self.nextIsSymbol():
                             value['target'] = self.getSymbolRecord()['name']
@@ -1631,7 +1644,8 @@ class Core(Handler):
             return value
 
         if token == 'files':
-            if self.nextIs('of'):
+            token = self.nextToken()
+            if token in ['in', 'of']:
                 value['target'] = self.nextValue()
                 return value
             return None
@@ -1716,6 +1730,14 @@ class Core(Handler):
         value['content'] = round(math.cos(angle * 0.01745329) * radius)
         return value
 
+    def v_count(self, v):
+        variable = self.getVariable(v['name'])
+        content = variable['value'][variable['index']]['content']
+        value = {}
+        value['type'] = 'int'
+        value['content'] = len(content)
+        return value
+
     def v_datime(self, v):
         ts = self.getRuntimeValue(v['timestamp'])
         fmt = v['format']
@@ -1729,9 +1751,17 @@ class Core(Handler):
         return value
 
     def v_decode(self, v):
+        content = self.getRuntimeValue(v['content'])
         value = {}
         value['type'] = 'text'
-        value['content'] = self.program.decode(v['content'])
+        if self.encoding == 'utf-8':
+            value['content'] = content.decode('utf-8')
+        elif self.encoding == 'base64':
+            base64_bytes = content.encode('ascii')
+            message_bytes = base64.b64decode(base64_bytes)
+            value['content'] = message_bytes.decode('ascii')
+        else:
+            value = v
         return value
 
     def v_element(self, v):
@@ -1754,18 +1784,9 @@ class Core(Handler):
         var = self.getVariable(v['name'])
         value = {}
         value['type'] = 'int'
-        # value['content'] = self.getVariable(v['name'])['elements']
         value['content'] = var['elements']
         return value
 
-    def v_count(self, v):
-        variable = self.getVariable(v['name'])
-        content = variable['value'][variable['index']]['content']
-        value = {}
-        value['type'] = 'int'
-        value['content'] = len(content)
-        return value
-
     def v_empty(self, v):
         value = {}
         value['type'] = 'text'
@@ -1773,9 +1794,17 @@ class Core(Handler):
         return value
 
     def v_encode(self, v):
+        content = self.getRuntimeValue(v['content'])
         value = {}
         value['type'] = 'text'
-        value['content'] = self.program.encode(v['content'])
+        if self.encoding == 'utf-8':
+            value['content'] = content.encode('utf-8')
+        elif self.encoding == 'base64':
+            data_bytes = content.encode('ascii')
+            base64_bytes = base64.b64encode(data_bytes)
+            value['content'] = base64_bytes.decode('ascii')
+        else:
+            value = v
         return value
 
     def v_error(self, v):
@@ -1789,21 +1818,22 @@ class Core(Handler):
             value['content'] = errorReason
         return value
 
-    def v_stringify(self, v):
-        item = self.getRuntimeValue(v['content'])
+    def v_files(self, v):
+        v = self.getRuntimeValue(v['target'])
         value = {}
         value['type'] = 'text'
-        value['content'] = json.dumps(item)
+        value['content'] = os.listdir(v)
         return value
 
-    def v_json(self, v):
-        item = self.getRuntimeValue(v['content'])
+    def v_float(self, v):
+        val = self.getRuntimeValue(v['content'])
         value = {}
-        value['type'] = 'object'
+        value['type'] = 'float'
         try:
-            value['content'] = json.loads(item)
+            value['content'] = float(val)
         except:
-            RuntimeError(self.program, 'Cannot encode value')
+            RuntimeWarning(self.program, f'Value cannot be parsed as floating-point')
+            value['content'] = 0.0
         return value
 
     def v_from(self, v):
@@ -1827,17 +1857,6 @@ class Core(Handler):
         value['content'] = hashlib.sha256(hashval.encode('utf-8')).hexdigest()
         return value
 
-    def v_float(self, v):
-        val = self.getRuntimeValue(v['content'])
-        value = {}
-        value['type'] = 'float'
-        try:
-            value['content'] = float(val)
-        except:
-            RuntimeWarning(self.program, f'Value cannot be parsed as floating-point')
-            value['content'] = 0.0
-        return value
-
     def v_index(self, v):
         value = {}
         value['type'] = 'int'
@@ -1845,16 +1864,22 @@ class Core(Handler):
         return value
 
     def v_indexOf(self, v):
-        value1 = v['value1']
+        value = v['value']
+        if value == None:
+            value = self.getSymbolValue(v['variable'])['content']
+        else:
+            value = self.getRuntimeValue(value)
         target = self.getVariable(v['target'])
-        try:
-            index = target['value'].index(value1)
-        except:
-            index = -1
-        value = {}
-        value['type'] = 'int'
-        value['content'] = index
-        return value
+        data = self.getSymbolValue(target)['content']
+        index = -1
+        for n in range(0, len(data)):
+            if data[n] == value:
+                index = n
+                break
+        retval = {}
+        retval['type'] = 'int'
+        retval['content'] = index
+        return retval
 
     def v_integer(self, v):
         val = self.getRuntimeValue(v['content'])
@@ -1863,6 +1888,16 @@ class Core(Handler):
         value['content'] = int(val)
         return value
 
+    def v_json(self, v):
+        item = self.getRuntimeValue(v['content'])
+        value = {}
+        value['type'] = 'object'
+        try:
+            value['content'] = json.loads(item)
+        except:
+            RuntimeError(self.program, 'Cannot encode value')
+        return value
+
     def v_keys(self, v):
         value = {}
         value['type'] = 'int'
@@ -1893,18 +1928,20 @@ class Core(Handler):
         value['content'] = content.lower()
         return value
 
-    def v_uppercase(self, v):
-        content = self.getRuntimeValue(v['content'])
+    def v_memory(self, v):
+        process: Process = Process(os.getpid())
+        megabytes: float = process.memory_info().rss / (1024 * 1024)
         value = {}
-        value['type'] = 'text'
-        value['content'] = content.upper()
+        value['type'] = 'float'
+        value['content'] = megabytes
         return value
 
-    def v_random(self, v):
-        limit = self.getRuntimeValue(v['content'])
+    def v_modification(self, v):
+        fileName = self.getRuntimeValue(v['fileName'])
+        ts = int(os.stat(fileName).st_mtime)
         value = {}
         value['type'] = 'int'
-        value['content'] = randrange(0, limit)
+        value['content'] = ts
         return value
 
     def v_modulo(self, v):
@@ -1954,6 +1991,13 @@ class Core(Handler):
             value['type'] = 'text'
         return value
 
+    def v_random(self, v):
+        limit = self.getRuntimeValue(v['content'])
+        value = {}
+        value['type'] = 'int'
+        value['content'] = randrange(0, limit)
+        return value
+
     def v_right(self, v):
         content = self.getRuntimeValue(v['content'])
         count = self.getRuntimeValue(v['count'])
@@ -1970,32 +2014,11 @@ class Core(Handler):
         value['content'] = round(math.sin(angle * 0.01745329) * radius)
         return value
 
-    def v_tan(self, v):
-        angle = self.getRuntimeValue(v['angle'])
-        radius = self.getRuntimeValue(v['radius'])
-        value = {}
-        value['type'] = 'int'
-        value['content'] = round(math.tan(angle * 0.01745329) * radius)
-        return value
-
-    def v_timestamp(self, v):
-        value = {}
-        value['type'] = 'int'
-        fmt = v['format']
-        if fmt == None:
-            value['content'] = int(time.time())
-        else:
-            fmt = self.getRuntimeValue(fmt)
-            dt = self.getRuntimeValue(v['datime'])
-            spec = datetime.strptime(dt, fmt)
-            t = datetime.now().replace(hour=spec.hour, minute=spec.minute, second=spec.second, microsecond=0)
-            value['content'] = int(t.timestamp())
-        return value
-
-    def v_today(self, v):
+    def v_stringify(self, v):
+        item = self.getRuntimeValue(v['content'])
         value = {}
-        value['type'] = 'int'
-        value['content'] = int(datetime.combine(datetime.now().date(),datetime.min.time()).timestamp())*1000
+        value['type'] = 'text'
+        value['content'] = json.dumps(item)
         return value
 
     def v_symbol(self, symbolRecord):
@@ -2014,39 +2037,45 @@ class Core(Handler):
         else:
             return None
 
-    def v_valueOf(self, v):
-        v = self.getRuntimeValue(v['content'])
+    def v_tab(self, v):
         value = {}
-        value['type'] = 'int'
-        value['content'] = int(v)
+        value['type'] = 'text'
+        value['content'] = '\t'
         return value
 
-    def v_files(self, v):
-        v = self.getRuntimeValue(v['target'])
+    def v_tan(self, v):
+        angle = self.getRuntimeValue(v['angle'])
+        radius = self.getRuntimeValue(v['radius'])
         value = {}
-        value['type'] = 'text'
-        value['content'] = os.listdir(v)
+        value['type'] = 'int'
+        value['content'] = round(math.tan(angle * 0.01745329) * radius)
         return value
 
-    def v_trim(self, v):
-        v = self.getRuntimeValue(v['content'])
+    def v_timestamp(self, v):
         value = {}
-        value['type'] = 'text'
-        value['content'] = v.strip()
+        value['type'] = 'int'
+        fmt = v['format']
+        if fmt == None:
+            value['content'] = int(time.time())
+        else:
+            fmt = self.getRuntimeValue(fmt)
+            dt = self.getRuntimeValue(v['datime'])
+            spec = datetime.strptime(dt, fmt)
+            t = datetime.now().replace(hour=spec.hour, minute=spec.minute, second=spec.second, microsecond=0)
+            value['content'] = int(t.timestamp())
         return value
 
-    def v_weekday(self, v):
+    def v_today(self, v):
         value = {}
         value['type'] = 'int'
-        value['content'] = datetime.today().weekday()
+        value['content'] = int(datetime.combine(datetime.now().date(),datetime.min.time()).timestamp())*1000
         return value
 
-    def v_memory(self, v):
-        process: Process = Process(os.getpid())
-        megabytes: float = process.memory_info().rss / (1024 * 1024)
+    def v_trim(self, v):
+        v = self.getRuntimeValue(v['content'])
         value = {}
-        value['type'] = 'float'
-        value['content'] = megabytes
+        value['type'] = 'text'
+        value['content'] = v.strip()
         return value
 
     def v_type(self, v):
@@ -2067,12 +2096,24 @@ class Core(Handler):
             value['content'] = 'object'
         return value
 
-    def v_modification(self, v):
-        fileName = self.getRuntimeValue(v['fileName'])
-        ts = int(os.stat(fileName).st_mtime)
+    def v_uppercase(self, v):
+        content = self.getRuntimeValue(v['content'])
+        value = {}
+        value['type'] = 'text'
+        value['content'] = content.upper()
+        return value
+
+    def v_valueOf(self, v):
+        v = self.getRuntimeValue(v['content'])
         value = {}
         value['type'] = 'int'
-        value['content'] = ts
+        value['content'] = int(v)
+        return value
+
+    def v_weekday(self, v):
+        value = {}
+        value['type'] = 'int'
+        value['content'] = datetime.today().weekday()
         return value
 
     #############################################################################
@@ -2170,20 +2211,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):
@@ -2193,58 +2273,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/ec_program.py

@@ -192,11 +192,11 @@ class Program:
 				index = 0
 			symbolRecord['value'][index] = value
 
-	def encode(self, value):
-		return value
+	def encode(self, value, encoding='UTF-8'):
+		return value.encode(encoding)
 
-	def decode(self, value):
-		return value
+	def decode(self, value, encoding='UTF-8'):
+		return value.decode(encoding)
 
 	# Tokenise the script
 	def tokenise(self, script):

{easycoder-241231.1.dist-info → easycoder-250103.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: easycoder
-Version: 241231.1
+Version: 250103.1
 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>
@@ -10,7 +10,7 @@ Requires-Dist: pytz
 Project-URL: Home, https://github.com/easycoder/easycoder-py
 
 # Introduction
-This is the Python version of **_EasyCoder_**, a high-level English-like scripting language suited for prototyping and rapid testing of ideas. It operates on the command line.
+**_EasyCoder_** is a high-level English-like scripting language suited for prototyping and rapid testing of ideas. It operates on the command line and a graphics module is under construction. This version of the language is written in Python and its runtime acts as a fairly thin wrapper around Python functions, giving good performance for general applications.
 
 The JavaScript version of **_EasyCoder_**, which provides a full set of graphical features to run in a browser, is at
 
@@ -31,7 +31,7 @@ This is traditionally the first program to be written in virtually any language.
 The output will look like this:
 
 ```
-EasyCoder version 5
+EasyCoder version 250101.1
 Compiled <anon>: 1 lines (2 tokens) in 0 ms
 Run <anon>
 1-> Hello, world!
@@ -43,28 +43,28 @@ It's conventional to add a program title to a script:
     script Test
     print `Hello, world!`
 ```
-The first line here is just a comment and has no effect on the running of the script. The second line gives the script a name, which is useful in debugging as it says which script was running. When run, the output is now
+The first line here is just a comment and has no effect on the running of the script.   The second line gives the script a name, which is useful in debugging as it says which script was running. When run, the output is now
 
 ```
-EasyCoder version 5
-Compiled Test: 5 lines (4 tokens) in 0 ms
+EasyCoder version 250101.1
+Compiled Test: 3 lines (4 tokens) in 0 ms
 Run Test
-5-> Hello, world!
+3-> Hello, world!
 ```
-As you can guess from the above, the print command gives the line in the script it was called from. This is very useful in tracking down debugging print commands in large scripts.
+As you might guess from the above, the print command shows the line in the script it was called from. This is very useful in tracking down debugging print commands in large scripts.
 
 Here in the repository is a folder called `scripts` containing some sample scripts:
 
-`benchmark.ecs` allows the performance of EasyCoder to be compared to other languages if a similar program is written for each one  
-`tests.ecs` is a test program containing many of the EasyCoder features  
-`fizzbuzz.ecs` is a simple programming challenge often given at job interviews
+`fizzbuzz.ecs` is a simple programming challenge often given at job interviews  
+`tests.ecs` is a test program containing many of the **_EasyCoder_** features  
+`benchmark.ecs` allows the performance of **_EasyCoder_** to be compared to other languages if a similar script is written for each one.
 
 ## Graphical programmming
-**_EasyCoder_** includes a graphical programming environment that is in the early stages of development. A couple of demo scripts are included in the `scripts` directory. To run them, first install the Python `kivy` graphics library if it's not already present on your system. This is done with `pip install kivy`. Then run a script using `easycoder {scriptname}.ecg`.
+**_EasyCoder_** includes a graphical programming environment that is in the early stages of development. A couple of demo scripts are included in the `scripts` directory. To run them, first install the Python `kivy` graphics library if it's not already present on your system. This is done with `pip install kivy`. Then run your **_EasyCoder_** script using `easycoder {scriptname}.ecg`.
 
-Graphical scripts look much like any other script but their file names must use the extension `.ecg` to signal to **_EasyCoder_** that it needs to load the graphics module. This allows the **_EasyCoder_** application to be used wherever Python is installed, in either a command-line or a graphical environment (but graphics will of course not be available in the former).
+Graphical scripts look much like any other script but their file names must use the extension `.ecg` to signal to **_EasyCoder_** that it needs to load the graphics module. Non-graphical applications can use any extension but `.ecs` is recommended. This allows the **_EasyCoder_** application to be used wherever Python is installed, in either a command-line or a graphical environment, but graphics will of course not be available in the former.
 
-A couple of demo scripts are included in the `scripts` directory:
+A couple of demo graphical scripts are included in the `scripts` directory:
 
 `graphics-demo.ecg` shows some of the elements that can be created, and demonstrates a variety of the graphical features of the language such as detecting when elements are clicked.
 
@@ -72,11 +72,9 @@ A couple of demo scripts are included in the `scripts` directory:
 
 **_EasyCoder_** graphics are handled by a library module, `ec_renderer` that can be used outside of the **_EasyCoder_** environment, in other Python programs.
 
-## EasyCoder programming reference
+## Programming reference
 
-The language comprises a general-purpose core package, which can be enhanced by plugins to provide special features on demand.
-
-[The core package](doc/README.md)
+**_EasyCoder_** comprises a set of modules to handle tokenisation, compilation and runtime control. Syntax and grammar are defined by [packages](doc/README.md), of which there are currently two; the [core](doc/core/README.md) package, which implements a comprehensive set of command-line programming features, and and the [graphics](doc/graphics/README.md) package, which adds graphical features in a windowing environment.
 
 ## Extending the language
 

{easycoder-241231.1.dist-info → easycoder-250103.1.dist-info}/RECORD

@@ -1,19 +1,19 @@
 easycoder/README.md,sha256=PYqOc_SkIGiFbyCNs90y7JqoqWe4aO1xYIW-6bOnFKU,573
-easycoder/__init__.py,sha256=WpuFq9C1_LWCjt7667A94jo8QMavAs_jT2qZluZgT2E,283
+easycoder/__init__.py,sha256=5hieaJUWovLn09r1Tf2I2hBLjfYGXMKuBb6usyd9sYc,283
 easycoder/ec.py,sha256=Nj5PRl8GsKjfGJKq0FOM1a7FeK3cN68CoIFg8lswQEg,221
 easycoder/ec_classes.py,sha256=xnWBNak8oKydkFoxHLlq9wo3lIsB3aMnTDrqbtCfoWo,1512
 easycoder/ec_compiler.py,sha256=2r6Nk7px9UMYqIpYc6dAbYOAFu-CoWPy-iqlsed49Lo,4690
 easycoder/ec_condition.py,sha256=WSbONo4zs2sX1icOVpscZDFSCAEFmTsquoc2RGcLx_k,763
-easycoder/ec_core.py,sha256=HtJWpfwz1eon0o4ZFYVM42ECAD6sKT8izvHYIb7dnv8,77463
+easycoder/ec_core.py,sha256=1rYUGd5EXpjJkfYnnvJNjvMD_JfTGZRMEV0lLbYrzAU,78939
 easycoder/ec_graphics.py,sha256=o70BdQ-Y3uIo5nheQYwJUmM3gYVerKD9_5arQ8JTP-Y,15556
 easycoder/ec_handler.py,sha256=IJvxcrJJSR53d6DS_8H5qPHKhp9y5-GV4WXAjhZxu_o,2250
-easycoder/ec_program.py,sha256=6jK4blJMcRbspUEh-AW5MUVuLtLP023sZAbbgvPad-Y,8615
+easycoder/ec_program.py,sha256=TUKQo56vURtx_UO7avIJZhz0EeOe2lNxQQz8EOOnCZ4,8685
 easycoder/ec_renderer.py,sha256=ejVFemHGuFBwGA__6VfZQZeZMnw4Ilvf_y9I34k04LM,7981
 easycoder/ec_screenspec.py,sha256=TeXgccfYoE--r7Rf9t9drV1V3fU-p-iBnZwtjHzIh8M,2524
 easycoder/ec_timestamp.py,sha256=_3QFJPzIWZ9Rzk3SQOQJ-gwmvB07pg78k23SPntoZtY,288
 easycoder/ec_value.py,sha256=XIBtGhcCgh1abrzAn-Wy4l_xH_3cTWakMVIiSlBAZjM,2386
-easycoder-241231.1.dist-info/entry_points.txt,sha256=JXAZbenl0TnsIft2FcGJbJ-4qoztVu2FuT8PFmWFexM,44
-easycoder-241231.1.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-easycoder-241231.1.dist-info/WHEEL,sha256=ssQ84EZ5gH1pCOujd3iW7HClo_O_aDaClUbX4B8bjKY,100
-easycoder-241231.1.dist-info/METADATA,sha256=MhsFB-Ftja3Q0DFD-IomqX4Sntipma64e6WIUXyfXdQ,4605
-easycoder-241231.1.dist-info/RECORD,,
+easycoder-250103.1.dist-info/entry_points.txt,sha256=JXAZbenl0TnsIft2FcGJbJ-4qoztVu2FuT8PFmWFexM,44
+easycoder-250103.1.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+easycoder-250103.1.dist-info/WHEEL,sha256=ssQ84EZ5gH1pCOujd3iW7HClo_O_aDaClUbX4B8bjKY,100
+easycoder-250103.1.dist-info/METADATA,sha256=6X8NoMG3Px2cLNDqWYxoMfki71O06qYk8qILNM_49VI,5178
+easycoder-250103.1.dist-info/RECORD,,