jq

镜像概述和主要用途

基于alpine:edge构建的jq Docker化镜像。

根据jq官网描述：

jq是轻量级且灵活的命令行JSON处理器。jq就像是JSON数据的sed——您可以像使用sed、awk、grep等工具处理文本一样轻松地对结构化数据进行切片、过滤、映射和转换。

该镜像的源代码托管在GitHub的backplane/conex仓库中。

核心功能和特性

• 轻量级基础：基于alpine:edge，镜像体积小，资源占用低
• 完整JSON处理能力：支持jq全部原生功能，包括JSON数据的切片、过滤、映射和转换
• 终端自适应：自动检测输入输出终端类型，动态调整颜色和格式（彩色/单色、格式化/紧凑）
• 便捷交互模式：支持终端交互和管道输入，提供灵活的运行参数配置

使用场景

• 容器环境中需要处理JSON数据的命令行操作
• 跨平台一致的jq工具环境，避免本地依赖冲突
• 脚本集成JSON数据处理，确保执行环境一致性

使用方法

交互式使用配置

可通过以下shell函数简化镜像调用，实现终端自适应和格式控制：

sh
jq() {
  run_flags="--rm -i"  # 自动清理容器并保持标准输入打开
  container_flags=""

  if [ -t 0 ]; then
    # 标准输入是终端，启用交互模式
    run_flags="${run_flags} -t"
  fi

  if [ -t 1 ] && [ -z "$NOFORMAT" ]; then
    # 标准输出是终端且未设置NOFORMAT，启用彩色输出
    container_flags="${container_flags} -C" # 彩色化JSON
  else
    # 标准输出是管道或文件，使用单色输出
    container_flags="${container_flags} -M" # 单色

    if [ -n "$NOFORMAT" ]; then
      container_flags="${container_flags} -c" # 紧凑格式
    fi
  fi

  # shellcheck disable=SC2086
  docker run $run_flags "backplane/jq" $container_flags "$@"
}

环境变量说明

• NOFORMAT：控制输出格式，设置该变量（如NOFORMAT=1）时，jq将使用紧凑格式输出JSON

使用示例

1. 终端交互处理JSON：

   sh
   echo '{"name":"jq","type":"tool"}' | jq .name
   

   输出（彩色格式化）："jq"

2. 管道输出至文件（紧凑格式）：

   sh
   NOFORMAT=1 echo '[{"id":1},{"id":2}]' | jq . > output.json
   

   输出文件内容（紧凑格式）：[{"id":1},{"id":2}]