README.md (jq-1.5) | : | README.md (jq-1.6) | ||
---|---|---|---|---|
jq | jq | |||
== | == | |||
jq is a command-line JSON processor. | jq is a lightweight and flexible command-line JSON processor. | |||
[](https://coveralls.io/github/stedolan/jq?branch=master), | ||||
Unix: [](htt | ||||
ps://travis-ci.org/stedolan/jq), | ||||
Windows: [](https://ci.appveyor.com/project/stedolan/jq) | ||||
If you want to learn to use jq, read the documentation at | If you want to learn to use jq, read the documentation at | |||
[https://stedolan.github.io/jq](https://stedolan.github.io/jq). This | [https://stedolan.github.io/jq](https://stedolan.github.io/jq). This | |||
documentation is generated from the docs/ folder of this repository. | documentation is generated from the docs/ folder of this repository. | |||
You can also try it online at [jqplay.org](https://jqplay.org). | You can also try it online at [jqplay.org](https://jqplay.org). | |||
If you want to hack on jq, feel free, but be warned that its internals | If you want to hack on jq, feel free, but be warned that its internals | |||
are not well-documented at the moment. Bring a hard hat and a | are not well-documented at the moment. Bring a hard hat and a | |||
shovel. Also, read the wiki: https://github.com/stedolan/jq/wiki | shovel. Also, read the wiki: https://github.com/stedolan/jq/wiki, where | |||
you will find cookbooks, discussion of advanced topics, internals, | ||||
release engineering, and more. | ||||
Source tarball and built executable releases can be found on the | Source tarball and built executable releases can be found on the | |||
homepage and on the github release page, https://github.com/stedolan/jq/releases | homepage and on the github release page, https://github.com/stedolan/jq/releases | |||
If you're building directly from the latest git, you'll need flex, | If you're building directly from the latest git, you'll need flex, | |||
bison (3.0 or newer), libtool, make, and autoconf installed. To get | bison (3.0 or newer), libtool, make, and autoconf installed. | |||
regexp support you'll also need to install Oniguruma (note that jq's | To get regexp support you'll also need to install Oniguruma or clone it as a | |||
tests require regexp support to pass). To build, run: | git submodule as per the instructions below. | |||
(note that jq's tests require regexp support to pass). To build, run: | ||||
autoreconf -i # if building from git | ||||
./configure | git submodule update --init # if building from git to get oniguruma | |||
autoreconf -fi # if building from git | ||||
./configure --with-oniguruma=builtin | ||||
make -j8 | make -j8 | |||
make check | make check | |||
To build without bison or flex, add `--disable-maintainer-mode` to the | To build without bison or flex, add `--disable-maintainer-mode` to the | |||
./configure invocation: | ./configure invocation: | |||
./configure --disable-maintainer-mode | ./configure --with-oniguruma=builtin --disable-maintainer-mode | |||
(Developers must not use `--disable-maintainer-mode`, not when making | (Developers must not use `--disable-maintainer-mode`, not when making | |||
changes to the jq parser and/or lexer.) | changes to the jq parser and/or lexer.) | |||
To build a statically linked version of jq, run: | To build a statically linked version of jq, run: | |||
make LDFLAGS=-all-static | make LDFLAGS=-all-static | |||
After make finishes, you'll be able to use `./jq`. You can also | After make finishes, you'll be able to use `./jq`. You can also | |||
install it using: | install it using: | |||
End of changes. 4 change blocks. | ||||
9 lines changed or deleted | 20 lines changed or added |