如何在 jq 中向 CSV 导出添加标题？

Question

我正在从jq tutorial 获取修改后的命令：

curl 'https://api.github.com/repos/stedolan/jq/commits?per_page=5' \
| jq -r -c '.[] | {message: .commit.message, name: .commit.committer.name} | [.[]] | @csv'

csv 导出效果好，但顶部缺少标题：

"Fix README","Nicolas Williams"
"README: send questions to SO and Freenode","Nicolas Williams"
"usage() should check fprintf() result (fix #771)","Nicolas Williams"
"Use jv_mem_alloc() in compile.c (fix #771)","Nicolas Williams"
"Fix header guards (fix #770)","Nicolas Williams"

如何在顶部添加标题（在本例中为 message,name）？ （我知道可以手动操作，但是如何在jq 内完成呢？）

Answer 1

只需在值前面的数组中添加标题文本。

["Commit Message","Committer Name"], (.[].commit | [.message,.committer.name]) | @csv

Answer 2

基于 Anton 对 Jeff Mercado 的回答的 cmets，此 sn-p 将获取第一个元素的属性的键名，并将它们作为数组输出到行之前，从而将它们用作标题。如果不同的行有不同的属性，那么它就不能很好地工作；再说一次，生成的 CSV 也不会。

map({message: .commit.message, name: .commit.committer.name}) | (.[0] | to_entries | map(.key)), (.[] | [.[]]) | @csv

Answer 3

虽然我完全意识到 OP 正在寻找一个 purely jq 答案，但我发现这个问题正在寻找 any 答案。所以，让我将我发现（并且发现有用）的一个提供给像我这样的其他人。

1. sudo apt install moreutils - 如果你还没有。 Moreutils website。
2. echo "Any, column, name, that, is, not, in, your, json, object" | cat - your.csv | sponge your.csv

缺点：需要moreutils 包，不仅仅是jq-reliant，所以有些人会说不太优雅。

优点：您可以选择标头，而不是 JSON 键。此外，纯粹的 jq 方式会受到键的排序 depending on your version 的困扰。

它是如何工作的？

1. echo 输出你的标题
2. cat - 从 stdin 获取 echo 输出（原因 -）并将其与 csv 文件合并
3. sponge 一直等到完成，然后将结果写入同一个文件，并覆盖它。

但您可以使用 tee 来完成，而无需安装任何软件包！

不，你不能，就像Kos excellently demonstrates here。除非您可以在某个时候丢失 csv，否则不会。