-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
752a077
commit 7b2f9de
Showing
1 changed file
with
85 additions
and
9 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,31 +1,107 @@ | ||
| # BrainIDE | ||
| Welcome to BrainIDE! Following will be some information about this software as well as some help about Brainfuck itself. | ||
|
|
||
|
|
||
| ## What's BrainIDE? | ||
| BrainIDE aims to provide an **easy-to-use, lightweight and user-friendly** brainfuck IDE. The main purpose of this piece of sowtware is to allow for brainfuck coding on the go, without the need of an Internet connection. Fully coded using python and tkinter for GUI design. | ||
| BrainIDE aims to provide an **easy-to-use, lightweight and user-friendly** brainfuck IDE. The main purpose of this piece of sowtware is to allow for | ||
| brainfuck coding on the go, without the need of an Internet connection. Fully coded using python and tkinter for GUI design. | ||
|
|
||
| | Linux version | Windows version | | ||
| | - | -| | ||
| |  |  | | ||
|
|
||
| ## BrainIDE's features. | ||
| BrainIDE has several features that makes it helful and easy-to-use. The most relevant ones are automatic code highlighting, keyboard shorcuts for ecery | ||
| action, and typical functions any IDE has (save, open project...) | ||
|
|
||
| For more advanced users, BrainIDE's interpreter can be changed by just cloning the repository and changing brainfuck_compiler.py with your own. **Note it | ||
| must be renamed to _brainfuck_compiler.py_** | ||
|
|
||
|
|
||
| ## How to Install BrainIDE? | ||
| Installation is as easy as it could be, just download the zip file corresponding to your OS (current version is only supported in Windows and Linux) and follow the intructions for your own dist. You can find these instructions in the README.txt file inside the zip file you've downloaded! | ||
| Installation is as easy as it could be, just download the zip file corresponding to your OS (current version is only supported in Windows and Linux) and | ||
| follow the intructions for your own dist. You can find these instructions in the README.txt file inside the zip file you've downloaded! | ||
|
|
||
|
|
||
| ## How to contribute? | ||
| All contributions and suggestions are welcome. If you´d like to contribute, clone the repo with: | ||
| ``` | ||
| https://github.com/LovetheFrogs/BrainIDE | ||
| ``` | ||
| Send your PL's and they will be reviewed. | ||
| Send your PR's and they will be reviewed. | ||
|
|
||
|
|
||
| ## Brainfuck! | ||
| Continue reading for some information regarding brainfuck and how to use it. | ||
|
|
||
| ## Brainfuck? | ||
| Continue reading for some information regarding brainfuck. | ||
| The following is extracted from the [Wikipedia page](https://en.wikipedia.org/wiki/Brainfuck) for brainfuck. If you would like a better insight into the history and origin of this language, I'd recommend you to head over there. | ||
|
|
||
| >Brainfuck is an esoteric programming language created in 1993 by Urban Müller.[1] | ||
| ### What is brainfuck? | ||
| The following is extracted from the [Wikipedia page](https://en.wikipedia.org/wiki/Brainfuck) for brainfuck. If you would like a better insight into the | ||
| history and origin of this language, I'd recommend you to head over there. | ||
|
|
||
| >Brainfuck is an esoteric programming language created in 1993 by Urban Müller. | ||
| > | ||
| >Notable for its extreme minimalism, the language consists of only eight simple commands, a data pointer and an instruction pointer. While it is fully >Turing complete, it is not intended for practical use, but to challenge and amuse programmers. Brainfuck simply requires one to break commands into >microscopic steps. | ||
| >Notable for its extreme minimalism, the language consists of only eight simple commands, a data pointer and an instruction pointer. While it is fully | ||
| >Turing complete, it is not intended for practical use, but to challenge and amuse programmers. Brainfuck simply requires one to break commands into | ||
| >microscopic steps. | ||
| > | ||
| >The language's name is a reference to the slang term brainfuck, which refers to things so complicated or unusual that they exceed the limits of one's >understanding. | ||
| >The language's name is a reference to the slang term brainfuck, which refers to things so complicated or unusual that they exceed the limits of one's | ||
| >understanding. | ||
| ### The language. | ||
| Brainfuck is made of two main components. An array of 30k cells and a pointer to one of its cells. When a brainfuck program begins execution, the pointer | ||
| is placed at cell 0 and each of the cell's values are set to 0. | ||
|
|
||
| The programmer can manipulate the value of a cell or move to a different one, as well as looping through a set of instructions or use input/output. In | ||
| total, there are 8 commands as stated above. Here you can find a table detailing the function of each oone of them. | ||
|
|
||
| | Command | Description | | ||
| | - | - | | ||
| | **+** | Increment value of current cell by one. | | ||
| | **-** | Decrement value of current cell by one. | | ||
| | **>** | Move pointer one position to the right. | | ||
| | **<** | Move pointer one position to the left.| | ||
| | **[** | Start of a while loop, will repeat until cell pointet to is cero. | | ||
| | **]** | Marks the end of a while loop. if the cell pointet to when reached here is noncero, it loops over. | | ||
| | **.** | Used to output the ASCII value of the current cell to the screen. | | ||
| | **,** | Used to input the ASCII value of one byte to the cell pointed to. | | ||
|
|
||
| As one could have probably guessed by now, brainfuck uses ASCII codes to manage whats in the cell. This means that if cell 3 has the value '97', it | ||
| actually has the letter 'a'. | ||
|
|
||
| ### A simple introduction to programming in brainfuck. | ||
| Below, you will learn how to write some code wich will print a letter. However, this is super simple. However, if you'd want to learn brainfuck from | ||
| scratch, I'd recommend heading over to [**roachhd's brainfuck bacics**](https://gist.github.com/roachhd/dce54bec8ba55fb17d3a) as it deepens way more into | ||
| the basics of this language. | ||
|
|
||
| Let's code a simple program in brainfuck. This one is pretty simple and its aim is just to show how to print a character. Let's say you would like to | ||
| output 'B' to screen, you could use the following code: | ||
| ``` | ||
| ++++++[>+++++++++++<-]>. | ||
| ``` | ||
| Lets break it down: | ||
|
|
||
| First, we set the value of the first to 6. This will be used to iterate trough a loop and avoid the hussle of havint to type in 66 plus symbols (as 'B' in | ||
| ASCII is 66 decimal). | ||
|
|
||
| After that, we start a while loop and move to the second cell, adding 11 to it. When we are done with that, we move back to the first cell and decrease | ||
| it's value by one. | ||
|
|
||
| As we've reached the end of our loop and the current cell we're at is not 0, we iterate though again. Following there's a diagram of show the fist 3 cells | ||
| look like at the start of all the loop iterations. (Note that the pointer will be pointing to the first cell at the start of each cycle). | ||
|
|
||
| <p align='center'> |6|0|0| ---> |5|11|0| ---> |4|22|0| ---> |3|33|0| ---> |2|44|0| ---> |1|55|0| </p> | ||
|
|
||
| Lastly, we move to the second cell, wich contains the value 66, and use '.' to output it's value. If you open BrainIDE, copy the code snippet above, and | ||
| execute it, you will see that a letter **B** prints on the output box. | ||
|
|
||
| So, with what you have learned, you could easily write your very own Hello World! program. I'll leave one example below, so take your time to analize it. | ||
| Note that there's nos only one way to code it, so it is likely you'll see other implementations online. A commented version of the code can be found inside | ||
| the repository, under CompilerApp > Premade > HelloWorld.bf | ||
| ``` | ||
| >++++++++[<+++++++++>-]<.>+++++++[<++++>-]<+.+++++++..+++.[-]>++++++++[<++++>-]<.>+++++++++++[<+++++>-]<. | ||
| >++++++[<++++>-]<.+++.>++[<--->-]<.>++++[<-->-]<.>+++++++++++++++++[<---->-]<+. | ||
| ``` | ||
|
|
||
| ## About. | ||
| BrainIDE is software developed by LovetheFrogs and licensed under GPL-3.0 license. |