easycoder 4__py2.py3-none-any.whl → 241211.1__py2.py3-none-any.whl

easycoder/__init__.py

@@ -9,4 +9,4 @@ from .ec_program import *
 from .ec_timestamp import *
 from .ec_value import *
 
-__version__ = "4"
+__version__ = "241211.1"

easycoder/ec_compiler.py

@@ -6,7 +6,6 @@ class Compiler:
 
 	def __init__(self, program):
 		self.program = program
-		self.domains = self.program.domains
 		self.value = Value(self)
 		self.condition = Condition(self)
 		self.marker = 0
@@ -142,11 +141,11 @@ class Compiler:
 	# Compile the current token
 	def compileToken(self):
 		token = self.getToken()
-		# print(f'Compile {token}')
+#		print(f'Compile {token}')
 		if not token:
 			return False
 		mark = self.getIndex()
-		for domain in self.domains:
+		for domain in self.program.getDomains():
 			handler = domain.keywordHandler(token)
 			if handler:
 				command = {}
@@ -163,7 +162,6 @@ class Compiler:
 			else:
 				self.rewindTo(mark)
 		FatalError(self, f'No handler found for "{token}"')
-		return False
 
 	# Compile a single command
 	def compileOne(self):

easycoder/ec_condition.py

@@ -1,7 +1,7 @@
 class Condition:
 
 	def __init__(self, compiler):
-		self.domains = compiler.domains
+		self.compiler = compiler
 		self.getToken = compiler.getToken
 		self.nextToken = compiler.nextToken
 		self.peek = compiler.peek
@@ -12,7 +12,7 @@ class Condition:
 
 	def compileCondition(self):
 		mark = self.getIndex()
-		for domain in self.domains:
+		for domain in self.compiler.program.getDomains():
 			condition = domain.compileCondition()
 			if condition != None:
 				condition.domain= domain.getName()

easycoder/ec_core.py

@@ -18,6 +18,7 @@ class Core(Handler):
     # Keyword handlers
 
     # Arithmetic add
+    # add {value} to {variable}[ giving {variable}]}
     def k_add(self, command):
         # Get the (first) value
         command['value1'] = self.nextValue()
@@ -79,6 +80,7 @@ class Core(Handler):
         return self.nextPC()
 
     # Append a value to an array
+    # append {value} to {array}
     def k_append(self, command):
         command['value'] = self.nextValue()
         if self.nextIs('to'):
@@ -111,8 +113,14 @@ class Core(Handler):
         return self.nextPC()
 
     # Assertion
+    #assert {condition} [with {message}]
     def k_assert(self, command):
         command['test'] = self.nextCondition()
+        if self.peek() == 'with':
+            self.nextToken()
+            command['with'] = self.nextValue()
+        else:
+            command['with'] = None
         self.addCommand(command)
         return True
 
@@ -120,7 +128,7 @@ class Core(Handler):
         test = self.program.condition.testCondition(command['test'])
         if test:
             return self.nextPC()
-        AssertionError(self.program)
+        AssertionError(self.program, self.getRuntimeValue(command['with']))
 
     # Begin a block
     def k_begin(self, command):
@@ -136,6 +144,7 @@ class Core(Handler):
             return self.compileFromHere(['end'])
 
     # Clear (set False)
+    # clear {variable}
     def k_clear(self, command):
         if self.nextIsSymbol():
             target = self.getSymbolRecord()
@@ -155,6 +164,7 @@ class Core(Handler):
         return self.nextPC()
 
     # Close a file
+    # close {file}
     def k_close(self, command):
         if self.nextIsSymbol():
             fileRecord = self.getSymbolRecord()
@@ -170,6 +180,7 @@ class Core(Handler):
         return self.nextPC()
 
     #Create directory
+    # create directory {name}
     def k_create(self, command):
         if self.nextIs('directory'):
             command['item'] = 'directory'
@@ -229,6 +240,7 @@ class Core(Handler):
         return self.nextPC()
 
     # Decrement a variable
+    # decrement {variable}
     def k_decrement(self, command):
         if self.nextIsSymbol():
             symbolRecord = self.getSymbolRecord()
@@ -243,6 +255,8 @@ class Core(Handler):
         return self.incdec(command, '-')
 
     # Delete a file or a property
+    # delete {filename}
+    # delete property {value} of {variable}
     def k_delete(self, command):
         token = self.nextToken( )
         if token == 'file':
@@ -281,6 +295,7 @@ class Core(Handler):
         return self.nextPC()
 
     # Arithmetic division
+    # divide {variable} by {value}[ giving {variable}]}
     def k_divide(self, command):
         # Get the (first) value
         command['value1'] = self.nextValue()
@@ -381,6 +396,7 @@ class Core(Handler):
         return next
 
     # Issue a REST GET request
+    # get {variable) from {url} [or {command}]
     def k_get(self, command):
         if self.nextIsSymbol():
             symbolRecord = self.getSymbolRecord()
@@ -490,7 +506,7 @@ class Core(Handler):
     def r_gotoPC(self, command):
         return command['goto']
 
-    # If <condition> <action> [else <action>]
+    # if <condition> <action> [else <action>]
     def k_if(self, command):
         command['condition'] = self.nextCondition()
         self.addCommand(command)
@@ -536,6 +552,16 @@ class Core(Handler):
             self.program.pc += 1
         return self.program.pc
 
+    # Import a plugin. This is done at compile time.
+    # import {class} from {source}
+    def k_import(self, command):
+        clazz = self.nextToken()
+        if self.nextIs('from'):
+            source = self.nextToken()
+            self.program.importPlugin(f'{source}:{clazz}')
+            return True
+        return False
+
     # Increment a variable
     def k_increment(self, command):
         if self.nextIsSymbol():
@@ -551,6 +577,7 @@ class Core(Handler):
         return self.incdec(command, '+')
 
     # Index to a specified element in a variable
+    # index {variable} to {value}
     def k_index(self, command):
         # get the variable
         if self.nextIsSymbol():
@@ -567,7 +594,31 @@ class Core(Handler):
         symbolRecord['index'] = self.getRuntimeValue(command['value'])
         return self.nextPC()
 
+    # Initialise a stack, array or object
+    def k_init(self, command):
+        # get the variable
+        if self.nextIsSymbol():
+            symbolRecord = self.getSymbolRecord()
+            keyword = symbolRecord['keyword']
+            if keyword in ['stack','array', 'object']:
+                command['keyword'] = keyword
+                command['target'] = symbolRecord['name']
+                return True
+        return False
+
+    def r_init(self, command):
+        symbolRecord = self.getVariable(command['target'])
+        keyword = command['keyword']
+        if keyword in ['stack', 'array']:
+            self.putSymbolValue(symbolRecord, json.loads('[]'))
+        elif keyword == 'object':
+            self.putSymbolValue(symbolRecord, json.loads('{}'))
+        else:
+            RuntimeError(self.program, f"Inappropriate variable type '{keyword}'")
+        return self.nextPC()
+
     # Inout a value from the terminal
+    # input {variable} [with {prompt}]
     def k_input(self, command):
         # get the variable
         if self.nextIsSymbol():
@@ -594,30 +645,8 @@ class Core(Handler):
         self.putSymbolValue(symbolRecord, value)
         return self.nextPC()
 
-    # Initialise a stack, array or object
-    def k_init(self, command):
-        # get the variable
-        if self.nextIsSymbol():
-            symbolRecord = self.getSymbolRecord()
-            keyword = symbolRecord['keyword']
-            if keyword in ['stack','array', 'object']:
-                command['keyword'] = keyword
-                command['target'] = symbolRecord['name']
-                return True
-        return False
-
-    def r_init(self, command):
-        symbolRecord = self.getVariable(command['target'])
-        keyword = command['keyword']
-        if keyword in ['stack', 'array']:
-            self.putSymbolValue(symbolRecord, json.loads('[]'))
-        elif keyword == 'object':
-            self.putSymbolValue(symbolRecord, json.loads('{}'))
-        else:
-            RuntimeError(self.program, f"Inappropriate variable type '{keyword}'")
-        return self.nextPC()
-
     # Arithmetic multiply
+    # multiply {variable} by {value}[ giving {variable}]}
     def k_multiply(self, command):
         # Get the (first) value
         command['value1'] = self.nextValue()
@@ -675,6 +704,7 @@ class Core(Handler):
         return self.nextPC()
 
     # Open a file
+    # open {file} for reading/writing/appending
     def k_open(self, command):
         if self.nextIsSymbol():
             symbolRecord = self.getSymbolRecord()
@@ -711,6 +741,7 @@ class Core(Handler):
         RuntimeError(self.program, f"File {path} does not exist")
 
     # Pop a value from a stack
+    # pop {variable} from {stack}
     def k_pop(self, command):
         if (self.nextIsSymbol()):
             symbolRecord = self.getSymbolRecord()
@@ -738,6 +769,7 @@ class Core(Handler):
         return self.nextPC()
 
     # Perform an HTTP POST
+    # post {value} to {url} [giving {variable}] [or {command}]
     def k_post(self, command):
         if self.nextIs('to'):
             command['value'] = self.getConstant('')
@@ -825,6 +857,7 @@ class Core(Handler):
         return self.nextPC()
 
     # Push a value onto a stack
+    # push {value} to/onto {stack}
     def k_push(self, command):
         value = self.nextValue()
         command['value'] = value
@@ -853,6 +886,7 @@ class Core(Handler):
         return self.nextPC()
 
     # Put a value into a variable
+    # put {value} into {variable}
     def k_put(self, command):
         command['value'] = self.nextValue()
         if self.nextIs('into'):
@@ -880,6 +914,7 @@ class Core(Handler):
         return self.nextPC()
 
     # Read from a file
+    # read {variable} from {file}
     def k_read(self, command):
         if self.peek() == 'line':
             self.nextToken()
@@ -918,6 +953,7 @@ class Core(Handler):
         return self.nextPC()
 
     # Replace a substring
+    #replace {value} with {value} in {variable}
     def k_replace(self, command):
         original = self.nextValue()
         if self.peek() == 'with':
@@ -960,6 +996,9 @@ class Core(Handler):
         return True
 
     # Set a value
+    # set {variable}
+    # set the elements of {variable} to {value}
+    # set element/property of {variable} to {value}
     def k_set(self, command):
         if self.nextIsSymbol():
             target = self.getSymbolRecord()
@@ -1074,6 +1113,7 @@ class Core(Handler):
             return self.nextPC()
 
     # Split a string into a variable with several elements
+    # split {variable} on {value}
     def k_split(self, command):
         if self.nextIsSymbol():
             symbolRecord = self.getSymbolRecord()
@@ -1128,6 +1168,7 @@ class Core(Handler):
         return 0
 
     # Issue a system call
+    # system {command}
     def k_system(self, command):
         background = False
         token = self.nextToken()
@@ -1154,6 +1195,7 @@ class Core(Handler):
             return self.nextPC()
 
     # Arithmetic subtraction
+    # take {value} from {variable}[ giving {variable}]}
     def k_take(self, command):
         # Get the (first) value
         command['value1'] = self.nextValue()
@@ -1281,7 +1323,7 @@ class Core(Handler):
         threading.Timer(value/1000.0, lambda: (self.run(next))).start()
         return 0
 
-    # While <condition> <action>
+    # while <condition> <action>
     def k_while(self, command):
         code = self.nextCondition()
         if code == None:

easycoder/ec_program.py

@@ -10,23 +10,10 @@ from importlib.metadata import version
 class Program:
 
 	def __init__(self, argv):
-		print(f'EasyCoder version {version('easycoder')}')
+		print(f'EasyCoder version {version("easycoder")}')
 		scriptName = None
-		domains=[Core]
 		if len(argv)>0:
 			scriptName = argv[0]
-			# Process any extra modules needed
-			for n in range(1, len(argv)):
-				args=argv[n].split(':')
-				idx=args[0].rfind('/')
-				if idx<0:
-					modue=args[0]
-				else:
-					sys.path.append(args[0][0:idx])
-					module=args[0][idx+1:]
-				module = importlib.import_module(module.replace('/','.').replace('.py',''))
-				myClass = getattr(module, args[1])
-				domains.append(myClass)
 		else:
 			print('No script supplied')
 			exit();
@@ -36,6 +23,7 @@ class Program:
 		source = f.read()
 		f.close()
 		self.argv = argv
+		self.classes=[Core]
 		self.domains = []
 		self.domainIndex = {}
 		self.name = '<anon>'
@@ -44,15 +32,12 @@ class Program:
 		self.onError = 0
 		self.pc = 0
 		self.debugStep = False
-		self.script = Script(source)
 		self.stack = []
+		self.script = Script(source)
 		self.compiler = Compiler(self)
 		self.value = self.compiler.value
 		self.condition = self.compiler.condition
-		for domain in domains:
-			handler = domain(self.compiler)
-			self.domains.append(handler)
-			self.domainIndex[handler.getName()] = handler
+		self.processClasses()
 		self.queue = deque()
 
 		startCompile = time.time()
@@ -74,6 +59,33 @@ class Program:
 			self.compiler.showWarnings()
 			return
 
+	# Import a plugin
+	def importPlugin(self, source):
+		args=source.split(':')
+		idx=args[0].rfind('/')
+		if idx<0:
+			module=args[0]
+		else:
+			sys.path.append(args[0][1:idx])
+			module=args[0][idx+1:len(args[0])-1]
+		module = module.replace('/','.').replace('.py','')
+		module = importlib.import_module(module)
+		plugin = getattr(module, args[1][1:len(args[1])-1])
+		self.classes.append(plugin)
+		self.processClasses()
+
+	# Process the class list to get the domains
+	def processClasses(self):
+		self.domains=[]
+		for clazz in self.classes:
+			handler = clazz(self.compiler)
+			self.domains.append(handler)
+			self.domainIndex[handler.getName()] = handler
+	
+	# Get the domain list
+	def getDomains(self):
+		return self.domains
+
 	# Add a command to the code list
 	def add(self, command):
 		self.code.append(command)

easycoder/ec_value.py

@@ -4,7 +4,6 @@ class Value:
 
 	def __init__(self, compiler):
 		self.compiler = compiler
-		self.domains = compiler.domains
 		self.getToken = compiler.getToken
 		self.nextToken = compiler.nextToken
 		self.peek = compiler.peek
@@ -47,7 +46,7 @@ class Value:
 
 		# See if any of the domains can handle it
 		mark = self.compiler.getIndex()
-		for domain in self.domains:
+		for domain in self.compiler.program.getDomains():
 			item = domain.compileValue()
 			if item != None:
 				return item
@@ -77,7 +76,7 @@ class Value:
 			value = item
 
 	# See if any domain has something to add to the value
-		for domain in self.domains:
+		for domain in self.compiler.program.getDomains():
 			value = domain.modifyValue(value)
 
 		return value

easycoder-241211.1.dist-info/METADATA

@@ -0,0 +1,71 @@
+Metadata-Version: 2.3
+Name: easycoder
+Version: 241211.1
+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)
+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
+
+## The EasyCoder programming language
+There are three primary components to the language:
+
+ - Keywords
+ - Values
+ - Conditions
+
+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)
+

easycoder-241211.1.dist-info/RECORD

@@ -0,0 +1,14 @@
+easycoder/__init__.py,sha256=eOqNGCU4g6MwlxDersMEb_FgzxfIYAg7EK3zmX6ZTjs,262
+easycoder/ec_classes.py,sha256=onBKF6Lj8BZKNuJKacx4HyhOrVLXsoHdzl6RnMf77uM,1413
+easycoder/ec_compiler.py,sha256=1z5U92uzUdCOO5-k0VXLnU581iAhwzQga04kfdTlpMY,4629
+easycoder/ec_condition.py,sha256=WSbONo4zs2sX1icOVpscZDFSCAEFmTsquoc2RGcLx_k,763
+easycoder/ec_core.py,sha256=AnPrSJ4oUIOFGV0iF6KxE3AmEb9NG77ae0KwoyvafYs,76175
+easycoder/ec_handler.py,sha256=WDDIz0awD3vSQZ149rgbUWsClt6zXqED8ByXQJ5p1Ds,2200
+easycoder/ec_program.py,sha256=_tfAS_p9JBk6aH9ZOzsrf_xuSNyTdy7yqxJ5ER-AJfw,7890
+easycoder/ec_timestamp.py,sha256=_3QFJPzIWZ9Rzk3SQOQJ-gwmvB07pg78k23SPntoZtY,288
+easycoder/ec_value.py,sha256=aOvSF6bM1iKpcLLm0zyGerxHixBkyjE3iYl1Bx6jmzU,2381
+easycoder-241211.1.dist-info/entry_points.txt,sha256=JXAZbenl0TnsIft2FcGJbJ-4qoztVu2FuT8PFmWFexM,44
+easycoder-241211.1.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+easycoder-241211.1.dist-info/WHEEL,sha256=ssQ84EZ5gH1pCOujd3iW7HClo_O_aDaClUbX4B8bjKY,100
+easycoder-241211.1.dist-info/METADATA,sha256=uJRPPgtc65Ou6ShnNRJ-DwvQ9WLWqy4Vqb7GnU7chjs,2511
+easycoder-241211.1.dist-info/RECORD,,

easycoder-4.dist-info/METADATA

@@ -1,79 +0,0 @@
-Metadata-Version: 2.3
-Name: easycoder
-Version: 4
-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 [https://easycoder.github.io](https://easycoder.github.io)
-
-## Quick Start
-1: Install EasyCoder in your Python environment:
-```
-pip install easycoder
-```
-2: Write a test script, 'hello.ecs':
-```
-print `Hello, world!`
-```
-This is traditionally the first program to be written in virtually any language. To run it under REPL, launch Python and type the following commands:
-```
-from easycoder import Program
-Program(['hello.ecs'])
-```
-The script is passed in as a list because it could be just one of a number of command-line arguments.
-
-The output will look like this:
-```
-Compiled <anon>: 1 lines (2 tokens) in 0 ms
-Run <anon>
-1-> Hello, world!
-```
-To avoid having to use REPL you can set up a simple executable command such as this Python script. On Linux the first line will ensure it runs as a command if given execute permission. You can name it 'easycoder' - there's no need for a '.py' extension.
-```
-#!/bin/python3
-
-from sys import argv
-from easycoder import Program
-
-if (len(argv) > 1):
-    Program(argv[1:])
-else:
-    print('Syntax: easycoder <scriptname> [plugins]')
-```
-With this you can run your script with the command `easycoder hello.ecs`. You can place `easycoder` anywhere on your system execution path, such as in a local `bin` directory.
-
-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
-```
-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.
-
-In the repository is a folder called `tests` containing a couple of 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.
-
-## The EasyCoder programming language
-There are three primary components to the language:
- 1 Keywords
- 2 Values
- 3 Conditions
-
-All program lines start with a keyword - a command to EasyCoder to do something
-
-(Under construction)
-

easycoder-4.dist-info/RECORD

@@ -1,14 +0,0 @@
-easycoder/__init__.py,sha256=dOthEUbaFHi3Q78a4SIjHVPY6ggqf38yhio47M-NH9A,255
-easycoder/ec_classes.py,sha256=onBKF6Lj8BZKNuJKacx4HyhOrVLXsoHdzl6RnMf77uM,1413
-easycoder/ec_compiler.py,sha256=ByWwWA4GTzDX1kljgNbBwzfvvUuR34FRQSEpRVtRo5s,4670
-easycoder/ec_condition.py,sha256=s7xKM3ZeOOiSgZv16RnWznAikHZaJRp1UHwrliebpUE,748
-easycoder/ec_core.py,sha256=_PnwCJcxa7vD5MouuM9COTAC9RnGvzSZ9022Tlqzh5M,74591
-easycoder/ec_handler.py,sha256=WDDIz0awD3vSQZ149rgbUWsClt6zXqED8ByXQJ5p1Ds,2200
-easycoder/ec_program.py,sha256=Z_bR-iE5tieWBTMjUrtnQ0iwkXAStvV3vsxTzOFXOzs,7658
-easycoder/ec_timestamp.py,sha256=_3QFJPzIWZ9Rzk3SQOQJ-gwmvB07pg78k23SPntoZtY,288
-easycoder/ec_value.py,sha256=GnHkWSfcB2InGeLj4T8x_H8U9bvbkj9lF4klEUylt38,2371
-easycoder-4.dist-info/entry_points.txt,sha256=JXAZbenl0TnsIft2FcGJbJ-4qoztVu2FuT8PFmWFexM,44
-easycoder-4.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-easycoder-4.dist-info/WHEEL,sha256=ssQ84EZ5gH1pCOujd3iW7HClo_O_aDaClUbX4B8bjKY,100
-easycoder-4.dist-info/METADATA,sha256=0KeuF7X7-u0rp7gvTN3MUFJwk_r9VxUZ5mW8Pp9z6is,2964
-easycoder-4.dist-info/RECORD,,