dwayne / whitespace-python

A Whitespace interpreter written in Python.

Whitespace

An interpreter written in Python for the imperative, stack-based language called Whitespace.

Installation

To install, simply use pip (or pipenv):

$ pip install whitespace

Usage

Let program.ws be any Whitespace program. To execute it, type:

$ whitespace program.ws

You can find example Whitespace programs at tests/fixtures.

For example, here's the factorial program:

$ whitespace fact.ws
Enter a number: 40
40! = 815915283247897734345611269596115894272000000000

Development

Recommended tools:

• pyenv
• pipenv

Clone the repository and install the dependencies:

$ git clone [email protected]:dwayne/whitespace-python.git
$ cd whitespace-python
$ pipenv shell
$ pipenv install --dev

You're now all set to begin development.

Testing

Tests are written using the built-in unit testing framework, unittest.

Run all tests.

$ python -m unittest

Run a specific test module.

$ python -m unittest tests.test_parser

Run a specific test case.

$ python -m unittest tests.test_parser.ParserTestCase.test_it_parses_push

References

• Whitespace tutorial

Credits

Thanks to Edwin Brady and Chris Morris for designing/developing this programming language; they are also developers of the Idris programming language.

whitespace-python's Issues

40! != 20397882081197443358640281739902897356800000000

fact.ws computes the wrong value.

>>> import math
>>> math.factorial(40)
815915283247897734345611269596115894272000000000

Thanks to beertown for pointing that out in this comment.

Add disassemble option

Displays the instructions in a human readable format.

$ whitespace --disassemble count.ws
# or
$ whitespace -d count.ws
push 1
label " "
dup
putn
...