Directive

Directives are global configuration statements prefixed with @. They are processed before recipe definitions.

DirectiveDescriptionValueExample
importImport another chariot file.Path to a chariot file, relative to the current file. Supports globs.@import "recipes/*.chariot"
envDeclare a global environment variable.Key-value pair of environment variable name and value.@env "CLICOLOR_FORCE" = "1"
collectionCreate a collection of dependencies.Key-value pair of collection name and its dependencies.@collection autotools = [ tool/autoconf tool/automake ]
optionDeclare an option.Key-value pair of option name and valid values. Note that the first value is considered the default value.@option "buildtype" = [ "debug", "release" ]
global_pkgAdd global image packagesEither a package or a list of packages.@global_pkg build-essentials