bf-link
A brainf*ck linker and minifier
Installing
You can install this module for use on the command line by running:
npm install -g bf-link
Alternatively, you can use bf-link in your module by running this command:
npm install -s bf-link
Usage
bf-link -i <infile> -o <outfile> -l <library location>
Introduction
A brainf*ck file can link other files in a variety of ways.
Project modules refer to another unlinked (or linked) file that can reside anywhere on your file system, but require a relative or absolute path to each one.
Project packages refer to pre-linked singular files that reside within a particular folder that you can specify during compile time.
You'd typically use project modules for project specific files (such as a constants file). On the other hand, you'd use pre-linked project modules when you repeatedly use a file (such as a cell swapping file).
Command line usage
Firstly, you can view the help page built into the linker at any time by running:
bf-link -h
Now for an example, say you had a project structure of:
myProject/
├-- main.b
├-- const.b
├-- const1.b
├-- const2.b
└-- lib/
└-- add.b
Where
main.b
is the main entry file (i.e. nothing else depends on it in the project)const.b
brings together the constants, and sets themconst1.b
is a file which moves along one cell, and adds 7const2.b
is a file which moves along one cell, and adds 5lib/add.b
is a pre-linked and minified file which adds two cells together
So let's start by creating the const1.b
and const2.b
, as we need no extra knowledge of this.
const1.b
move along one cell
>
add 7 to the cell
+++++++
const2.b
move along one cell
>
add 5 to the cell
+++++
Great! Now we need to include the project modules const1.b
and const2.b
in the const.b
file, which will set the cells that we need.
We can link a file by using the syntax {{absolute/or/relative/path/to/file.b}}
. This will get replaced by the linker with the actual file contents, and then get minified after.
const.b
this will get replaced by the contents of const1
{{const1.b}}
this will get replaced by the contents of const2
{{const2.b}}
and we want to move back two cells to get back to the 0th cell
<<
So therefore, after linking this file will become:
move along one cell
>
add 7 to the cell
+++++++
move along one cell
>
add 5 to the cell
+++++
and we want to move back two cells to get back to the 0th cell
<<
Awesome! We want to then set these constants in our entry file, so let's import the const.b
file into the main.b
file. In this example, we don't include the file extension, as it isn't strictly necessary.
main.b
{{const}}
Now that we have that sorted, we want to import our add package, which does not depend on anything (either it doesn't import anything, or it has been pre-linked).
The syntax for this uses ((libraryname))
. In our example, we can import it by using ((add))
, like this:
main.b
{{const}}
((add))
Building our project
Now we've got all of the files set up, we can build our project. Our entry point is main.b
, we want our linked and minified file to be saved as out.b
, and our library folder is at lib/
. Therefore, we can run this command in our project directory to build it:
bf-link -i main.b -o out.b -l lib
TODOs
- Talk about the node API for linking files
- Make the documentation better/clearer
- Write unit tests