easycoder 250123.2__tar.gz → 250204.1__tar.gz

{easycoder-250123.2 → easycoder-250204.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: easycoder
-Version: 250123.2
+Version: 250204.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>

{easycoder-250123.2 → easycoder-250204.1}/doc/core/keywords/lock.md

@@ -9,7 +9,7 @@
 ## Description:
 Locks a variable to prevent it being modified. See also [unlock](unlock.md).
 
-Next: [lock](lock.md)  
-Prev: [init](init.md)
+Next: [log](log.md)
+Prev: [load](load.md)
 
 [Back](../../README.md)

easycoder-250204.1/doc/core/keywords/log.md

@@ -0,0 +1,21 @@
+# log
+
+## Syntax:
+`log {message}`
+
+## Examples:
+``log `ProcessResponses` ``
+
+## Description:
+Prints a log message to the console.
+
+The output is prefixed by the current time and the script line number of the print command. This is very useful in large scripts when trying to find a log command that is outputting some unwanted messages. For example, the above example produces the output
+
+`14:46:59.048918: 1056-> ProcessResponses`
+
+See also [print](print.md).
+
+Next: [module](module.md)
+Prev: [lock](lock.md)
+
+[Back](../../README.md)

{easycoder-250123.2 → easycoder-250204.1}/doc/core/keywords/module.md

@@ -12,6 +12,6 @@ Declare a module variable, which enables you to run another script as a child of
 Module variables can be assigned any number of elements - see [set the elements](set.md).
 
 Next: [multiply](multiply.md)  
-Prev: [lock](lock.md)
+Prev: [log](log.md)
 
 [Back](../../README.md)

{easycoder-250123.2 → easycoder-250204.1}/doc/core/keywords/print.md

@@ -7,8 +7,7 @@
 `print Data cat newline`
 
 ## Description:
-Print something to the terminal. The second example shows the use of string catenation, which is also covered in [values](../core.md).  
-The output is prefixed by the script line number of the print command. This is very useful in large scripts when trying to figure where print output is coming from.
+Print something to the terminal. The second example shows the use of string catenation, which is also covered in [values](../core.md). See also [log](log.md)
 
 Next: [push](push.md)  
 Prev: [post](post.md)

{easycoder-250123.2 → easycoder-250204.1}/doc/graphics/README.md

@@ -1,5 +1,7 @@
 # The 'graphics' package
 
+**Documentation yet to be written**
+
 The graphics package contains keywords values and conditionals needed for programming graphical applications.
 
 There are three primary components to the language:
@@ -10,11 +12,11 @@ There are three primary components to the language:
 
 The core keywords are:
 
-[attach](attach.md) [close](close.md) [create](create.md) [ellipse](ellipse.md) [image](image.md) [move](move.md) [on](on.md) [rectangle](rectangle.md) [render](render.md) [run](run.md) [set](set.md) [text](text.md)
+
 
 The core values are:
 
-[attribute](attribute.md) [window](window.md) 
+
 
 The core conditions are:
 

{easycoder-250123.2 → easycoder-250204.1}/easycoder/__init__.py

@@ -9,4 +9,4 @@ from .ec_program import *
 from .ec_timestamp import *
 from .ec_value import *
 
-__version__ = "250123.2"
+__version__ = "250204.1"

{easycoder-250123.2 → easycoder-250204.1}/easycoder/ec_core.py

@@ -1,4 +1,4 @@
-import json, math, hashlib, threading, os, subprocess, sys, requests, time, numbers, base64
+import json, math, hashlib, threading, os, subprocess, sys, requests, time, numbers, base64, binascii
 from psutil import Process
 from datetime import datetime, timezone
 from random import randrange
@@ -484,7 +484,6 @@ class Core(Handler):
         except:
             pass
         RuntimeError(self.program, f'There is no label "{label}"')
-        return None
 
     def r_gotoPC(self, command):
         return command['goto']
@@ -499,12 +498,14 @@ class Core(Handler):
 
     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
+        try:
+            address = self.symbols[label]
+            if address != None:
+                self.stack.append(self.nextPC())
+                return address
+        except:
+            pass
+        RuntimeError(self.program, f'There is no label "{label}"')
 
     # if <condition> <action> [else <action>]
     def k_if(self, command):
@@ -1002,9 +1003,9 @@ class Core(Handler):
         program = command['program']
         code = program.code[program.pc]
         lino = str(code['lino'] + 1)
-        while len(lino) < 4: lino = f' {lino}'
+        while len(lino) < 5: lino = f' {lino}'
         if value == None: value = '<empty>'
-        if 'log' in command: print(f'{datetime.now().time()}: {lino}-> {value}')
+        if 'log' in command: print(f'{datetime.now().time()}:{lino}-> {value}')
         else: print(value)
         return self.nextPC()
 
@@ -1988,6 +1989,10 @@ class Core(Handler):
         value['type'] = 'text'
         if self.encoding == 'utf-8':
             value['content'] = content.decode('utf-8')
+        elif self.encoding == 'hex':
+            b = content.encode('utf-8')
+            mb = binascii.unhexlify(b)
+            value['content'] = mb.decode('utf-8')
         elif self.encoding == 'base64':
             base64_bytes = content.encode('ascii')
             message_bytes = base64.b64decode(base64_bytes)
@@ -2031,6 +2036,10 @@ class Core(Handler):
         value['type'] = 'text'
         if self.encoding == 'utf-8':
             value['content'] = content.encode('utf-8')
+        elif self.encoding == 'hex':
+            b = content.encode('utf-8')
+            mb = binascii.hexlify(b)
+            value['content'] = mb.decode('utf-8')
         elif self.encoding == 'base64':
             data_bytes = content.encode('ascii')
             base64_bytes = base64.b64encode(data_bytes)

{easycoder-250123.2 → easycoder-250204.1}/easycoder/ec_graphics.py

@@ -1,8 +1,8 @@
-from .ec_classes import FatalError, RuntimeError, Object
-from .ec_handler import Handler
+from .ec_classes import FatalError, RuntimeError, Handler
 from .ec_gutils import GUtils
 import PySimpleGUI as psg
 import json
+from copy import deepcopy
 
 class Graphics(Handler):
 
@@ -61,28 +61,13 @@ class Graphics(Handler):
                     args = self.utils.decode(self, default, layout[n])
                 except Exception as e:
                     RuntimeError(self.program, e)
-            item = self.utils.createElement(type, param, args)
+            item = self.utils.createWidget(type, param, args)
             target['layout'].append(item)
         else:
             v = self.getVariable(args)
             target['layout'].append(v['layout'])
         return self.nextPC()
 
-    def k_capture(self, command):
-        if self.nextIs('event'):
-            if self.nextIs('as'):
-                if self.nextIsSymbol():
-                    record = self.getSymbolRecord()
-                    command['target'] = record['name']
-                    self.addCommand(command)
-                    return True
-        return False
-
-    def r_capture(self, command):
-        target = self.getVariable(command['target'])
-        self.putSymbolValue(target, self.getConstant(self.eventValues))
-        return self.nextPC()
-
     def k_close(self, command):
         if self.nextIsSymbol():
             symbolRecord = self.getSymbolRecord()
@@ -126,15 +111,14 @@ class Graphics(Handler):
         type = command['type']
         record = self.getVariable(command['name'])
         if type == 'window':
-            layout = self.getVariable(command['layout'])
             title = self.getRuntimeValue(command['title'])
-            window = psg.Window(title, layout['layout'], finalize=True)
+            layout = self.getVariable(command['layout'])['layout']
+            window = psg.Window(title, layout, finalize=True)
             record['window'] = window
             record['eventHandlers'] = {}
             self.program.windowRecord = record
             self.program.run(self.nextPC())
             self.mainLoop()
-            # self.program.kill()
             return 0
         else:
             RuntimeError(self.program, 'Variable is not a window or an element')
@@ -206,176 +190,7 @@ class Graphics(Handler):
         psg.popup(self.getRuntimeValue(command['message']))
         return self.nextPC()
 
-    # set property {property} of {key} in {window} to {value}
-    def k_set(self, command):
-        if self.nextIs('property'):
-            command['property'] = self.nextValue()
-            if self.nextIs('of'):
-                command['key'] = self.nextValue()
-                if self.nextIs('in'):
-                    if self.nextIsSymbol():
-                        record = self.getSymbolRecord()
-                        if record['keyword'] == 'window':
-                            name = record['name']
-                            command['window'] = name
-                            if self.nextIs('to'):
-                                command['value'] = self.nextValue()
-                                self.add(command)
-                            return True
-                        else: RuntimeError(self.program, f'\'{name}\' is not a window variable')
-                    else: RuntimeError(self.program, 'No window variable given')
-        return False
-
-    def r_set(self, command):
-        property = self.getRuntimeValue(command['property'])
-        key = self.getRuntimeValue(command['key'])
-        window = self.program.windowRecord['window']
-        value = self.getRuntimeValue(command['value'])
-        self.utils.updateProperty(window[key], property, value)
-        return self.nextPC()
-
-    def k_window(self, command):
-        return self.compileVariable(command)
-
-    def r_window(self, command):
-        return self.nextPC()
-
-    #############################################################################
-    # Compile a value in this domain
-    def compileValue(self):
-        value = {}
-        value['domain'] = self.getName()
-        token = self.getToken()
-        if self.isSymbol():
-            value['name'] = token
-            symbolRecord = self.getSymbolRecord()
-            keyword = symbolRecord['keyword']
-            if keyword == 'event':
-                value['type'] = 'symbol'
-                return value
-            return None
-
-        if self.getToken() == 'the':
-            self.nextToken()
-
-        token = self.getToken()
-        value['type'] = token
-
-        if token == 'event':
-           return value
-
-        return None
-
-    #############################################################################
-    # Modify a value or leave it unchanged.
-    def modifyValue(self, value):
-        return value
-
-    #############################################################################
-    # Value handlers
-
-    # This is used by the expression evaluator to get the value of a symbol
-    def v_symbol(self, symbolRecord):
-        if symbolRecord['keyword'] == 'event':
-            return self.getSymbolValue(symbolRecord)
-        else:
-            return None
-
-    def v_event(self, v):
-        v['type'] = 'text'
-        v['content'] = self.eventValues
-        return v
-
-    #############################################################################
-    # Compile a condition
-    def compileCondition(self):
-        condition = {}
-        return condition
-
-    #############################################################################
-    # Condition handlers
-
-    #############################################################################
-    # The main loop
-    def mainLoop(self):
-        windowRecord = self.program.windowRecord
-        window = windowRecord['window']
-        eventHandlers = windowRecord['eventHandlers']
-        while True:
-            event, values = window.Read(timeout=100)
-            if event == psg.WIN_CLOSED or event == "EXIT":
-                del window
-                break
-            if event == '__TIMEOUT__': self.program.flushCB()
-            else:
-                if event in eventHandlers:
-                    self.eventValues = values
-                    eventHandlers[event]()
-class Graphics(Handler):
-
-    def __init__(self, compiler):
-        Handler.__init__(self, compiler)
-        self.utils = GUtils()
-
-    def getName(self):
-        return 'graphics'
-
-    #############################################################################
-    # Keyword handlers
-
-    def k_add(self, command):
-        token = self.nextToken()
-        if self.isSymbol():
-            symbolRecord = self.getSymbolRecord()
-            name = symbolRecord['name']
-            keyword = symbolRecord['keyword']
-            if keyword == 'layout':
-                command['args'] = name
-            elif keyword in ['column', 'frame', 'tab']:
-                command['name'] = name
-                command['type'] = token
-                if self.peek() == 'to':
-                    command['args'] = []
-                else:
-                    command['args'] = self.utils.getArgs(self)
-        else:
-            command['type'] = token
-            command['args'] = self.utils.getArgs(self)
-        if self.nextIs('to'):
-            if self.nextIsSymbol():
-                symbolRecord = self.getSymbolRecord()
-                if symbolRecord['keyword'] in ['column', 'frame', 'layout', 'tab']:
-                    command['target'] = symbolRecord['name']
-                    self.addCommand(command)
-                    return True
-        return False
-
-    def r_add(self, command):
-        target = self.getVariable(command['target'])
-        type = command['type']
-        args = command['args']
-        param= None
-        if not 'layout' in target:
-            target['layout'] = []
-        if args[0] == '{':
-            if type in ['Column', 'Frame', 'Tab']:
-                record = self.getVariable(command['name'])
-                param = record['layout']
-            layout = json.loads(self.getRuntimeValue(json.loads(args)))
-            default = self.utils.getDefaultArgs(type)
-            for n in range(0, len(layout)):
-                try:
-                    args = self.utils.decode(self, default, layout[n])
-                except Exception as e:
-                    RuntimeError(self.program, e)
-            item = self.utils.createElement(type, param, args)
-            target['layout'].append(item)
-        else:
-            v = self.getVariable(args)
-            target['layout'].append(v['layout'])
-        return self.nextPC()
-
-    def k_close(self, command):
+    def k_refresh(self, command):
         if self.nextIsSymbol():
             symbolRecord = self.getSymbolRecord()
             if symbolRecord['keyword'] == 'window':
@@ -384,121 +199,9 @@ class Graphics(Handler):
                 return True
         return False
 
-    def r_close(self, command):
-        target = self.getVariable(command['target'])
-        target['window'].close()
-        return self.nextPC()
-
-    def k_column(self, command):
-        return self.compileVariable(command)
-
-    def r_column(self, command):
-        return self.nextPC()
-
-    # create {window} layout {layout}
-    # create {element} {args...}
-    def k_create(self, command):
-        if self.nextIsSymbol():
-            symbolRecord = self.getSymbolRecord()
-            type = symbolRecord['keyword']
-            command['type'] = type
-            command['name'] = symbolRecord['name']
-            if type == 'window':
-                command['title'] = self.nextValue()
-                if self.nextIs('layout'):
-                    if self.nextIsSymbol():
-                        symbolRecord = self.getSymbolRecord()
-                        if symbolRecord['keyword'] == 'layout':
-                            command['layout'] = symbolRecord['name']
-                            self.addCommand(command)
-                            return True
-        return False
-
-    def r_create(self, command):
-        type = command['type']
-        record = self.getVariable(command['name'])
-        if type == 'window':
-            title = self.getRuntimeValue(command['title'])
-            layout = self.getVariable(command['layout'])['layout']
-            # keys = {}
-            # self.utils.tagKeys(keys, layout)
-            window = psg.Window(title, layout, finalize=True)
-            # window.keys = keys
-            record['window'] = window
-            record['eventHandlers'] = {}
-            self.program.windowRecord = record
-            self.program.run(self.nextPC())
-            self.mainLoop()
-            # self.program.kill()
-            return 0
-        else:
-            RuntimeError(self.program, 'Variable is not a window or an element')
-
-    def k_init(self, command):
-        if self.nextIsSymbol():
-            symbolRecord = self.getSymbolRecord()
-            if symbolRecord['keyword'] in ['column', 'frame', 'layout', 'tab']:
-                command['target'] = symbolRecord['name']
-                self.add(command)
-                return True
-        return False
-
-    def r_init(self, command):
+    def r_refresh(self, command):
         target = self.getVariable(command['target'])
-        target['layout'] = []
-        return self.nextPC()
-
-    def k_layout(self, command):
-        return self.compileVariable(command)
-
-    def r_layout(self, command):
-        return self.nextPC()
-
-    def k_on(self, command):
-        token = self.nextToken()
-        if token == 'event':
-            command['key'] = self.nextValue()
-            if self.nextIs('in'):
-                if self.nextIsSymbol():
-                    record = self.getSymbolRecord()
-                    if record['keyword'] == 'window':
-                        command['window'] = record['name']
-                        command['goto'] = self.getPC() + 2
-                        self.add(command)
-                        self.nextToken()
-                        pcNext = self.getPC()
-                        cmd = {}
-                        cmd['domain'] = 'core'
-                        cmd['lino'] = command['lino']
-                        cmd['keyword'] = 'gotoPC'
-                        cmd['goto'] = 0
-                        cmd['debug'] = False
-                        self.addCommand(cmd)
-                        self.compileOne()
-                        cmd = {}
-                        cmd['domain'] = 'core'
-                        cmd['lino'] = command['lino']
-                        cmd['keyword'] = 'stop'
-                        cmd['debug'] = False
-                        self.addCommand(cmd)
-                        # Fixup the link
-                        self.getCommandAt(pcNext)['goto'] = self.getPC()
-                        return True
-        return False
-
-    def r_on(self, command):
-        key = self.getRuntimeValue(command['key'])
-        window = self.getVariable(command['window'])
-        window['eventHandlers'][key] = lambda: self.run(command['goto'])
-        return self.nextPC()
-
-    def k_popup(self, command):
-        command['message'] = self.nextValue()
-        self.addCommand(command)
-        return True
-
-    def r_popup(self, command):
-        psg.popup(self.getRuntimeValue(command['message']))
+        target['window'].refresh()
         return self.nextPC()
 
     # set property {property} of {key} in {window} to {value}
@@ -560,21 +263,24 @@ class Graphics(Handler):
            return value
 
         if token == 'property':
-            value['key'] = self.nextValue()
+            value['property'] = self.nextValue()
             if self.nextIs('of'):
                 if self.nextToken() == 'the':
                     if self.nextIs('event'):
-                        value['source'] = '_event_'
                         return value
-                else:
-                    value['key'] = self.getValue()
+            return None
+
+        if token == 'value':
+            if self.nextIs('of'):
+                if self.nextIs('key'):
+                    value['key'] = self.nextValue()
                     if self.nextIs('in'):
                         if self.nextIsSymbol():
                             record = self.getSymbolRecord()
                             if record['keyword'] == 'window':
-                                value['source'] = record['name']
+                                value['window'] = record['name']
                                 return value
-        return None
+            return None
 
     #############################################################################
     # Modify a value or leave it unchanged.
@@ -600,21 +306,23 @@ class Graphics(Handler):
         return v
 
     def v_property(self, v):
+        property = self.getRuntimeValue(v['property'])
+        window = self.eventValues['window']
+        values = self.eventValues['values']
+        self.utils.getEventProperties(window, values)
+        v['type'] = 'text'
+        v['content'] = values[property]
+        return v
+
+    def v_value(self, v):
         key = self.getRuntimeValue(v['key'])
-        source = v['source']
-        if source == '_event_':
-            window = self.eventValues['window']
-            values = self.eventValues['values']
-            self.utils.getEventProperties(window, values)
-            v['type'] = 'text'
-            v['content'] = values[key]
-            return v
-        else:
-            window = self.getVariable(source)
-            widget = window['window'].key_dict[key]
-            v['type'] = 'text'
-            v['content'] = widget.get()
-            return v
+        window = self.getVariable(v['window'])
+        value = self.utils.getWidgetValue(window, key)
+        if value == None: RuntimeError(self.program, 'getWidgetValue: unimplemented widget type')
+        v = deepcopy(v)
+        v['type'] = 'text'
+        v['content'] = value
+        return v
 
     #############################################################################
     # Compile a condition
@@ -643,3 +351,4 @@ class Graphics(Handler):
                     self.eventValues['values'] = values
                     self.eventValues['window'] = window
                     eventHandlers[event]()
+                    pass

{easycoder-250123.2 → easycoder-250204.1}/easycoder/ec_gutils.py

@@ -52,14 +52,14 @@ class GUtils:
         keys = values.keys()
         for key in keys:
             v = values[key]
-            element = window.key_dict[key]
-            if type(element) is psg.Listbox:
+            widget = window.key_dict[key]
+            if type(widget) is psg.Listbox:
                 # Only pick one from those selected
                 v = v[0]
             values[key] = v
 
-    # Create an element
-    def createElement(self, type, param, args):
+    # Create a widget
+    def createWidget(self, type, param, args):
         if type == 'Button': return self.createButton(param, args)
         elif type == 'Checkbox': return self.createCheckbox(param, args)
         elif type == 'Column': return self.createColumn(param, args)
@@ -69,10 +69,29 @@ class GUtils:
         elif type == 'Text': return self.createText(param, args)
         else: return None
 
+    # Get the current value of a widget
+    def getWidgetValue(self, window, key):
+        key_dict = window['window'].key_dict
+        widget = key_dict[key]
+        if type(widget) is psg.Button: return widget.get()
+        elif type(widget) is psg.Checkbox: return widget.get()
+        elif type(widget) is psg.Column: return widget.get()
+        elif type(widget) is psg.Input: return widget.get()
+        elif type(widget) is psg.Listbox:
+            items = widget.get()
+            if len(items) > 0:
+                return items[0]
+            return ''
+        elif type(widget) is psg.Multiline: return widget.get()
+        elif type(widget) is psg.Text: return widget.get()
+        return None
+
     # Update a property
     def updateProperty(self, element, property, value):
         if property == 'disabled':
             element.update(disabled=value)
+        elif property == 'text':
+            element.update(text=value)
         elif property == 'value':
             element.update(value=value)
         elif property == 'values':
@@ -136,9 +155,10 @@ class GUtils:
 
     def getDefaultText(self, args):
         args['text'] = '(empty)'
+        args['key'] = None
         args['size'] = (None, None)
         args['expand_x'] = False
 
     def createText(self, param, args):
-        return psg.Text(text=args['text'], expand_x=args['expand_x'], size=self.getSize(args))
+        return psg.Text(text=args['text'], expand_x=args['expand_x'], key=args['key'], size=self.getSize(args))