Include / Evaluate Murex Code (source)

Import Murex code from another file or code block

Description

source imports code from another file or code block. It can be used as either an "import" / "include" directive (eg Python, Go, C, etc) or an "eval" (eg Python, Perl, etc).

Usage

Execute source from stdin

<stdin> -> source

Execute source from a file

source filename.mx

Execute a code block from parameter

source { code-block }

Execute a module

source module:package/module

Examples

Execute source from stdin

» tout block { out "Hello, world!" } -> source
Hello, world!

Execute source from file

» tout block { out "Hello, world!" } |> example.mx
» source example.mx
Hello, world!

Execute a code block from parameter

» source { out "Hello, world!" }
Hello, world!

Execute a module

Lets say we want to use the secrets function from the devops package. This secrets function allows us to store and recall GPG encrypted API keys, so pretty useful functionality for a script. But since this is a script, it wouldn't automatically load all of the profiles and nor would we want it to.

So we could prepend the following to our script:

source module:devops/secret

Synonyms

• source
• .

See Also

• Define Function Arguments (args): Command line flag parser for Murex shell scripting
• Execute External Command (exec): Runs an executable
• Execute Shell Function or Builtin (fexec): Execute a command or function, bypassing the usual order of precedence.
• Murex Version (version): Get Murex version
• Private Function (private): Define a private function block
• Public Function (function): Define a function block
• Shell Configuration And Settings (config): Query or define Murex runtime settings
• Shell Runtime (runtime): Returns runtime information on the internal state of Murex
• Tab Autocompletion (autocomplete): Set definitions for tab-completion in the command line
• murex-parser: Runs the Murex parser against a block of code

---

This document was generated from builtins/core/management/source_doc.yaml.