easycoder 241215.1__tar.gz → 241227.1__tar.gz

{easycoder-241215.1 → easycoder-241227.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: easycoder
-Version: 241215.1
+Version: 241227.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>
@@ -62,7 +62,7 @@ Here in the repository is a folder called `scripts` containing some sample scrip
 ## 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`.
 
-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.
+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.
 
 ## EasyCoder programming reference
 
@@ -74,5 +74,5 @@ The language comprises a general-purpose core package, which can be enhanced by
 
 **_EasyCoder_** can be extended to add new functionality with the use of 'plugins'. These contain compiler and runtime modules for the added language features. **_EasyCoder_** can use the added keywords, values and conditions freely; the effect is completely seamless. There is an outline example in the `plugins` directory called `example.py`, which comprises a module called `Points` with new language syntax to deal with two-valued items such as coordinates. In the `scripts` directory there is `points.ecs`, which exercises the new functionality.
 
-A plugin can act as a wrapper around any Python functionality that has a sensible API, thereby hiding its complexity. The only challenge is to devise an unambiguous syntax that doesn't clash with anything already existing in **_EasyCoder_**
+A plugin can act as a wrapper around any Python functionality that has a sensible API, thereby hiding its complexity. The only challenge is to devise an unambiguous syntax that doesn't clash with anything already existing in **_EasyCoder_**.
 

{easycoder-241215.1 → easycoder-241227.1}/README.md

@@ -51,7 +51,7 @@ Here in the repository is a folder called `scripts` containing some sample scrip
 ## 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`.
 
-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.
+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.
 
 ## EasyCoder programming reference
 
@@ -63,4 +63,4 @@ The language comprises a general-purpose core package, which can be enhanced by
 
 **_EasyCoder_** can be extended to add new functionality with the use of 'plugins'. These contain compiler and runtime modules for the added language features. **_EasyCoder_** can use the added keywords, values and conditions freely; the effect is completely seamless. There is an outline example in the `plugins` directory called `example.py`, which comprises a module called `Points` with new language syntax to deal with two-valued items such as coordinates. In the `scripts` directory there is `points.ecs`, which exercises the new functionality.
 
-A plugin can act as a wrapper around any Python functionality that has a sensible API, thereby hiding its complexity. The only challenge is to devise an unambiguous syntax that doesn't clash with anything already existing in **_EasyCoder_**
+A plugin can act as a wrapper around any Python functionality that has a sensible API, thereby hiding its complexity. The only challenge is to devise an unambiguous syntax that doesn't clash with anything already existing in **_EasyCoder_**.

{easycoder-241215.1 → easycoder-241227.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__ = "241215.1"
+__version__ = "241227.1"

easycoder-241227.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-241215.1 → easycoder-241227.1}/easycoder/ec_classes.py

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

{easycoder-241215.1 → easycoder-241227.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-241215.1 → easycoder-241227.1}/easycoder/ec_core.py

@@ -724,8 +724,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:

easycoder-241227.1/easycoder/ec_graphics.py

@@ -0,0 +1,371 @@
+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 'kivy'
+
+    #############################################################################
+    # 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 k_image(self, command):
+        return self.compileVariable(command)
+
+    def r_image(self, command):
+        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()
+
+    # 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_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()
+        ScreenSpec().render(self.getRuntimeValue(command['spec']), self.ui)
+        return self.nextPC()
+
+    # run graphics
+    def k_run(self, command):
+        if self.nextIs('graphics'):
+            self.add(command)
+            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()
+
+    #############################################################################
+    # 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('attribute'):
+            attribute = self.nextValue()
+            if self.nextIs('of'):
+                if self.nextIsSymbol():
+                    record = self.getSymbolRecord()
+                    if record['keyword'] in ['ellipse', 'rectangle']:
+                        value['type'] = 'attribute'
+                        value['attribute'] = attribute
+                        value['target'] = record['name']
+                        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)
+
+    #############################################################################
+    # Compile a condition
+    def compileCondition(self):
+        condition = {}
+        return condition
+
+    #############################################################################
+    # Condition handlers

{easycoder-241215.1 → easycoder-241227.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

{easycoder-241215.1 → easycoder-241227.1}/easycoder/ec_program.py

@@ -11,23 +11,18 @@ class Program:
 
 	def __init__(self, argv):
 		print(f'EasyCoder version {version("easycoder")}')
-		scriptName = None
 		if len(argv) == 0:
 			print('No script supplied')
 			exit()
 		self.classes=[Core]
-		for n in range(len(argv)):
-			arg = argv[n]
-			if arg == '-g':
-				from .ec_graphics import Graphics
-				self.classes.append(Graphics)
-			else:
-				scriptName = arg
+		scriptName = argv[0]
+		if scriptName.endswith('.ecg'):
+			from .ec_graphics import Graphics
+			self.classes.append(Graphics)
 
 		f = open(scriptName, 'r')
 		source = f.read()
 		f.close()
-		self.argv = argv
 		self.domains = []
 		self.domainIndex = {}
 		self.name = '<anon>'
@@ -43,6 +38,8 @@ class Program:
 		self.condition = self.compiler.condition
 		self.processClasses()
 		self.queue = deque()
+		self.externalControl = False
+		self.quit = False
 
 	def start(self):
 		startCompile = time.time()
@@ -242,18 +239,17 @@ class Program:
 				index += 1
 			lino += 1
 		return
+	
+	def finish(self):
+		self.quit = True
 
-	# Run the script
-	def run(self, pc):
-		# print(f'Run from {pc}')
-		length = len(self.queue)
-		self.queue.append(pc)
-		if length > 0:
-			return
-
+	# Flush the queue
+	def flush(self):
 		while len(self.queue):
 			self.pc = self.queue.popleft()
 			while True:
+				if self.quit:
+					return
 				command = self.code[self.pc]
 				domainName = command['domain']
 				if domainName == None:
@@ -272,11 +268,20 @@ class Program:
 						self.pc = handler(command)
 						try:
 							if self.pc == 0 or self.pc >= len(self.code):
-								return 0
+								break
 						except:
-							return 0
-				if self.pc < 0:
-					return -1
+							break
+
+	def setExternalControl(self):
+		self.externalControl = True
+
+	# Run the script
+	def run(self, pc):
+		length = len(self.queue)
+		self.queue.append(pc)
+		if not self.externalControl:
+			if length == 0:
+				return self.flush()
 
 	def nonNumericValueError(self):
 		FatalError(self.compiler, 'Non-numeric value')
@@ -322,10 +327,3 @@ class Program:
 		if v1 < v2:
 			return -1
 		return 0
-
-# This is the program launcher
-def Main():
-	if (len(sys.argv) > 1):
-		Program(sys.argv[1:]).start()
-	else:
-		print('Syntax: easycoder <scriptname> [plugins]')