yq/pkg/yqlib/doc/operators/headers
Copilot 44c55c8a54
Add system(command; args) operator (disabled by default) (#2640)
* Initial plan

* Add system(command; args) operator with --enable-system-operator flag

Agent-Logs-Url: https://github.com/mikefarah/yq/sessions/8a11e9a0-10d2-4f2a-ae29-4e9d0bfc266f

Co-authored-by: mikefarah <1151925+mikefarah@users.noreply.github.com>

* Update pkg/yqlib/operator_system.go

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Evaluate system command/args per matched node using SingleReadonlyChildContext

Agent-Logs-Url: https://github.com/mikefarah/yq/sessions/dca841eb-3f63-4f23-adeb-556431560420

Co-authored-by: mikefarah <1151925+mikefarah@users.noreply.github.com>

* Add yqFlags to expressionScenario for doc command snippets; fix system op docs

Agent-Logs-Url: https://github.com/mikefarah/yq/sessions/3f8a5375-25fd-4428-a8e6-b630194c36b2

Co-authored-by: mikefarah <1151925+mikefarah@users.noreply.github.com>

* Update pkg/yqlib/doc/operators/headers/system-operators.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update pkg/yqlib/doc/operators/system-operators.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Validate command node type and handle multiple results with debug log

Agent-Logs-Url: https://github.com/mikefarah/yq/sessions/928aabc5-ad71-41d8-94ab-403942e3f92d

Co-authored-by: mikefarah <1151925+mikefarah@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Remove deprecated --enable-system-operator alias; use --security-enable-system-operator consistently

Agent-Logs-Url: https://github.com/mikefarah/yq/sessions/286b95e9-b6d7-4ab8-b401-2d7a03853922

Co-authored-by: mikefarah <1151925+mikefarah@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Address deep review feedback: error on disabled, strict arg/cmd validation, debug logs, docs

Agent-Logs-Url: https://github.com/mikefarah/yq/sessions/fbfba2db-60ea-4c20-a4c2-0fd396b80c81

Co-authored-by: mikefarah <1151925+mikefarah@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: mikefarah <1151925+mikefarah@users.noreply.github.com>
Co-authored-by: Mike Farah <mikefarah@gmail.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-04-10 20:06:46 +10:00
..
add.md Added support for adding objects 2022-01-23 11:35:44 +11:00
alternative-default-value.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
anchor-and-alias-operators.md Fixed test doc gen 2025-07-23 13:31:25 +10:00
array-to-map.md Updating docs 2022-11-13 11:16:01 +11:00
assign-update.md Minor typos (#1595) 2023-03-16 13:39:36 +11:00
boolean-operators.md Grammar fixes (#1877) 2023-11-23 11:54:25 +11:00
collect-into-array.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
column.md Improving column docs 2024-03-05 10:13:36 +11:00
comment-operators.md Minor typos (#1595) 2023-03-16 13:39:36 +11:00
compare.md Fixed help links 2022-03-29 11:08:50 +11:00
contains.md Minor typos (#1595) 2023-03-16 13:39:36 +11:00
create-collect-into-object.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
datetime.md Switch to uk (#2557) 2025-12-20 19:11:48 +11:00
delete.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
divide.md Added docs 2023-03-18 14:51:31 +11:00
document-index.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
encode-decode.md Added docs on base64 only working with utf8 content 2023-05-23 15:38:08 +10:00
entries.md chore: fix some minor issues in the comments 2025-07-10 13:33:36 +10:00
env-variable-operators.md Added flags to disable env and file ops #2515 2025-11-22 09:40:03 +11:00
equals.md Fixed help links 2022-03-29 11:08:50 +11:00
error.md Added error operator for custom validation #1259 2022-06-25 12:46:24 +10:00
eval.md Minor typos (#1595) 2023-03-16 13:39:36 +11:00
file-operators.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
filter.md Added docs 2023-03-18 14:51:31 +11:00
first.md Improving first op test 2025-10-12 14:32:28 +11:00
flatten.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
group-by.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
has.md Minor typos (#1595) 2023-03-16 13:39:36 +11:00
keys.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
kind.md Create kind.md header doc 2024-08-20 15:23:06 +10:00
length.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
line.md Added line and column operators 2022-02-27 11:56:46 +11:00
load.md Added flags to disable env and file ops #2515 2025-11-22 09:40:03 +11:00
Main.md Updating references to yq being a YAML processor 2023-11-30 15:32:21 +11:00
map.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
max.md min/max operators (#1992) 2024-03-30 13:34:36 +11:00
min.md min/max operators (#1992) 2024-03-30 13:34:36 +11:00
modulo.md Fixed modulo docs 2023-03-18 14:53:36 +11:00
multiply-merge.md Improve merge docs 2024-02-09 14:54:22 +11:00
omit.md Fixing omit docs 2024-03-24 10:59:29 +11:00
parent.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
path.md Added DELPATHS operator 2022-10-05 20:09:53 +11:00
pick.md Bumping version 2022-03-10 13:50:53 +11:00
pipe.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
pivot.md pivot operator (#1993) 2024-03-30 13:29:35 +11:00
recursive-descent-glob.md Minor typos (#1595) 2023-03-16 13:39:36 +11:00
reduce.md Fix typo (#1222) 2022-05-24 18:18:27 +10:00
reverse.md Added reverse op 2022-02-22 14:15:31 +11:00
select.md Fixed help links 2022-03-29 11:08:50 +11:00
shuffle.md Added shuffle command #1503 2023-02-11 05:08:20 +11:00
slice-array.md Add string slicing support (#2639) 2026-04-06 19:29:07 +10:00
sort-keys.md sort_by works on maps 2025-01-22 14:36:50 +11:00
sort.md Added reverse op 2022-02-22 14:15:31 +11:00
split-into-documents.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
string-operators.md Typo in cats example 2025-05-03 11:27:51 +10:00
style.md Updating style docs 2024-02-09 10:47:09 +11:00
subtract.md Minor typos (#1595) 2023-03-16 13:39:36 +11:00
system-operators.md Add system(command; args) operator (disabled by default) (#2640) 2026-04-10 20:06:46 +10:00
tag.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
to_number.md Added tonumber support #71 2023-10-05 15:15:01 +11:00
traverse-read.md Fixed test doc gen 2025-07-23 13:31:25 +10:00
union.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
unique.md Updated unique docs 2022-04-29 12:16:57 +10:00
variable-operators.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00
with.md Added XML decoder (#1044) 2021-12-21 15:02:07 +11:00