https://github.com/bornlex/whitespace-interpreter

A Whitespace interpreter. Written in Python.
https://github.com/bornlex/whitespace-interpreter

compiler interpreter python-3-5 whitespace whitespace-interpreter whitespace-language

Last synced: 20 days ago
JSON representation

A Whitespace interpreter. Written in Python.

• Host: GitHub
• URL: https://github.com/bornlex/whitespace-interpreter
• Owner: Bornlex
• License: mit
• Created: 2017-08-09T19:42:59.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2020-02-18T13:39:19.000Z (almost 5 years ago)
• Last Synced: 2024-12-20T23:24:20.341Z (22 days ago)
• Topics: compiler, interpreter, python-3-5, whitespace, whitespace-interpreter, whitespace-language
• Language: Python
• Homepage:
• Size: 28.3 KB
• Stars: 5
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# WhiteSpace Interpreter

> A whitespace programming language interpreter

The following program executes .ws (WhiteSpace) files.

## About

Whitespace is an esoteric programming language that makes use of only 3 characters:

* whitespace (of course)

* tab

* line feed

It has been invented by Edwin Brady & Chris Morris and released on 1st April 2003.

This is not that easy to find documentation and resources about writing Whitespace, but here are some good ones:

* [Specs](http://web.archive.org/web/20150426193527/http://compsoc.dur.ac.uk:80/whitespace/tutorial.php)

* [IDE](http://vii5ard.github.io/whitespace/)

* [Tutorial](http://www.whoishostingthis.com/resources/whitespace-programming/)

## Installation

OS X, Linux & Windows:

```sh

git clone https://github.com/Bornlex/WhitespaceCompiler.git

```

The Python version I used to implement and run it is 3.5.

It is possible that it won't work with verions under 3 because of the importing system, but I did not test it.

## Usage example

To execute a .ws file:

```sh

./main.py file_to_execute.ws

```

## Development setup

To add some functionalities to the program and to check that everything is working properly, just run:

```sh

make test

```

All tests should pass.

## Release History

* 0.0.1

    * First release

## Meta

Do not hesitate to contact me for any information or feedback:

[email protected]

Distributed under the MIT license. See ``LICENSE`` for more information.

## Contributing

1. Fork it

2. Create your feature branch (`git checkout -b feature/fooBar`)

3. Commit your changes (`git commit -am 'Add some fooBar'`)

4. Push to the branch (`git push origin feature/fooBar`)

5. Create a new Pull Request