jq-lite — Lightweight jq
概 What is jq-lite?
jq-lite is a Pure Perl JSON query engine inspired by jq.
It lets you query and transform JSON using jq-like syntax — without external binaries, native libraries, or compilation.
正 Official Alpine Linux package
apk add jq-lite
JQ::Lite is designed for minimal environments such as:
- Alpine Linux
- containers & CI pipelines
- legacy / restricted / air-gapped systems
where simplicity, readability, and low dependency footprint matter.
要 Why jq-lite
-
軽 Pure Perl — no XS, no C, no shared libraries
-
探 jq-style filters:
.users[].name,select(...),map(...) -
算 Arithmetic & conditionals:
if ... then ... else ... end -
具 CLI tool:
jq-lite--null-input,--slurp,--from-file--yaml,--arg,--rawfile,--argfile,--argjson,--ascii-output
-
術 100+ built-in jq functions
-
対 Interactive mode
-
材 JSON & YAML input
-
域 Runs almost anywhere Perl runs
試 Quick Start (CLI)
jq-lite '.users[].name' users.json
jq-lite '.users[] | select(.age > 25)' users.json
jq-lite --yaml '.users[].name' users.yaml
Interactive exploration:
jq-lite users.json
境 Environment Support
| Environment | jq | jq-lite | | -------------------- | -- | ------- | | Legacy CentOS / RHEL | 不X | 可O | | Alpine Linux | 条△ | 可O | | Air-gapped systems | 不X | 可O | | No root privilege | 条△ | 可O |
可 Runs on Perl ≥ 5.14 (e.g. CentOS 6, Debian 7 via perlbrew or local install)
理 Why Pure Perl?
携 Portability
No compilation, no shared libraries. If Perl runs, jq-lite runs.
拡 Extensibility
Extend jq-like behavior directly in Perl.
- LWP
- DBI
- filesystem / OS tools
融 Seamless Perl Integration
use JQ::Lite;
my $jq = JQ::Lite->new;
say for $jq->run_query($json, '.users[].name');
No external command calls. No parsing of CLI output.
軽 Lightweight Installation
- No XS / C toolchain
- No system-wide install
- Ideal for CI/CD
保 Maintainability
- Faster iteration than C-based jq
- Easier debugging
- Simple contributions
入 Installation
配 CPAN
cpanm JQ::Lite
林 Alpine Linux
apk add jq-lite
麦 Homebrew (macOS)
brew tap kawamurashingo/jq-lite
brew install --HEAD jq-lite
容 Containers
FROM alpine
RUN apk add --no-cache jq-lite
jq-lite is ideal as a container-standard JSON tool.
移 Portable Installer (Offline)
./download.sh [-v <version>] [-o /path]
./install.sh [-p <prefix>] [--skip-tests] JQ-Lite-<version>.tar.gz
Default:
$HOME/.local
窓 Windows (PowerShell)
.\install-jq-lite.ps1 [-Prefix <path>] [--SkipTests] JQ-Lite-<version>.tar.gz
例 Example Queries
jq-lite '.users[] | select(.profile.active) | .name'
jq-lite '.users | sort_by(.age) | map(.name) | join(", ")'
jq-lite '.users[].nickname? // .name'
書 Documentation
作 Author
川村慎吾 (Shingo Kawamura) pannakoota1@gmail.com
許 License
Same terms as Perl itself.