hipycas / brainrs Goto Github PK

Allow definition of custom "function", with optional parameters like this:

:f:[++++<-]; Optional parenthesis for no parameters
:g(t): [t<-]; Parameters are just pieces of bf code that can be executed

Function definitions start with : and end with :, and in between the function name which must be a single character not already used and the parameters inside parenthesis. The end of the function definition is determined by a semicolon (;).

brained (name idea) is a CLI tool to ease the development of Brainf**k projects. Under the hood, it makes use of the brainrs interpreter, and gives you a project structure, build and run pipeline and tools and a easier way of working with your code.

Project structure

project_folder/
 |-- src/
 |     |-- main.bf
 |     |-- funcs.bf
 |     |-- ... (other code)
 |-- build/ (generated build files)
 |-- Brained.toml (configuration file)

All Brainf**k code files should be placed in the src directory, where all will be passed as included files and then main.rs will be the last to be executed. All output, if any, would go to the build folder. The Brained.toml file takes care of dependencies and all data related to the project.

File execution order

If your files should execute in any specific order, you can achieve so by indicating it in the Brained.toml file.

Before running the main input code, allow to pass with the -i flag a series of other code files that should be run before, and share the tape with the main file, thus allowing for code splitting functionalities.