yq is a portable command-line YAML, JSON, XML, CSV, TOML and properties processor
Go to file
2017-09-23 20:24:09 -04:00
docs Feature: Add append to array 2017-09-23 20:21:16 -04:00
examples Bugfix: Read yaml array 2017-09-23 13:53:04 -04:00
mkdocs Feature: Add append to array 2017-09-23 20:21:16 -04:00
scripts Feature: Adds support for --version 2017-09-23 01:08:39 -04:00
vendor Feature: Adds merge command 2017-09-23 14:45:59 +10:00
.gitignore Task: Simplify development 2017-09-23 08:37:34 +10:00
.travis.yml Task: Simplify development 2017-09-23 08:37:34 +10:00
commands_test.go Feature: Add append to array 2017-09-23 20:21:16 -04:00
data_navigator_test.go Task: Increase test coverage, includes refactor 2017-09-22 23:01:46 -04:00
data_navigator.go Feature: Add append to array 2017-09-23 20:21:16 -04:00
Dockerfile.dev Task: Add merge command docs 2017-09-23 15:33:23 -04:00
json_converter_test.go Task: Increase test coverage, includes refactor 2017-09-22 23:01:46 -04:00
json_converter.go Task: Increase test coverage, includes refactor 2017-09-22 23:01:46 -04:00
LICENSE Added License (MIT) 2017-02-10 16:00:25 +11:00
Makefile Task: Add merge command docs 2017-09-23 15:33:23 -04:00
Makefile.variables Feature: Adds support for --version 2017-09-23 01:08:39 -04:00
merge_test.go Feature: Adds merge command 2017-09-23 14:45:59 +10:00
merge.go Feature: Adds merge command 2017-09-23 14:45:59 +10:00
mkdocs.yml Task: Add merge command docs 2017-09-23 15:33:23 -04:00
path_parser_test.go Feature: Add append to array 2017-09-23 20:21:16 -04:00
path_parser.go Task: Simplify development 2017-09-23 08:37:34 +10:00
README.md Feature: Adds support for --version 2017-09-23 01:08:39 -04:00
utils_test.go Task: Increase test coverage, includes refactor 2017-09-22 23:01:46 -04:00
version_test.go Feature: Adds support for --version 2017-09-23 01:08:39 -04:00
version.go Feature: Adds support for --version 2017-09-23 01:08:39 -04:00
yaml_test.go Task: Increase test coverage, includes refactor 2017-09-22 23:01:46 -04:00
yaml.go Feature: Add append to array 2017-09-23 20:21:16 -04:00

yaml Build Status

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 [flags]
  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
  -V, --version   Print version information and quit

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