easycoder 241218.1__tar.gz → 241231.1__tar.gz

{easycoder-241218.1 → easycoder-241231.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: easycoder
-Version: 241218.1
+Version: 241231.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>
@@ -60,9 +60,17 @@ Here in the repository is a folder called `scripts` containing some sample scrip
 `fizzbuzz.ecs` is a simple programming challenge often given at job interviews
 
 ## Graphical programmming
-**_EasyCoder_** is currently being extended to include a graphical programming environment. A single demo script `graphics-demo.ecs` is included in the `scripts` directory. To run it, first install the Python graphics library if it's not already present on your system. On Linux this is done with `sudo apt install python3-tk`. On Windows it's `pip install tk`. Then give the command `easycoder -g scripts/graphics-demo.ecs`.
+**_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`.
 
-As development progresses this demo script will be extended to include new features as they are added. **_EasyCoder_** graphics are handled by a library module, `ec_renderer` that can be used outside of the **_EasyCoder_** environment, in other Python programs.
+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).
+
+A couple of demo 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.
+
+`wave.ecg` is a "Mexican Wave" simulation.
+
+**_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
 

{easycoder-241218.1 → easycoder-241231.1}/README.md

@@ -49,9 +49,17 @@ Here in the repository is a folder called `scripts` containing some sample scrip
 `fizzbuzz.ecs` is a simple programming challenge often given at job interviews
 
 ## Graphical programmming
-**_EasyCoder_** is currently being extended to include a graphical programming environment. A single demo script `graphics-demo.ecs` is included in the `scripts` directory. To run it, first install the Python graphics library if it's not already present on your system. On Linux this is done with `sudo apt install python3-tk`. On Windows it's `pip install tk`. Then give the command `easycoder -g scripts/graphics-demo.ecs`.
+**_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`.
 
-As development progresses this demo script will be extended to include new features as they are added. **_EasyCoder_** graphics are handled by a library module, `ec_renderer` that can be used outside of the **_EasyCoder_** environment, in other Python programs.
+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).
+
+A couple of demo 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.
+
+`wave.ecg` is a "Mexican Wave" simulation.
+
+**_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
 

easycoder-241231.1/easycoder/README.md

@@ -0,0 +1,6 @@
+# EasyCode source code
+These are the Python files that comprise **_EasyCoder_**.
+
+**_EasyCoder_** has a small number of third-party dependencies. A minor one is `pytz`, which handles timezones. The biggest one by far is `kivy`, a comprehensive Python graphics library.
+
+If an **_EasyCoder_** script filename ends with `.ecs` it's a command-line script. If it ends with `.ecg` it's a script for a graphical application and will cause `kivy` to be imported. Obviously this will only work on a GUI-based system, whereas command-line scripts will run anywhere there is Python.

{easycoder-241218.1 → easycoder-241231.1}/easycoder/__init__.py

@@ -1,5 +1,6 @@
 '''EasyCoder for Python'''
 
+from .ec import Main
 from .ec_classes import *
 from .ec_compiler import *
 from .ec_condition import *
@@ -8,6 +9,5 @@ from .ec_handler import *
 from .ec_program import *
 from .ec_timestamp import *
 from .ec_value import *
-from .ec_graphics import *
 
-__version__ = "241218.1"
+__version__ = "241231.1"

easycoder-241231.1/easycoder/ec.py

@@ -0,0 +1,10 @@
+import sys
+from .ec_program import Program
+
+# This is the program launcher
+def Main():
+	print(f'Args: {sys.argv}')
+	if (len(sys.argv) > 1):
+		Program(sys.argv[1:]).start()
+	else:
+		print('Syntax: easycoder <scriptname>')

{easycoder-241218.1 → easycoder-241231.1}/easycoder/ec_classes.py

@@ -52,3 +52,6 @@ class Token:
 	
 class Condition():
 	negate = False
+
+class Object():
+    pass

{easycoder-241218.1 → easycoder-241231.1}/easycoder/ec_compiler.py

@@ -16,6 +16,7 @@ class Compiler:
 		self.warnings = []
 		self.program.compiler = self
 		self.addCommand = self.program.add
+		self.compileConstant = self.value.compileConstant
 
 	def getPC(self):
 		return len(self.program.code)
@@ -44,6 +45,11 @@ class Compiler:
 		except:
 			return None
 
+	# Get a constant
+	def getConstant(self, token):
+		self.index += 1
+		return self.compileConstant(token)
+
 	# Get a value
 	def getValue(self):
 		return self.value.compileValue()
@@ -53,11 +59,6 @@ class Compiler:
 		self.index += 1
 		return self.value.compileValue()
 
-	# Get a constant
-	def getConstant(self, token):
-		self.index += 1
-		return self.value.compileConstant(token)
-
 	# Get a condition
 	def getCondition(self):
 		return self.condition.compileCondition()
@@ -101,7 +102,7 @@ class Compiler:
 
 	def showWarnings(self):
 		for warning in self.warnings:
-			print(f'Warning: Line {self.getLino() + 1}: {warning}')
+			print(f'Warning at line {self.getLino() + 1} from {warning}')
 
 	def getSymbolRecord(self):
 		token = self.getToken()

{easycoder-241218.1 → easycoder-241231.1}/easycoder/ec_core.py

@@ -696,6 +696,29 @@ class Core(Handler):
         self.putSymbolValue(target, value)
         return self.nextPC()
 
+    # Negate a variable
+    def k_negate(self, command):
+        if self.nextIsSymbol():
+            symbolRecord = self.getSymbolRecord()
+            if symbolRecord['valueHolder']:
+                command['target'] = self.getToken()
+                self.add(command)
+                return True
+            self.warning(f'Core.negate: Variable "{symbolRecord["name"]}" does not hold a value')
+        return False
+
+    def r_negate(self, command):
+        symbolRecord = self.getVariable(command['target'])
+        if not symbolRecord['valueHolder']:
+            RuntimeError(self.program, f'{symbolRecord["name"]} does not hold a value')
+            return None
+        value = self.getSymbolValue(symbolRecord)
+        if value == None:
+            RuntimeError(self.program, f'{symbolRecord["name"]} has not been initialised')
+        value['content'] *= -1
+        self.putSymbolValue(symbolRecord, value)
+        return self.nextPC()
+
     # Define an object variable
     def k_object(self, command):
         return self.compileVariable(command)
@@ -724,8 +747,10 @@ class Core(Handler):
                         FatalError(self.program.compiler, 'Unknown file open mode {self.getToken()}')
                         return False
                     command['mode'] = mode
-                    self.add(command)
-                    return True
+                else:
+                    command['mode'] = 'r'
+                self.add(command)
+                return True
             else:
                 FatalError(self.compiler, f'Variable "{self.getToken()}" is not a file')
         else:
@@ -974,7 +999,7 @@ class Core(Handler):
         content = self.getSymbolValue(templateRecord)['content']
         original = self.getRuntimeValue(command['original'])
         replacement = self.getRuntimeValue(command['replacement'])
-        content = content.replace(original, replacement)
+        content = content.replace(original, str(replacement))
         value = {}
         value['type'] = 'text'
         value['numeric'] = False
@@ -1415,7 +1440,7 @@ class Core(Handler):
     # Compile a value in this domain
     def compileValue(self):
         value = {}
-        value['domain'] = 'core'
+        value['domain'] = self.getName()
         token = self.getToken()
         if self.isSymbol():
             value['name'] = token

easycoder-241231.1/easycoder/ec_graphics.py

@@ -0,0 +1,429 @@
+from .ec_classes import FatalError, RuntimeError, Object
+from .ec_handler import Handler
+from .ec_screenspec import ScreenSpec
+from .ec_renderer import Renderer
+
+class Graphics(Handler):
+
+    def __init__(self, compiler):
+        Handler.__init__(self, compiler)
+
+    def getName(self):
+        return 'graphics'
+
+    #############################################################################
+    # Keyword handlers
+
+    def k_attach(self, command):
+        if self.nextIsSymbol():
+            record = self.getSymbolRecord()
+            command['name'] = record['name']
+            if self.nextIs('to'):
+                value = self.nextValue()
+                record['id'] = value
+                command['id'] = value
+            self.add(command)
+        return True
+
+    def r_attach(self, command):
+        targetRecord = self.getVariable(command['name'])
+        keyword = targetRecord['keyword']
+        id = self.getRuntimeValue(command['id'])
+        element = self.ui.getElement(id)
+        if element == None:
+            FatalError(self.program.compiler, f'There is no screen element with id \'{id}\'')
+            return -1
+        if element.getType() != keyword:
+            FatalError(self.program.compiler, f'Mismatched element type ({element['type']} and {keyword})')
+        self.putSymbolValue(targetRecord, {'type': 'text', 'content': id})
+        return self.nextPC()
+
+    # close window
+    def k_close(self, command):
+        if (self.nextIs('window')):
+            self.add(command)
+            return True
+        return False
+
+    def r_close(self, command):
+        self.renderer.stop()
+        return 0
+
+    # create window/ellipse/rectangle//text/image
+    def k_create(self, command):
+        token = self.nextToken()
+        if (token == 'window'):
+            t = {}
+            t['type'] = 'text'
+            t['content'] = 'EasyCoder'
+            width = self.compileConstant(640)
+            height = self.compileConstant(480)
+            left = self.compileConstant(100)
+            top = self.compileConstant(100)
+            r = self.compileConstant(255)
+            g = self.compileConstant(255)
+            b = self.compileConstant(255)
+            while True:
+                token = self.peek()
+                if token == 'title':
+                    self.nextToken()
+                    t = self.nextValue()
+                elif token == 'at':
+                    self.nextToken()
+                    left = self.nextValue()
+                    top = self.nextValue()
+                elif token == 'size':
+                    self.nextToken()
+                    width = self.nextValue()
+                    height = self.nextValue()
+                elif token == 'fill':
+                    self.nextToken()
+                    if self.nextIs('color'):
+                        r = self.nextValue()
+                        g = self.nextValue()
+                        b = self.nextValue()
+                else:
+                    break
+            command['type'] = 'window'
+            command['title'] = t
+            command['pos'] = (left, top)
+            command['size'] = (width, height)
+            command['fill'] = (r, g, b)
+            self.add(command)
+            return True
+        
+        elif self.isSymbol():
+            record = self.getSymbolRecord()
+            command['target'] = record['name']
+            type = record['keyword']
+            command['type'] = type
+            if type in ['ellipse', 'rectangle', 'image']:
+                self.getElementData(type, command)
+                for item in ['width', 'height', 'left', 'bottom', 'r', 'g', 'b']:
+                    if command[item] == None:
+                        FatalError(self.program.compiler, f'Missing property \'{item}\'')
+                return True
+            elif type == 'text':
+                self.getElementData(type, command)
+                for item in ['width', 'height', 'left', 'bottom', 'r', 'g', 'b', 'text']:
+                    if command[item] == None:
+                        FatalError(self.program.compiler, f'Missing property \'{item}\'')
+            self.add(command)
+            record['elementID'] = command['id']
+        return False
+    
+    def getElementData(self, type, command):
+        width = None
+        height = None
+        left = None
+        bottom = None
+        r = None
+        g = None
+        b = None
+        text = None
+        source = None
+        id = self.nextValue()
+        while True:
+            token = self.peek()
+            if token == 'size':
+                self.nextToken()
+                width = self.nextValue()
+                height = self.nextValue()
+            elif token == 'at':
+                self.nextToken()
+                left = self.nextValue()
+                bottom = self.nextValue()
+            elif token == 'fill':
+                self.nextToken()
+                r = self.nextValue()
+                g = self.nextValue()
+                b = self.nextValue()
+            elif token == 'text':
+                self.nextToken()
+                text = self.nextValue()
+            elif token == 'source':
+                self.nextToken()
+                source = self.nextValue()
+            else:
+                break
+        command['id'] = id
+        command['type'] = type
+        if width != None:
+            command['width'] = width
+        if height != None:
+            command['height'] = height
+        if left!= None:
+            command['left'] = left
+        if bottom != None:
+            command['bottom'] = bottom
+        if r != None:
+            command['r'] = r
+        if g != None:
+            command['g'] = g
+        if b != None:
+            command['b'] = b
+        if text != None:
+            command['text'] = text
+        if source != None:
+            command['source'] = source
+
+    def r_create(self, command):
+        try:
+            type = command['type']
+            if type == 'window':
+                self.windowSpec = Object()
+                self.windowSpec.title = command['title']['content']
+                self.windowSpec.flush = self.program.flush
+                self.windowSpec.finish = self.program.finish
+                self.windowSpec.pos = (self.getRuntimeValue(command['pos'][0]), self.getRuntimeValue(command['pos'][1]))
+                self.windowSpec.size = (self.getRuntimeValue(command['size'][0]), self.getRuntimeValue(command['size'][1]))
+                self.windowSpec.fill = (self.getRuntimeValue(command['fill'][0])/255, self.getRuntimeValue(command['fill'][1])/255, self.getRuntimeValue(command['fill'][2])/255)
+            else:
+                element = self.ui.createWidget(self.getWidgetSpec(command))
+                print(element)
+        except Exception as e:
+            RuntimeError(self.program, e)
+        return self.nextPC()
+    
+    def getWidgetSpec(self, command):
+        spec = Object()
+        spec.id = self.getRuntimeValue(command['id'])
+        spec.type = command['type']
+        spec.w = self.getRuntimeValue(command['width'])
+        spec.h = self.getRuntimeValue(command['height'])
+        spec.x = self.getRuntimeValue(command['left'])
+        spec.y = self.getRuntimeValue(command['bottom'])
+        spec.r = self.getRuntimeValue(command['r'])/255
+        spec.g = self.getRuntimeValue(command['g'])/255
+        spec.b = self.getRuntimeValue(command['b'])/255
+        return spec
+
+    def k_ellipse(self, command):
+        return self.compileVariable(command)
+
+    def r_ellipse(self, command):
+        return self.nextPC()
+
+    def r_getui(self, command):
+        self.ui = self.renderer.getUI()
+        return self.nextPC()
+
+    def k_image(self, command):
+        return self.compileVariable(command)
+
+    def r_image(self, command):
+        return self.nextPC()
+
+    # move an element
+    def k_move(self, command):
+        if self.nextIsSymbol():
+            record = self.getSymbolRecord()
+            type = record['keyword']
+            if type in ['ellipse', 'rectangle']:
+                command['target'] = record['id']
+                token = self.nextToken()
+                if token == 'to':
+                    command['x'] = self.nextValue()
+                    command['y'] = self.nextValue()
+                    self.add(command)
+                    return True
+                elif token == 'by':
+                    command['keyword'] = 'moveBy'
+                    command['dx'] = self.nextValue()
+                    command['dy'] = self.nextValue()
+                    self.add(command)
+                    return True
+        return False
+
+    def r_move(self, command):
+        pos = (self.getRuntimeValue(command['x']), self.getRuntimeValue(command['y']))
+        self.ui.moveElementTo(self.getRuntimeValue(command['target']), pos)
+        return self.nextPC()
+
+    def r_moveBy(self, command):
+        dist = (self.getRuntimeValue(command['dx']), self.getRuntimeValue(command['dy']))
+        self.ui.moveElementBy(self.getRuntimeValue(command['target']), dist)
+        return self.nextPC()
+
+    def k_on(self, command):
+        token = self.nextToken()
+        if token in ['click', 'tap']:
+            command['type'] = 'tap'
+            if self.nextIsSymbol():
+                target = self.getSymbolRecord()
+            else:
+                FatalError(self.program.compiler, f'{self.getToken()} is not a screen element')
+                return False
+            command['target'] = target['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):
+        pc = command['goto']
+        if command['type'] == 'tap':
+            record = self.getVariable(command['target'])
+            keyword = record['keyword']
+            if keyword in ['ellipse', 'rectangle', 'text', 'image']:
+                id = record['value'][record['index']]['content']
+                self.ui.setOnClick(id, lambda: self.run(pc))
+            else:
+                RuntimeError(self.program, f'{record['name']} is not a clickable object')
+        return self.nextPC()
+
+    def k_rectangle(self, command):
+        return self.compileVariable(command)
+
+    def r_rectangle(self, command):
+        return self.nextPC()
+
+    def k_text(self, command):
+        return self.compileVariable(command)
+
+    def r_text(self, command):
+        return self.nextPC()
+
+    # render {spec}
+    def k_render(self, command):
+        command['spec'] = self.nextValue()
+        self.add(command)
+        return True
+
+    def r_render(self, command):
+        self.ui = self.renderer.getUI()
+        try:
+            ScreenSpec().render(self.getRuntimeValue(command['spec']), self.ui)
+        except Exception as e:
+            RuntimeError(self.program, e)
+        return self.nextPC()
+
+    # run graphics
+    def k_run(self, command):
+        if self.nextIs('graphics'):
+            self.add(command)
+            cmd = {}
+            cmd['domain'] = 'graphics'
+            cmd['lino'] = command['lino'] + 1
+            cmd['keyword'] = 'getui'
+            cmd['debug'] = False
+            self.addCommand(cmd)
+            return True
+        return False
+
+    def r_run(self, command):
+        self.renderer = Renderer()
+        self.renderer.init(self.windowSpec)
+        self.program.setExternalControl()
+        self.program.run(self.nextPC())
+        self.renderer.run()
+
+    # Set something
+    def k_set(self, command):
+        if self.nextIs('attribute'):
+            command['attribute'] = self.nextValue()
+            if self.nextIs('of'):
+                if self.nextIsSymbol():
+                    record = self.getSymbolRecord()
+                    if record['keyword'] in ['ellipse', 'rectangle', 'text', 'image']:
+                        command['target'] = record['name']
+                        if self.nextIs('to'):
+                            command['value'] = self.nextValue()
+                            self.addCommand(command)
+                            return True
+                    else:
+                        FatalError(self.program.compiler, f'Invalid type: {record['keyword']}')
+                else:
+                    FatalError(self.program.compiler, f'\'{self.getToken()}\' is not a variable')
+        return False
+
+    def r_set(self, command):
+        attribute = self.getRuntimeValue(command['attribute'])
+        target = self.getVariable(command['target'])
+        id = target['value'][target['index']]['content']
+        value = self.getRuntimeValue(command['value'])
+        self.ui.setAttribute(id, attribute, value)
+        return self.nextPC()
+
+    #############################################################################
+    # Modify a value or leave it unchanged.
+    def modifyValue(self, value):
+        return value
+
+    #############################################################################
+    # Compile a value in this domain
+    def compileValue(self):
+        value = {}
+        value['domain'] = self.getName()
+        if self.tokenIs('the'):
+            self.nextToken()
+        kwd = self.getToken()
+        value['type'] = kwd
+        if kwd == 'attribute':
+            attribute = self.nextValue()
+            if self.nextIs('of'):
+                if self.nextIsSymbol():
+                    record = self.getSymbolRecord()
+                    if record['keyword'] in ['ellipse', 'rectangle']:
+                        value['attribute'] = attribute
+                        value['target'] = record['name']
+                        return value
+        elif kwd == 'window':
+            attribute = self.nextToken()
+            if attribute in ['left', 'top', 'width', 'height']:
+                value['attribute'] = attribute
+                return value
+        return None
+
+    #############################################################################
+    # Value handlers
+
+    def v_attribute(self, v):
+        try:
+            attribute = self.getRuntimeValue(v['attribute'])
+            target = self.getVariable(v['target'])
+            val = self.getSymbolValue(target)
+            v = self.ui.getAttribute(val['content'], attribute)
+            value = {}
+            value['type'] = 'int'
+            value['content'] = int(round(v))
+            return value
+        except Exception as e:
+            RuntimeError(self.program, e)
+
+    def v_window(self, v):
+        try:
+            attribute = v['attribute']
+            value = {}
+            value['type'] = 'int'
+            value['content'] = int(round(self.ui.getWindowAttribute(attribute)))
+            return value
+        except Exception as e:
+            RuntimeError(self.program, e)
+
+    #############################################################################
+    # Compile a condition
+    def compileCondition(self):
+        condition = {}
+        return condition
+
+    #############################################################################
+    # Condition handlers

{easycoder-241218.1 → easycoder-241231.1}/easycoder/ec_handler.py

@@ -25,6 +25,7 @@ class Handler:
 		self.getCommandAt = compiler.getCommandAt
 		self.compileOne = compiler.compileOne
 		self.compileFromHere = compiler.compileFromHere
+		self.compileConstant = compiler.compileConstant
 
 		self.code = self.program.code
 		self.add = self.program.add