palgen.toml#

Minimum required project settings#

To be able to run palgen the project’s root directory must include a file called palgen.toml. This file can be used to configure both palgen and provide settings for extensions used in this project.

Builtin settings:

 1# Required
 2[project]
 3name        = "Foobar"       # Project name
 4version     = "v0.1"         # Project version string. Optional.
 5description = "Bars the foo" # Project description. Optional.
 6sources     = ["src"]        # List of source folders. Optional, defaults to none.
 7
 8# Optional. All fields of the palgen table have defaults.
 9[palgen]
10output = "build" # Default output path
11jobs   = 4       # Maximum amount of parallel jobs to use. Defaults to number of virtual CPU cores.
12
13# Optional. All fields of the palgen.extensions table have defaults.
14[palgen.extensions]
15inline       = true           # Search for extensions in the project's source folders
16inherit      = true           # Whether to inherit extensions from dependencies
17folders      = ["templates"]  # Extra paths to check for extensions
18dependencies = ["dependency"] # List of Paths to dependencies
19
20python   = true # Load extensions from Python modules
21manifest = true # Load extensions from `palgen.manifest` files

Schemas for these default settings can be found in the palgen/schemas subdirectory.