Pure Python implementation of a subset of the features of
jq
for YAML
documents.
Status: No active development planned, maintenance work only. This repository
is superseded by https://github.com/kislyuk/yq in PyPI, starting with version 2.0.0
.
If you're looking for a way to do jq
-like filtering on YAML
documents,
you'll probably be better off using the yq
provided by y2j
or kislyuk/yq
. They
provides a wrapper around jq
that transforms the input YAML
into
JSON
, calls out to jq
, then transforms the result back. This means it
automatically supports the full feature set of jq
.
If for some reason you need a pure python implementation, this repo is for you.
pip install 'yq < 2.0.0'
Everything from the Basic
Filters section
of the jq
manual is supported - at least yq
acts the same way as
jq
in the examples there. Object construction also more or less
works.
The parsing technology used in this project (parser combinators) is
not powerful enough to support parsing some of the more complex features of
jq
.
virtualenv virtualenv . virtualenv/bin/activate pip install -r requirements.txt # Optionally install as a package: pip install .
There are basic unit-tests for some of the operators, but the meat of
the test suite are the functional tests defined in
functional_tests/*.yml
files and run by run_functional_tests.py
.
The whole test suite of jq
is in functional_tests/jq.txt
, run by
run_jq_tests.py
. Sections starting with a line containing skip
are, surprisingly, skipped - until that functionality is implemented.
They're all started by nosetests
Here are some steps that'd need to be taken to bring the feature set of
this yq
closer to that of jq
.
- Work the same way as
jq
for the "Types and Values" section - Operators, functions
- Check if operators can be refactored
- Package, release
- Conditionals, comparisons
- "Advanced features", Assignment from the
jq
manual