release_notes.txt

4.31.2:
  - Fixed variable handling #1458, #1566
  - Fixed merged anchor reference problem #1482
  - Fixed xml encoding of ProcInst #1563, improved XML comment handling
  - Allow build without json and xml support (#1556) Thanks @afbjorklund
  - Bumped dependencies

4.31.1:
  - Added shuffle command #1503
  - Added ability to sort by multiple fields #1541
  - Added @sh encoder #1526
  - Added @uri/@urid encoder/decoder #1529
  - Fixed date comparison with string date #1537
  - Added from_unix/to_unix Operators
  - Bumped dependency versions

4.30.8:
 - Log info message when unable to chown file in linux (e.g. snap confinement) #1521


4.30.7:
 - Fixed bug in splice operator #1511
 - Fixed value operator bug  #1515
 - Fixed handling of merging null #1501
 - Ownership of file now maintained in linux (thanks @vaguecoder) #1473
 - Bumped dependency versions

4.30.6:
  - Fixed xml comment in array of scalars #1465
  - Include blank new lines in leading header preprocessing #1462
  - Added aarch64 build (#1261)
  - Bumped dependency versions (#1453)

4.30.5:
  - XML Decoder: Comment parsing tweak 
  - XML Decoder: Fixed processing comments in empty XML #1446
  - XML Decoder: Checking for invalid content outside of a root node #1448
  - XML Decoder: Fixed issue where content surrounding tags are lost #1447
  - XML Decoder: Fixed xml decode bug when there is content after a comment
  - Fixed loading yaml with header issue #1445
  - guessTagFromCustomType warning log is now a debug.
  - Special thanks to @Kopfbremse for reporting XML issues!

4.30.4:
  - Fixed bug in automated versioning (snap/brew)

4.30.3:
  - Updated release process (automated versioning)
  - Fixed handling of yaml directives (#1424)
  - Fixed parsing of newline character in string expression #1430
  - Fixed length compares to null instead of 0 issue #1427

4.30.2:
  - Actually updated the default xml prefix :facepalm:

4.30.1:
  - XML users note: the default attribute prefix has change to `+@` to avoid naming conflicts!
  - Can use expressions in slice #1419
  - Fixed unhandled exception when decoding CSV thanks @washanhanzi
  - Added array_to_map operator for #1415
  - Fixed sorting by date #1412
  - Added check to ensure only maps can be encoded to XML #1408
  - Check merge alias is a map #1425
  - Explicity setting unwrap flag works for json output #437, #1409
  - Bumped go version



4.29.2:
  - Fixed null pointer exception when parsing CSV with empty field #1404

4.29.1:
  - Fixed Square brackets removing update #1342
  - Added slice array operator (.[10:15]) #44
  - XML decoder/encoder now parses directives and proc instructions (#1344). Please use the new skip flags [documented here](https://mikefarah.gitbook.io/yq/usage/xml) to ignore them.
  - XML users note that the default attribute prefix will change to `+@` in the 4.30 release to avoid naming conflicts!
  - Improved comment handling of decoders (breaking change for yqlib users sorry)
  - Fixed load operator bug when loading yaml file with multiple documents
  - Bumped Go compiler version
  - Bumped dependencies

4.28.2:
  - Fixed Github Actions issues (thanks @mattphelps-8451)
  - Fixed bug - can now delete documents #1377
  - Fixed handling of UTF8 encoded CSVs #1373
  - Detect and fail on missing closing brackets #1366
  - yq Github actions now build docker image as part of release
  - Bumped dependencies

4.28.1:
  - Added `setpath` and `delpaths` operators, like jq (#1374)
  - Added `is_key` operator, to check if a match was a key when recursing
  - Added validation when attempting to add sequences to maps (#1341)

4.27.5:
  - Fixed relative merge bug #1333

4.27.4:
  - Fixed bug in alternative (//) operator, RHS being evaluated when it didn't need to be
  - Fixed footer comment issue #1231
  - Github action now runs as root (as recommended by Github Actions doc)
  - Updated dependencies

4.27.3:
  - Added new 'c' merge and assign flag that clobbers custom tags
  - Bumped go dependency to fix CVE (#1316)
  - Updated dependencies

4.27.2:
  - Fixed JSON decoder to maintain object key order.

4.27.1:
  - Added 'json' decoder for support for multiple JSON documents in a single file (e.g. NDJSON)
  - Added 'csv' decoding, array of objects encoding, and round-triping
  - New StringEvaluator when using yq as a lib (thanks @leviliangtw)
  - Fixed XML decoding issue (#1284)

4.26.1:
  - Switched to new expression parser (#1264)
  - Don't clobber anchor when adding nodes (#1269)
  - New error operator for custom validation (#1259)
  - Added support for --wrapScalar=false in properties encoder (#1241) Thanks @dcarbone
  - Fix error on multiple assign (#1257) Thanks @care0717
  - Bumped dependency versions

4.25.4:
  - Fixed panic when using multiply assign on multiple documents #1256 Thanks @care0717

4.25.3:
  - xml decoder now maintains namespaces by default. Use new flags to disable if required. Thanks @rndmit
  - Length and other similar operators no longer return comments (#1231)
  - When split expression includes an extension, dont add .yml automatically (#1165)
  - Map -r to --unwrapScalar to be more a drop in replacement for jq (#1245) Thanks @SuperSandro2000
  - Fixing usage of quoted numeric keys #1247
  - Bumped dependency versions


4.25.2:
  - Fixed comments disappearing from end of file (#1217)
  - Fixed empty base64 decoding error (#1209)
  - JSON output now in colors (#1208)
  - Added codeql and fixed minor issues
  - Bumped go-yaml library
  - Bumped go dependency

4.25.1:
- Can specify a split expression file #1194
- Fixed append map bug when key matches value in existing map #1200
- Nicer error message when trying to use merge anchor tags other than maps #1184
- Fixed Don't automatically read stdin when the null input flag is used
- Added type as an alias for tag #1195
- Fixes bug when using write in-place with no expression and multiple files #1193

4.24.5:
  - Fixed scenarios that dropped the first line if it's a comment (#1181)
  - Fixed updating existing empty map resulting in single line styling (#1176)
  - Fixed `with` operation bug (#1174)
  - Bumped go compiler

4.24.4:
  - Fixed docker release build


4.24.3:
  - Added from_props
  - Re-releasing, 4.24.2 release failed to publish correctly.


4.24.2:
  - Fixing release pipeline for go1.18

4.24.1:
  - Added comparison operators! (#94)
  - Bumped golang to 1.18 (#1153)
  - XML parser no longer runs in strict mode (added new flag to run in strict mode) (#1155)

4.23.1:
  - Can now supply the envsubst operator with parameters (nounset, noempty, failfast). See [envsubst](https://mikefarah.gitbook.io/yq/operators/env-variable-operators) for details (#1137)
  - Bumped dependencies
  - Fixed '+=' problem with multiple matches #1145
  - Fixed bug with "and", "or" evaluating the RHS when not needed
  - Fixed potential panic (thanks @mkatychev)
  - Tweaked CLI help (thanks @justin-f-perez)

4.22.1:
  - Added [pick] (https://mikefarah.gitbook.io/yq/operators/pick) operator
  - Can load expression from a file '--from-file' (#1120)
  - Fixed property auto expansion (#1127)

4.21.1:
  - Added [reverse](https://mikefarah.gitbook.io/yq/operators/reverse) operator
  - Added [string case](https://mikefarah.gitbook.io/yq/operators/string-operators) operators
  - Added [base64 support](https://mikefarah.gitbook.io/yq/operators/encode-decode)
  - Added [line](https://mikefarah.gitbook.io/yq/operators/line)  and [column](https://mikefarah.gitbook.io/yq/operators/column) operators
  - Bumped dependency versions

4.20.2:
  - Fixed self assignment issue (#1107)
  - Fixed bad capture groups with multiple matches (#1114)
  - No longer auto-read from STDIN if there are files given (#1115)
  - Added missing load_props operator

4.20.1:
  - New [Date Operators](https://mikefarah.gitbook.io/yq/operators/datetime) (now, tz, add and subtract durations from dates) 
  - Can now decode property files!
  - New flag to manually set expression if required
  - ZSH completion bug fix (#1108) thanks @whi-tw
  - Fixed SEGV error (#1096)
  - Fixed Github actions issues (it pipes in /dev/null) for XML
  - Fixed bug - handle expressions that match a directory (e.g. ".")

4.19.1:
  - New [eval](https://mikefarah.gitbook.io/yq/operators/eval) _operator_ that allows dynamic expression evaluation (e.g. from a env variable) (#1087)
  - Adding new elements to array now automatically applies styling of existing elements (#722)

4.18.1:
  - `eval` is now the _default_ command, you can leave it out #113
  - `-` no longer needs to be specified as STDIN, unless you are also working with multiple files. #113
  - Adding to empty maps / arrays now uses idiomatic yaml styling by default
  - Fixed seg fault on bad input #1086
  - New `envsubst` operator! (thanks @sciyoshi)
  - Added support for `*=`, relative multiply/merge
  - Custom tag types now autocast to there actual types #933

4.17.2:
  - Fixed manpath issue (thanks @mr-pmillz)
  
4.17.1:
  - Added XML support (#491)
  - New merge flag (n) to only merge new fields (#1038)
  - Fixed exit status bug for permission denied error (#1062)
  - Fixed using multiple variables with union (,) operator (#1048)
  - Bumped some versions of dependencies

4.16.2:
  - Bumped go-lang compiler to fix CVE-2021-44717 (#1037)
  - Dependency version bumps via dependabot
  - Added extract-checksum.sh to make it easier to validate checksums (#1011)
  - Report filename on parsing error (#1030)

4.16.1:
  - Added csv, tsv output formats
  - Added map, map_values operators
  - Added sort, sort_by operators (#947, #1024)
  - Fixed bug in collect
  - Fixed permissions issue in Dockerfile (#1014)
  - Fixed assignment operator to no longer overwrite anchor (#1029)

4.15.1:
  - Added 'load/strload' operators for dynamically loading content from files
  - Added 'key' operator
  - Added 'parent' operator
  - Smarter MAN page installation script (thanks @coolaj86)
  - Dockerfile improvements (thanks @actualben)
  - Error handling improvements (thanks @mmorel-35)

4.14.2:
  - Fixed header preprocessing issue (#1000)
  - Bumped version dependencies

4.14.1:
  - Added group_by operator
  - Added encode/decode operators (toyaml, fromjson etc) (#974)
  - Added flatten operator
  - Added --split-exp, for splitting results into multiple files (#966)
  - Fixed json null array bug (#985)

4.13.5:
  - Performance improvement for deepMatch (thanks @pmatseykanets)
  - Added manpage, included in tar.gz downloads as well as a separate tar.gz (#961)
  - Fixed expression parsing bug #970
  - Rebuild fixes CVE (#964)
  - Bumped docker alpine version


4.13.4:
  - Fixed select bug (#958)
  - Improved performance of `explode` (this will also speed up json conversion)
  - Improved performance of `merge` (significantly if your merging a small file into a big one)

4.13.3:

- Updated go compiler to 1.17 to fix CVE (#944)

4.13.2:

- Fixing Docker build timeout issues when attempting to release

4.13.1:

- Update to `with` operator, allow for no leading space on the `;`.

4.13.0:

BREAKING CHANGE - the `as` variable operator (e.g. `.a as $x`) now makes a _copy_ of the node(s) at the 
path rather than a reference. This is in order to make it work more like the `jq` equivalent. 

This means any updates made to that variable do not update the original.

There's a new operator `ref` that will make a reference (and allow multiple updates to the original path by referencing the variable).
Sorry for any inconvenience caused!.


- New `with` operator for making multiple changes to a given path
- New `contains` operator, works like the `jq` equivalent
- Subtract operator now supports subtracting elements from arrays!
- Fixed Swapping values using variables #934
- Github Action now properly supports multiline output #936, thanks @pjxiao
- Fixed missing closing bracket validation #932

4.12.2:
- Fix processing of hex numbers #929
- Fixed alternative and union operator issues #930

4.12.1:
 - Merge comment fix #919

4.12.0:
- Can now convert yaml to properties properties format (`-o=props`), See [docs](https://mikefarah.gitbook.io/yq/v/v4.x/usage/properties) for more info.
- Fixed document header/footer comment handling when merging (https://github.com/mikefarah/yq/issues/919)
- pretty print yaml 1.1 compatibility  (https://github.com/mikefarah/yq/issues/914)