Input Data

input.yaml:

documents:
  - title: Some document title
    sections:
    - title: Some section title
      description: Some section description
      text: Some text for some section
      chapters:
      - title: Some chapter title
        description: Some chapter description
        text: The text of some chapter
      - title: Some other chapter title
        description:
        - descriptionparagraph1: Some description for other chapter
        - descriptionparagraph2: Some description for other chapter
        text: The text of some other chapter
    - title: Some other section title
      description: Some other section description
      text: Some text for some other section
      chapters:
        - title: About encoding
          description: "Some German: äöü,ÄÖÜ,ß"

Schema for validating input.yaml

schema.yaml

$schema: "http://json-schema.org/schema#"

definitions:
  chapter:
    type: object
    properties:
      title: {type: string}
      description:
        oneOf: [{type: string}, {type: array}]
      text: {type: string}
    additionalProperties: false
    required: [title, description]
  chapters:
    type: array
    items: {$ref: "#/definitions/chapter"}
    additionalItems: false
  section:
    type: object
    properties:
      title: {type: string}
      description: {type: string}
      text: {type: string}
      chapters: {$ref: "#/definitions/chapters"}
    additionalProperties: false
    required: [title, description]
  sections:
    type: array
    items: {$ref: "#/definitions/section"}
    additionalItems: false
  document:
    type: object
    properties:
      title: {type: string}
      description: {type: string}
      sections: {$ref: "#/definitions/sections"}
    additionalProperties: false
    required: [title, description]
  documents:
    type: array
    items: {$ref: "#/definitions/document"}
    additionalItems: false
type: object
properties:
  documents: {$ref: "#/definitions/documents"}
additionalProperties: false

When not providing a jsonpath expression

If you don’t provide a jsonpath expression using the -p option ytools uses '$' as default and therefore dumps the complete input:

🎼  ytools input.yaml
---
documents:
- title: Some document title
  description: The document's description
  sections:
  - title: Some section title
    description: Some section description
    text: Some text for some section
    chapters:
    - {title: Some chapter title, description: Some chapter description, text: The
        text of some chapter}
    - title: Some other chapter title
      description:
      - {descriptionparagraph1: Some description for other chapter}
      - {descriptionparagraph2: Some description for other chapter}
      text: The text of some other chapter
  - title: Some other section title
    description: Some other section description
    text: Some text for some other section
    chapters:
    - {title: About encoding, description: 'Some German: äöü,ÄÖÜ,ß'}
...

Output format yaml (default)

With the yaml output format by default, each match is output as a separate yaml document. This way we achieve that the output is valid yaml.:

🎼  ytools -p '$..chapters[*].description' input.yaml
--- Some chapter description
...

---
- {descriptionparagraph1: Some description for other chapter}
- {descriptionparagraph2: Some description for other chapter}
...

--- 'Some German: äöü,ÄÖÜ,ß'
...

If you want different behavior you can set explicit_start and/or explicit_end to False. In this case the output will no longer be guaranteed to be valid yaml:

🎼  ytools -p '$..chapters[*].description' input.yaml --yaml-options='{explicit_start: False, explicit_end: False}'
Some chapter description
...

- {descriptionparagraph1: Some description for other chapter}
- {descriptionparagraph2: Some description for other chapter}

'Some German: äöü,ÄÖÜ,ß'

Other output formats

Unfortunately, when using the json or python output format the same selection can’t produce valid json or python output. That’s because neither json nor python support the concept of (multiple) documents:

🎼  ytools -p '$..chapters[*].description' input.yaml -f json --json-options='{indent: 4}'
"Some chapter description"
[
    {
        "descriptionparagraph1": "Some description for other chapter"
    },
    {
        "descriptionparagraph2": "Some description for other chapter"
    }
]
"Some German: \u00e4\u00f6\u00fc,\u00c4\u00d6Y,\u00df"

That’s definitely not valid json.

Neither is the following valid python:

🎼  ytools -p '$..chapters[*].description' input.yaml -f python
Some chapter description
[{'descriptionparagraph1': 'Some description for other chapter'}, {'descriptionparagraph2': 'Some description for other chapter'}]
Some German: äöü,ÄÖÜ,ß

So if you ever want to process the output automatically please stick to ``yaml``.

Input Data

test/sampledata.yaml

name: 'my_name'
date: '2017-10-01T10:55:00Z'
metrics:
  percentage:
    value: 87
    trend: stable

Schema for Validating

test/sampleschema.yaml

type: object
properties:
  name: { type: string }
  date: { type: string, format: date-time }
  metrics:
    type: object
    properties:
      percentage:
        type: object
        properties:
          value:
            type: number
            minimum: 0
            maximum: 100
          trend: { type: string, enum: [down, stable, up] }
        additionalProperties: false
        required: [value, trend]
    additionalProperties: false
    required: [percentage]
additionalProperties: false
required: [name, date, metrics]