easycoder 241211.2__tar.gz → 241215.1__tar.gz

easycoder-241215.1/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.3
+Name: easycoder
+Version: 241215.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>
+Description-Content-Type: text/markdown
+Classifier: License :: OSI Approved :: MIT License
+Requires-Dist: pytz
+Project-URL: Home, https://github.com/easycoder/easycoder-py
+
+# Introduction
+This is the Python version of **_EasyCoder_**, a high-level English-like scripting language suited for prototyping and rapid testing of ideas. It operates on the command line.
+
+The JavaScript version of **_EasyCoder_**, which provides a full set of graphical features to run in a browser, is at
+
+Repository: [https://github.com/easycoder/easycoder.github.io](https://github.com/easycoder/easycoder.github.io)  
+Website: [https://easycoder.github.io](https://easycoder.github.io)
+
+## Quick Start
+Install **_EasyCoder_** in your Python environment:
+```
+pip install easycoder
+```
+Write a test script, 'hello.ecs', containing the following:
+```
+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:
+
+```
+EasyCoder version 5
+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:
+
+```
+!   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 5
+Compiled Test: 5 lines (4 tokens) in 0 ms
+Run Test
+5-> Hello, world!
+```
+As you can guess from the above, the print command gives 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:
+
+`benchmark.ecs` allows the performance of EasyCoder to be compared to other languages if a similar program is written for each one  
+`tests.ecs` is a test program containing many of the EasyCoder features  
+`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`.
+
+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
+
+The language comprises a general-purpose core package, which can be enhanced by plugins to provide special features on demand.
+
+[The core package](doc/README.md)
+
+## Extending the language
+
+**_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_**
+

easycoder-241211.2/PKG-INFO → easycoder-241215.1/README.md

@@ -1,19 +1,9 @@
-Metadata-Version: 2.3
-Name: easycoder
-Version: 241211.2
-Summary: EasyCoder for Python
-Author-email: Graham Trott <gtanyware@gmail.com>
-Description-Content-Type: text/markdown
-Classifier: License :: OSI Approved :: MIT License
-Requires-Dist: pytz
-Project-URL: Home, https://github.com/easycoder
-
 # Introduction
 This is the Python version of **_EasyCoder_**, a high-level English-like scripting language suited for prototyping and rapid testing of ideas. It operates on the command line.
 
 The JavaScript version of **_EasyCoder_**, which provides a full set of graphical features to run in a browser, is at
 
-Repository: [https://github.com/easycoder/easycoder.github.io](https://github.com/easycoder/easycoder.github.io)
+Repository: [https://github.com/easycoder/easycoder.github.io](https://github.com/easycoder/easycoder.github.io)  
 Website: [https://easycoder.github.io](https://easycoder.github.io)
 
 ## Quick Start
@@ -58,14 +48,19 @@ Here in the repository is a folder called `scripts` containing some sample scrip
 `tests.ecs` is a test program containing many of the EasyCoder features  
 `fizzbuzz.ecs` is a simple programming challenge often given at job interviews
 
-## The EasyCoder programming language
-There are three primary components to the language:
+## 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.
 
- - Keywords
- - Values
- - Conditions
+## EasyCoder programming reference
 
 The language comprises a general-purpose core package, which can be enhanced by plugins to provide special features on demand.
 
-[The core package](doc/core.md)
+[The core package](doc/README.md)
+
+## Extending the language
+
+**_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_**

easycoder-241215.1/doc/README.md

@@ -0,0 +1,20 @@
+# The 'core' package
+
+There are three primary components to the language:
+
+ - Keywords
+ - Values
+ - Conditions
+
+The core package contains all the keywords values and conditionals needed for general programming, and in most cases these are all that will be needed.
+
+The core keywords are:
+
+[add](core/add.md) [append](core/append.md) [assert](core/assert.md) [begin](core/begin.md) [clear](core/clear.md) [close](core/close.md) [create](core/create.md) [debug](core/debug.md) [decrement](core/decrement.md) [delete](core/delete.md) [divide](core/divide.md) [exit](core/exit.md) [file](core/file.md) [fork](core/fork.md) [get](core/get.md) [go](core/go.md) [gosub](core/gosub.md) [if](core/if.md) [import](core/import.md) [increment](core/increment.md) [index](core/index.md) [init](core/init.md) [input](core/input.md) [multiply](core/multiply.md) [open](core/open.md) [pop](core/pop.md) [post](core/post.md) [print](core/print.md) [push](core/push.md) [put](core/put.md) [read](core/read.md) [replace](core/replace.md) [return](core/return.md) [script](core/script.md) [set](core/set.md) [split](core/split.md) [stack](core/stack.md) [stop](core/stop.md) [system](core/system.md) [take](core/take.md) [toggle](core/toggle.md) [truncate](core/truncate.md) [variable](core/variable.md) [wait](core/wait.md) [while](core/while.md) [write](core/write.md)
+
+The core values are:
+
+
+The core conditions are:
+
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/add.md

@@ -10,4 +10,4 @@ Adds a numeric value to a numeric variable or adds two values and puts the resul
 Next: [append](append.md)  
 Prev: [write](write.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/append.md

@@ -10,4 +10,4 @@ Appends an item to a JSON array, which is is a string value held in a single var
 Next: [assert](assert.md)  
 Prev: [add](add.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/assert.md

@@ -8,4 +8,4 @@ Tests the condition and throws an exception if it is not true.
 Next: [begin](begin.md)  
 Prev: [append](append.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/begin.md

@@ -12,4 +12,4 @@
 Next: [clear](clear.md)  
 Prev: [assert](assert.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/clear.md

@@ -10,4 +10,4 @@
 Next: [close](close.md)  
 Prev: [begin](begin.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/close.md

@@ -8,4 +8,4 @@ Close the file identified by the `{file}` variable. See `file`, `open`, `read` a
 Next: [create](create.md)  
 Prev: [clear](clear.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/create.md

@@ -8,4 +8,4 @@ Create a directory, giving the full path in `{name}`.
 Next: [debug](debug.md)  
 Prev: [close](close.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/debug.md

@@ -13,4 +13,4 @@ Set up a debug option.
 Next: [decrement](decrement.md)  
 Prev: [create](create.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/decrement.md

@@ -8,4 +8,4 @@ Decrements the value of the variable by 1. See also [increment](increment.md)
 Next: [delete](delete.md)  
 Prev: [debug](debug.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/delete.md

@@ -13,4 +13,4 @@ The second form deletes a named property of an object. See also [set property](s
 Next: [divide](divide.md)  
 Prev: [decrement](decrement.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/divide.md

@@ -11,4 +11,4 @@ Divides a numeric variable by a numeric value or divides one value by another an
 Next: [exit](exit.md)  
 Prev: [delete](delete.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/exit.md

@@ -8,4 +8,4 @@ Terminate the program.
 Next: [file](file.md)  
 Prev: [divide](divide.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/file.md

@@ -11,4 +11,4 @@ Declare a file variable. See [open](open.md), [read](read.md), [write](write.md)
 Next: [fork](fork.md)  
 Prev: [exit](exit.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/fork.md

@@ -10,4 +10,4 @@ When `fork` is used, the forked commands run until they reach a [stop](stop.md)
 Next: [get](get.md)  
 Prev: [exit](exit.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/get.md

@@ -12,4 +12,4 @@ Perform an HTTP GET to request data. In the second example, if the request fails
 Next: [gosub](gosub.md)  
 Prev: [fork](fork.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/go.md

@@ -10,4 +10,4 @@
 Next: [gosub](gosub.md)  
 Prev: [get](get.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/gosub.md

@@ -9,4 +9,4 @@
 Next: [if](if.md)  
 Prev: [go](go.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/if.md

@@ -8,7 +8,7 @@
 ## Description:
 `if` tests the condition that follows. If the result is `true` then control resumes at the named label; otherwise if there's an `else` section this is executed, then the program resumes at the next instruction after the `if`. See also [while](while.md).
 
-Next: [increment](increment.md)  
+Next: [import](import.md)  
 Prev: [gosub](gosub.md)
 
-[Back](../core.md)
+[Back](../README.md)

easycoder-241215.1/doc/core/import.md

@@ -0,0 +1,13 @@
+## Syntax:
+`import {classname} from {path}`
+
+## Examples:
+`import Points from plugins/example.py`
+
+## Description:
+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.
+
+Next: [increment](increment.md)  
+Prev: [if](if.md)
+
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/increment.md

@@ -8,6 +8,6 @@
 Add 1 to the value of the variable. See also [decrement](decrement.md).
 
 Next: [index](index.md)  
-Prev: [if](if.md)
+Prev: [import](import.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/index.md

@@ -12,4 +12,4 @@
 Next: [init](init.md)  
 Prev: [increment](increment.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/init.md

@@ -11,4 +11,4 @@
 Next: [input](input.md)  
 Prev: [index](index.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/input.md

@@ -10,4 +10,4 @@
 Next: [multiply](multiply.md)  
 Prev: [init](init.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/multiply.md

@@ -11,4 +11,4 @@ Multiplies a numeric variable by a numeric value or multiplies one value by anot
 Next: [open](open.md)  
 Prev: [input](input.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/open.md

@@ -22,4 +22,4 @@ Opens a disk file for reading, writing or appending. Each of the [file](file.md)
 Next: [pop](pop.md)  
 Prev: [multiply](multiply.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/pop.md

@@ -9,4 +9,4 @@ Pops the top value from the specified [stack](stack.md).
 Next: [post](post.md)  
 Prev: [open](open.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/post.md

@@ -14,4 +14,4 @@ Perform an HTTP PUT request with the specified data and endpoint, optionally sav
 Next: [print](print.md)  
 Prev: [pop](pop.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/print.md

@@ -11,4 +11,4 @@ The output is prefixed by the script line number of the print command. This is v
 Next: [push](push.md)  
 Prev: [post](post.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/push.md

@@ -10,4 +10,4 @@ Push something onto the specified [stack](stack.md).
 Next: [put](put.md)  
 Prev: [print](print.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/put.md

@@ -10,4 +10,4 @@ Put a value into a [variable](variable.md). The second example illustrates how t
 Next: [read](read.md)  
 Prev: [push](push.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/read.md

@@ -9,4 +9,4 @@ Read a value from a [file](file.md). See [open](open.md), [write](write.md) and
 Next: [replace](replace.md)  
 Prev: [put](put.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/replace.md

@@ -10,4 +10,4 @@ Replaces all occurrences of one string with another in a string [variable](varia
 Next: [return](return.md)  
 Prev: [read](read.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/return.md

@@ -9,4 +9,4 @@ Return from a subroutine. See [gosub](gosub.md).
 Next: [script](script.md)  
 Prev: [replace](replace.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/script.md

@@ -9,4 +9,4 @@ Provides a name for the script. Note that `name` is literal text, not a script v
 Next: [set](set.md)  
 Prev: [return](return.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/set.md

@@ -22,4 +22,4 @@
 Next: [split](split.md)  
 Prev: [script](script.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/split.md

@@ -10,4 +10,4 @@ Split a [variable](variable.md) containing a string into a number of parts on a
 Next: [stack](stack.md)  
 Prev: [set](set.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/stack.md

@@ -10,4 +10,4 @@ Declares a stack variable, a special kind of array that permits elements to be [
 Next: [stop](stop.md)  
 Prev: [split](split.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/stop.md

@@ -12,4 +12,4 @@ Stop execution of the current thread. The program will not exit as there may be
 Next: [system](system.md)  
 Prev: [stack](stack.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/system.md

@@ -10,4 +10,4 @@ Issue a command to the operating system.
 Next: [take](take.md)  
 Prev: [stop](stop.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/take.md

@@ -12,4 +12,4 @@ Subtracts a numeric value from a numeric variable or subtracts one value from an
 Next: [toggle](toggle.md)  
 Prev: [system](system.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/toggle.md

@@ -10,4 +10,4 @@ Toggle - change from `true` to `false` or vice versa - a variable that has been
 Next: [variable](variable.md)  
 Prev: [take](take.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/truncate.md

@@ -11,4 +11,4 @@ Truncate a file
 Next: [variable](variable.md)  
 Prev: [toggle](toggle.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/variable.md

@@ -12,4 +12,4 @@ Variables can be assigned any number of elements - see [set the elements](set.md
 Next: [wait](wait.md)  
 Prev: [toggle](toggle.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/wait.md

@@ -15,4 +15,4 @@ By "thread" we mean the pseudo-threads **_EasyCoder_** uses to simulate multi-ta
 Next: [while](while.md)  
 Prev: [variable](variable.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/while.md

@@ -17,4 +17,4 @@ When constructing loops like this it's common for programmers to forget to bump
 Next: [write](write.md)  
 Prev: [wait](wait.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/doc/core/write.md

@@ -10,4 +10,4 @@ Write a value to a [file](file.md). See [open](open.md), [read](read.md) and [cl
 Next: [add](add.md)  
 Prev: [while](while.md)
 
-[Back](../core.md)
+[Back](../README.md)

{easycoder-241211.2 → easycoder-241215.1}/easycoder/__init__.py

@@ -8,5 +8,6 @@ from .ec_handler import *
 from .ec_program import *
 from .ec_timestamp import *
 from .ec_value import *
+from .ec_graphics import *
 
-__version__ = "241211.2"
+__version__ = "241215.1"

{easycoder-241211.2 → easycoder-241215.1}/easycoder/ec_classes.py

@@ -9,11 +9,14 @@ class FatalError:
 		sys.exit()
 
 class AssertionError:
-	def __init__(self, program):
+	def __init__(self, program, msg=None):
 		code = program.code[program.pc]
 		lino = code['lino']
 		script = program.script.lines[lino].strip()
-		print(f'Assertion Error in {program.name} at line {lino + 1}')
+		message = f'Assertion Error in {program.name} at line {lino + 1}'
+		if msg != None:
+			message += f': {msg}'
+		print(message)
 		sys.exit()
 
 class RuntimeError:

{easycoder-241211.2 → easycoder-241215.1}/easycoder/ec_compiler.py

@@ -101,7 +101,7 @@ class Compiler:
 
 	def showWarnings(self):
 		for warning in self.warnings:
-			print(f'Line {self.getLino() + 1}: {warning}')
+			print(f'Warning: Line {self.getLino() + 1}: {warning}')
 
 	def getSymbolRecord(self):
 		token = self.getToken()