easycoder 250105.1__tar.gz → 250106.2__tar.gz

{easycoder-250105.1 → easycoder-250106.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.1
 Name: easycoder
-Version: 250105.1
+Version: 250106.2
 Summary: Rapid scripting in English
 Keywords: compiler,scripting,prototyping,programming,coding,python,low code,hypertalk,computer language,learn to code
 Author-email: Graham Trott <gtanyware@gmail.com>
@@ -77,7 +77,7 @@ A couple of demo graphical scripts are included in the `scripts` directory:
 
  - English-like syntax based on vocabulary rather than structure. Scripts can be read as English
  - Comprehensive feature set
- - Runs directly from source scripts, using a fast compiler to create efficient intermediate runtime code that is run immediately
+ - Runs directly from source scripts. A fast compiler creates efficient intermediate code that runs immediately after compilation
  - Low memory requirements
  - Minimim dependency on other 3rd-party packages
  - Built-in co-operative multitasking

{easycoder-250105.1 → easycoder-250106.2}/README.md

@@ -66,7 +66,7 @@ A couple of demo graphical scripts are included in the `scripts` directory:
 
  - English-like syntax based on vocabulary rather than structure. Scripts can be read as English
  - Comprehensive feature set
- - Runs directly from source scripts, using a fast compiler to create efficient intermediate runtime code that is run immediately
+ - Runs directly from source scripts. A fast compiler creates efficient intermediate code that runs immediately after compilation
  - Low memory requirements
  - Minimim dependency on other 3rd-party packages
  - Built-in co-operative multitasking

{easycoder-250105.1 → easycoder-250106.2}/doc/core/keywords/import.md

@@ -2,15 +2,15 @@
 
 ## Syntax:
 `import {type} {variable} [and {type} {variable} ...]]`  
-`import {classname} from {path}`
+`import plugin {classname} from {path}`
 
 ## Examples:
 `import variable Name and variable Surname`  
-`import Points from plugins/example.py`
+`import plugin Points from plugins/example.py`
 
 ## Description:
 First form:
-This specifies which variable should be provided by a calling script
+This specifies which variable should be provided by a calling script.
 
 Second form:
 As with [script](script.md), `import` is a compiler directive that should be placed at the top of the script, under the [script](script.md) directive. It's used to call in a plugin language extension where needed. The example above is provided in the repository, to be used as a starting point for your own extra functionality.

{easycoder-250105.1 → easycoder-250106.2}/doc/graphics/README.md

@@ -10,10 +10,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-250106.2/doc/graphics/keywords/attach.md

@@ -0,0 +1,18 @@
+## attach
+
+## Syntax:
+`attach {id} to {graphic element}`
+
+## Examples:
+``attach `big-circle` to Ellipse1` ``  
+``attach `container` to Container` ``
+
+## Description:
+Attaches an **_EasyCoder_** graphic variable ([ellipse](ellipse.md), [rectangle](rectangle.md), [text](text.md), [image](image.md) etc.) to the rendered graphic item with the given id.
+
+When a graphic specification is rendered, every item in the structure is added to 1) a list of items in the order they were rendered (the z-order) and 2) a dictionary of items indexed by their ids.
+
+Next: [close](close.md)  
+Prev: [text](text.md)
+
+[Back](../../README.md)

easycoder-250106.2/doc/graphics/keywords/close.md

@@ -0,0 +1,15 @@
+## close
+
+## Syntax:
+`close window`
+
+## Examples:
+`close window`
+
+## Description:
+Close the window. This will also terminate the **_EasyCoder_** script.
+
+Next: [create](create.md)  
+Prev: [attach](attach.md)
+
+[Back](../../README.md)

easycoder-250106.2/doc/graphics/keywords/create.md

@@ -0,0 +1,15 @@
+## create
+
+## Syntax:
+`create window {parameters}`
+
+## Examples:
+``create window title `Demo` at 300 300 size 640 480 fill color 255 255 200` ``
+
+## Description:
+Creates a window with the given parameters. There can only be one of these in a program.
+
+Next: [ellipse](ellipse.md)  
+Prev: [close](close.md)
+
+[Back](../../README.md)

easycoder-250106.2/doc/graphics/keywords/ellipse.md

@@ -0,0 +1,15 @@
+## ellipse
+
+## Syntax:
+`ellipse {name}`
+
+## Examples:
+`ellipse Circle`
+
+## Description:
+Declares an ellipse variable. This will be attached to a rendered ellipse and used to pass commands to it. See also [image](image.md), [rectangle](rectangle.md) and [text](text.md).
+
+Next: [image](image.md)  
+Prev: [create](create.md)
+
+[Back](../../README.md)

easycoder-250106.2/doc/graphics/keywords/image.md

@@ -0,0 +1,15 @@
+## image
+
+## Syntax:
+`image {name}`
+
+## Examples:
+`image House`
+
+## Description:
+Declares an image variable. This will be attached to a rendered image and used to pass commands to it. See also [ellipse](ellipse.md), [rectangle](rectangle.md) and [text](text.md).
+
+Next: [move](move.md)  
+Prev: [ellipse](ellipse.md)
+
+[Back](../../README.md)

easycoder-250106.2/doc/graphics/keywords/move.md

@@ -0,0 +1,17 @@
+## move
+
+## Syntax:
+`move {name} by {dx} {dy}`  
+`move {name} to {x} {y}`
+
+## Examples:
+`move Blob by 5 10`  
+`move Button to X Y`
+
+## Description:
+Moves a graphic element in its parent container, either by a relative amount or to a specified location.
+
+Next: [on](on.md)  
+Prev: [image](image.md)
+
+[Back](../../README.md)

easycoder-250106.2/doc/graphics/keywords/on.md

@@ -0,0 +1,16 @@
+## on
+
+## Syntax:
+`on click/tap {element} {action}`
+
+## Examples:
+`on click Button stop`  
+`on tap Plus increment Count`
+
+## Description:
+Handle a graphic event. When the user clicks/taps the specified element, perform the requested action, which can be a single command or a `begin...end` block.
+
+Next: [rectangle](rectangle.md)  
+Prev: [move](move.md)
+
+[Back](../../README.md)

easycoder-250106.2/doc/graphics/keywords/rectangle.md

@@ -0,0 +1,15 @@
+## rectangle
+
+## Syntax:
+`rectangle {name}`
+
+## Examples:
+`rectangle BigBox`
+
+## Description:
+Declares a rectangle variable. This will be attached to a rendered rectangle and used to pass commands to it. See also [ellipse](ellipse.md), [image](image.md) and [text](text.md).
+
+Next: [render](render.md)  
+Prev: [on](on.md)
+
+[Back](../../README.md)

easycoder-250106.2/doc/graphics/keywords/render.md

@@ -0,0 +1,18 @@
+## render
+
+## Syntax:
+`render {specification} [in {parent}]`
+
+## Examples:
+`render Spec`  
+`render Spec in BigBox`
+
+## Description:
+Render a graphic specification, optionally giving the parent container.
+
+Specifications are JSON structures that describe the layout and the element(s) comprising the graphic. See [specification](../specification.md).
+
+Next: [run](run.md)  
+Prev: [rectangle](rectangle.md)
+
+[Back](../../README.md)

easycoder-250106.2/doc/graphics/keywords/run.md

@@ -0,0 +1,18 @@
+## run
+
+## Syntax:
+`render {specification} [in {parent}]`
+
+## Examples:
+`render Spec`  
+`render Spec in BigBox`
+
+## Description:
+Render a graphic specification, optionally giving the parent container.
+
+Specifications are JSON structures that describe the layout and the element(s) comprising the graphic. See [specification](../specification.md).
+
+Next: [run](run.md)  
+Prev: [rectangle](rectangle.md)
+
+[Back](../../README.md)

easycoder-250106.2/doc/graphics/keywords/set.md

@@ -0,0 +1,15 @@
+## set
+
+## Syntax:
+`set attribute {name} of {element} to {value}`
+
+## Examples:
+``set attribute `left` of Button to Left`
+
+## Description:
+Set an attribute of a graphic element. Valid attributes depend on the element but include such as `left`, `bottom`, `width` and `height`.
+
+Next: [text](text.md)  
+Prev: [run](run.md)
+
+[Back](../../README.md)

easycoder-250106.2/doc/graphics/keywords/text.md

@@ -0,0 +1,15 @@
+## text
+
+## Syntax:
+`text {name}`
+
+## Examples:
+`text BigBox`
+
+## Description:
+Declares a text variable. This will be attached to a rendered text object and used to pass commands to it. See also [ellipse](ellipse.md), [image](image.md) and [rectangle](rectangle.md).
+
+Next: [attach](attach.md)  
+Prev: [set](set.md)
+
+[Back](../../README.md)

easycoder-250106.2/doc/graphics/values/attribute.md

@@ -0,0 +1,15 @@
+# attribute
+
+## Syntax:
+`attribute {key} of {element}`
+
+## Examples:
+``attribute `width` of BigBox` ``
+
+## Description:
+Gets the named attribute of a graphic element. 
+
+Next: [window](window.md)  
+Prev: [window](window.md)
+
+[Back](../../README.md)

easycoder-250106.2/doc/graphics/values/window.md

@@ -0,0 +1,15 @@
+# window
+
+## Syntax:
+`[the] window left/top/width/height`
+
+## Examples:
+`the window height`
+
+## Description:
+Gets the specified attribute of the window. 
+
+Next: [attribute](attribute.md)  
+Prev: [attribute](attribute.md)
+
+[Back](../../README.md)

{easycoder-250105.1 → easycoder-250106.2}/easycoder/__init__.py

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

{easycoder-250105.1 → easycoder-250106.2}/easycoder/ec_compiler.py

@@ -102,7 +102,7 @@ class Compiler:
 
 	def showWarnings(self):
 		for warning in self.warnings:
-			print(f'Warning at line {self.getLino() + 1} from {warning}')
+			print(f'Warning at line {self.getLino() + 1} of {self.program.name}: {warning}')
 
 	def getSymbolRecord(self):
 		token = self.getToken()

{easycoder-250105.1 → easycoder-250106.2}/easycoder/ec_core.py

@@ -1900,7 +1900,6 @@ class Core(Handler):
                     return value
             return None
 
-        self.warning(f'Core.compileValue: Unknown token "{token}"')
         return None
 
     #############################################################################

{easycoder-250105.1 → easycoder-250106.2}/easycoder/ec_graphics.py

@@ -9,6 +9,7 @@ class Graphics(Handler):
 
     def __init__(self, compiler):
         Handler.__init__(self, compiler)
+        self.windowCreated = False
 
     def getName(self):
         return 'graphics'
@@ -36,7 +37,7 @@ class Graphics(Handler):
             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})')
+            FatalError(self.program.compiler, f'Mismatched element type: \'{element['type']}\' and \'{keyword}\'')
         self.putSymbolValue(targetRecord, {'type': 'text', 'content': id})
         return self.nextPC()
 
@@ -65,11 +66,15 @@ class Graphics(Handler):
             r = self.compileConstant(255)
             g = self.compileConstant(255)
             b = self.compileConstant(255)
+            fullscreen = False
             while True:
                 token = self.peek()
                 if token == 'title':
                     self.nextToken()
                     t = self.nextValue()
+                elif token == 'fullscreen':
+                    fullscreen = True
+                    self.nextToken()
                 elif token == 'at':
                     self.nextToken()
                     left = self.nextValue()
@@ -91,9 +96,10 @@ class Graphics(Handler):
             command['pos'] = (left, top)
             command['size'] = (width, height)
             command['fill'] = (r, g, b)
+            command['fullscreen'] = fullscreen
             self.add(command)
             return True
-        
+
         elif self.isSymbol():
             record = self.getSymbolRecord()
             command['target'] = record['name']
@@ -113,7 +119,7 @@ class Graphics(Handler):
             self.add(command)
             record['elementID'] = command['id']
         return False
-    
+
     def getElementData(self, type, command):
         width = None
         height = None
@@ -170,23 +176,28 @@ class Graphics(Handler):
             command['source'] = source
 
     def r_create(self, command):
+
         try:
             type = command['type']
             if type == 'window':
+                if self.windowCreated == True:
+                    RuntimeError(self.program, 'A window has already been created')
                 self.windowSpec = Object()
                 self.windowSpec.title = command['title']['content']
+                self.windowSpec.fullscreen = command['fullscreen']
                 self.windowSpec.flush = flush
                 self.windowSpec.kill = self.program.kill
                 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)
+                self.windowCreated = True
             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'])
@@ -301,13 +312,22 @@ class Graphics(Handler):
     # render {spec}
     def k_render(self, command):
         command['spec'] = self.nextValue()
+        command['parent'] = None
+        if self.peek() == 'in':
+            self.nextToken()
+            if self.nextIsSymbol():
+                command['parent'] = self.getSymbolRecord()['name']
         self.add(command)
         return True
 
     def r_render(self, command):
+        spec = self.getRuntimeValue(command['spec'])
+        parent = command['parent']
+        if parent !=None:
+            parent = self.getVariable(command['parent'])
         self.ui = self.renderer.getUI()
         try:
-            ScreenSpec().render(self.getRuntimeValue(command['spec']), self.ui)
+            ScreenSpec().render(spec, parent, self.ui)
         except Exception as e:
             RuntimeError(self.program, e)
         return self.nextPC()
@@ -316,12 +336,6 @@ class Graphics(Handler):
     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
 
@@ -385,7 +399,7 @@ class Graphics(Handler):
                 value['type'] = 'symbol'
                 return value
             return None
-        
+
         if self.tokenIs('the'):
             self.nextToken()
         kwd = self.getToken()

{easycoder-250105.1 → easycoder-250106.2}/easycoder/ec_renderer.py

@@ -41,21 +41,21 @@ class Element():
     def setPos(self, pos):
         self.spec.realpos = pos
         self.spec.item.pos = pos
-    
+
     # Called when the parent moves
     def repos(self):
         spec = self.spec
         spec.item.pos = Vector(spec.realpos) + spec.parent.realpos
-            
+
     def getRealSize(self):
         return self.spec.realsize
-            
+
     def getSize(self):
         return self.spec.size
 
     def setSize(self, size):
         self.spec.size = size
-    
+
     def getChildren(self):
         return self.spec.children
 
@@ -68,7 +68,7 @@ class UI(Widget):
         if id in self.elements.keys():
             return self.elements[id]
         return None
-    
+
     def addElement(self, id, spec):
         if id in self.elements.keys():
             raise(Exception(f'Element {id} already exists'))
@@ -133,7 +133,7 @@ class UI(Widget):
                 item = AsyncImage(pos=pos, size=size, source=spec.source)
             spec.item = item
             self.addElement(spec.id, spec)
-    
+
     def moveElementBy(self, id, dist):
         element = self.getElement(id)
         if element != None:
@@ -141,7 +141,7 @@ class UI(Widget):
             for id in element.getChildren():
                 self.getElement(id).repos()
         return
-    
+
     def moveElementTo(self, id, pos):
         element = self.getElement(id)
         if element != None:
@@ -172,7 +172,7 @@ class UI(Widget):
                     if tp[0] >= pos[0] and tp[0] < pos[0] + size[0] and tp[1] >= pos[1] and tp[1] < pos[1] + size[1]:
                         element.cb()
                         break
-    
+
     def setOnClick(self, id, callback):
         self.getElement(id).cb = callback
 
@@ -200,7 +200,7 @@ class UI(Widget):
             return spec.realsize[1]
         else:
             raise Exception(f'Unknown attribute: {attribute}')
-        
+
     def setAttribute(self, id, attribute, value):
         spec = self.getElement(id).spec
         if attribute == 'left':
@@ -222,15 +222,15 @@ class Renderer(App):
 
     def getUI(self):
         return self.ui
-    
+
     def request_close(self):
         print('close window')
         self.kill()
         Window.close()
-    
+
     def flushQueue(self, dt):
         self.flush()
-    
+
     def build(self):
         Clock.schedule_interval(self.flushQueue, 0.01)
         return self.ui
@@ -240,8 +240,11 @@ class Renderer(App):
         self.title = spec.title
         self.flush = spec.flush
         self.kill = spec.kill
-        Window.size = spec.size
-        Window.left = spec.pos[0]
-        Window.top = spec.pos[1]
         Window.clearcolor = spec.fill
         Window.on_request_close=self.request_close
+        if spec.fullscreen:
+            Window.fullscreen = True
+        else:
+            Window.size = spec.size
+            Window.left = spec.pos[0]
+            Window.top = spec.pos[1]

{easycoder-250105.1 → easycoder-250106.2}/easycoder/ec_screenspec.py

@@ -61,17 +61,14 @@ class ScreenSpec():
             self.createWidget(spec[widgets], parent)
 
     # Render a graphic specification
-    def render(self, spec, ui):
+    def render(self, spec, parent, ui):
         self.ui = ui
 
         # If it'a string, process it
         if isinstance(spec, str):
-            self.renderSpec(loads(spec), None)
+            self.renderSpec(loads(spec), parent)
 
         # If it's a 'dict', extract the spec and the args
-        elif isinstance(spec, dict):
-            spec = loads(spec['spec'])
-            self.renderSpec(spec, None)
-
         else:
-            raise Exception('Spec is an unknown type')
+            self.renderSpec(spec, parent)
+

{easycoder-250105.1 → easycoder-250106.2}/easycoder/ec_value.py

@@ -51,14 +51,14 @@ class Value:
 			if item != None:
 				return item
 			self.compiler.rewindTo(mark)
-		self.compiler.warning(f'I don\'t understand \'{token}\'')
+		# self.compiler.warning(f'I don\'t understand \'{token}\'')
 		return None
 
 	def compileValue(self):
 		token = self.getToken()
 		item = self.getItem()
 		if item == None:
-			FatalError(self.compiler, f'Cannot get the value of "{token}"')
+			self.compiler.warning(f'ec_value.compileValue: Cannot get the value of "{token}"')
 			return None
 
 		value = {}

{easycoder-250105.1 → easycoder-250106.2}/scripts/wave.ecg

@@ -97,7 +97,7 @@
         increment N
     end
 
-    wait 2
+    wait 1
     ! Run the main animation
     while true
     begin