Skip to main content

Command-line YAML processor - jq wrapper for YAML documents

Project description

Installation

pip install yq

Before using yq, you also have to install its dependency, jq. See the jq installation instructions for details and directions specific to your platform.

Synopsis

yq’s mode of operation is simple: it transcodes YAML on standard input to JSON (using yaml.safe_load to avoid dangerous vulnerabilities in YAML/PyYAML design) and pipes it to jq:

cat input.yml | yq .foo.bar

Or specify the filename directly:

yq .foo.bar input.yml

By default, no transcoding of jq output is done. Specify the --yaml-output/-y option to transcode it back into YAML (using yaml.safe_dump):

cat input.yml | yq -y .foo.bar

Use the --width/-w argument to pass the line wrap width for string literals.

All other command line arguments are forwarded to jq. yq forwards the exit code jq produced, unless there was an error in YAML parsing, in which case the exit code is 1. See the jq manual for more details on jq features and options.

Authors

  • Andrey Kislyuk

License

Licensed under the terms of the Apache License, Version 2.0.

https://img.shields.io/travis/kislyuk/yq.svg https://codecov.io/github/kislyuk/yq/coverage.svg?branch=master https://img.shields.io/pypi/v/yq.svg https://img.shields.io/pypi/l/yq.svg https://readthedocs.org/projects/yq/badge/?version=latest

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yq-2.1.2.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

yq-2.1.2-py2.py3-none-any.whl (6.2 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file yq-2.1.2.tar.gz.

File metadata

  • Download URL: yq-2.1.2.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for yq-2.1.2.tar.gz
Algorithm Hash digest
SHA256 daa2fcde26220382527c68bac353a7d972d81ea4f348d20eea3ffa981991f8dc
MD5 14532bedeba4e0a910262603e5288711
BLAKE2b-256 7df1a514c077d4022ce1358cb6f25d003a71aa5485a437c2ca649c7d6b34d4f3

See more details on using hashes here.

Provenance

File details

Details for the file yq-2.1.2-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for yq-2.1.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 85a3a1707838802fff63f0ba64096ba8e97f5af5824e87ed99e019b1ba83cdc7
MD5 d4a7421b71dcd3841cc847eda81b4b98
BLAKE2b-256 16493d5f8fd5080e5c746fc02f66fe983922ec013c2c061507377eb8575a68a3

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page