Skip to main content

Angle : speakable programming language compiling to python bytecode

Project description

![ENGLISH SCRIPT](English script.png "ENGLISH SCRIPT")

**[Angle](** is the Python implementation of [English]( as a programming language.
The main purpose of this language is to make programming accessible to many more people, more fun and to facilitate programming computers via voice.


`pip install angle`
<!-- `pip install anglang` -->

OR from source:

`git clone --recursive`

`cd angle`


Start the shell : `./bin/angle`

Here are some of our favorite working examples from the [tests](tests):

`assert two minus 1½ equals 0.5`

`beep three times`
(There will be a generation of programmers who will shake their heads that there ever was a programming language which did not interpret that sentence correctly.)

`assert square of [1,2 and 3] equals 1,4,9`

`assert 3rd word in 'hi my friend' is 'friend'`

`x is 2; if all 0,2,4 are smaller 5 then increase x; assert x equals 3 `

`beep every three seconds`

`last item in 'hi','you' is equal to 'you'`

While Peter is online on Skype
make a beep
sleep for 10 seconds

To check if person is online on Skype:
if result is "online": return yes
else return no


ALPHA, partly usable, some [tests](tests) not yet passing:
[![Build Status](](

In progress

`add one to every odd number in 1,2,3 == 2,2,4`

The implicit list filter '**that**' applies a selection criterion to all elements.

`delete all files in my home folder that end with 'bak'`

translates to ruby:

`folder(:home){|that|that.end_with?("bak")}.each{|file| file.delete}`

Implicit lambda variable '**it**'

`for all mails by peter: mark it as read if its subject contains 'SPAM'`

translates to ruby:

`mails(by: Peter).each{|it| it.mark(:read) if it.subject.match('SPAM')}`

The last example also illustrates what we call **matching by type name**.
To delete mail:
move that mail to trash folder
Here 'mail' acts as argument name and argument type at once.
No more Java style Mail mail=new Mail().getMail();

<!-- Self documenting code is not about the "how", it's about the "what". Ex: A method name should be FilterOutOddNumbers(). Not MapModulo2Predicate(). -->

Run it and see yourself!

**experiment** by typing

`./bin/angle "6 plus six"`

`./bin/angle examples/test.e`

`./bin/angle` (no args to start the shell)

`⦠ 1/4`

`⦠ 6 plus six`

`⦠ beep three times`

`⦠ x is 2; if all 0,2,4 are smaller 5 then increase x`

Language Specification
Angle is a multi-paradigm programming language with [gradual typing](

Read the [DOSSIER]( for a more complete [**language specification**](, vision and some background.

The grammar is not meant to be linguistically complete, but [functionality complete]( and easily extendable.
"Premature optimization is the root of all evil." Many programming languages 'optimize' on the syntax level in order to optimize the resulting applications. Maybe [this]( is a mistake.

To check out the current capabilities of English Script have a look at the [tests](,
[keywords]( and

English Script / Angle is currently running in the
* [ruby]( and [python]( environment, but will soon compile to the
* WEB(!!) thanks to [WebAssembly](
* JVM thanks to [Mirah](, [zippy]( and [truffle](
* [.Net/CLR/DLR]( (via [Cecil](, maybe Mirah too),
* As a final aim: run **natively**, maybe similar to [Crystal](, [Vala]( or RPython

Having a [self-hosted "bootstrapped" compiler]( is an important mid-term goal.

One very hot idea is to allow modifying the language grammar on the fly, at least till a limited extend.
One first step would be to make possible setting the precedence of functions.
This would enable very natural and sweet mathematical expressions, especially combined with Unicode names:
class Complex alias ℂ (re, im)
to add number x
alias '+' = add
ī := √-1
ī + 3ī == 4ī
This would run against the goal to avoid sigil special chars though.

Why the new python implementation
We can **compile** English script / [Angle]( directly to python byte-code:
As opposed to Ruby, Python(3) comes with a very nice and clean abstract syntax tree as well as byte code capabilities preinstalled.
Compiling is so much nicer & faster than interpreted code.
Also the Python execution model is a bit more friendly than the Ruby VM, but both have their [advantages and drawbacks]( The biggest advantage of Python is that objects can be given attributes at any time o.x='y'! However pythons limited lamda capabilities are a painful limitation.

"There should be one-- and preferably only one --obvious way to do it"
Beautiful is better than ugly.
Explicit is better than implicit.
Simple is better than complex.
Complex is better than complicated.
Flat is better than nested.

For a background story/vision/philosophy/future of this project read the [DOSSIER](

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

angle-0.1.9.tar.gz (137.7 kB view hashes)

Uploaded source

Built Distribution

angle-0.1.9-py2.py3-none-any.whl (168.9 kB view hashes)

Uploaded 3 5

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page