brainfoamkit 1.1.0

An interpreter for the brainf*** language
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

<!--
SPDX-FileCopyrightText: 2023 - 2024 Ali Sajid Imami

SPDX-License-Identifier: Apache-2.0
SPDX-License-Identifier: MIT
-->

# Getting Started

## Installation

The software can be installed in different ways, depending on your taste:

### Cargo Install

You can install it directly from [crates.io](https://crates.io) using `cargo`:

```bash
cargo install brainfoamkit
```

### Cargo Binaries

You can also use the excellent [cargo-binstall](https://github.com/cargo-bins/cargo-binstall) tool to install the binaries directly from the repository:

```bash
cargo install cargo-binstall
cargo binstall brainfoamkit
```

### Manual Installation

You can also install the binaries manually by downloading the appropriate binaries from the [releases](https://github.com/AliSajid/BrainFoamKit/releases) page and placing them in your `$PATH`.

## Usage

### `bfkrun`

`bfkrun` is the main binary that can be used to run programs written in either `BF` or `BFK` dialects.

`bfkrun` accepts both strings and files as input.

```bash
# Use a direct input string
bfkrun --input "+[-->-[>>+>-----<<]<--<---]>-.>>>+.>>..+++[.>]<<<<.+++.------.<<-.>>>>+."

#> Hello, World!
```

```bash
# Use a file as input

# Create a file with the program
echo "+[-->-[>>+>-----<<]<--<---]>-.>>>+.>>..+++[.>]<<<<.+++.------.<<-.>>>>+." > hello_world.bf

# Run the program
bfkrun --file hello_world.bf

#> Hello, World!
```

### `bfkview`

`bfkview` is a TUI application with a (hopefully) intutive interface that lets you step through BF[K] programs.

_Detailed instructions coming soon._