https://github.com/xavier-maruff/bft
An optimizing multi-target brainf*ck transpiler
https://github.com/xavier-maruff/bft
ada brainfuck brainfuck-transpiler c compiler cpp fortran90 js rust transpiler
Last synced: about 2 months ago
JSON representation
An optimizing multi-target brainf*ck transpiler
- Host: GitHub
- URL: https://github.com/xavier-maruff/bft
- Owner: Xavier-Maruff
- Created: 2021-10-08T07:19:44.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2021-12-02T09:58:02.000Z (over 3 years ago)
- Last Synced: 2025-01-22T15:47:55.447Z (3 months ago)
- Topics: ada, brainfuck, brainfuck-transpiler, c, compiler, cpp, fortran90, js, rust, transpiler
- Language: Brainfuck
- Homepage:
- Size: 82 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# 🧠bft
## A multi-target brainf*ck transpiler
bft is an optimizing modular brainf*ck transpiler which currently has backends for:
* C (`--target=c`)
* JavaScript for the NodeJS runtime (`--target=js`)
* Rust (`--target=rust`)
* Ada (`--target=ada`)
* Fortran 90 (`--target=fortran`)
## Command line options
bft accepts the following command-line arguments:
* `--target={target lang}, -t {target lang}` → the transpilation target langauge
* `positional, --source={source file}, -s {source file}` → the source brainf*ck file
* `--verbose, -v` → increases the logging verbosity
* `--output={output file}, -o {output file}` → the transpiled output file
* `--help, -h` → displays the options guide
* `--optimize={0 - 3}, -O {0 - 3}` → how aggressively the transpiler should optimize the brainf*ck. If not specified, defaults to `3`
## Building
Dependencies:
* CMake
* Make
* Boost program options
To build bft, run `./build.sh {{Debug or Release}}`
## Running
To transpile a brainf*ck program, simply run `bft {{input file}} -o {{output file}} --target={{target language}}`
Examples:
```bash
bft input.bf -o output.js --target=js
bft input.bf -o output.c --target=c
bft input.bf -o output.rs --target=rust
bft input.bf -o output.adb --target=ada
bft input.bf -o output.f90 --target=fortran
```
## Testing
Run the `test.sh` script to run the C, JavaScript, Rust, Ada, and Fortran tests. DISCLAIMER: You will need to modify the `libc` crate path in the `test/rust/test.sh` script for rustc to correctly include it, see the *Rust notes* section below
## Rust notes
The rust target references the `libc` crate, so to compile either create a Cargo project and add `libc` to the dependencies, or compile with `rustc` with `--extern libc={path to libc rlib}`