Working with context

Here are some examples:

• {{ steps.step-id.results }} - Result of step-id
• keep.len({{ steps.step-id.results }}) - Number of results from step-id
• {{ steps.this.results[0] }} - First result of this step
• keep.first({{ steps.this.results }}) - First result (equivalent to the previous example)
• {{ steps.step-id.results[0][0] }} - First item of the first result

If you have suggestions/improvments/bugs for Keep’s syntax, please open feature request and get eternal glory.

​

Special context

Keep provides two special context containers - providers and steps

​

Providers

Provider configuration typically look like:

provider:
  type: mysql
  config: "{{ providers.mysql-prod }}"
  with:
    # Get max(datetime) from the random table
    query: "SELECT MAX(datetime) FROM demo_table LIMIT 1"

Here, {{ providers.mysql-prod }} is dynamically translated at runtime from the providers.yaml file.

​

Steps

The output of steps can be accessed from anywhere in the YAML using {{ steps.step-name.results }}. This output can be used in conditions, actions, or any other place.

​

Functions

Keep’s syntax allow to use functions on context blocks. For example, keep.len({{ steps.step-name.results }}) will return the number of results of step-name step.

• See supported functions
• Create new functions

Under the hood, Keep uses Python’s ast module to parse these expressions and evaluate them as best as possible.