Làm thế nào để sử dụng `jq` trong một đường ống vỏ?

Tôi dường như không thể jqcư xử "bình thường" trong một đường ống vỏ. Ví dụ:

$ curl -s https://api.github.com/users/octocat/repos | jq | cat

kết quả jqchỉ đơn giản là in ra văn bản trợ giúp của nó *. Điều tương tự cũng xảy ra nếu tôi cố chuyển hướng jqđầu ra của tệp sang tệp:

$ curl -s https://api.github.com/users/octocat/repos | jq > /tmp/stuff.json

Là jqcố tình bảo lãnh ra nếu nó xác định rằng nó không được chạy từ một tty? Làm thế nào tôi có thể ngăn chặn hành vi này để tôi có thể sử dụng jqtrong một đường ống dẫn?

* _{(Tôi nhận ra ví dụ này chứa việc sử dụng mèo vô dụng ; nó chỉ nhằm mục đích minh họa)}

Bạn cần cung cấp một bộ lọc làm đối số. Để vượt qua JSON thông qua chưa sửa đổi, ngoài việc in ấn đẹp jqcung cấp theo mặc định, hãy sử dụng bộ lọc nhận dạng .:

curl -s https://api.github.com/users/octocat/repos | jq '.' | cat

Một trường hợp sử dụng mà tôi thấy mình cũng thường xuyên làm là "Làm thế nào để tôi xây dựng dữ liệu JSON để cung cấp cho các lệnh shell khác, chẳng hạn curl?" Cách tôi làm điều này là bằng cách sử dụng --null-input/-ntùy chọn:

Đừng đọc bất kỳ đầu vào nào cả! Thay vào đó, bộ lọc được chạy một lần bằng cách sử dụng nulllàm đầu vào. Điều này hữu ích khi sử dụng jqnhư một máy tính đơn giản hoặc để xây dựng dữ liệu JSON từ đầu.

Và một ví dụ chuyển nó vào curl:

jq -n '{key: "value"}' | curl -d @- \
  --url 'https://some.url.com' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json'