Skip to main content


Laurence MorganAbout 1 min


Tom's Obvious, Minimal Language (TOML)


TOML support within Murex is pretty mature however it is not considered a primitive. Which means, while it is a recommended builtin which you should expect in most deployments of Murex, it's still an optional package and thus may not be present in some edge cases. This is because it relies on external source packages for the shell to compile.


Example TOML document taken from Wikipediaopen in new window

# This is a TOML document.

title = "TOML Example"

name = "Tom Preston-Werner"
dob = 1979-05-27T07:32:00-08:00 # First class dates

server = ""
ports = [ 8001, 8001, 8002 ]
connection_max = 5000
enabled = true


  # Indentation (tabs and/or spaces) is allowed but not required
  ip = ""
  dc = "eqdc10"

  ip = ""
  dc = "eqdc10"

data = [ ["gamma", "delta"], [1, 2] ]

# Line breaks are OK when inside arrays
hosts = [

Default Associations

  • Extension: toml
  • MIME: application/toml
  • MIME: application/x-toml
  • MIME: text/toml
  • MIME: text/x-toml

Supported Hooks

  • Marshal() Supported
  • ReadArray() Hook supported albeit TOML doesn't support naked arrays
  • ReadArrayWithType() Hook supported albeit TOML doesn't support naked arrays
  • ReadIndex() Works against all properties in TOML
  • ReadNotIndex() Works against all properties in TOML
  • Unmarshal() Supported

See Also

  • [[ Element ]]: Outputs an element from a nested structure
  • cast: Alters the data type of the previous function without altering it's output
  • format: Reformat one data-type into another data-type
  • json: JavaScript Object Notation (JSON)
  • jsonl: JSON Lines
  • open: Open a file with a preferred handler
  • runtime: Returns runtime information on the internal state of Murex
  • yaml: YAML Ain't Markup Language (YAML)
  • index: Outputs an element from an array, map or table

Read more about type hooks

This document was generated from builtins/types/toml/toml_doc.yamlopen in new window.

Last update:
Contributors: Laurence Morgan,Laurence Morgan,Laurence