v5.2

The v5.2 release introduces significant new features and improvements for those using Murex as their interactive shell. Many of these features are unique to Murex.

Breaking Changes

• Change to experimental feature: all lambda variables now follow the $.k and $.v convention (read more)

• Murex now requires Go compiler version 1.20 or above, however a C compiler is no longer required (though still supported)

• expressions that return a boolean will no longer write true nor false to stdout if it is followed by a boolean operator (&& or ||). This is marked as a breaking change because some of Murex's tests had to be updated to reflect this update, however this change actually fixes a number of bugs around expectations for how boolean expressions should work

Deprecation Warnings

Please read out compatibility commitment to understand how features are deprecated.

• the ? pipe will be deprecated to make way for a the ternary operator. You can achieve the same result with <err> <!out>, eg command <err> <!out> parameters... | next-command ...

• experimental TTY buffer was removed. This was disabled by default, would create a slight slow down to rendering when enabled, created a few rendering glitches when enabled, added to the overall code complexity, and the primary use case for this no longer requires buffering anyway

Features

Features marked as EXPERIMENTAL are provided without assurances of future breaking changes. All other features are considered stable as part of Murex's compatibility commitment.

• debug builtin now supports { ... } blocks (read more)

• new flags for count: --sum / -s and --sum-strict

• Lambda support for arrays and objects re-written and now considered stable (read more)

• f9 command line preview added -- this feature allows you to quickly build and test pipelines that might otherwise require iterating on trial and error to get right

• f1 autocomplete preview is no longer considered experimental. Several bug fixes included

• new pipe: pty. This behaves similarly to a regular pipe except it creates a pseudo-TTY

• f1 preview now includes cheat sheets from https://cheat.sh/

• job control: builtins can now be stopped via ^z (issue #716)

• docgen has seen several new features added to improve the ease of writing documentation for Murex

Bug Fixes

• readline: fixed regression bug introduced in preview release where vim keys wouldn't write their updated state to the terminal

• f1 preview now resets the cursor position correctly when closed

• f1 preview has had autocomplete parameters rewritten to jump to the right man page flag more precisely

• f1 preview scrolling had an off-by-one error resulting in the last line sometimes getting cropped

• shebang (#!/path/to/murex) scripts should be loaded into a module namespace. This fixes module scoped config (read more)

• command lines passed via -c flag (eg murex -c "out hello world") are also loaded into a module namespace

• readline: trim whitespace before walking history

• recommended optional builtins are now opt-out -- this is to make it easier to work with 3rd party package maintainers

• job control: bug fixes around when to show and hide the interactive prompt (issue #716)

• job control: processes invoked via bg {...} now support being brought to the foreground via fg (this could be argued as a new feature) (issue #716)

• error handling added to get-type (read more)

• boolean expressions, eg 2+3==5 now work with boolean operators (&&, ||). eg $USER == "bob" && out "Hello Bob".

Special Thanks

Special thank yous for this release goes to tiymat for their bug fixes and everyone in the discussions group for raising bug reports and design discussions.

You rock!

---

Published: 18.11.2023 at 20:59

See Also

• Background Process (bg): Run processes in the background
• Count (count): Count items in a map, list or array
• Debugging Mode (debug): Debugging information
• Foreground Process (fg): Sends a background process into the foreground
• How To Contribute: Murex is community project. We gratefully accept contributions
• Install: Installation Instructions
• Job Control: How to manage jobs with Murex
• Terminal Hotkeys: A list of all the terminal hotkeys and their uses
• [{ Lambda }]: Iterate through structured data

---

This document was generated from gen/changelog/v5.2_doc.yaml.