From 651d9edf88b1a9725678d84e726aa318eec159b5 Mon Sep 17 00:00:00 2001 From: Mike Farah Date: Fri, 21 Feb 2020 21:08:28 +1100 Subject: [PATCH] Updating readme --- Upgrade Notes | 74 --------------------------------------------------- 1 file changed, 74 deletions(-) delete mode 100644 Upgrade Notes diff --git a/Upgrade Notes b/Upgrade Notes deleted file mode 100644 index bdd8f99a..00000000 --- a/Upgrade Notes +++ /dev/null @@ -1,74 +0,0 @@ - -Major release! Upgraded underlying yaml parser, re-written majority of yq. This has brought on a number of features that have been in demand for a while (see below). - -This is in beta and needs some community feedback and testing :) - -# New Features - - Keeps yaml comments and formatting, can specify yaml tags when updating. https://github.com/mikefarah/yq/issues/19, https://github.com/mikefarah/yq/issues/169, https://github.com/mikefarah/yq/issues/107, https://github.com/mikefarah/yq/issues/171, https://github.com/mikefarah/yq/issues/245, https://github.com/mikefarah/yq/issues/303,https://github.com/mikefarah/yq/issues/308,https://github.com/mikefarah/yq/issues/314 - - Handles anchors! https://github.com/mikefarah/yq/issues/310, https://github.com/mikefarah/yq/issues/178 - - Can print out matching paths and values when splatting https://github.com/mikefarah/yq/issues/20 - - JSON output works for all commands! Yaml files with multiple documents are printed out as one JSON document per line. - - Deep splat (**) to match arbitrary paths - - -# Breaking changes - -## Update scripts file format has changed to be more powerful. -Comments can be added, and delete commands have been introduced. - -Before: -```yaml -b.e[+].name: Mike Farah -``` - -After: -```yaml -- command: update - path: b.e[+].thing - value: - #great - things: frog # wow! -- command: delete - path: b.d -``` - -https://github.com/mikefarah/yq/issues/305 - -## Reading and splatting, matching results are printed once per line. - e.g: - -```json -parent: - childA: - no: matches here - childB: - there: matches - hi: no match - there2: also matches -``` - -```bash -yq r sample.yaml 'parent.*.there*' -``` - -old -```yaml -- null -- - matches - - also matches -``` - -new -```yaml -matches -also matches -``` - -and you can print the matching paths: - -yq r --printMode pv sample.yaml 'parent.*.there*' - -```yaml -parent.childB.there: matches -parent.childB.there2: also matches -``` \ No newline at end of file