Table of Contents

• Introduction
• Features
• Installation
• Usage
• Examples
• Contributing
• License

• Brainfk is a Python package that provides an interpreter for the Brainfuck programming language. It allows you to execute Brainfuck code and see the output.

• Simple and intuitive interface to run Brainfuck code.
• Supports reading Brainfuck code from a file or direct input.
• Handles the basic Brainfuck commands: +, -, <, >, ., ,, [, ].
• Supports nested loops in Brainfuck code.

You can install Brainfk using pip:

pip install brainfk

Brainfk requires Python 3.7 or higher.

You can run the Brainfuck interpreter by executing the brainfk command followed by the path to a file containing Brainfuck code or by providing the code directly as input.

To execute Brainfuck code from a file:

brainfk path/to/brainfuck_file.bf

To provide Brainfuck code as input:

brainfk

The interpreter will prompt you to enter the Brainfuck code. Type or paste the code, and press Enter.

Here are some examples to demonstrate how to use Brainfk:

1. Execute Brainfuck code from a file:

brainfk examples/hello_world.bf

2. Execute Brainfuck code by providing input:

brainfk

Enter the Brainfuck code: ,.[.,]

Enter the input: Hello, Brainfuck!

If you would like to contribute to Brainfk, feel free to open pull requests for bug fixes, enhancements, or new features. Please ensure that your code follows the existing coding style and includes appropriate tests.

This project is licensed under the MIT License. See the LICENSE file for details.