安装

其他安装命令

macOS

Homebrew已验证 · 100%

brew install oq

local Homebrew formula metadata

MacPorts已验证 · 94%

sudo port install oq

MacPorts ports tree · devel/oq/Portfile · 来源: api.github.com

Linux

Alpine Linux apk已验证 · 92%

sudo apk add oq

Alpine Linux edge package indexes · oq · 来源: dl-cdn.alpinelinux.org

Nix已验证 · 92%

nix profile install nixpkgs#oq

nixpkgs package indexes · pkgs/by-name/oq/oq/package.nix · 来源: api.github.com

概览

软件包摘要

Performant, and portable jq wrapper to support formats other than JSON

项目链接

命令和别名

oq

历史

项目历史与用法

oq is a Crystal-written wrapper around `jq` that converts non-JSON formats into JSON for filtering and then serializes the result back out. Its core idea is to keep jq's filter language while adding practical YAML and XML input/output paths.

项目历史

George Dietrich introduced oq in a 2019 article after comparing existing jq-adjacent tooling and wanting a more portable, higher-performance option for large non-JSON documents. The project goals were portability, performance, and extending the formats that jq can handle without replacing jq's filter language.

The 1.x series broadened oq from a CLI into a small Crystal library as well. Release notes for v1.2.0 describe library support, a SimpleYAML format for streamable large inputs, and better handling of multiple non-JSON files; v1.3.0 added XML namespace options and forced-array behavior for XML parsing.

采用历史

oq remains a niche developer utility, but it has enough packaging surface to be available through Homebrew, Alpine, MacPorts, and Nix in the input metadata. Homebrew describes it as a performant and portable jq wrapper, with Crystal required only for source builds.

使用方式

A typical use keeps jq syntax in place and adds format flags, such as reading YAML with `-i yaml`, writing XML with `-o xml`, or using the tool as a Crystal dependency through `OQ::Processor`. That makes it useful in shell scripts where JSON, YAML, and XML need the same transformation logic.

为什么软件包爱好者会关心

oq is package-nerd interesting because it does less than a full data-query language and more than a one-off converter. It packages the proven jq execution model with format adapters and a single-binary distribution story, which is often the sweet spot for command-line glue.

时间线

2019: The author publishes the oq introduction and motivation.
2021-02-27: v1.2.0 adds library support, SimpleYAML, and improved multiple-file handling for non-JSON inputs.
2021-08-17: v1.3.0 adds XML namespace controls and XML force-array behavior.
2024-04-04: v1.3.5 is tagged.

Related projects

oq depends conceptually on jq and overlaps with yq-style data conversion workflows. Its implementation and library surface are tied to Crystal, libyaml, and XML/JSON conversion behavior.

来源

安全态势

风险级别：绿色

narrow executable package without higher-risk signals.

风险分类器

绿色风险 · 低置信度 · appliance

原因

narrow executable package without higher-risk signals

信号

metadata:no-higher-risk-signals

安装行为

formula 元数据中未记录 Homebrew post-install 钩子。
Homebrew bottle 元数据适用于 6 个平台目标。
安装时包含 3 个运行时依赖。
构建元数据列出 1 个构建依赖。

建议审查

在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。

可执行文件

已安装的可执行文件

命令	类型	暴露范围	备注
`oq`	cli	全局可执行文件

新鲜度

版本和新鲜度

这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。

页面生成时间2026-07-25

管理器版本1.3.5

管理器更新时间

本地数据OK

上游当前

检测到的最新版本v1.3.5

https://github.com/Blacksmoke16/oq

信息No package-manager update timestamp was available.低置信度

安装元数据

软件包元数据

软件包键	brew:oq
版本	1.3.5
软件包管理器	Homebrew
软件包管理器页面	https://formulae.brew.sh/formula/oq
主页	https://blacksmoke16.github.io/oq
仓库	https://github.com/Blacksmoke16/oq
上游文档	https://blacksmoke16.github.io/oq
许可证	MIT
源码归档	https://github.com/Blacksmoke16/oq/archive/refs/tags/v1.3.5.tar.gz
依赖	bdw-gc, libyaml, pcre2
构建依赖	crystal
macOS 提供的库	jq, libxml2
Bottle	可用 (于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	未定义
服务	未声明

注册表事实

源数据库详情

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	oq
Version Scheme	0
Revision	2
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	stable

源数据库匹配

其他软件包管理器记录

匹配项来自外部软件包管理器索引，并与本地 Automic Vault 软件包链接分开显示。

Nix95%

oq

nix profile install nixpkgs#oq

normalized package name match
匹配方式：Oq

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/oq/oq/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

apk95%

oq 1.3.5-r0

portable jq wrapper with support of other formats than JSON

https://github.com/blacksmoke16/oq

sudo apk add oq

License: MIT
Architecture: x86_64
Source Package: oq
1 依赖
1 提供
normalized package name match
匹配方式：Oq

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: oq from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

MacPorts95%

oq

sudo port install oq

normalized package name match
匹配方式：Oq

MacPorts ports tree · api.github.com · MacPorts ports tree: devel/oq/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

软件包图谱

链接来自本地软件包关系图、补充数据、依赖边、生态匹配和软件包 hub 归属。

来源线索

由仓库数据生成

此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。

Combined YAML source

View the package source record on GitHub.

combined/oq.yml

使用的来源

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

使用 Homebrew, apk, MacPorts, Nix 安装 oq