murex rocks

Welcome

About

Install

Change Log

Blog

Technical Docs

Language Tour

Interactive Shell

Rosetta Stone

User Guide

Commands

Types

Open Source

GitHub repo

Search Site

User Guide: Spellcheck

How to enable inline spellchecking

murex supports inline spellchecking, where errors are underlined. For example

However to use this there needs to be a few satisfied prerequisites, not all of which will be enabled by default:

CLI Spellchecker (3rd Party Software)

A CLI spellchecker needs to be installed. The recommendation is aspell. This might already be installed by default with your OS or has been included as a dependency with another application. You can check if aspell is installed by running the following:

which: aspell

If that returns no data, then you will need to install aspell yourself. Please consult your OS docs for how to install software.

For help debugging issues with aspell, please see the last section in this document.

murex Config

ANSI Escape Sequences

ANSI escape sequences need to be enabled (which they are by default). This option is found in config under shell, color.

config: set shell color true

Spellcheck Enable

Spellcheck needs to be enabled. This option can be found in config under shell, spellcheck-enabled.

To enable this run:

config: set shell spellcheck-enabled true

…or add the above line to your murex profile, ~/.murex_profile to make the change persistent.

Please note that this option will automatically be enabled is aspell is installed.

Spellcheck murex Code

This shouldn’t need tweaking if you’re running aspell but other spellcheckers will require updated code. The default will look something like this:

» config: get shell spellcheck-func
{ -> aspell list }

The default should be good enough for most people but should you want to run an alternative spellchecker then follow the instructions in the next section:

How To Write Your Own spellcheck-func

You might legitimately want to run a different spellchecker and if so you’ll need to write your own spellcheck-func. Fortunately this is simple:

The function reads the command line from STDIN, if the spellchecker reads lines from parameters rather than STDIN you’ll need to write something equivalent to the following

{
    # This is a theoretical example. It will not work generically.
    -> set: line
    newspellchecker --check "$line"
}

The output of the function must me an array containing the misspelt words only. That array can be JSON just as long as you have set STDOUT’s data type to json. Similarly, other supported murex data types can be used too. However in general you might just want to go with a misspelling per line as it’s pretty POSIX friendly and thus most spellcheckers are likely to support it. eg

» out "a list of misspelt words: qwert fuubar madeupword" -> aspell: list
qwert
fuubar
madeupword

User Dictionary

murex has it’s own user dictionary, which is held as a JSON array:

» config: get shell spellcheck-user-dictionary
["murex"]

You can add words to a user dictionary via:

» config: eval shell spellcheck-user-dictionary { -> append "myword" }

or

» config: eval shell spellcheck-user-dictionary { -> alter: --merge / (["word1", "word2", "word3"]) }

Don’t forget to record these in your murex profile, ~/.murex_profile to make the changes persistent.

Ignored By Default

Sometimes commands are not valid words in ones native language. Thus any words that fall into the following categories are ignored by default:

• words that are also the names of commands found in $PATH
• words that are the names of murex functions (defined via function)
• words that are builtins (eg config and jsplit)
• any global aliases
• also any words that are also the names of global variables

Common Problems With aspell

Error: No word lists can be found for the language "en_NZ".

The en_NZ portion of the error will differ depending on your language.

If this error arises then it means aspell is installed but it doesn’t have the dictionary for your language. This is an easy fix in most OSs. For example in Ubuntu:

apt install aspell-en

(you may need to change -en with your specific language code)

Please consult your operating systems documentation for how to install software and what the package names are for aspell and its corresponding dictionaries.

See Also

• ANSI Constants: Infixed constants that return ANSI escape sequences
• Code Block Parsing: Overview of how code blocks are parsed
• Curly Brace ({, }) Tokens: Initiates or terminates a code block
• murex Profile Files: A breakdown of the different files loaded on start up
• murex’s Interactive Shell: What’s different about murex’s interactive shell?
• alter: Change a value within a structured data-type and pass that change along the pipeline without altering the original source input
• append: Add data to the end of an array
• config: Query or define murex runtime settings
• json: JavaScript Object Notation (JSON) (primitive)
• jsplit: Splits STDIN into a JSON array based on a regex parameter
• set: Define a local variable and set it’s value