The quick start guide shows how to use the compiler to generate code and binaries from Fyr code. To install the compiler, please follow the instructions in Installation.
Fyr uses a C compiler to generate native applications.
By default, Fyr uses gcc, which must be installed.
Support for clang or avr-gcc will follow.
The package comes with the fyrc binary, which can be used to compile Fyr code into C or binary executables.
A simple hello_world.fyr looks like this:
export func main() int {
println("Hello World")
return 0
}
It can be compiled with fyrc -n hello_world.fyr.
The generated executable is hello_world and yields Hello World when run.
More examples can be found in the src/ folder of the repository.
The following example compiles a fyr source file into a C file.
The flag -c selects C as a compiler backend.
fyrc -c example.fyr
The output of the above command is example.c in the same directory.
Furthermore, the C-files are compiled and linked resulting in example.
To compile a package (i.e. all .fyr files in a directory`, go to the sources directory of the package and run
fyrc -n .
If the package is in the sources path of $FYRBASE or $FYRPATH, the object files are put to pkg/<architecture> in the respective path, and executables are put to bin/<architecture>.
This is preferable, since it does not clutter the source files with generated files.
You may set $FYRPATH to a directory that contains your personal sources in $FYRPATH/src.
The compiler will use it to search for additional packages referenced in your code.
If $FYRPATH is not set, it defaults to $HOME/fyr.
Optionally $FYRPATH can contain multiple paths separated by colons.