bf-derivatives-tools 0.4.0

Let's create your own brainfuck derivative.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

# bf-derivatives-tools

Let's create your own brainfuck derivative.

## Install

```bash
cargo install bf-derivatives-tools
```

After installation, two commands will be available.

* bfi
  - brainfuck derivative interpreter
* bft
  - brainfuck derivative translator

## Usage

### Edit the json file and write grammar rules

* the following example is quoted from http://kmaebashi.com/zakki/lang0003.html

```bash
vim jojo-grammar.json
```

```json
{
    "rshift": "ふるえるぞハート!",
    "lshift": "燃えつきるほどヒート!!",
    "inc": "オラ",
    "dec": "無駄",
    "write": "ァ!",
    "read": "やれやれだぜ",
    "loop_begin": "おまえの次のセリフは「",
    "loop_end": "」という!"
}
```

Grammar json file format: 

| JSON item  | brainfuck command |
| :--------: | :---------------: |
|   rshift   |         >         |
|   lshift   |         <         |
|    inc     |         +         |
|    dec     |         -         |
|   write    |         .         |
|    read    |         ,         |
| loop_begin |         [         |
|  loop_end  |         ]         |

### Run the program

#### Original brainfuck

```bash
bfi path/to/brainfuck/code/file
```

#### Your brainfuck derivative

```bash
vim hello.jojo
```

```
ふるえるぞハート!
オラオラオラオラオラオラオラオラオラオラオラオラオラオラオラオラ
おまえの次のセリフは「燃えつきるほどヒート!!オラオラオラオラオラオラ
ふるえるぞハート!無駄」という!
燃えつきるほどヒート!!オラオラオラオラオラオラオラオラァ!
無駄無駄無駄ァ!
オラオラオラオラオラオラオラァ!ァ!
オラオラオラァ!ふるえるぞハート!
オラオラオラオラオラオラオラオラオラオラオラオラオラオラオラオラ
おまえの次のセリフは「ふるえるぞハート!オラオラ燃えつきるほどヒート!!無駄」という!
ふるえるぞハート!オラオラオラオラオラオラオラオラオラオラオラオラァ!
無駄無駄無駄無駄無駄無駄無駄無駄無駄無駄無駄無駄ァ!
燃えつきるほどヒート!!燃えつきるほどヒート!!オラオラオラオラオラオラオラオラァ!
無駄無駄無駄無駄無駄無駄無駄無駄ァ!
オラオラオラァ!
無駄無駄無駄無駄無駄無駄ァ!
無駄無駄無駄無駄無駄無駄無駄無駄ァ!
ふるえるぞハート!
ふるえるぞハート!
オラオラオラオラオラオラオラオラオラオラオラオラオラオラァ!
```

#### Run interpreter

```bash
bfi path/to/hello.jojo -g path/to/jojo-grammar.json
```

Output:

```bash
hello, world.
```

#### Translate bf code -> bf-derivative code

```bash
bft path/to/bf-code-file/ -t path/to/bf-derivative-grammar.json
```

#### Translate bf-derivative code -> bf code

```bash
bft path/to/bf-derivative-code-file/ -f path/to/bf-derivative-grammar.json
```

The results will be output to stdout.  

## Uninstall

```bash
cargo uninstall bf-derivatives-tools
```