yq/README.md

yaml

yaml is a lightweight and portable command-line YAML processor

The aim of the project is to be the jq or sed of yaml files.

Install

Download latest binary or alternatively:

go get github.com/mikefarah/yaml

Features

• Written in portable go, so you can download a lovely dependency free binary
• Deep read a yaml file with a given path
• Update a yaml file given a path
• Update a yaml file given a script file
• Update creates any missing entries in the path on the fly
• Create a yaml file given a deep path and value
• Create a yaml file given a script file
• Convert from json to yaml
• Convert from yaml to json
• Pipe data in by using '-'
• Merge multiple yaml files where each additional file sets values for missing or null value keys.
• Merge multiple yaml files with overwrite to support overriding previous values.

Usage

Check out the documentation for more detailed and advanced usage.

Usage:
  yaml [command]

Available Commands:
  help        Help about any command
  merge       yaml m [--inplace/-i] [--overwrite/-x] sample.yaml sample2.yaml
  new         yaml n [--script/-s script_file] a.b.c newValueForC
  read        yaml r sample.yaml a.b.c
  write       yaml w [--inplace/-i] [--script/-s script_file] sample.yaml a.b.c newValueForC

Flags:
  -h, --help      help for yaml
  -j, --tojson    output as json
  -t, --trim      trim yaml output (default true)
  -v, --verbose   verbose mode

Use "yaml [command] --help" for more information about a command.

Contribute

1. make vendor OR run govendor sync link
2. add unit tests
3. apply changes
4. make
5. profit