Preprocessor

Preprocessor is an stage in within compilation (simplified) that works with lexer tokens (e.g raw text) and resolves references to preprocessor itself (e.g #include is preprocessor only directive and will throw an error if occured at next possible stage: parser)

All preprocessor keywords begins with #

Include system and #include

Most of the time you dont write program in a single file, or require additional code from libraries, in Gofra #inlcude allows to straighforward include whole text of an file (with some additional file path resolving and include-once strategy)

#include "sum.gof"

func void main
    2 2 sum // sum is defined at sum.gof
end

Inlcude system is like recursive so all definitions of an preprocessor will be available at include side

Module include

In Gofra, there is convention that when you include an directory (e.g #include "dir") it will search for file in that directory named same as directory itself, e.g dir directory will search for dir/dir.gof file and that is being included, that simplifies layout of directory tree of libraries

Searching strategy

At start of search, same file or an directory (e.g directory include file) will be searched in current working file directory parent, e.g if you include something from stdlib and it include something it first looks at its own directory, not your main one At next, if file is not found, it will search from directory where you main file is located And if file is not found there also, it will search against all include search directory (e.g -isd CLI flag)

Overview: 1. Parent of an current file (not main) 2. Parent of an main file 3. Include search directories