gerap

The package manager for the Gera programming language.

Commands

gerap new <name>

Creates a new project in a new directory with the given name.

gerap init

Creates a new project in the current working directory.

gerap build

Builds the project in the current directory.

gerap run

Builds and executes the project in the current directory. If the target is c this requires that the C compiler used generates an executable that can be used on this system.

gerap test

Runs all tests for this package using the C target. Requires that the C compiler used generates an executable that can be used on this system.

gerap info <procedure/variable/module>

Prints information about the given procedure, variable or module for the project in the current directory. The displayed information only gets refreshed after gerap build or gerap run is used.

gerap doc <modules...>

Generates documentation for all given module names (and their submodules) for the project in the current directory.

gerap clean

Deletes all output files generated by gerap, including compilation output, generated documentation and downloaded packages.

Environment Variables

• NO_COLOR, GERAP_NO_COLOR - Disables colored output if set.
• GERAP_JAVA_PATH - Defines the path of the Java implementation to use. Defaults to java if not set.
• GERAP_GERAC_PATH - Defines the path of the Gera compiler to use (jar file). Must be set.
• GERAP_GIT_PATH - Defines the path of the Git implementation to use. Defaults to git if not set.
• GERAP_CC_PATH - Defines the path of the C compiler to use. Defaults to cc if not set.
• GERAP_CC_ARGS - Defines C compiler arguments to use.
• GERAP_CCOREDEPS_PATH - Defines the C core dependencies to use. Defaults to https://github.com/geralang/ccoredeps if not set.
• GERAP_JS_PATH - Defines the Javascript runtime to use if a project with target js is executed with gerap run. Defaults to node if not set.

CLI arguments

• --no-color - Disables color.
• --cc-path <path> - Defines the path of the C compiler to use for built binaries. Overwrites the GERAP_CC_PATH environment variable.
• --cc-args <args...> - Defines the C compiler arguments to use. All following CLI arguments will be passed to the C compiler. Overwrites the GERAP_CC_ARGS environment variable.
• --ccoredeps-path <path> - Defines the path of the implementation of the C coredeps implementation to use. Overwrites the GERAP_CCOREDEPS_PATH environment variable.