How to add a header to CSV export in jq?

Question

I\'m taking a modified command from the jq tutorial:

curl \'https://api.github.com/repos/stedolan/jq/commits?per_page=5\' \\
| jq -r -c \'.[] | {mes         


        

Answer 1

While I fully realize OP was looking for a purely jq answer, I found this question looking for any answer. So, let me offer one I found (and found useful) to others like me.

1. sudo apt install moreutils - if you don't have them yet. Moreutils website.
2. echo "Any, column, name, that, is, not, in, your, json, object" | cat - your.csv | sponge your.csv

Disadvantages: requires moreutils package, is not just jq-reliant, so some would understandably say less elegant.

Advantages: you choose your headers, not your JSON keys. Also, pure jq ways are bothered by the sorting of the keys, depending on your version.

How does it work?

1. echo outputs your header
2. cat - takes echo output from stdin (cause -) and conCATenates it with your csv file
3. sponge waits until that is done and writes the result to same file, overwriting it.

But you could do it with tee without having to install any packages!

No, you could not, as Kos excellently demonstrates here. Not unless you're fine with loosing your csv at some point.