Skip to content

Workspace Definition

cobble.toml

The presence of a cobble.toml file marks the root of a Cobble workspace. The cobble.toml file can also contain configuration for the workspace. The following options can be configured in the cobble.toml file:

  • root_projects: array[string] - A list of root project paths to include in the workspace (Default = ["."])
  • num_threads: int - Number of threads to use for executing tasks (Default = 5)
  • modules_dir: string - Directory to search for lua modules in. modules_dir must exist within the workspace. (Default = ".", i.e. the workspace root is used as the module directory.)
  • stdout: "always" | "never" | "on_fail" - When to display stdout output from tasks (Default = "on_fail")
  • stderr: "always" | "never" | "on_fail" - When to display stderr output from tasks (Default = "on_fail")
  • output: "always" | "never" | "on_fail" - Sets both stdout and stderr. If stdout or stderr properties are present, they will take precedence over output.
  • vars: table - Variables which can be used in actions

Example

An example of what a cobble.toml file might look like:

root_projects = [ "./project_a", "./project_b" ]
num_threads = 10
modules_dir = "cobble"

[vars]
foo = "bar"
python.version = "3.11"