[execute-file]

execute-file is a core slot, one of the keywords of the Hyperlambda language, in Hyperlambda, the language of Magic Cloud. Loads a Hyperlambda file and evaluates it as if it were inlined; child nodes become its [.arguments].

  • Value (hyperlambda-file), required: File path to execute
  • Returns: Resolves to the executed file’s value result and any returned child nodes

Arguments

Required arguments come first, then the optional ones in the order they are declared.

Argument Type Required Description
any node name object no Named argument passed to the executed file as a child of [.arguments]. Can be repeated.

Returned nodes

Node Type Required Description
any node name lambda no Returned child node produced by the executed Hyperlambda file. Can be repeated.

Guide: How to use [execute-file]

JSON declaration

This is the complete declaration of execute-file, as the running system describes it. It is also published as slot.json.

JSON declaration
{
  "name": "execute-file",
  "description": "Loads a Hyperlambda file and evaluates it as if it were inlined; child nodes become its [.arguments]",
  "signature": {
    "input": {
      "kind": "hyperlambda-file",
      "description": "File path to execute",
      "required": true,
      "mode": "ValueOrExpression"
    },
    "children": {
      "*": {
        "type": "object",
        "kind": "value",
        "description": "Named argument passed to the executed file as a child of [.arguments]",
        "required": false,
        "mode": "Arguments",
        "cardinality": "ZeroOrMore",
        "preprocess": "UnwrapExpressions",
        "role": "Arguments",
        "projection": "ArgumentBag"
      }
    },
    "output": {
      "mode": "Both",
      "kind": "lambda-result",
      "description": "Resolves to the executed file's value result and any returned child nodes",
      "children": {
        "*": {
          "type": "lambda",
          "kind": "hyperlambda-result-node",
          "description": "Returned child node produced by the executed Hyperlambda file",
          "required": false,
          "mode": "Value",
          "cardinality": "ZeroOrMore",
          "role": "Payload",
          "projection": "Self"
        }
      }
    }
  }
}

← execute all core slots exists →