Skip to content

Structured Local Files

Load values out of common local structured files — INI, JSON, YAML — using a parser and selector, without writing any parsing code.

Example

source parser selector value

env-alias:

  BUILD_NUMBER:
    source: "~/.config/myproject/manifest.json"
    parser: "json"
    selector: ".meta.build"

  DOCKER_TAG:
    value: 'env:BUILD_NUMBER'

Walkthrough:

  1. BUILD_NUMBER — parser: json deserialises the local manifest and selector: ".meta.build" pulls out the nested build number. ~ expands to the current user's home directory, so the path does not depend on where the alias is invoked.
  2. DOCKER_TAG — reuses that resolved value via value: 'env:BUILD_NUMBER' instead of duplicating it.