From 1825b8b419b9d0ac2b7648e8bde50970477fcd62 Mon Sep 17 00:00:00 2001 From: XYenon Date: Mon, 19 Jan 2026 19:58:50 +0800 Subject: [PATCH] dasel: document v2 to v3 breaking changes Co-authored-by: Michael Daniels --- doc/release-notes/rl-2605.section.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/doc/release-notes/rl-2605.section.md b/doc/release-notes/rl-2605.section.md index 823262ea6bb4..7b8ca1fc595c 100644 --- a/doc/release-notes/rl-2605.section.md +++ b/doc/release-notes/rl-2605.section.md @@ -202,6 +202,17 @@ - `docker-color-output` has been updated from major version 2 to 3. One breaking change is, that they switched to [YAML-based configuration files](https://github.com/devemio/docker-color-output?tab=readme-ov-file#configuration). +- `dasel` has been updated from v2.8.1 to v3. There were significant breaking changes: + + - The `put` and `delete` commands have been removed. Use the new query syntax with expressions to modify data in-place. + - The `--version` flag is now a subcommand: `dasel version` + - CLI framework migrated from Cobra to Kong, changing flag parsing behavior + - Selector syntax has been revamped, see [dasel v3 documentation](https://daseldocs.tomwright.me/v3) for migration guide. + + Example migration: + - Old: `echo '{"my":{"favourites":{"colour":"blue"}}}' | dasel put -t json -r json -t string -v "red" "my.favourites.colour"` + - New: `echo '{"my":{"favourites":{"colour":"blue"}}}' | dasel query -i json -o json --root 'my.favourites.colour = "red"'` + - `stalwart-mail` has been renamed to `stalwart` - Ethercalc and its associated module have been removed, as the package is unmaintained and cannot be installed from source with npm now.