https://github.com/beatussum/brainfuck
A Brainfuck interpreter
https://github.com/beatussum/brainfuck
brainfuck brainfuck-interpreter ensimag
Last synced: 3 months ago
JSON representation
A Brainfuck interpreter
- Host: GitHub
- URL: https://github.com/beatussum/brainfuck
- Owner: beatussum
- License: gpl-3.0
- Created: 2024-03-26T14:27:09.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-04-11T16:23:25.000Z (about 1 year ago)
- Last Synced: 2025-01-23T11:42:57.827Z (5 months ago)
- Topics: brainfuck, brainfuck-interpreter, ensimag
- Language: C
- Homepage: https://beatussum.github.io/brainfuck/
- Size: 196 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Brainfuck
[](LICENSE) [](https://github.com/beatussum/brainfuck/releases/)
## Quel est ce projet ?
Ce projet consiste en un interpréteur _Brainfuck_. Il s'agit d'un projet donné lors de mes études à [l'ENSIMAG](https://ensimag.grenoble-inp.fr/), une école d'ingénieur française en informatique, durant l'année scolaire **2023-2024**.
## Qu'est-ce que le Brainfuck ?
Brainfuck est un langage de programmation exotique, inventé par Urban Müller en 1993. Il tire son nom de l’union de deux mots anglais, brain (« cerveau ») et fuck (« niquer »), et joue sur les mots, puisque ce langage est volontairement simpliste, et parce que l'expression Brain Fuck évoque, en argot, ce qui met le cerveau dans un état de confusion par sa complexité apparente. Ce vocabulaire peu flatteur lui a d'ailleurs valu d'être écrit sous d'autres orthographes plus prudes, telles que Brainf\*ck, Brainf\*\*\* ou encore BF. [^1]
## Construction depuis les sources
### Dépendances
Pour construire `brainfuck`, les dépendances suivantes sont nécessaires (**uniquement lors de la construction**) :
- [CMake](https://cmake.org/)
- [Doxygen](https://www.doxygen.nl/) [^2]
- [Git](https://git-scm.com/)
### Instructions
1. Récupérer les sources.
```bash
git clone "https://github.com/beatussum/brainfuck.git"
```
1. Se placer dans le répertoire.
```bash
cd brainfuck
```
1. Créer le dossier de construction.
```bash
mkdir build
cd build
```
1. Lancer **CMake**.
```bash
cmake -DCMAKE_BUILD_TYPE:STRING="Release" -G Ninja ..
```
Pour construire en plus la documentation, rajouter l'option `-DWITH_DOCS:BOOL=YES`.
1. Construire l'exécutable.
```bash
ninja
```
Pour construire la documentation, appeler
```bash
ninja docs
```
## Utilisation
```
USAGE:
brainfuck compile
brainfuck run
For the `compile` command, you can replace:
- `input` by `-` to set the standard input as input,
- `output` by `-` to set the standard output as output.
```
Pour `compile`, le programme va générer dans la sortie `output` **un source C** à partir du programme _Brainfuck_ `input` donné en entrée.
Pour `run`, l'exécutable prend un paramètre correspondant à un fichier contenant un programme _Brainfuck_.
## Licence
Le code de ce logiciel est sous licence GPL-3 ou toute version ultérieure.
[^1]: https://fr.wikipedia.org/wiki/Brainfuck
[^2]: seulement si vous souhaitez construire la documentation