Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mathialo/interactive-brainfuck
An interactive BrainFuck interpreter
https://github.com/mathialo/interactive-brainfuck
brainfuck brainfuck-interpreter brainfuck-repl bython python repl
Last synced: 6 days ago
JSON representation
An interactive BrainFuck interpreter
- Host: GitHub
- URL: https://github.com/mathialo/interactive-brainfuck
- Owner: mathialo
- License: mit
- Created: 2018-11-28T11:06:26.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2018-11-29T10:47:18.000Z (about 6 years ago)
- Last Synced: 2024-11-13T09:20:13.920Z (2 months ago)
- Topics: brainfuck, brainfuck-interpreter, brainfuck-repl, bython, python, repl
- Language: Python
- Size: 42 KB
- Stars: 1
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Interactive BrainFuck
An interactive BrainFuck interpreter written in Bython. Why not?
### Installation
You can install `ibf` from PyPI with `pip` (with or without `sudo -H`, depending
on your Python installation):
``` bash
$ pip3 install ibf
```
Or, if you want the latest version, you can build `ibf` from source yourself.
Note that you need a working installation of
[Bython](https://github.com/mathialo/bython#Installation) to do this. To install
from source, you must first build the Bython source into a Python package:
``` bash
$ make build
```
Then, you move to the `python` folder, and run the setup script:
``` bash
$ cd python
$ sudo -H pip3 install .
```
Alternatively, `make install` should do all of the above steps automatically.
### Quick intro
After installation, you run an interactive session with the `ibf` command:
```
$ ibf
Interactive BrainFuck - ibf v0.1
ibf is licensed under the permissive MIT license. Full license and
copyright information is available at the project's GitHub repository.
[Input] +[------->++<]>-.------------.--[--->+<]>--.+.+++[->+++<]>.+++++++++++++.[-->+++++<]>+++.[-->+++++++<]>.++.---.------------.-[--->+<]>----.+++[->+++<]>++.--[--->+<]>--.+.-----------.+++++.-------------.--[--->+<]>-.-----.+++.>++++++++++.
master procrastinator
```
Everything you input is interpreted as BrainFuck code, except for the following
reserved keywords:
| Command | Description |
|------------|-----------------------------------------------------------------------------------|
| tape | Prints the current status of the tape (data cells), with the current cell in bold |
| pos | Prints the current position on the tape |
| quit | Quits the session |
| run | Run code from a file |
You can also run prewritten BrainFuck code, either as a standalone program, or
in an interactive session:
```
$ ibf test.bf
Hello World!
$ ibf
Interactive BrainFuck - ibf v0.1
ibf is licensed under the permissive MIT license. Full license and
copyright information is available at the project's GitHub repository.
[Input] run test.bf
Hello World!
```
The `run` command always runs programs _inline_, ie the code is run on the
current tape and with the current tape position as starting position. Thus,
after running a program you can inspect the final state of the tape:
```
[Input] tape
0 1 2 3 4 5 6 7 8
0 0 72 100 87 33 10 0 0
```
For more help, type `ibf -h` or view the manual page by running `man ibf`.