force add files

Author: lsferreira42

.gitignore

@@ -0,0 +1,4 @@
+.vscode
+a.out.js
+a.out.wasm
+bli

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Leandro Ferreira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Makefile

@@ -0,0 +1,11 @@
+CC=gcc
+CFLAGS=-Wall -Werror
+
+all: bli.c
+		$(CC) $(CFLAGS) bli.c -o bli 
+
+clean: bli
+		rm -f bli
+
+web: bli.html
+		emcc -O3 -s WASM=1 bli.c

README.md

@@ -0,0 +1,43 @@
+# Simple and lazy Brainf*ck interpreter
+
+
+### Why?
+
+Because i'm learning about compilers and interpreters
+
+
+## Does it work?
+
+Yes, all you need is GCC and make ( in fact you just need gcc, but typing make is faster )
+
+```shell
+$ make
+gcc -Wall -Werror bli.c -o bli
+$ ./bli "++++++++[>++++[>++>+++>+++>+<<<<-]>+>+>->>+[<]<-]>>.>---.+++++++..+++.>>.<-.<.+++.------.--------.>>+.>++."
+Hello World!
+```
+
+And that's it!!
+
+### Why Brainf*ck?
+
+As much as Brainfuck can be a little bit intimidating at first look, it's a very simple esoteric language , it has a VERY compact instruction set ( 8 to be exact ) and it's functioning is kinda funny.
+
+
+### How it works?
+
+it starting by reading the first parameter passed throug the command line, than it loop through it char by char and do a action on the memory tape.
+
+Also, the tape is a 30000 array with 0 on every position, the instruction set move ou update the value of a position on this tape that's later converted to it's equivalent char in the ASCII table, talking about tables, that's one containing all possible brainfuck instructions:
+
+| Instruction | Utility |
+|------|-------|
+| "." (dot) | print the current cell value    |
+| "+" and "-" | increment or decrement the value of the current cell |
+| "," | read a char from the user and set at the pointer position |
+| "[" and "]" | start and end a loop when the current cell is not zero |
+| "<" and ">" | move the point to the right or left |
+
+### Visual explaining: TODO
+
+Add a visual run through the hello world example

bli.c

@@ -0,0 +1,87 @@
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <emscripten.h>
+
+char tape[30000], *ptr = tape;
+
+char brainfuck(char *code, size_t code_len) {
+    char output[30000] = {0};
+    int output_index = 0;
+    int code_index = 0;
+
+    while (code_index < code_len) {
+        char c = code[code_index];
+
+        switch (c) {
+            case '>':
+                ptr++;
+                break;
+            case '<':
+                ptr--;
+                break;
+            case '+':
+                (*ptr)++;
+                break;
+            case '-':
+                (*ptr)--;
+                break;
+            case '.':
+                output[output_index] = *ptr;
+                output_index++;
+                break;
+            case ',':
+                *ptr = getchar();
+                break;
+            case '[':
+                if (*ptr == 0) {
+                    int balance = 1;
+                    while (balance) {
+                        code_index++;
+                        char next_c = code[code_index];
+                        if (next_c == '[') {
+                            balance++;
+                        } else if (next_c == ']') {
+                            balance--;
+                        }
+                    }
+                }
+                break;
+            case ']':
+                if (*ptr != 0) {
+                    int balance = 1;
+                    while (balance) {
+                        code_index--;
+                        char next_c = code[code_index];
+                        if (next_c == ']') {
+                            balance++;
+                        } else if (next_c == '[') {
+                            balance--;
+                        }
+                    }
+                }
+                break;
+            default:
+                break;
+        }
+
+        code_index++;
+    }
+
+    printf("%s", output);
+    return 0;
+}
+
+int main(int argc, char *argv[]) {
+    if (argc < 2) {
+        fprintf(stderr, "Usage: %s \"brainfuck-code\"\n", argv[0]);
+        exit(EXIT_FAILURE);
+    }
+
+    char *code = argv[1];
+    size_t code_len = strlen(code);
+
+    brainfuck(code, code_len);
+
+    return 0;
+}

bli.html

@@ -0,0 +1,9 @@
+<script src="a.out.js"></script>
+<script>
+	Module.onRuntimeInitialized = async (_) => {
+		const brainfuck = {
+			version: Module.cwrap('main', 'number', ['string']),
+		};
+	console.log(brainfuck("++++++++[>++++[>++>+++>+++>+<<<<-]>+>+>->>+[<]<-]>>.>---.+++++++..+++.>>.<-.<.+++.------.--------.>>+.>++."));
+	};
+</script>