easycoder 250109.2__tar.gz → 250110.1__tar.gz

{easycoder-250109.2 → easycoder-250110.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: easycoder
-Version: 250109.2
+Version: 250110.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>
@@ -12,7 +12,8 @@ Project-URL: Home, https://github.com/easycoder/easycoder-py
 # Introduction
 **_EasyCoder_** is a high-level English-like scripting language suited for prototyping and rapid testing of ideas. It operates on the command line and a graphics module is under construction. This version of the language is written in Python and it acts as a fairly thin wrapper around Python functions, giving fast compilation and good runtime performance for general applications.
 <hr>
-For the JavaScript version of **_EasyCoder_**, which provides a full set of graphical features to run in a browser, please visit
+
+There is also a JavaScript version of **_EasyCoder_**, which provides a full set of graphical features to run in a browser. For this, please visit
 
 Repository: [https://github.com/easycoder/easycoder.github.io](https://github.com/easycoder/easycoder.github.io)  
 Website: [https://easycoder.github.io](https://easycoder.github.io)
@@ -23,6 +24,8 @@ Install **_EasyCoder_** in your Python environment:
 ```
 pip install easycoder
 ```
+You may also need to install `pytz`, as some commands need it.
+
 Write a test script, 'hello.ecs', containing the following:
 ```
 print `Hello, world!`
@@ -30,28 +33,27 @@ print `Hello, world!`
 This is traditionally the first program to be written in virtually any language. To run it, use `easycoder hello.ecs`.
 
 The output will look like this (the version number will differ):
-
 ```
 EasyCoder version 250101.1
 Compiled <anon>: 1 lines (2 tokens) in 0 ms
 Run <anon>
 1-> Hello, world!
 ```
-It's conventional to add a program title to a script:
 
+It's conventional to add a program title to a script:
 ```
 !   Test script
     script Test
     print `Hello, world!`
 ```
 The first line here is just a comment and has no effect on the running of the script.   The second line gives the script a name, which is useful in debugging as it says which script was running. When run, the output is now
-
 ```
 EasyCoder version 250101.1
 Compiled Test: 3 lines (4 tokens) in 0 ms
 Run Test
 3-> Hello, world!
 ```
+
 As you might guess from the above, the print command shows the line in the script it was called from. This is very useful in tracking down debugging print commands in large scripts.
 
 Here in the repository is a folder called `scripts` containing some sample scripts:
@@ -65,13 +67,15 @@ Here in the repository is a folder called `scripts` containing some sample scrip
 
 Graphical scripts look much like any other script but their file names must use the extension `.ecg` to signal to **_EasyCoder_** that it needs to load the graphics module. Non-graphical applications can use any extension but `.ecs` is recommended. This allows the **_EasyCoder_** application to be used wherever Python is installed, in either a command-line or a graphical environment, but graphics will of course not be available in the former.
 
-A couple of demo graphical scripts are included in the `scripts` directory:
+Some demo graphical scripts are included in the `scripts` directory:
 
 `graphics-demo.ecg` shows some of the elements that can be created, and demonstrates a variety of the graphical features of the language such as detecting when elements are clicked.
 
 `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.
+`keyboard.ecg` creates an on-screen keyboard (currently a 4-function calculator keypad) that responds to clicks on its keys. It uses a plugin module (see below) to add extra vocabulary and syntax to the language. This is currently under development so its features are likely to change. The intention is to support a wide range of keyboard styles with the minimum mount of coding. The plugin (`ec_keyword.py`) can be downloaded from the repository.
+
+**_EasyCoder_** graphics are handled by a library module, `ec_renderer` that can be used outside of the **_EasyCoder_** environment, in other Python programs. The renderer works with JSON-formatted specifications of the itens to be displayed.
 
 ## Significant features
 

{easycoder-250109.2 → easycoder-250110.1}/README.md

@@ -1,7 +1,8 @@
 # Introduction
 **_EasyCoder_** is a high-level English-like scripting language suited for prototyping and rapid testing of ideas. It operates on the command line and a graphics module is under construction. This version of the language is written in Python and it acts as a fairly thin wrapper around Python functions, giving fast compilation and good runtime performance for general applications.
 <hr>
-For the JavaScript version of **_EasyCoder_**, which provides a full set of graphical features to run in a browser, please visit
+
+There is also a JavaScript version of **_EasyCoder_**, which provides a full set of graphical features to run in a browser. For this, please visit
 
 Repository: [https://github.com/easycoder/easycoder.github.io](https://github.com/easycoder/easycoder.github.io)  
 Website: [https://easycoder.github.io](https://easycoder.github.io)
@@ -12,6 +13,8 @@ Install **_EasyCoder_** in your Python environment:
 ```
 pip install easycoder
 ```
+You may also need to install `pytz`, as some commands need it.
+
 Write a test script, 'hello.ecs', containing the following:
 ```
 print `Hello, world!`
@@ -19,28 +22,27 @@ print `Hello, world!`
 This is traditionally the first program to be written in virtually any language. To run it, use `easycoder hello.ecs`.
 
 The output will look like this (the version number will differ):
-
 ```
 EasyCoder version 250101.1
 Compiled <anon>: 1 lines (2 tokens) in 0 ms
 Run <anon>
 1-> Hello, world!
 ```
-It's conventional to add a program title to a script:
 
+It's conventional to add a program title to a script:
 ```
 !   Test script
     script Test
     print `Hello, world!`
 ```
 The first line here is just a comment and has no effect on the running of the script.   The second line gives the script a name, which is useful in debugging as it says which script was running. When run, the output is now
-
 ```
 EasyCoder version 250101.1
 Compiled Test: 3 lines (4 tokens) in 0 ms
 Run Test
 3-> Hello, world!
 ```
+
 As you might guess from the above, the print command shows the line in the script it was called from. This is very useful in tracking down debugging print commands in large scripts.
 
 Here in the repository is a folder called `scripts` containing some sample scripts:
@@ -54,13 +56,15 @@ Here in the repository is a folder called `scripts` containing some sample scrip
 
 Graphical scripts look much like any other script but their file names must use the extension `.ecg` to signal to **_EasyCoder_** that it needs to load the graphics module. Non-graphical applications can use any extension but `.ecs` is recommended. This allows the **_EasyCoder_** application to be used wherever Python is installed, in either a command-line or a graphical environment, but graphics will of course not be available in the former.
 
-A couple of demo graphical scripts are included in the `scripts` directory:
+Some demo graphical scripts are included in the `scripts` directory:
 
 `graphics-demo.ecg` shows some of the elements that can be created, and demonstrates a variety of the graphical features of the language such as detecting when elements are clicked.
 
 `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.
+`keyboard.ecg` creates an on-screen keyboard (currently a 4-function calculator keypad) that responds to clicks on its keys. It uses a plugin module (see below) to add extra vocabulary and syntax to the language. This is currently under development so its features are likely to change. The intention is to support a wide range of keyboard styles with the minimum mount of coding. The plugin (`ec_keyword.py`) can be downloaded from the repository.
+
+**_EasyCoder_** graphics are handled by a library module, `ec_renderer` that can be used outside of the **_EasyCoder_** environment, in other Python programs. The renderer works with JSON-formatted specifications of the itens to be displayed.
 
 ## Significant features
 

{easycoder-250109.2 → easycoder-250110.1}/easycoder/__init__.py

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

{easycoder-250109.2 → easycoder-250110.1}/easycoder/ec_renderer.py

@@ -9,8 +9,6 @@ from kivy.clock import Clock
 from kivy.vector import Vector
 import math, os
 
-os.environ['KIVY_TEXT'] = 'pango'
-
 ec_ui = None
 
 def getUI():
@@ -108,53 +106,54 @@ class UI(Widget):
         self.zlist.append(element)
 
     def createElement(self, spec):
-        with self.canvas:
-            if hasattr(spec, 'fill'):
-                c = spec.fill
-                if isinstance(c, str):
-                    c = colormap[c]
-                    Color(c[0], c[1], c[2])
-                else:
-                    Color(c[0]/255, c[1]/255, c[2]/255)
-            size = (getActual(spec.size[0], spec), getActual(spec.size[1], spec))
-            spec.realsize = size
-            # Deal with special case of 'center'
-            if spec.pos[0] == 'center':
-                left = getActual('50w', spec) - spec.realsize[0]/2
-            else:
-                left = getActual(spec.pos[0], spec)
-            if spec.pos[1] == 'center':
-                bottom = getActual('50h', spec) - spec.realsize[1]/2
-            else:
-                bottom = getActual(spec.pos[1], spec)
-            pos = (left, bottom)
-            spec.realpos = pos
-            if spec.parent != None:
-                pos = Vector(pos) + spec.parent.realpos
-            if spec.type == 'ellipse':
-                item = Ellipse(pos=pos, size=size)
-            elif spec.type == 'rectangle':
-                item = Rectangle(pos=pos, size=size)
-            elif spec.type == 'text':
-                if hasattr(spec, 'color'):
-                    c = spec.color
+        size = (getActual(spec.size[0], spec), getActual(spec.size[1], spec))
+        spec.realsize = size
+        # Deal with special case of 'center'
+        if spec.pos[0] == 'center':
+            left = getActual('50w', spec) - spec.realsize[0]/2
+        else:
+            left = getActual(spec.pos[0], spec)
+        if spec.pos[1] == 'center':
+            bottom = getActual('50h', spec) - spec.realsize[1]/2
+        else:
+            bottom = getActual(spec.pos[1], spec)
+        pos = (left, bottom)
+        spec.realpos = pos
+        if spec.parent != None:
+            pos = Vector(pos) + spec.parent.realpos
+        if spec.type != 'hotspot':
+            with self.canvas:
+                if hasattr(spec, 'fill'):
+                    c = spec.fill
                     if isinstance(c, str):
                         c = colormap[c]
                         Color(c[0], c[1], c[2])
                     else:
                         Color(c[0]/255, c[1]/255, c[2]/255)
-                else:
-                    Color(1, 1, 1, 1)
-                if self.font == None:
-                    label = CoreLabel(text=spec.text, font_size=1000, halign='center', valign='center')
-                else:
-                    label = CoreLabel(text=spec.text, font_context = None, font_name=self.font, font_size=1000, halign='center', valign='center')
-                label.refresh()
-                item = Rectangle(pos=pos, size=size, texture=label.texture)
-            elif spec.type == 'image':
-                item = AsyncImage(pos=pos, size=size, source=spec.source)
-            spec.item = item
-            self.addElement(spec.id, spec)
+                if spec.type == 'ellipse':
+                    item = Ellipse(pos=pos, size=size)
+                elif spec.type == 'rectangle':
+                    item = Rectangle(pos=pos, size=size)
+                elif spec.type == 'text':
+                    if hasattr(spec, 'color'):
+                        c = spec.color
+                        if isinstance(c, str):
+                            c = colormap[c]
+                            Color(c[0], c[1], c[2])
+                        else:
+                            Color(c[0]/255, c[1]/255, c[2]/255)
+                    else:
+                        Color(1, 1, 1, 1)
+                    if self.font == None:
+                        label = CoreLabel(text=spec.text, font_size=1000, halign='center', valign='center')
+                    else:
+                        label = CoreLabel(text=spec.text, font_context = None, font_name=self.font, font_size=1000, halign='center', valign='center')
+                    label.refresh()
+                    item = Rectangle(pos=pos, size=size, texture=label.texture)
+                elif spec.type == 'image':
+                    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)
@@ -185,19 +184,19 @@ class UI(Widget):
         for element in reversed(self.zlist):
             if element.actionCB != None:
                 spec = element.spec
-                pos = spec.realpos
+                pos = element.getPos()
                 size = element.getSize()
                 if spec.type == 'ellipse':
                     a = int(size[0])/2
                     b = int(size[1])/2
-                    ctr = (pos[0] + a, pos[1] +b)
+                    ctr = (pos[0]+a, pos[1]+b)
                     h = ctr[0]
                     k = ctr[1]
                     if (math.pow((x - h), 2) / math.pow(a, 2)) + (math.pow((y - k), 2) / math.pow(b, 2)) <= 1:
                         element.actionCB(element.data)
                         break
-                elif spec.type in ['rectangle', 'text', 'image']:
-                    if tp[0] >= pos[0] and tp[0] < pos[0] + size[0] and tp[1] >= pos[1] and tp[1] < pos[1] + size[1]:
+                elif spec.type in ['rectangle', 'text', 'image', 'hotspot']:
+                    if x >= pos[0] and x < pos[0] + size[0] and y >= pos[1] and y < pos[1] + size[1]:
                         element.actionCB(element.data)
                         break
 

{easycoder-250109.2 → easycoder-250110.1}/easycoder/ec_screenspec.py

@@ -58,16 +58,16 @@ class ScreenSpec():
 
     # Render a complete specification
     def renderSpec(self, spec, parent):
-        if 'font' in spec: getUI().font = spec['font']
-        else: getUI().font = None
-        widgets = spec['#']
-        # If a list, iterate it
-        if isinstance(widgets, list):
-            for widget in widgets:
-                self.createWidget(spec[widget], parent)
-        # Otherwise, process the single widget
+        if 'type' in spec: self.createWidget(spec, parent)
         else:
-            self.createWidget(spec[widgets], parent)
+            widgets = spec['#']
+            # If a list, iterate it
+            if isinstance(widgets, list):
+                for widget in widgets:
+                    self.createWidget(spec[widget], parent)
+            # Otherwise, process the single widget
+            else:
+                self.createWidget(spec[widgets], parent)
 
     # Render a graphic specification
     def render(self, spec, parent):

easycoder-250110.1/plugins/ec_keyboard.py

@@ -0,0 +1,191 @@
+from easycoder import Object, FatalError, RuntimeError
+from easycoder import Handler
+from easycoder import getConstant
+from easycoder.ec_screenspec import ScreenSpec
+from easycoder.ec_renderer import getActual, getUI
+import json
+
+class Keyboard(Handler):
+
+    def __init__(self, compiler):
+        Handler.__init__(self, compiler)
+        self.keyboard = None
+        self.key = None
+        self.onTap = None
+
+    def getName(self):
+        return 'keyboard'
+
+    #############################################################################
+    # Keyword handlers
+
+    # on click/tap keyboard
+    def k_on(self, command):
+        token = self.nextToken()
+        if token in ['click', 'tap']:
+            if self.nextIs('keyboard'):
+                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
+
+     # Set a handler
+    def r_on(self, command):
+        self.onTap = command['goto']
+        return self.nextPC()
+
+    # Render a keyboard
+    # render keyboard {layout) at {left} {bottom} width {width}
+    def k_render(self, command):
+        if self.nextIs('keyboard'):
+            command['layout'] = self.nextValue()
+            x = getConstant('10w')
+            y = getConstant('10h')
+            w = getConstant('50w')
+            token = self.peek()
+            while token in ['at', 'width']:
+                    self.nextToken()
+                    if token == 'at':
+                        x = self.nextValue()
+                        y = self.nextValue()
+                    elif token == 'width':
+                        w = self.nextValue()
+                    token = self.peek()
+            command['x'] = x
+            command['y'] = y
+            command['w'] = w
+            self.add(command)
+            return True
+        return False
+
+    def r_render(self, command):
+        self.keyboard = Object()
+        layout = self.getRuntimeValue(command['layout'])
+        with open(f'{layout}') as f: spec = f.read()
+        self.keyboard.layout = json.loads(spec)
+        layout = self.keyboard.layout[0]
+        x = getActual(self.getRuntimeValue(command['x']))
+        y = getActual(self.getRuntimeValue(command['y']))
+        w = getActual(self.getRuntimeValue(command['w']))
+        # Scan the keyboard layout to find the longest row
+        max = 0
+        rows = self.keyboard.layout[0]['rows']
+        nrows = len(rows)
+        for r in range(0, nrows):
+            row = rows[r]
+            # Count the number of buttons
+            count = 0.0
+            for n in range(0, len(row)):
+                key = row[n]
+                if 'span' in key: count += float(key['span'])
+                else: count += 1.0
+            if count > max: max = count
+        # Divide the keyboard width by the number of buttons to get the button size
+        # The basic key is always a square
+        bs = w / max
+        # Compute the keyboard height
+        h = bs * nrows
+        # Build the spec
+        spec = {}
+        spec['type'] = 'image'
+        spec['id'] = 'face'
+        spec['source'] = layout['face']
+        spec['left'] = x
+        spec['bottom'] = y
+        spec['width'] = w
+        spec['height'] = h
+        buttons = []
+        list = []
+        by = h
+        for r in range(0, nrows):
+            by -= bs
+            row = rows[r]
+            bx = 0
+            for b in range(0, len(row)):
+                button = row[b]
+                id = button['id']
+                if 'span' in button: span = float(button['span'])
+                else: span = 1.0
+                width = bs * span
+                button['type'] = 'hotspot'
+                button['left'] = bx
+                button['bottom'] = by
+                button['width'] = width
+                button['height'] = bs
+                button['parent'] = spec
+                buttons.append(button)
+                list.append(id)
+                bx += width
+        spec['#'] = list
+        for n in range(0, len(list)):
+            spec[list[n]] = buttons[n]
+        try:
+            ScreenSpec().render(spec, None)
+        except Exception as e:
+            RuntimeError(self.program, e)
+
+        # Add a callback to each button
+        def oncb(id):
+            self.key = id
+            if self.onTap != None:
+                self.program.run(self.onTap)
+        for b in range(0, len(list)):
+            id = list[b]
+            getUI().setOnClick(id, id, oncb)
+
+        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()
+
+        if kwd == 'key':
+            value['type'] = kwd
+            return value
+        return None
+
+    #############################################################################
+    # Value handlers
+
+    def v_key(self, v):
+        value = {}
+        value['type'] = 'text'
+        value['content'] = self.key
+        return value
+
+    #############################################################################
+    # Compile a condition in this domain
+    def compileCondition(self):
+        condition = {}
+        return condition
+
+    #############################################################################
+    # Condition handlers

easycoder-250110.1/plugins/keyboards/4-function.json

@@ -0,0 +1,64 @@
+[
+    {
+        "face": "plugins/keyboards/4-function.png",
+        "rows":
+            [
+                [
+                    {
+                        "id": "1"
+                    },
+                    {
+                        "id": "2"
+                    },
+                    {
+                        "id": "3"
+                    },
+                    {
+                        "id": "+"
+                    }
+                ],
+                [
+                    {
+                        "id": "4"
+                    },
+                    {
+                        "id": "5"
+                    },
+                    {
+                        "id": "6"
+                    },
+                    {
+                        "id": "-"
+                    }
+                ],
+                [
+                    {
+                        "id": "7"
+                    },
+                    {
+                        "id": "8"
+                    },
+                    {
+                        "id": "9"
+                    },
+                    {
+                        "id": "*"
+                    }
+                ],
+                [
+                    {
+                        "id": "0"
+                    },
+                    {
+                        "id": "C"
+                    },
+                    {
+                        "id": "="
+                    },
+                    {
+                        "id": "/"
+                    }
+                ]
+            ]
+    }
+]