toml-parse

toml-parse is a utility step that parses a TOML file and extracts values using expr-lang expressions.

Configuration

Name	Type	Required	Description
path	string	Y	Path to a TOML file. This path is relative to the temporary workspace that Kargo provisions for use by the promotion process.
outputs	[]object	Y	A list of rules for extracting values from the parsed TOML.
outputs[].name	string	Y	The name of the output variable.
outputs[].fromExpression	string	Y	An expr-lang expression that can extract the value from the TOML file. Note that this expression should not be offset by ${{ and }}. See examples for more details.

Expressions

The fromExpression field supports expr-lang expressions.

note

Expressions should not be offset by ${{ and }} to prevent pre-processing evaluation by Kargo. The toml-parse step itself will evaluate these expressions.

An outputs object (a map[string]any) is available to these expressions. It is structured as follows:

Field	Type	Description
outputs	map[string]any	The parsed TOML object.

Outputs

The toml-parse step produces the outputs described by the outputs field in its configuration.

Examples

Common Usage

In this example, a TOML file is parsed to find the container image tag. After cloning the repository and clearing the output directory, the toml-parse step parses config.toml to extract the image tag from the Freight being promoted. Using dot notation (image.tag), it extracts the nested value from the TOML file.

vars:
- name: gitRepo
  value: https://github.com/example/repo.git
steps:
- uses: git-clone
  config:
    repoURL: ${{ vars.gitRepo }}
    checkout:
    - commit: ${{ commitFrom(vars.gitRepo).ID }}
      path: ./src
    - branch: stage/${{ ctx.stage }}
      create: true
      path: ./out
- uses: git-clear
  config:
    path: ./out
- uses: toml-parse
  as: values
  config:
    path: './src/config.toml'
    outputs:
    - name: imageTag
      fromExpression: image.tag
# Render manifests to ./out, commit, push, etc...

Given the sample input TOML:

[image]
tag = "v1.2.3"

[rbac]
installClusterRoles = true

The step would produce the following outputs:

Name	Type	Value
imageTag	string	v1.2.3