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

murex Shell Docs

Data-Type Reference: mxjson

Murex-flavoured JSON (primitive)

Description

mxjson is an extension to JSON designed to integrate more seamlessly when use as a configuration file. Thus mxjson supports comments and murex code blocks embedded into the JSON schema.

mxjson is a format that is pre-parsed into a valid JSON format.

mxjson isn’t currently a proper murex data-type in that you cannot marshal and unmarshal mxjson files. Currently it is a format that is only supported by a small subset of murex builtins (eg config and autocomplete) where config might embed murex code blocks.

mxjson features the following enhancements:

Line Comments

Line comments are prefixed with a ‘hash’, #, just like with regular murex code.

Block Quotation

Code blocks are quoted with (, ). For example, below “ExampleFunction” uses the ({ block quote }) method.

{
    "ExampleFunction": ({
        out: "This is an example _murex_ function"
        if { =1==2 } then {
            err: "The laws of the universe are broken"
        }
    })
}

Any block quoted by this method will be converted to the following valid JSON:

{
    "ExampleFunction": "\n    out: \"This is an example _murex_ function\"\n    if { =1==2 } then {\n        err: \"The laws of the universe are broken\"\n    }"
}

See Also

• Brace Quote (%(, )) Tokens: Initiates or terminates a string (variables expanded)
• Code Block Parsing: Overview of how code blocks are parsed
• Curly Brace ({, }) Tokens: Initiates or terminates a code block
• Marshal() (type): Converts structured memory into a structured file format (eg for stdio)
• Unmarshal() (type): Converts a structured file format into structured memory
• [[ (element): Outputs an element from a nested structure
• [ (index): Outputs an element from an array, map or table
• autocomplete: Set definitions for tab-completion in the command line
• cast: Alters the data type of the previous function without altering it’s output
• config: Query or define murex runtime settings
• format: Reformat one data-type into another data-type
• hcl: HashiCorp Configuration Language (HCL)
• json: JavaScript Object Notation (JSON) (primitive)
• jsonc: Concatenated JSON
• jsonl: JSON Lines (primitive)
• open: Open a file with a preferred handler
• pretty: Prettifies JSON to make it human readable
• runtime: Returns runtime information on the internal state of murex
• toml: Tom’s Obvious, Minimal Language (TOML)
• yaml: YAML Ain’t Markup Language (YAML)