Walk synchronously through query and doc, and print the list of matching branches of doc as a YAML document.

Result is printed to standard output as a list of found matches, including their keys.

Given file.yaml:

dict:
  first: value1
  second: value2

QYAML may be used to query, for example, the value of the first key of the dict dictionary:

$ qyaml "dict: first" < file.yaml
- dict:
    first: value1

The query is itself a YAML document.

The output may be flatten with fyaml to only values (default behavior) or preserving the keys with keys argument, or format as a JSON string with json argument:

$ cat file.yaml | qyaml "dict: first" | fyaml
value1

$ cat file.yaml | qyaml "dict: first" | fyaml keys
first: value1

$ cat file.yaml | qyaml dict | fyaml json
["value1", "value2"]

$ cat file.yaml | qyaml dict | fyaml json keys
[{"first": "value1"}, {"second": "value2"}]