Drastically Reduced YAML / JSON Query
Project description
Drastically Reduced YAML / JSON Query
Lightweight package providing a subset of yq or jq functionality:
- get a single value from a YAML or JSON file
- change a single value in a YAML or JSON file
Requirements
PyYAML (Version 5.4.1 or newer)
Installation
pip install dryjq
Installation in a virtual environment is strongly recommended.
Usage
Please see the documentation at https://blackstream-x.gitlab.io/python-dryjq for detailed usage information.
The documentation is generated from the MarkDown files
in this repository’s docs/
directory.
Output of dryjq --help
(or python3 -m dryjq --help
):
usage: dryjq [-h] [--version] [-i] [-d | -v | -q] [-o OUTPUT_FORMAT]
[--indent {2,4,8}] [--sort-keys] [--separator SEPARATOR]
[--subscript-indicators SUBSCRIPT_INDICATORS]
[query] [input_file]
Drastically Reduced YAML / JSON Query
positional arguments:
query the query (simplest form of yq/jq syntax, default is
the separator character alone).
input_file the input file name (by default, data will be read
from standard input)
options:
-h, --help show this help message and exit
--version print version and exit
-i, --inplace modify the input file in place instead of writing the
result to standard output
Logging options:
control log level (default is WARNING)
-d, --debug output all messages (log level DEBUG)
-v, --verbose be more verbose (log level INFO)
-q, --quiet be more quiet (log level ERROR)
Output options:
control output formatting
-o OUTPUT_FORMAT, --output-format OUTPUT_FORMAT
output format (choice of 'JSON': set output format to
JSON, 'YAML': set output fromat to YAML, 'input': keep
input format, 'toggle': change JSON to YAML or vice
versa; default: 'input')
--indent {2,4,8} indentation depth of blocks, in spaces (default: 2)
--sort-keys sort mapping keys (by default, mapping keys are left
in input order)
Query syntax options:
control the query syntax
--separator SEPARATOR
the separator character (default: '.')
--subscript-indicators SUBSCRIPT_INDICATORS
the subscript indicator character(s) (default: '[]')
Issues, feature requests
Please open an issue here if you found a bug or have a feature suggestion.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
dryjq-1.9.1.tar.gz
(23.8 kB
view details)
Built Distribution
dryjq-1.9.1-py3-none-any.whl
(20.2 kB
view details)
File details
Details for the file dryjq-1.9.1.tar.gz
.
File metadata
- Download URL: dryjq-1.9.1.tar.gz
- Upload date:
- Size: 23.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | eff3d8be00d740e2befa57a97724f358cd7c5d95c0972326ad6d7d363fc51cca |
|
MD5 | 0f16ef099bf024702ec085bc9dcbb897 |
|
BLAKE2b-256 | 4854466a45c85956fc7df2e17bfcf63666afad089f0990af2389b23d2a76cda4 |
Provenance
File details
Details for the file dryjq-1.9.1-py3-none-any.whl
.
File metadata
- Download URL: dryjq-1.9.1-py3-none-any.whl
- Upload date:
- Size: 20.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a3d87ecf1d08dc57d83ec9431b79393425a7e71f7a23d7c295cab23c698b01b0 |
|
MD5 | 0e08ff29f39b5077cb11dcc2645a7319 |
|
BLAKE2b-256 | c5817b397c47b9369da9e1baa0337fe4536e6e1a90d883fabfa5ad357cac3790 |