Skip to content

Commit cf3f694

Browse files
committed
File added
1 parent aff8f5e commit cf3f694

File tree

1 file changed

+35
-0
lines changed

1 file changed

+35
-0
lines changed

README.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# FuckBench
2+
3+
## What is it?
4+
5+
FuckBench (*FB*) is a set of batch files and tools to comiple from several languages into (BrainFuck)[https://en.wikipedia.org/wiki/Brainfuck] (*BF*).
6+
7+
In addition to creating BF code, FB creates higly optimized C files using the
8+
(Esotope)[https://github.com/lifthrasiir/esotope-bfc] BF to C compiler.
9+
If a C compiler is configured, a Windows executable is also created.
10+
11+
Currently, it supports comipiling the following languages to BF:
12+
* ANSI C (no float support)
13+
* 6502 Assembler
14+
15+
## How does it work?
16+
17+
FB contains an emulator of the 6502 CPU (`6502.fbf`); this allows using cross-comiplers available for the 6502 CPU to create BF code.
18+
A "linker" is provided (`CodeMerge.jar`) to "link" 6502 executable code to the emulator, creating a single BF file that can then be executed
19+
by using any available BF compiler or interpreter.
20+
21+
Given the generated code is not the fastest, I stringly suggest to configure a C compiler, as explained below,
22+
such that C code generated by Esotope can be turned into a Windows executable.
23+
24+
## Usage
25+
26+
### Prerequisites
27+
28+
FB relies on a set of tools that need to be installed, as described below.
29+
30+
#### Configuration
31+
32+
Download latest BF release and unzip it in a folder on your machine. We will refer to this folder as `<root>`.
33+
34+
1. Edit `<root>\bin\config.bat` set FB_HOME to `<root>`.
35+
2. I stringly suggest to

0 commit comments

Comments
 (0)