v250101.1

Author: easycoder

README.md

@@ -1,5 +1,5 @@
 # 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.
+**_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 its runtime acts as a fairly thin wrapper around Python functions, giving good performance for general applications.
 
 The JavaScript version of **_EasyCoder_**, which provides a full set of graphical features to run in a browser, is at
 
@@ -44,16 +44,16 @@ As you can guess from the above, the print command gives the line in the script
 
 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
+`fizzbuzz.ecs` is a simple programming challenge often given at job interviews    
+`tests.ecs` is a test program containing many of the EasyCoder features
+`benchmark.ecs` allows the performance of EasyCoder to be compared to other languages if a similar program is written for each one
 
 ## Graphical programmming
-**_EasyCoder_** includes a graphical programming environment that is in the early stages of development. A couple of demo scripts are included in the `scripts` directory. To run them, first install the Python `kivy` graphics library if it's not already present on your system. This is done with `pip install kivy`. Then run a script using `easycoder {scriptname}.ecg`.
+**_EasyCoder_** includes a graphical programming environment that is in the early stages of development. A couple of demo scripts are included in the `scripts` directory. To run them, first install the Python `kivy` graphics library if it's not already present on your system. This is done with `pip install kivy`. Then run your **_EasyCoder_** script using `easycoder {scriptname}.ecg`.
 
-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. 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).
+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 scripts are included in the `scripts` directory:
+A couple of 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.
 

dist/easycoder-241231.1-py2.py3-none-any.whl

@@ -1,21 +1,7 @@
-# The 'core' package
+# _EasyCoder_ packages
 
-There are three primary components to the language:
+'Packages' are components of the **_EasyCoder_** system that deal with specific groups of language features. Thos included or available from the repository are
 
- - Keywords
- - Values
- - Conditions
+{core}(core/README.md) contains all the language features needed to construct command-line applications to run on any computer equipped with Python.
 
-The core package contains all the keywords values and conditionals needed for general programming, and to build most command-line tools these are all that will be needed.
-
-The core keywords are:
-
-[add](core/keywords/add.md) [append](core/keywords/append.md) [assert](core/keywords/assert.md) [begin](core/keywords/begin.md) [clear](core/keywords/clear.md) [close](core/keywords/close.md) [create](core/keywords/create.md) [debug](core/keywords/debug.md) [decrement](core/keywords/decrement.md) [delete](core/keywords/delete.md) [divide](core/keywords/divide.md) [exit](core/keywords/exit.md) [file](core/keywords/file.md) [fork](core/keywords/fork.md) [get](core/keywords/get.md) [go](core/keywords/go.md) [gosub](core/keywords/gosub.md) [if](core/keywords/if.md) [import](core/keywords/import.md) [increment](core/keywords/increment.md) [index](core/keywords/index.md) [init](core/keywords/init.md) [input](core/keywords/input.md) [multiply](core/keywords/multiply.md) [negate](core/keywords/negate.md) [open](core/keywords/open.md) [pop](core/keywords/pop.md) [post](core/keywords/post.md) [print](core/keywords/print.md) [push](core/keywords/push.md) [put](core/keywords/put.md) [read](core/keywords/read.md) [replace](core/keywords/replace.md) [return](core/keywords/return.md) [script](core/keywords/script.md) [set](core/keywords/set.md) [split](core/keywords/split.md) [stack](core/keywords/stack.md) [stop](core/keywords/stop.md) [system](core/keywords/system.md) [take](core/keywords/take.md) [toggle](core/keywords/toggle.md) [truncate](core/keywords/truncate.md) [variable](core/keywords/variable.md) [wait](core/keywords/wait.md) [while](core/keywords/while.md) [write](core/keywords/write.md)
-
-The core values are:
-
-[arg](core/values/arg.md) [args](core/values/args.md) [cos/sin/tan](core/values/trig.md) [now](core/values/now.md) [today](core/values/today.md) [newline](core/values/newline.md) [break](core/values/break.md) [empty](core/values/empty.md) [date](core/values/date.md) [encode](core/values/encode.md) [decode](core/values/decode.md) [stringify](core/values/stringify.md) [json](core/values/json.md) [lowercase](core/values/lowercase.md) [uppercase](core/values/uppercase.md) [hash](core/values/hash.md) [random](core/values/random.md) [float](core/values/float.md) [integer](core/values/integer.md) [datime/datetime](core/values/datime.md) [element](core/values/element.md) [elements](core/values/elements.md) [property](core/values/property.md) [trim](core/values/trim.md) [keys](core/values/keys.md) [count](core/values/count.md) [index](core/values/index.md) [value](core/values/value.md) [length](core/values/length.md) [left](core/values/left.md) [right](core/values/right.md) [from](core/values/from.md) [position](core/values/position.md) [message](core/values/message.md) [timestamp](core/values/timestamp.md) [files](core/values/files.md) [weekday](core/values/weekday.md) [mem/memory](core/values/mem.md) [error](core/values/error.md) [type](core/values/type.md) [modification](core/values/modification.md)
-
-The core conditions are:
-
-[Back](../README.md)
+{graphics}(graphics/README.md) contains a growing selection of graphical language features, to construct applications that will run on a computer with a graphical user interface; Windows, Mac or Linux.

dist/easycoder-250101.1-py2.py3-none-any.whl

@@ -0,0 +1,21 @@
+# The 'core' package
+
+The core package contains all the keywords values and conditionals needed for general programming, and to build most command-line tools these are all that will be needed.
+
+There are three primary components to the language:
+
+ - Keywords
+ - Values
+ - Conditions
+
+The core keywords are:
+
+[add](core/keywords/add.md) [append](core/keywords/append.md) [assert](core/keywords/assert.md) [begin](core/keywords/begin.md) [clear](core/keywords/clear.md) [close](core/keywords/close.md) [create](core/keywords/create.md) [debug](core/keywords/debug.md) [decrement](core/keywords/decrement.md) [delete](core/keywords/delete.md) [divide](core/keywords/divide.md) [exit](core/keywords/exit.md) [file](core/keywords/file.md) [fork](core/keywords/fork.md) [get](core/keywords/get.md) [go](core/keywords/go.md) [gosub](core/keywords/gosub.md) [if](core/keywords/if.md) [import](core/keywords/import.md) [increment](core/keywords/increment.md) [index](core/keywords/index.md) [init](core/keywords/init.md) [input](core/keywords/input.md) [multiply](core/keywords/multiply.md) [negate](core/keywords/negate.md) [open](core/keywords/open.md) [pop](core/keywords/pop.md) [post](core/keywords/post.md) [print](core/keywords/print.md) [push](core/keywords/push.md) [put](core/keywords/put.md) [read](core/keywords/read.md) [replace](core/keywords/replace.md) [return](core/keywords/return.md) [script](core/keywords/script.md) [set](core/keywords/set.md) [split](core/keywords/split.md) [stack](core/keywords/stack.md) [stop](core/keywords/stop.md) [system](core/keywords/system.md) [take](core/keywords/take.md) [toggle](core/keywords/toggle.md) [truncate](core/keywords/truncate.md) [variable](core/keywords/variable.md) [wait](core/keywords/wait.md) [while](core/keywords/while.md) [write](core/keywords/write.md)
+
+The core values are:
+
+[arg](core/values/arg.md) [args](core/values/args.md) [cos](core/values/cos.md) [count](core/values/count.md) [break](core/values/break.md) [empty](core/values/empty.md) [date](core/values/date.md) [datime/datetime](core/values/datime.md) [element](core/values/element.md) [elements](core/values/elements.md) [decode](core/values/decode.md) [encode](core/values/encode.md) [error](core/values/error.md) [files](core/values/files.md) [float](core/values/float.md) [from](core/values/from.md) [hash](core/values/hash.md) [index](core/values/index.md) [integer](core/values/integer.md) [json](core/values/json.md) [keys](core/values/keys.md) [left](core/values/left.md) [length](core/values/length.md) [lowercase](core/values/lowercase.md) [mem/memory](core/values/mem.md) [modification](core/values/modification.md) [message](core/values/message.md) [newline](core/values/newline.md) [now](core/values/now.md) [position](core/values/position.md) [property](core/values/property.md) [random](core/values/random.md) [right](core/values/right.md) [sin](core/values/sin.md) [stringify](core/values/stringify.md) [tan](core/values/tan.md) [timestamp](core/values/timestamp.md) [today](core/values/today.md) [trim](core/values/trim.md) [type](core/values/type.md) [uppercase](core/values/uppercase.md) [value](core/values/value.md) [weekday](core/values/weekday.md)
+
+The core conditions are:
+
+[Back](../README.md)

dist/easycoder-241231.1.tar.gz renamed to dist/easycoder-250101.1.tar.gz

@@ -1,14 +1,16 @@
 ## Syntax:
 `set {variable}`  
-`set the elements of {variable} to {value}`  
-`set element/property {name} of {variable} to {value}`
+`set [the] elements of {variable} to {value}`  
+`set element/property {name} of {variable} to {value}`  
+``set [the] encoding to `utf-8`/`base64` ``
 
 ## Examples:
 `set Flag`  
 `set the elements of ThisVariable to 10`  
 `set element 5 of MyList to NewValue`  
 ``set property `name` of MyProperties to `first` ``  
-``set property `age` of MyProperties to Age``
+``set property `age` of MyProperties to Age``  
+``set the encoding to `base64` ``
 
 ## Description:
 `set` is a heavily used command in **_EasyCoder_**. Here in the core package it does the following, as listed in the Syntax above:
@@ -19,6 +21,8 @@
 
 -- Sets an element or a property of a [variable](variable.md), providing it was intialised appropriately. Elements can be added to a variable that is intialised as JSON list, for example as ``put json `[]` into MyList``. Properties can be set on a variable that is initialised as a JSON object, for example as ``put json `{}` into MyProperties``. Note that this has nothing to do with the indexing of variables using [index](index.md). Each of the elements of such a variable can be treated as either a JSON list or as a JSON object, and either can be used for different elements of the same variable.
 
+-- Sets the encoding to be used by the [encode](../values/encode.md) and [decode](../values/decode.md) value handlers. The encoder options are `utf-8` and `base64`. The default is `utf-8` if none is set by the script.
+
 Next: [split](split.md)  
 Prev: [script](script.md)
 

doc/README.md

@@ -0,0 +1,14 @@
+## Syntax:
+`arg {n}`
+
+## Examples:
+`print arg N`  
+`print arg 2`
+
+## Description:
+Gets the value of the `{n}`th command-line argument. 
+
+Next: [args](args.md)  
+Prev: [weekday](weekday.md)
+
+[Back](../../README.md)

doc/core/README.md

@@ -0,0 +1,13 @@
+## Syntax:
+`[the] args`
+
+## Examples:
+`print the args`
+
+## Description:
+Gets the command-line arguments as a JSON-formatted array. 
+
+Next: [cos](cos.md)  
+Prev: [arg](arg.md)
+
+[Back](../../README.md)

doc/core/keywords/set.md

@@ -0,0 +1,14 @@
+## Syntax:
+`cos {value} radius {radius}`
+
+## Examples:
+`print cos 45 radius 100`  
+`print cos Angle radius Radius`
+
+## Description:
+Gets an integer value being the cosine of the given angle (in degrees), multiplied by the given radius. See also [sin](sin.md) and [tan](tan.md).
+
+Next: [datime](datime.md)  
+Prev: [args](args.md)
+
+[Back](../../README.md)