mirror of
https://github.com/stedolan/jq.git
synced 2024-05-11 05:55:39 +00:00
173 lines
6.9 KiB
YAML
173 lines
6.9 KiB
YAML
headline: Download jq
|
|
body:
|
|
|
|
- text: |
|
|
|
|
jq is written in C and has no runtime dependencies, so it should be
|
|
possible to build it for nearly any platform. Prebuilt binaries are
|
|
available for Linux, OS X and Windows.
|
|
|
|
The binaries should just run, but on OS X and Linux you may need
|
|
to make them executable first using `chmod +x jq`.
|
|
|
|
jq is licensed under the MIT license. For all of the gory
|
|
details, read the file `COPYING` in the source distribution.
|
|
|
|
|
|
### Linux
|
|
|
|
* jq 1.5 is in the official [Debian](https://packages.debian.org/jq) and
|
|
[Ubuntu](http://packages.ubuntu.com/jq) repositories. Install using
|
|
`sudo apt-get install jq`.
|
|
|
|
* jq 1.5 is in the official
|
|
[Fedora](http://pkgs.fedoraproject.org/cgit/jq.git/) repository.
|
|
Install using `sudo yum install jq`.
|
|
|
|
* jq 1.4 is in the official [openSUSE](https://software.opensuse.org/package/jq)
|
|
repository. Install using `sudo zypper install jq`.
|
|
|
|
* For Arch users, a PKGBUILD is in the
|
|
[AUR](https://aur.archlinux.org/packages/jq-git/).
|
|
Refer to the
|
|
[ArchWiki](https://wiki.archlinux.org/index.php/Arch_User_Repository)
|
|
for how to install from AUR.
|
|
|
|
* jq 1.5 binaries for
|
|
[64-bit](https://github.com/stedolan/jq/releases/download/jq-1.5/jq-linux64)
|
|
or
|
|
[32-bit](https://github.com/stedolan/jq/releases/download/jq-1.5/jq-linux32).
|
|
|
|
* jq 1.4 binaries for
|
|
[64-bit](https://github.com/stedolan/jq/releases/download/jq-1.4/jq-linux-x86_64)
|
|
or
|
|
[32-bit](https://github.com/stedolan/jq/releases/download/jq-1.4/jq-linux-x86).
|
|
|
|
* jq 1.3 binaries for
|
|
[64-bit](https://github.com/stedolan/jq/releases/download/jq-1.3/jq-linux-x86_64)
|
|
or
|
|
[32-bit](https://github.com/stedolan/jq/releases/download/jq-1.3/jq-linux-x86).
|
|
|
|
### OS X
|
|
|
|
* Use [Homebrew](http://brew.sh/) to install jq 1.5 with
|
|
`brew install jq`.
|
|
|
|
* jq 1.5 binary for
|
|
[64-bit](https://github.com/stedolan/jq/releases/download/jq-1.5/jq-osx-amd64).
|
|
|
|
* jq 1.4 binaries for
|
|
[64-bit](https://github.com/stedolan/jq/releases/download/jq-1.4/jq-osx-x86_64)
|
|
or
|
|
[32-bit](https://github.com/stedolan/jq/releases/download/jq-1.4/jq-osx-x86).
|
|
|
|
* jq 1.3 binaries for
|
|
[64-bit](https://github.com/stedolan/jq/releases/download/jq-1.3/jq-osx-x86_64)
|
|
or
|
|
[32-bit](https://github.com/stedolan/jq/releases/download/jq-1.3/jq-osx-x86).
|
|
|
|
### FreeBSD
|
|
|
|
* Use [FreshPorts](https://www.freshports.org/textproc/jq/) to install
|
|
jq 1.4 with `pkg install jq`.
|
|
|
|
### Solaris
|
|
|
|
* `pkgutil -i jq` in [OpenCSW](https://www.opencsw.org/p/jq) for Solaris
|
|
10+, Sparc and x86.
|
|
|
|
* jq 1.4 binaries for Solaris 11
|
|
[64-bit](https://github.com/stedolan/jq/releases/download/jq-1.4/jq-solaris11-64)
|
|
or
|
|
[32-bit](https://github.com/stedolan/jq/releases/download/jq-1.4/jq-solaris11-32).
|
|
|
|
### Windows
|
|
|
|
* Use [Chocolatey NuGet](https://chocolatey.org/) to install jq 1.5 with
|
|
`chocolatey install jq`.
|
|
|
|
* jq 1.5 executables for
|
|
[64-bit](https://github.com/stedolan/jq/releases/download/jq-1.5/jq-win64.exe)
|
|
or
|
|
[32-bit](https://github.com/stedolan/jq/releases/download/jq-1.5/jq-win32.exe).
|
|
|
|
* jq 1.4 executables for
|
|
[64-bit](https://github.com/stedolan/jq/releases/download/jq-1.4/jq-win64.exe)
|
|
or
|
|
[32-bit](https://github.com/stedolan/jq/releases/download/jq-1.4/jq-win32.exe).
|
|
|
|
* jq 1.3 executables for
|
|
[64-bit](https://github.com/stedolan/jq/releases/download/jq-1.3/jq-win64.exe)
|
|
or
|
|
[32-bit](https://github.com/stedolan/jq/releases/download/jq-1.3/jq-win32.exe).
|
|
|
|
### Checksums and signatures
|
|
|
|
SHA-256 checksums are provided for all release and pre-release binaries.
|
|
They can be found under
|
|
[sig/v1.x/sha256sum.txt](https://github.com/stedolan/jq/tree/master/sig).
|
|
The checksums for jq 1.5 are in
|
|
[sig/v1.5/sha256sum.txt](https://raw.githubusercontent.com/stedolan/jq/master/sig/v1.5/sha256sum.txt).
|
|
|
|
Additionally, all binaries are signed by the
|
|
[jq Package Signing Key](https://raw.githubusercontent.com/stedolan/jq/master/sig/jq-release.key).
|
|
The signatures can be found under
|
|
[sig/v1.x/\*.asc](https://github.com/stedolan/jq/tree/master/sig).
|
|
The signatures for jq 1.5 are in
|
|
[sig/v1.5/\*.asc](https://github.com/stedolan/jq/tree/master/sig/v1.5).
|
|
You can use [GnuPG](https://gnupg.org/) to verify a signature by downloading
|
|
the signature and running `gpg --verify signature.asc`.
|
|
|
|
### From source on Linux, OS X, Cygwin, and other POSIX-like operating systems
|
|
|
|
* [Source tarball for jq 1.5](https://github.com/stedolan/jq/releases/download/jq-1.5/jq-1.5.tar.gz)
|
|
|
|
You can build it using the usual `./configure && make && sudo
|
|
make install` rigmarole.
|
|
|
|
If you're interested in using the lastest development version, try:
|
|
|
|
git clone https://github.com/stedolan/jq.git
|
|
cd jq
|
|
autoreconf -i
|
|
./configure --disable-maintainer-mode
|
|
make
|
|
sudo make install
|
|
|
|
To build it from a git clone, you'll need to install a few
|
|
packages first:
|
|
|
|
* [GCC](https://gcc.gnu.org)
|
|
* [Make](https://www.gnu.org/software/make/)
|
|
* [Autotools](https://www.gnu.org/software/automake/)
|
|
|
|
For Linux systems, these will all be in your system's package
|
|
manager, and if you do development on the machine they're most
|
|
likely already installed.
|
|
|
|
On OS X, these are all included in Apple's command line tools, which can
|
|
be installed from [Xcode](https://developer.apple.com/xcode/). However,
|
|
you may find that you need a newer version of Bison than the one provided
|
|
by Apple. This can be found in [Homebrew](http://brew.sh) or
|
|
[MacPorts](https://macports.org/).
|
|
|
|
The `--disable-maintainer-mode` flag says to use the pre-generated lexer
|
|
and parser that come with the code. To compile the lexer and parser also
|
|
from source, leave out this flag. You will need to install
|
|
[Flex](http://flex.sourceforge.net/) and
|
|
[Bison](https://www.gnu.org/software/bison/).
|
|
|
|
#### Building the documentation
|
|
|
|
jq's documentation is compiled into static HTML using
|
|
[Bonsai](http://www.tinytree.info). To view the documentation
|
|
locally, run `rake serve` (or `bundle exec rake serve`) from the
|
|
docs/ subdirectory. To build the docs just `rake build` from the
|
|
docs subdirectory. You'll need a few Ruby dependencies, which can
|
|
be installed by following the instructions in `docs/README.md`.
|
|
|
|
The man page is built by `make jq.1`, or just `make`, also from
|
|
the YAML docs, and you'll still need the Ruby dependencies to
|
|
build the manpage.
|
|
|